享道出行开放平台文档中心

# 订单信息同步

# 简介

用于进行订单状态变更回调。

# 服务提供方

合作方

# 接口URL

/v1/saicm/orderChange

# 请求方式

POST

# 请求频次

单次

# 请求参数

参数名称 类型 必选 说明
msgID string 是 消息唯一 ID 每个请求的唯一 ID，确保唯一即可。 推荐使用 UUID 策略。
type string 是 数据类型 固定值：orders
time long 是 发送时间 发送数据的时间，发送方服务器的本地时间. 以毫秒为单位的 Unix 时间戳
data object 是 数据体
data.orders list 是 订单信息
data.orders.openId string 是 用户ID
data.orders.orderId string 是 订单ID 订单唯一标识如:9877234
data.orders.oid string 是 合作方订单ID 合作方订单 ID。 如: 2502789315097779
data.orders.type int 是 订单类型 订单类型(订单类型支持根据业务进行递增)，如:1：实时订单 2：预约订单 3：接机单 4：送机单
data.orders.status int 是 订单状态见附录3
data.orders.statusTime long 是 订单状态变化时间 订单发生变化时刻的时间，以毫秒为单位的Unix 时间戳
data.orders.vehicleID string 否 车辆 ID 订单匹配的车辆的唯一标示。如订单还未分配车辆则传空。如:497060272
data.orders.vehicleType int 是 订单车辆类型 享道车辆类型定义见附录。
data.orders.vehicleLocation string 否 车辆位置 车辆位置经纬度。经度在前，纬度在后。经纬度之间用英文半角逗号分 开。
data.orders.start string 是 出发地经纬度 车辆位置经纬度。经度在前，纬度在后。经纬度之间用英文半角逗号分开。每次只能传1 组经纬度。如: 120.131275,30.342033
data.orders.startName string 是 出发地名称 出发地名称
data.orders.end string 是 目的地经纬度 车辆位置经纬度。经度在前，纬度在后。经纬度之间用英文半角逗号分开。每次只能传1 组经纬度。如: 120.131275,30.342033
data.orders.endName string 是 目的地名称 目的地名称
data.orders.userLocation string 是 用户叫车时位置 用户叫车位置（没有传"0.0,0.0"）
data.orders.supportModifyDestination boolean 否 是否支持修改目的地
data.orders.matched_vehicle string 否 同时呼叫场景存在，最终成单运力，参见附录1
data.orders.is_relay_order string 否 是否是接力单，0 不是，1 是
data.orders.relay_order_lat string 否 接力单终点纬度，仅接力单返回
data.orders.relay_order_lon string 否 接力单终点经度，仅接力单返回
data.orders.relay_order_id string 否 接力单享道订单号，仅接力单返回
data.orders.connectTel string 否 客服热线
data.orders.vehicleModel string 否 车辆型号
data.orders.vehicleColor string 否 车辆颜色
data.orders.vehiclePlate string 否 车辆车牌
data.orders.driverId string 否 司机id
data.orders.driverName string 否 司机名字
data.orders.virtualMobile string 否 司机虚拟手机号

# 响应参数

参数名称 类型 必有 说明
errCode int Y 服务响应状态，参见附录5
errMsg string Y 服务响应状态说明，参见附录5

← 司机位置 →