场景描述

同步专员侧相关信息，用户服务信息回调见通用订单状态更新回调

调用方式

HTTP Post

功能

Open NSC 将使用统一的回调参数，将接入方需要的专员任务信息回传到接入方系统。

接入流程

接入方根据自身业务需求，明确需要回调的信息，从目前支持的 section 中选取实际需要的信息区。
Open NSC 增加相关接入方的接入配置。
Open NSC 和接入方进行联调测试，确认回调成功后上线。

接口签名规范

为保证通讯安全，Open NSC 侧会用和验签相同的加签方式（见签名规范），对发送的请求进行签名。

接口返回值要求

接口返回值请尽量参照 Response 结构实现。如果不能完全根据上述标准返回，必须返回 result_code 字段，并以 "success" 作为回调成功的标识。Open NSC 将以此作为回调成功与否的判断。

接口性能要求

接口响应时间请控制在 1000ms 内，否则 Open Nsc 会认为请求失败。

回调重试次数

Open NSC 支持回调重试，接入方需提供回调重试次数，重试次数默认值为 0。重试次数最大不超过3次，每次都在失败之后立即重试。

专员任务信息

任务信息包含在不同的 section 中。

section 释义

Section	说明
task	任务基本信息
staff	任务专员信息
parking_info	任务停车信息
user	任务对应用户信息
vehicle	任务对应车辆的基本信息

参数示例

{ 
   "task":{
      "task_id":"830067347951321103",
      "city_code":"252000",
      "city_name":"聊城市",
      "mission":"STAFF_CHARGE_WITH_THIRD_PART_CS",
      "status":40,
      "actual_start_time":1517987840,
      "actual_end_time":1517988902,
      "creation_time":1517987834,
      "update_time":1517987834      
   },
   "staff":{
      "external_employee_no":"123456",
      "name":"张三",
      "phone":"13012341234",
      "location":{
         "latitude":36.443333,
         "longitude":115.969948
      }
   },
   "parking_info":[
      {
         "type":13,
         "latitude":36.443333,
         "longitude":115.969948,
         "poi_id":"qq:2577301541586800564",
         "poi_name":"聊城市",
         "poi_area_code":"371500",
         "poi_address":"光岳楼",
         "poi_latitude":36.443333,
         "poi_longitude":115.969948
      },
      {
         "type":14,
         "latitude":36.443333,
         "longitude":115.969948,
         "poi_id":"qq:2577301541586800564",
         "poi_name":"聊城市",
         "poi_area_code":"371500",
         "poi_address":"光岳楼",
         "poi_latitude":36.443333,
         "poi_longitude":115.969948
      }
   ],
   "user":{
      "name":"张*",
      "phone":"139****0123"
   },
   "vehicle":{
      "vin":"1FDEE14H4MHA16668"
   }
}

参数说明

task section

参数名	类型	说明
task_id	string	任务 ID
city_code	string	任务城市编码
city_name	string	任务城市名称
mission	string	任务类型，具体见Mission
status	integer	任务状态，具体见TaskStatus
actual_start_time	timestamp	任务实际开始时间，取值为第一个执行步骤的实际开始时间
actual_end_time	timestamp	任务实际完成时间，取值为最后一个执行步骤的实际完成时间
creation_time	timestamp	创建时间
update_time	timestamp	更新时间

staff section

参数名	类型	说明
external_employee_no	string	专员工号
name	string	专员姓名
phone	string	专员联系方式
location	object	专员当前位置
-- latitude	double	纬度
-- longitude	double	经度

parking_info section

参数名	类型	说明
type	byte	见枚举值 ParkingInfoType
longitude	double	停车经度
latitude	double	停车纬度
poi_id	string	停车点 POI ID
poi_name	string	停车点 POI 名称
poi_area_code	string	停车点区级邮编
poi_address	string	停车点 POI地址（不含行政区域）
poi_latitude	double	POI 纬度
poi_longitude	double	POI 经度

user section

参数名	类型	说明
name	string	用户姓名，第一个字之后掩码
phone	string	用户联系方式，4-7位掩码

vehicle section

参数名	类型	说明
vin	string	车辆车架号

通用任务信息回调