# 订单中心

# 同步订单信息

接口说明： 本接口用于同步订单信息，业务侧生成订单时同步数据调用。
请求地址：/order/rsync
请求方式： POST
请求参数： 通用参数 + 业务参数

参数名称	类型	最大长度	必须	说明
user_code	string	32	是	用户标识(同插件跳转的 openId 参数)
out_order_id	string	32	是	服务商订单标识，服务商系统内唯一服务商系统内部订单号，要求`32`个字符内，只能是数字、大小写字母_-\|*@ ，且在同一个商户号下唯一
app_id	string	32	是	同插件跳转的appId(下单小程序)
book_time	int	11	是	下单时间，单位秒
product_info	array	-	是	商品信息列表
product_info[0].id	string	32	是	商品ID, 业务侧自己定义
product_info[0].name	string	64	是	商品名称
product_info[0].ori_price	int	11	是	原始价格, 单位分
product_info[0].pay_price	int	11	是	支付价格, 单位分
product_info[0].number	int	11	是	商品数量
product_info[0].supplier_id	string	32	否	供应商ID
product_info[0].supplier_name	string	128	否	供应商名称
ori_fee	int	11	是	订单原始金额, 单位分
pay_fee	int	11	是	订单支付金额, 单位分
coupon_fee	int	11	否	优惠券金额, 单位分
transport_fee	int	11	否	运费金额, 单位分
logistics_number	int	11	否	物流数量
logistics_carrier	int	11	否	物流公司
plate_no	string	11	否	车牌号(道路救援业务必填)
tai_model_id	long	20	否	腾讯车型 ID (保养业务必填)
status	int	11	是	订单状态，参见如下`订单状态说明`
ext_info	string	256	否	扩展信息分业务，JSON 格式的字符串，参见如下`扩展信息说明`
attach	string	128	否	小程序跳转所附带参数，回传的小程序附带信息
buss_classify	int	32	否	业务类型，参见如下`订单业务类型说明`
app_channel_id	int	11	否	app用户渠道id
source_id	int	11	否	订单来源ID
buss_status	int	11	否	业务侧订单状态，由业务侧自己控制
order_phone	string	32	否	下单手机号
city_id	string	32	否	城市ID，数据源在腾讯侧
channel_order_id	string	32	否	渠道订单号

返回参数

参数名称	类型	最大长度	必选	说明
code	int	11	是	服务响应状态，参见错误码表
message	string	64	是	服务响应状态说明，参见错误码表
data	object	-	否	数据字段

请求数据示例

{
  "api_key": "PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y",
  "seq_id": "38d42bd9-9f5a-415e-89d9-ea4ff9cffdf2",
  "timestamp": "1572342076",
  "nonce": "157234207",
  "sign": "8A983278E5366EB93FEB0D4143E1C522",
  "user_code": "udxbxd",
  "out_order_id": "193839494",
  "book_time": 1572355050,
  "product_info": [
    {
      "id": "331",
      "name": "轮胎更换",
      "ori_price": 1,
      "pay_price": 1,
      "number": 1,
      "supplier_id": 1,
      "supplier_name": "途虎"
    },
    {
      "id": "332",
      "name": "道路救援",
      "ori_price": 1,
      "pay_price": 1,
      "number": 1,
      "supplier_id": 1,
      "supplier_name": "途虎"
    }
  ],
  "ori_fee": 2,
  "pay_fee": 2,
  "transport_fee": 0,
  "logistics_number": "C1111101",
  "logistics_carrier": "京东物流",
  "ext_info": "{\"models\":\"大众探岳自动挡5座\",\"receive_adress\":\"深圳机场—九州港\",\"delivery_address\":\"腾讯大厦\"}"
}

返回数据示例

{
  "code": 0,
  "message": "successful"
}

# 同步订单状态信息

接口说明： 本接口用于同步订单状态信息，业务侧订单状态变更时同步数据调用。
请求地址： /order/status/rsync
请求方式： POST
请求参数： 通用参数 + 业务参数

参数名称	类型	最大长度	必选	说明
user_code	string	32	是	用户标识(同插件跳转的 openId 参数)
out_order_id	string	32	是	服务商订单标识，服务商系统内唯一服务商系统内部订单号，要求`32`个字符内，只能是数字、大小写字母_-\|*@ ，且在同一个商户号下唯一
status	int	11	是	订单状态，参见如下`订单状态说明`
logistics_status	int	11	否	物流状态 1: 待发货 2: 已发货 3: 已送达
ori_fee	int	11	否	订单原始金额, 单位分
pay_fee	int	11	否	订单支付金额, 单位分
coupon_fee	int	11	否	订单优惠券金额, 单位分
action_time	int	11	是	状态变更时间，单位秒
ext_info	string	256	否	扩展信息分业务，JSON 格式的字符串，参见`扩展信息说明`
app_channel_id	int	11	否	app用户渠道id
buss_status	int	11	否	业务订单状态，由业务侧自己控制
buss_sp_id	int	11	否	业务服务商ID
buss_sp_order_id	int	11	否	业务服务商订单号
payment_flag	int	11	否	支付方式：1H5，2扫码，3支付分，4线下，5小程序，6APP
payment_channel	int	11	否	支付渠道：1微信，2支付宝，3银联，4米大师，5微信H5，6支付中台，7打车支付，8外部渠道
trade_no	int	11	否	交易单号
transaction_id	int	11	否	微信交易单号
pay_score_no	int	11	否	微信支付分单号
license_plate	int	11	否	车牌号
buss_pay_status	int	11	否	业务支付状态，由业务侧自己控制
price_change_flag	int	11	否	改价标识，价格可改为0：1表示有效

