百度智能小程序导入售后订单信息

2020-09-05 14:54 更新

导入售后订单信息

接口调用说明

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 结构

以上内容是否对您有帮助：

百度智能小程序 导入售后订单信息