腾讯出行服务·开放平台

# 订单中心

# 同步订单信息

  • 接口说明 本接口用于同步订单信息，业务侧生成订单时同步数据调用。

  • 请求地址 /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 - 是 商品信息，list 数组
id string 32 是 ， 商品 id, 业务侧自己定义
name string 64 是 ， 商品名称
ori_price int 11 是 ， 原始价格, 单位分
pay_price int 11 是 ， 支付价格, 单位分
number int 11 是 ， 商品数量
supplier_id string 32 否 ， 供应商 id
supplier_name string 128 否 ， 供应商名称
ori_fee int 11 是 订单原始金额, 单位分
pay_fee int 11 是 订单支付金额, 单位分
coupon_fee int 11 否 优惠券金额, 单位分
transport_fee 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 11 否 业务类型(一个服务商提供多种业务场景)
BC_RESTAURANT=22,//订餐订单 ，
BC_TRAIN_TICKET=23,//火车票订单,
BC_BUS_TICKET=26,//汽车票,
BC_STEAMER_TICKET=27,//船票
BC_INSURANCE=29,//车险
BC_TYRE=30,//轮胎
BC_AIR_TRAVEL_INSURANCE = 37,//航旅保险
BC_TRAVEL_ITINERARY = 38,//行程单邮寄
appChannelId int 11 否 app用户渠道id
订单状态说明:
1: 待支付
2: 已取消
3: 已支付（可使用）
4: 已过期
5: 已完成（已使用）
6: 退款中
7: 退款失败
8: 已退款
9: 退款失败已处理(SP 手动退款成功)
10: 已点评
//  扩展状态
21: 派单中
22: 服务中(进行中)
33: SP 处理失败(救援失败)

扩展信息说明:
// 1、保养领域 JSON: 
{
  "service_mode": 1,           //保养类型, 1: 到店，2: 上门
  "type": 2,                   //保养项目, 1: 小保养，2: 大保养, 3: 其他保养(一键预约)
  "mileage": 10,               //保养公里数
  "poi_name": "途虎养车工场店" //保养门店名称
}
  // 传值如：{\"service_mode\":1, \" type\":2, \"mileage\":10}

// 2、代驾、打车领域 JSON:
{
  "departure": "",  //出发地的 POI 名称 
  "destination": "" //目的地的 POI 名称
}
  // 传值如：{\"departure\":\"腾讯大厦\", \"destination\":\"百度大厦\"}

// 3、救援领域 JSON: 
{
  "item": "",       //服务项目 1: 搭电, 2: 换胎, 3: 拖车 4: 紧急脱困, 车牌号必填
  "appointment": 0, //预约时间，单位秒
  "address": ""     //POI 名称
}
  // 传值如：{\"item\":1, \"appointment\":1597231261, \"departure\":\"腾讯大厦\"}

// 4、代泊车 JSON:
{
  "receive_time":0,  // 接车时间,单位秒
  "delivery_time":0, // 送车时间，单位秒
  "address":""       // 场站POI名称
}
  //传值如：{\"receive_time \":1597231261,\"delivery_time \":1597231261,\"address \":\"腾讯大厦\"}

// 5、船票 JSON:
 {
  "departure_time":0, // 船票出发时间,单位秒
  "route":"",         // 航线
  "seat":""           // 舱位名称
 }
  // 传值如：{\"departure_time \":1597231261,\"route\":\"深圳机场—九州港\",\"seat\":\"三等B\"}

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

// 7、年检代办 JSON:
{
  "service_mode":0,            // 0:六年免检;1:上线验车
  "vehicle_testing_address":"" // 检查场
}
  // 传值如：{\"service_mode\":0,\"vehicle_testing\":\"三里河检测场\"}

// 8、汽车票 JSON:
{
  "departure_time":0,     // 出发时间,单位秒
  "departure_address":"", // 出发站
  "arrive_address":"",    // 到达站
  "shift":""              // 班次
}
// 传值如：{\"departure_time\":1597231261,,\"departure_address\":\"南京汽车南站\",\"arrive_address\":\"苏州汽车北站\",\"shift \":\"班次\"}

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

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

// 11、车险JSON:
{
  "insurance_period":"2020.01.02-2021.01.02", // 保险周期，YYYY.MM.DD-YYYY.MM.DD
  "underwriting":"安盛天平保险股份有限公司"   // 承保公司 
}
  // 传值如：{\"insurance_period\":\"2020.01.02-2021.01.02\",\"underwriting\":\"安盛天平保险股份有限公司\"}

// 12、乘车码JSON:
{
  "route":"购物公园-华侨城",//乘车路线，POI(A)-POI(B)
  "travel_time":1983332 ,//乘车时间,单位s
  "city":"西安" //城市
}
  // 传值如：{\"route\":\"购物公园-华侨城\",\"travel_time\":1983332}

// 13、航旅保险JSON:
{
  "insurance_type":1,//保险类型: 1、航空意外险;2、航班延误险;3、旅行险
  "start_time":1983332, //保障起始时间,单位s
  "end_time":1983332, //保障截止时间,单位s
  "assured":"" //被保险人
}
  // 传值如：{\"assured\":\"张三\",\"start_time\":1983332,\"end_time\":1983332,\"insurance_type\":1}

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

// 15、充电领域: 
{
  "order_type": 1,           //订单类型, 1: 充电，2: 充值
  "poi_name": "途虎养车工场店" //充电站名称
}
  // 传值如：{\"order_type\":1,   \"poi_name\":\"途虎养车工场店\"}
  
// 16、机票:
{
  "flight_info":"",//航班信息
  "flight_no":"", //航班号
  "departure_time":11011 // 出发时间，秒级时间戳
}
  // 传值如：{\"flight_info\":\"张三\",\"flight_no\":\"张三\",\"departure_time\":1983332}
  • 返回数据
参数名称 类型 最大长度 必选 说明
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 是 订单状态 1: 待支付 2: 已取消 3: 已支付（可使用） 4: 已过期 5: 已完成（已使用） 6: 退款中 7: 退款失败 8: 已退款 9: 退款失败已处理(SP 手动退款成功) 10: 已点评
扩展状态 21: 派单中 22: 服务中(进行中) 33: SP 处理失败(救援失败)
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 格式的字符串，参见扩展信息说明
appChannelId int 11 否 app用户渠道id
  • 返回数据
参数名称 类型 最大长度 必选 说明
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"
}

← 账单信息 →