阅读(2257)
赞(7)
百度智能小程序 导入售后订单信息
2020-08-13 16:42:52 更新
导入售后订单信息
接口调用说明
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_token | String | 是 | 小程序的接口调用凭据，参考开发者服务权限说明。 |
| open_id | String | 是 | 用户 openId |
| scene_id | String | 否 | 百度收银台分配的平台订单 ID ，通知支付状态接口返回的 orderId 。 |
| scene_type | Int | 否 | 支付场景类型，开发者请默认传 2 。 |
请求示例
请求 body 参数
- JSON
{
"Data":[{
"CateID": 2, // 2:订单种类-虚拟物品
"BizAPPID": "a392qXwK8L5GDUWhFoC01cKwoy7tmehg", // 小程序的appKey
"ResourceID": "2221554346520", // 开发者接入的唯一订单ID
"EXT": { // 拓展字段 根据资产的不同其结构也不固定 此处以订单为例
"SubsOrder": { // 售后订单信息，
"Items": [{
"SubOrderID": "onlyOne", // 售后订单ID
"SubStatus": "", // 自订单状态,枚举参照 【退换货枚举值】
"CTime": 1571026201, // 售后订单创建时间,时间戳,单位秒
"MTime": 1571026201, // 售后订单修改时间,时间戳,单位秒
"OrderDetail": { // 退款退货订单详情跳转
"Status": 2,
"Name": "",
"SwanSchema": "baiduboxapp://swan/B3GF3AWvCSr59myIs61uqaoYz7pPCSY1/wjz/bdxd/order-detail/order-detail?orderId=159259079195"
},
"Refund": { //商品 退款／退货 信息
"Amount": 10, //退款总金额
"Product": [ //退款/退货商品
{
"ID": "1014093064", //商品ID
"Quantity": 1, //商品退款/商品退货 数量
"Amount": 0 //应退金额,单位分
}
]
},
"OrderType": 1 // 退款订单类型
}]
}
}
}]
}
POST请求字段说明
Data.Ext.SubsOrder
多为退换货产生的售后订单
| 字段名称 | 字段类型 | 必填 | 备注 |
|---|---|---|---|
| Status | Int | 是 | 所有售后订单的状态汇总最终状态，参考 Data.Ext.SubsOrder.Status 退换货枚举值。 |
| Items | []Data.Ext.SubsOrder.Item | 是 | 售后订单列表 |
Data.Ext.SubsOrder.Status
退换货枚举值
| Status 值 | 含义 |
|---|---|
| 400 | 申请中，买家发起申请，等待卖家同意申请。 |
| 401 | 处理中，卖家同意售后申请，售后处理中状态。 |
| 402 | 退款成功，已完成售后。针对需退款的订单已退款成功。 |
| 403 | 退款成功，已完成售后。对换货订单，买家已收到货物。 |
| 404 | 已关闭，买家主动关闭售后，或者系统关闭售后。 |
| 407 | 卖家已拒绝，卖家主动拒绝售后申请。 |
Data.Ext.SubsOrder.Item
| 字段名称 | 字段类型 | 必填 | 备注 |
|---|---|---|---|
| SubOrderID | String | 是 | 售后订单 ID |
| SubStatus | Int | 是 | 售后订单状态，同 Data.Ext.SubsOrder.Status 退换货枚举值一致。 |
| CTime | Int | 是 | 创建时间，单位秒。 |
| MTime | Int | 是 | 修改时间，单位秒。 |
| OrderType | Int | 是 | 退款类型，1(仅退款)，2(换货)，3(退款+退货)。 |
| OrderDetail | Data.Ext.SubsOrder.Item.OrderDetail | 否 | 跳转到这个订单的详情结构 |
| Refund | Data.Ext.SubsOrder.Item.Refund | 否 | 售后订单商品信息 |
Data.Ext.SubsOrder.Item.OrderDetail
该结构定义了如何执行跳转的数据结构协议。 Scheme 即客户端统一调起协议，协议的使用需要确保参数传递的正确。
| 字段名称 | 字段类型 | 必填 | 备注 |
|---|---|---|---|
| Status | Int | 否 | 默认传 2 |
| SwanSchema | String | 否 | 售后订单跳转地址，用以小程序跳转 Scheme ，小程序跳转 Scheme 协议规则。 |
Data.Ext.SubsOrder.Item.Payment
参照 Data.Ext.MainOrder.Payment 结构
Data.Ext.SubsOrder.Item.Refund
| 字段名称 | 字段类型 | 必填 | 备注 |
|---|---|---|---|
| Amount | Int | 是 | 退款总金额，单位分，即100为1元。 |
| Product | []Data.Ext.SubsOrder.Item.Refund.Product | 是 | 售后商品列表 |
Data.Ext.SubsOrder.Item.Refund.Product
| 字段名称 | 字段类型 | 必填 | 备注 |
|---|---|---|---|
| ID | String | 是 | 商品 ID |
| Quantity | Int | 是 | 售后商品数量 |
| Amount | Int | 是 | 退款金额，单位分，即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 结构