场景描述

拖车单下单

调用方式

HTTP Post

功能

Open NSC 将使用统一的参数，将供应商下单需要的信息传到供应商系统。

接入流程

供应商根据自身系统需求，明确需要下单需要的信息，如无疑问，则按此文档信息进行对接
Open NSC 增加相关供应商的接入配置
Open NSC 和接入方进行联调测试，确认下单成功后上线。

接口签名规范

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

接口返回值要求

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

下单信息

Post body 格式

application/json

参数示例

{
  "order_id": "826127771471626630",
  "business_order_id": "845127771471626630",
  "service_type": 1,
  "reason": 1,
  "trailer_reason": "1,2",
  "request_time": 1234567890,
  "appoint_time": 1234567890,
  "operator_info":"管家chanx.ch",
  "source_handover": {
    "name": "abc",
    "phone": "12345678901"
  },
  "dest_handover": {
    "name": "abc",
    "phone": "12345678901"
  },
  "source_address": {
    "longitude": 36.443333,
    "latitude": 115.969948,
    "address": "",
    "description": ""
  },
  "dest_address": {
    "longitude": 36.443333,
    "latitude": 115.969948,
    "address": "",
    "description": ""
  },
  "vehicle": {
    "vin": "",
    "plate_number": "",
    "brand_model": ""
  },
  "vehicle_condition": {
    "console_enabled": true,
    "above_ground": true,
    "ahead_distance": 1,
    "around_wheel_distance": 1,
    "wheel_locked": true,
    "scene": 1,
    "battery_pack_error": true,
    "remark": ""
  },
  "vehicle_condition_v2": {
    "console_enabled": -1,
    "ahead_distance": 0,
    "around_wheel_distance": 1,
    "scene": "1,2",
    "unable_to_drive_reason":"wrap",
    "remark": ""
  },
  "brand": "nio"
}

参数说明

参数名	必选	类型	说明
order_id	yes	string	订单 ID
business_order_id	yes	string	业务订单 ID
service_type	yes	int	服务单类型，参见拖车服务单类型
reason	yes	int	使用拖车原因，参见使用拖车原因
trailer_reason	yes	string	使用拖车原因，多个原因使用逗号分隔，过渡期 reason 和 trailer_reason 必有其一，参见使用拖车原因
request_time	yes	timestamp	发起服务时间，unix timestamp
appoint_time	no	timestamp	预约到达起点时间，unix timestamp
operator_info	no	string	下单操作人信息，姓名+域账号
source_handover	yes	object	取车地联系信息
-- name	no	string	姓名
-- phone	yes	string	联系方式
dest_handover	yes	object	目的地联系信息
-- name	no	string	姓名
-- phone	yes	string	联系方式
vehicle	yes	object	车辆信息
-- vin	yes	string	车架号
-- plate_number	yes	string	车牌号
-- brand_model	yes	string	品牌车型
source_address	yes	object	停车点信息
-- longitude	yes	double	经度
-- latitude	yes	double	纬度
-- address	yes	string	详细地址
-- description	no	string	地址描述
dest_address	yes	object	拖车送达目的地信息
-- longitude	yes	double	经度
-- latitude	yes	double	纬度
-- address	yes	string	详细地址
-- description	no	string	地址描述
vehicle_condition	no	object	车况信息
-- console_enabled	no	boolean	中控台是否可以点亮
-- above_ground	no	boolean	是否在地上
-- ahead_distance	no	int	车辆前方距障碍物距离(米)，如果有障碍物，则需要
-- around_wheel_distance	no	double	车轮四周障碍物距离(米)
-- wheel_locked	no	boolean	方向是否锁死
-- scene	no	int	场景，参见场景
-- battery_pack_error	no	boolean	电池包是否有异常
-- remark	no	string	备注
vehicle_condition_v2	no	object	车况信息 2.0
-- console_enabled	yes	int	中控台能否点亮,参见拖车其他故障信息
-- ahead_distance	yes	int	车辆前方是否有5米以上距离,,参见拖车其他故障信息
-- around_wheel_distance	yes	int	车轮四周是否有半米距离,,参见拖车其他故障信息
-- scene	yes	string	场景，多个场景逗号分隔，参见场景
-- unable_to_drive_reason	no	string	车辆无法行驶原因
-- remark	no	string	备注
brand	yes	string	所属品牌，参加品牌

接口返回信息

返回示例

{
    "result_code": "success",
    "data": {
        "trailer_order_id": "826127771471626630"
    },
    "request_id": "0a6f981aj9xvewih_23",
    "server_time": 1510558306
}

返回参数说明

键	类型	是否必须	说明
request_id	string	是	见api规范
result_code	string	是	见api规范
message	string	是	见api规范
data	object	是	见api规范
- trailer_order_id	string	是	拖车订单号

通用下单规范