百度智能小程序 導(dǎo)入售后訂單信息

2020-09-05 14:54 更新

導(dǎo)入售后訂單信息

接口調(diào)用說明

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

1)Data.Ext.SubsOrder.Item 參數(shù)可填寫多個,實現(xiàn)批量導(dǎo)入。

2)必須先導(dǎo)入 POST 中 ResourceID 參數(shù)對應(yīng)的訂單信息,否則無法導(dǎo)入售后訂單信息。

參數(shù)說明

參數(shù)名類型是否必須描述
access_tokenString小程序的接口調(diào)用憑據(jù),參考開發(fā)者服務(wù)權(quán)限說明
open_idString用戶 openId
scene_idString百度收銀臺分配的平臺訂單 ID ,通知支付狀態(tài)接口返回的 orderId 。
scene_typeInt支付場景類型,開發(fā)者請默認傳 2 。

請求示例

請求 body 參數(shù)

  • JSON

{
	"Data":[{
		"CateID": 2, // 2:訂單種類-虛擬物品
		"BizAPPID": "a392qXwK8L5GDUWhFoC01cKwoy7tmehg", // 小程序的appKey
		"ResourceID": "2221554346520", // 開發(fā)者接入的唯一訂單ID
		"EXT": { // 拓展字段 根據(jù)資產(chǎn)的不同其結(jié)構(gòu)也不固定 此處以訂單為例
			"SubsOrder": { // 售后訂單信息,
				"Items": [{
					"SubOrderID": "onlyOne", // 售后訂單ID
					"SubStatus": "", // 自訂單狀態(tài),枚舉參照 【退換貨枚舉值】
					"CTime": 1571026201, // 售后訂單創(chuàng)建時間,時間戳,單位秒
					"MTime": 1571026201, // 售后訂單修改時間,時間戳,單位秒
					"OrderDetail": { // 退款退貨訂單詳情跳轉(zhuǎn)
						"Status": 2,
						"Name": "",
						"SwanSchema": "baiduboxapp://swan/B3GF3AWvCSr59myIs61uqaoYz7pPCSY1/wjz/bdxd/order-detail/order-detail?orderId=159259079195"
					},
					"Refund": { //商品 退款/退貨 信息
						"Amount": 10, //退款總金額
						"Product": [ //退款/退貨商品
							{
								"ID": "1014093064", //商品ID
								"Quantity": 1, //商品退款/商品退貨 數(shù)量
								"Amount": 0 //應(yīng)退金額,單位分
							}
						]
					},
					"OrderType": 1 // 退款訂單類型
				}]
			}
		}
	}]
}

POST請求字段說明

Data.Ext.SubsOrder

多為退換貨產(chǎn)生的售后訂單

字段名稱字段類型必填備注
StatusInt所有售后訂單的狀態(tài)匯總最終狀態(tài),參考 Data.Ext.SubsOrder.Status 退換貨枚舉值。
Items[]Data.Ext.SubsOrder.Item售后訂單列表

Data.Ext.SubsOrder.Status

退換貨枚舉值

Status 值含義
400申請中,買家發(fā)起申請,等待賣家同意申請。
401處理中,賣家同意售后申請,售后處理中狀態(tài)。
402退款成功,已完成售后。針對需退款的訂單已退款成功。
403退款成功,已完成售后。對換貨訂單,買家已收到貨物。
404已關(guān)閉,買家主動關(guān)閉售后,或者系統(tǒng)關(guān)閉售后。
407賣家已拒絕,賣家主動拒絕售后申請。

Data.Ext.SubsOrder.Item

字段名稱字段類型必填備注
SubOrderIDString售后訂單 ID
SubStatusInt售后訂單狀態(tài),同 Data.Ext.SubsOrder.Status 退換貨枚舉值一致。
CTimeInt創(chuàng)建時間,單位秒。
MTimeInt修改時間,單位秒。
OrderTypeInt退款類型,1(僅退款),2(換貨),3(退款+退貨)。
OrderDetailData.Ext.SubsOrder.Item.OrderDetail跳轉(zhuǎn)到這個訂單的詳情結(jié)構(gòu)
RefundData.Ext.SubsOrder.Item.Refund售后訂單商品信息

Data.Ext.SubsOrder.Item.OrderDetail

該結(jié)構(gòu)定義了如何執(zhí)行跳轉(zhuǎn)的數(shù)據(jù)結(jié)構(gòu)協(xié)議。 Scheme 即客戶端統(tǒng)一調(diào)起協(xié)議,協(xié)議的使用需要確保參數(shù)傳遞的正確。

字段名稱字段類型必填備注
StatusInt默認傳 2
SwanSchemaString售后訂單跳轉(zhuǎn)地址,用以小程序跳轉(zhuǎn) Scheme ,小程序跳轉(zhuǎn) Scheme 協(xié)議規(guī)則。

Data.Ext.SubsOrder.Item.Payment

參照 Data.Ext.MainOrder.Payment 結(jié)構(gòu)

Data.Ext.SubsOrder.Item.Refund

字段名稱字段類型必填備注
AmountInt退款總金額,單位分,即1001元。
Product[]Data.Ext.SubsOrder.Item.Refund.Product售后商品列表

Data.Ext.SubsOrder.Item.Refund.Product

字段名稱字段類型必填備注
IDString商品 ID
QuantityInt售后商品數(shù)量
AmountInt退款金額,單位分,即1001元

Data.Ext.SubsOrder.Item.Aftermarket

字段名稱字段類型必填備注
Product[]Data.Ext.SubsOrder.Item.Aftermarket.Product退貨商品列表

Data.Ext.SubsOrder.Item.Aftermarket.Product

參照 Data.Ext.SubsOrder.Item.Refund.Product 結(jié)構(gòu)


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號