导入售后订单信息

接口调用说明

  1. POST https://openapi.baidu.com/rest/2.0/smartapp/ordercenter/app/append/sub/info?access_token=ACCESS_TOKEN

1)Data.Ext.SubsOrder.Item 参数可填写多个，实现批量导入。

2)必须先导入 POST 中 ResourceID 参数对应的订单信息,否则无法导入售后订单信息。

参数说明

参数名类型是否必须描述
access_tokenString是小程序的接口调用凭据，参考开发者服务权限说明。
open_idString是用户 openId
scene_idString是百度收银台分配的平台订单 ID ，通知支付状态接口返回的 orderId 。
scene_typeInt是支付场景类型，开发者请默认传 2 。
pm_app_keyString是调起百度收银台的支付服务 appKey 。

请求示例

请求 body 参数

  • JSON
  2. {
  3.     "Data":[{
  4.         // 2:订单种类-虚拟物品
  5.         "CateID": 2, 
  6.         // 小程序的appKey
  7.         "BizAPPID": "a392qXwK8L5GDUWhFoC01cKwoy7tmehg", 
  8.         // 开发者接入的唯一订单ID
  9.         "ResourceID": "2221554346520", 
  10.         // 拓展字段 根据资产的不同其结构也不固定 此处以订单为例
  11.         "EXT": { 
  12.             // 售后订单信息
  13.             "SubsOrder": { 
  14.                 "Items": [{
  15.                     // 售后订单ID
  16.                     "SubOrderID": "onlyOne", 
  17.                     // 自订单状态,枚举参照 【退换货枚举值】
  18.                     "SubStatus": "", 
  19.                     // 售后订单创建时间,时间戳,单位秒
  20.                     "CTime": 1571026201, 
  21.                     // 售后订单修改时间,时间戳,单位秒
  22.                     "MTime": 1571026201, 
  23.                     // 退款退货订单详情跳转
  24.                     "OrderDetail": { 
  25.                         "Status": 2,
  26.                         "Name": "",
  27.                         "SwanSchema": "baiduboxapp://swan/B3GF3AWvCSr59myIs61uqaoYz7pPCSY1/wjz/bdxd/order-detail/order-detail?orderId=159259079195"
  28.                     },
  29.                     // 商品 退款／退货 信息
  30.                     "Refund": { 
  31.                         // 退款总金额
  32.                         "Amount": 10,
  33.                         // 退款/退货商品 
  34.                         "Product": [ 
  35.                             {
  36.                                 // 商品ID
  37.                                 "ID": "1014093064", 
  38.                                 // 商品退款/商品退货 数量
  39.                                 "Quantity": 1, 
  40.                                 // 应退金额,单位分
  41.                                 "Amount": 0 
  42.                             }
  43.                         ]
  44.                     },
  45.                     // 退款订单类型
  46.                     "OrderType": 1 
  47.                 }]
  48.             }
  49.         }
  50.     }]
  51. }

POST 请求字段说明

Data.Ext.SubsOrder

多为退换货产生的售后订单

字段名称字段类型必填备注
StatusInt否所有售后订单的状态汇总最终状态，参考 Data.Ext.SubsOrder.Status 退换货枚举值。
Items[]Data.Ext.SubsOrder.Item是售后订单列表

Data.Ext.SubsOrder.Status

退换货枚举值

Status 值含义
400申请中，买家发起申请，等待卖家同意申请。
401处理中，卖家同意售后申请，售后处理中状态。
402退款成功，已完成售后。针对需退款的订单已退款成功。
403退款成功，已完成售后。对换货订单，买家已收到货物。
404已关闭，买家主动关闭售后，或者系统关闭售后。
407卖家已拒绝，卖家主动拒绝售后申请。

Data.Ext.SubsOrder.Item

字段名称字段类型必填备注
SubOrderIDString是售后订单 ID
SubStatusInt是售后订单状态，同 Data.Ext.SubsOrder.Status 退换货枚举值一致。
CTimeInt是创建时间（单位：秒）。
MTimeInt是修改时间（单位：秒）。
OrderTypeInt是退款类型，1(仅退款)，2(换货)，3(退款+退货)。
OrderDetailData.Ext.SubsOrder.Item.OrderDetail否跳转到这个订单的详情结构
RefundData.Ext.SubsOrder.Item.Refund否售后订单商品信息

Data.Ext.SubsOrder.Item.OrderDetail

该结构定义了如何执行跳转的数据结构协议。 Scheme 即客户端统一调起协议，协议的使用需要确保参数传递的正确。

字段名称字段类型必填备注
StatusInt否默认传 2
SwanSchemaString否售后订单跳转地址，用以小程序跳转 Scheme ，小程序跳转 Scheme 协议规则。

Data.Ext.SubsOrder.Item.Payment

参照 Data.Ext.MainOrder.Payment 结构

Data.Ext.SubsOrder.Item.Refund

字段名称字段类型必填备注
AmountInt是退款总金额（单位：分），即100为1元。
Product[]Data.Ext.SubsOrder.Item.Refund.Product是售后商品列表

Data.Ext.SubsOrder.Item.Refund.Product

字段名称字段类型必填备注
IDString是商品 ID
QuantityInt是售后商品数量
AmountInt是退款金额（单位：分），即100为1元。

Data.Ext.SubsOrder.Item.Aftermarket

字段名称字段类型必填备注
Product[]Data.Ext.SubsOrder.Item.Aftermarket.Product是退货商品列表

Data.Ext.SubsOrder.Item.Aftermarket.Product

参照 Data.Ext.SubsOrder.Item.Refund.Product 结构