场景描述

同步用户侧相关信息，专员服务信息回调见通用任务信息回调

调用方式

HTTP Post

功能

Open NSC 将使用统一的回调参数，将接入方需要的订单信息回传到接入方系统。接入方可根据此信息对订单进行更新，但需要对回调进行幂等控制。

接入流程

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

接口签名规范

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

接口返回值要求

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

回调重试次数

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

订单状态回调-创建/更新 说明

订单状态回调通过创建、更新两个接口共同完成，在和渠道方的对接过程中，多次出现对两个接口可回调状态产生误解的情况，补充说明如下：

1. 订单的首次回调一定通过创建接口回调，创建接口只会回调一次，并且状态可能是 1000，1100，1200
   • 1000：创建订单，需求未冻结
   • 1100：创建订单，需求已冻结，未分配资源
   • 1200：创建订单，并立即分配资源成功（这也是最为常见的情况）
2. 相同状态会在创建、更新接口分别回调，有且只有 1200
   当下单成功，并且是立即分配资源成功时，系统会在很短的间隔内触发两次不同的回调
   • 在创建接口回调 1200
   • 在更新接口也回调 1200
3. 相同状态可能在更新接口回调多次
   根据订单的执行流程不同，订单可能重复回到某种状态，因而在更新接口会有相同状态重复回调多次

订单信息

订单信息包含在不同的 section 中。

section 释义

Post body 格式

application/json

参数示例

{
   "channel_account":{
      "access_token":"channal_access_token_xxx",
      "user_id":"channal_user_id_xxx"
   } 
   "order":{
      "order_id":"820034787833641750",
      "status":1000,
      "creation_time":1517987834,
      "update_time":1517987834,
      "phone":"17865736543",
      "pay_due_time":1517988434,
      "original_start_time":1517988000,
      "original_end_time":1517988912,
      "estimate_start_time":1517988647,
      "estimate_end_time":1517988659,
      "actual_serve_start_time":1517987840,
      "actual_serve_end_time":1517988902,
      "resource_schedule_mode":0
   },
   "staff":{
      "staff_id":"1234",
      "avatar_url": "https://cdn-app.nio.com/lbSys/2020/1/9/f2446abc-9315-4a80-bae1-f315cab6982b.jpg",
      "name":"张三",
      "phone":"12345674567"
   },
   "vehicle":{
      "model_id":"model-123",
      "brand":"蔚来",
      "model_name":"ES8",
      "plate_number":"京A12222"
   },
   "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
     }
   ]
   "payment_info":{
      "status":1,
      "amount":180
   },
   "resource_info":{
      "resource_id":"CS-TLD-00000001-BJ-00003",
      "name":"天津崇泰响螺湾王相大厦充电站",
      "show_name":"特来电充电站（天津崇泰响螺湾王相大厦充电站）",
      "latitude":36.443333,
      "longitude":115.969948,
      "region_code":"110000",
      "operator_id":"TLD",
      "opeartor_name":"特来电"
   },
   "soc_info":{
      "soc":80,
      "remaining_range":400
   },
    "cancellation_fee":{
      "has_cancellation_fee":true
   },
   "service_image": [
       {
           "order_id": "820116867791554949",
           "task_id": "830116867792554359",
           "image_type": "1",
           "image_url": "https://cdn-app-test.nio.com/tibbers/2020/9/14/e1d6f2d4-d624-4c9c-8e21-91b7a9ae045d",
           "creation_time": 1600067844
       }
   ]
}

参数说明

channel_account section

order section

staff section

vehicle section

parking_info section

payment_info section

resource_info section

soc_info section

cancellation_fee section

service_image section