返回参数

参数名称	类型	最大长度	必选	说明
code	int	11	是	服务响应状态，参见错误码表
message	string	64	是	服务响应状态说明，参见错误码表
data	object	-	否	-

请求数据示例

{
  "api_key": "PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y",
  "seq_id": "38d42bd9-9f5a-415e-89d9-ea4ff9cffdf2",
  "timestamp": "1572342076",
  "nonce": "157234207",
  "sign": "8A983278E5366EB93FEB0D4143E1C522",
  "user_code": "udxbxd",
  "out_order_id": "193839494",
  "status": 2,
  "logistics_status": 2
}

返回数据示例

{
  "code": 0,
  "message": "successful"
}

# 订单状态说明

参数值	参数描述	备注
1	待支付
2	已取消
3	已支付、可使用
4	已过期
5	已完成、已使用
6	退款中
7	退款失败
8	已退款
9	退款失败，已处理
10	已点评
11	支付中，不可取消
21	派单中	网约车、顺风车
22	服务中、进行中	网约车、顺风车
23	已接单	网约车、顺风车
24	司机已到达	网约车、顺风车
25	行程已结束	网约车、顺风车
26	违约待支付	网约车、顺风车
27	司机接单后，正在赶往出发点	网约车、顺风车
31	待发货
32	申请SP退款中
33	SP处理失败
34	SP已发货
41	取件中	跑腿业务
42	已取件	跑腿业务
43	送件中	跑腿业务
44	送回中	跑腿业务

# 扩展信息说明

保养领域

{
  //保养类型, 1: 到店，2: 上门
  "service_mode": 1,
  //保养项目, 1: 小保养，2: 大保养, 3: 其他保养(一键预约)
  "type": 2,
  //保养公里数
  "mileage": 10,
  //保养门店名称
  "poi_name": "途虎养车工场店"
}

代驾、打车领域

{
  //出发地的 POI 名称
  "departure": "腾讯大厦",
  //目的地的 POI 名称
  "destination": "百度大厦"
}

救援领域

{
  //服务项目 1: 搭电, 2: 换胎, 3: 拖车 4: 紧急脱困, 车牌号必填
  "item": "1",
  //预约时间，单位秒
  "appointment": 1597231261,
  //POI 名称
  "address": "腾讯大厦"
}

代泊车

{
  // 接车时间，单位秒
  "receive_time": 1597231261,
  // 送车时间，单位秒
  "delivery_time": 1597231261,
  // 场站POI名称
  "address": "腾讯大厦"
}

船票

{
  // 船票出发时间,单位秒
  "departure_time": 1597231261,
  // 航线
  "route": "深圳机场—九州港",
  // 舱位名称
  "seat": "三等B"
}

租车

{
  // 车型信息
  "models": "大众探岳自动挡5座",
  // 取车门店
  "receive_adress": "深圳机场—九州港",
  // 还车门店名称
  "delivery_address": "腾讯大厦"
}

年检代办

{
  // 0:六年免检;1:上线验车
  "service_mode": 0,
  // 检查场
  "vehicle_testing_address": "三里河检测场"
}

汽车票

{
  // 出发时间,单位秒
  "departure_time": 1597231261,
  // 出发站
  "departure_address": "南京汽车南站",
  // 到达站
  "arrive_address": "苏州汽车北站",
  // 班次
  "shift": "班次"
}

轮胎

{
  // 商品规格
  "product_specifications": "邓禄普轮胎 LM705 205/55R16 91V",
  //门店名称
  "shop_name": "途虎养车工厂店（上西西路店）"
}

火车票

{
  // 出发到达站
  "departure_arrival_station": "上海-苏州",
  // 车次信息
  "train_number": "K156",
  // 出发时间，秒级时间戳
  "departure_time": 1608607773,
  // 到达时间，秒级时间戳
  "arrival_time": 1608687773,
  // 关联老的订单，改签信息，乘客流水号-->product.id
  "rebook": "订单号_乘客流水号",
  //取票号，E760558269
  "t": "E760558269",
  // 乘客 - 检票口 - 座位号，多个用英文;分割
  "p": ""
}

车险

{
  // 保险周期，YYYY.MM.DD-YYYY.MM.DD
  "insurance_period": "2020.01.02-2021.01.02",
  // 承保公司
  "underwriting": "安盛天平保险股份有限公司"
}

乘车码

{
  //乘车路线，POI(A)-POI(B)
  "route": "购物公园-华侨城",
  //乘车时间，秒级时间戳
  "travel_time": 1597231261,
  //城市
  "city": "西安"
}

航旅保险

{
  //保险类型: 1、航空意外险;2、航班延误险;3、旅行险
  "insurance_type": 1,
  //保障起始时间，秒级时间戳
  "start_time": 1597231261,
  //保障截止时间，秒级时间戳
  "end_time": 1597231261,
  //被保险人
  "assured": ""
}

停车

{
  //停车类型 1、场库;2、路边
  "parking_type": 1,
  //停车时长,单位s
  "parking_time": 3600,
  //停车场
  "parking_lot": "光明地产大厦"
}

充电领域

{
  //订单类型, 1: 充电，2: 充值
  "order_type": 1,
  //充电站名称
  "poi_name": "途虎养车工场店"
}

机票

{
  //航班信息
  "flight_info": "",
  //航班号
  "flight_no": "",
  // 出发时间，秒级时间戳
  "departure_time": 1597231261
}

← 车服门店账单信息 →