新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案

創(chuàng)新互聯(lián)百度小程序教程：導(dǎo)入訂單信息

導(dǎo)入訂單信息
- 接口簡介
- 接口調(diào)用請求說明
- 參數(shù)說明
- 請求示例
- 訂單類型
- POST 請求字段說明
  - Data
  - Data.Ext
  - Data.Ext.MainOrder
  - Data.Ext.MainOrder.Product
  - Data.Ext.MainOrder.Express
  - Data.Ext.MainOrder.Product.DetailPage
  - Data.Ext.MainOrder.Product.SkuAttr
  - Data.Ext.MainOrder.Payment
  - Data.Ext.MainOrder.Payment.PaymentSpecInfo
  - Data.Ext.MainOrder.Appraise
  - Data.Ext.MainOrder.OrderDetail
  - Data.Ext.MainOrder.Express
- 返回值參數(shù)說明

導(dǎo)入訂單信息

接口簡介

1）該接口用于添加訂單，即當 POST 請求中 ResourceID 參數(shù)不存在時，導(dǎo)入新的訂單數(shù)據(jù)。

成都創(chuàng)新互聯(lián)公司2013年成立，先為佳木斯等服務(wù)建站，佳木斯等地企業(yè)，進行企業(yè)商務(wù)咨詢服務(wù)。為佳木斯企業(yè)網(wǎng)站制作PC+手機+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問題。

2）POST 請求中 Data 參數(shù)不可填寫多個，暫不支持批量導(dǎo)入。

3）注意：若 ResourceID 已存在，則會用當前 POST 請求中信息全量覆蓋該條記錄中訂單和售后訂單信息,故更新訂單場景請使用更新專用接口。

接口調(diào)用請求說明

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

參數(shù)說明

參數(shù)名	類型	是否必填	描述
access_token	String	是	小程序的接口調(diào)用憑據(jù)，參考開發(fā)者服務(wù)權(quán)限說明
open_id	String	二選一	（1）百度 App 已登錄用戶使用 openId 作為用戶標識（2）百度 App 未登錄用戶（無 openId 時）使用 swanId 作為用戶標識
swan_id	String	二選一
scene_id	String	是	百度收銀臺分配的平臺訂單 ID，通知支付狀態(tài)接口返回的 orderId
scene_type	Int	是	支付場景類型，開發(fā)者請默認傳 2
pm_app_key	String	是	調(diào)起百度收銀臺的支付服務(wù) appKey

請求示例

請求 body 參數(shù)

JSON

 
 
 
  
  
    
  
  {  
  
   "Data": [  
  
   {  
  
   // 1:訂單種類-實物商品  
  
   "CateID": 1,   
  
   // 小程序AppKey  
  
   "BizAPPID": "a392qXwK8L5GDUWhFoC01cKwoy7tmehg",  
  
   // 訂單名稱   
  
   "Title": "test",   
  
   // 開發(fā)者接入的唯一訂單ID   
  
   "ResourceID": "2221554346520",   
  
   // 訂單創(chuàng)建時間，單位秒   
  
   "Ctime": 1233212343,   
  
   // 訂單最后修改時間，單位秒   
  
   "Mtime": 1233212343,   
  
   // 200:訂單狀態(tài)-已完成交易   
  
   "Status": 200,   
  
   // 拓展字段   
  
   "EXT": {   
  
   // 訂單信息   
  
   "MainOrder": {   
  
   // 商品信息   
  
   "Products": [   
  
   {  
  
   //商品ID  
  
   "ID": "1014093064",   
  
   //商品名稱   
  
   "Name": "四川大涼山丑蘋果脆甜紅將軍鹽源丑蘋果",  
  
   //商品詳情   
  
   "Desc": "四川大涼山丑蘋果脆甜:5斤小果25個左右偏小;",   
  
   //商品數(shù)量   
  
   "Quantity": 1,   
  
   //商品原價,單位分。   
  
   "Price": 2390,   
  
   //實付價格,單位分。   
  
   "PayPrice": 2390,   
  
   //商品圖片地址   
  
   "ImgList": [   
  
   "https://imagelib.cdn.bcebos.com/cip_ml_picbc34db9a-7e10-4a96-bf8e-1c690640c6a4.jpeg"  
  
   ],  
  
   //商品SKU屬性  
  
   "SkuAttr": [   
  
   {  
  
   "Name": "四川大涼山丑蘋果脆甜",  
  
   "Value": "5斤小果25個左右偏小"  
  
   }  
  
   ]  
  
   }  
  
   ],  
  
   "Payment": {  
  
   //支付信息   
  
   "Time": 0,   
  
   //付款時間，時間戳，單位秒   
  
   "Method": 1,   
  
   //支付方式   
  
   "Amount": 2390,   
  
   //合計金額，單位分   
  
   "IsPayment": false,   
  
   //是否支付   
  
   "PreferentialInfo": [   
  
   //優(yōu)惠信息   
  
   {  
  
   //名稱  
  
   "Name":"優(yōu)惠券使用",   
  
   //優(yōu)惠金額，單位分   
  
   "Value":100,   
  
   //數(shù)量   
  
   "Quantity":1   
  
   }  
  
   ],   
  
   //付款信息   
  
   "PaymentInfo": [   
  
   {  
  
   //展示名稱  
  
   "Name":"運費",   
  
   //付款金額，單位分   
  
   "Value":100,   
  
   //數(shù)量   
  
   "Quantity":1   
  
   }  
  
   ]   
  
   },  
  
   // 訂單評價跳轉(zhuǎn)  
  
   "Appraise": {   
  
   "Status": 0,  
  
   "Name": "",  
  
   "SwanSchema": "baiduboxapp://swan/B3GF3AWvCSr59myIs61uqaoYz7pPCSY1/wjz/bdxd/order-detail/order-detail?orderId=159259079195"  
  
   },  
  
   // 訂單詳情跳轉(zhuǎn)  
  
   "OrderDetail": {   
  
   "Status": 2,  
  
   "Name": "",  
  
   "SwanSchema": "baiduboxapp://swan/B3GF3AWvCSr59myIs61uqaoYz7pPCSY1/wjz/bdxd/order-detail/order-detail?orderId=159259079195"  
  
   }  
  
   },  
  
   // 售后訂單信息，若該訂單發(fā)生退款/售后，需新增同步其售后訂單的售后信息狀態(tài)  
  
   "SubsOrder": {   
  
   "Status": 0,  
  
   "Items": [  
  
   {  
  
   // 售后訂單ID  
  
   "SubOrderID":"onlyOne",   
  
   // 自訂單狀態(tài),枚舉參照 【退換貨枚舉值】   
  
   "SubStatus":"",   
  
   // 售后訂單創(chuàng)建時間,時間戳,單位秒   
  
   "CTime":1571026201,   
  
   // 售后訂單修改時間,時間戳,單位秒   
  
   "MTime":1571026201,   
  
   // 退款退貨訂單詳情跳轉(zhuǎn)   
  
   "OrderDetail":{   
  
   "Status": 2,  
  
   "Name": "",  
  
   "SwanSchema": "baiduboxapp://swan/B3GF3AWvCSr59myIs61uqaoYz7pPCSY1/wjz/bdxd/order-detail/order-detail?orderId=159259079195"  
  
   },  
  
   // 商品 退款／退貨 信息  
  
   "Refund":{   
  
   // 退款總金額   
  
   "Amount":10,   
  
   // 退款/退貨商品   
  
   "Product":[   
  
   {  
  
   // 商品ID  
  
   "ID":"1014093064",   
  
   // 商品退款/商品退貨 數(shù)量   
  
   "Quantity":1,  
  
   // 應(yīng)退金額,單位分   
  
   "Amount":0   
  
   }  
  
   ]  
  
   },  
  
   // 退款訂單類型  
  
   "OrderType":1   
  
   }  
  
   ]  
  
   }  
  
   }  
  
   }  
  
   ]  
  
  }

訂單類型

1）從交易的正逆 2 個場景，訂單中心整體分為 MainOrder 主訂單和 SubsOrder 售后訂單 2 種類型。
MainOrder：主訂單，即購買商品、服務(wù)的訂單。
SubsOrder：售后訂單，當訂單發(fā)生退換貨等售后時，需導(dǎo)入售后相關(guān)的信息，作為售后訂單。

2）主訂單又細分為實物訂單、快遞服務(wù)訂單、虛擬訂單、上門服務(wù)訂單、酒店訂單、出行票務(wù)訂單、打車訂單 7 種，每種訂單狀態(tài)定義不同，前端對用戶的展示也不同。
· 實物訂單：進行實物交易，需要發(fā)貨等物流的交易訂單。
· 快遞服務(wù)訂單：快遞類的服務(wù)訂單。
· 虛擬訂單：不需要貨源、不涉及物流的交易訂單。
· 上門服務(wù)訂單：服務(wù)類訂單，含搬家拉貨、保潔、衣物洗護、上門維修，不含快遞、外賣。
· 酒店訂單：酒店類的訂單。
· 出行票務(wù)訂單：出行票務(wù)類訂單，含汽車票、火車票、機票等。
· 打車訂單：打車類的訂單。

POST 請求字段說明

Data

字段名稱	字段類型	必填	備注
ResourceID	String	是	開發(fā)者接入的唯一訂單 ID
BizAPPID	String	是	小程序 AppKey
Ctime	Int	是	訂單創(chuàng)建時間（單位：秒）
Mtime	Int	是	訂單最后被修改時間（單位：秒）
CateID	Int	是	訂單種類：1（實物）、2（虛擬物品）、5（快遞服務(wù)類）、6（快遞服務(wù)類無金額訂單）、10（上門服務(wù)類）、11（上門服務(wù)類無金額訂單）、15（酒店類）、20（票務(wù)類）、25（打車類）、26（打車類無金額訂單）
Title	String	是	訂單標題，建議使用訂單商品名稱
Status	Int	是	訂單狀態(tài)，其值根據(jù)`TypeID`不同有不同的定義，詳細見下
Ext	Data.Ext	是	擴展信息，詳細結(jié)構(gòu)見下

CateID==1 ，即實物訂單時

Data.Status	含義	訂單中心狀態(tài) Tab
1	待付款	“全部”、“待付款” Tab
5	待發(fā)貨	“全部”、“待收貨” Tab
6	待收貨	“全部”、“待付款” Tab
100	交易關(guān)閉	“全部” Tab
200	交易成功	“全部” Tab

CateID==2 ，即虛擬物訂單時

Data.Status	含義	訂單中心狀態(tài) Tab
1	待付款	“全部”、“待付款” Tab
2	等待賣家確認	“全部”、“待付款” Tab
3	賣家處理中	“全部”、“待付款” Tab
4	賣家已確認	“全部”、“待付款” Tab
100	交易關(guān)閉	“全部” Tab
200	交易完成	“全部” Tab

CateID==5 ，即快遞服務(wù)類訂單時

Data.Status	含義	訂單中心狀態(tài) Tab
1	待付款	“全部”、“待付款” Tab
3	待攬件	“全部”、“待收貨” Tab
4	已攬件	“全部”、“待收貨” Tab
6	派送中	“全部”、“待收貨” Tab
7	運輸中	“全部”、“待收貨” Tab
100	已取消	“全部” Tab
101	退回運輸中	“全部” Tab
102	退回并簽收	“全部” Tab
103	疑難件	“全部” Tab
200	已簽收	“全部” Tab

CateID==6，即快遞服務(wù)類無金額訂單時
含義和訂單中心狀態(tài) TAB 同 CateID==5 快遞服務(wù)類訂單。

CateID==10 ，即上門服務(wù)類訂單時

上門服務(wù)類，含搬家拉貨、保潔、衣物洗護、上門維修等，不含快遞、外賣。

Data.Status	含義	訂單中心狀態(tài) Tab
1	待付款	“全部”、“待付款” Tab
2	等待商家確認	“全部”、“待收貨” Tab
4	商家已確認	“全部”、“待收貨” Tab
100	交易關(guān)閉	“全部” Tab
200	交易完成	“全部” Tab

CateID==11，即上門服務(wù)類無金額訂單時
含義和訂單中心狀態(tài) TAB 同 CateID==10 上門服務(wù)類訂單。

CateID==15 ，即酒店類訂單時

Data.Status	含義	訂單中心狀態(tài) Tab
1	待付款	“全部”、“待付款” Tab
2	等待商家確認	“全部”、“待收貨” Tab
6	待入住	“全部”、“待收貨” Tab
9	已入駐	“全部” Tab
100	交易關(guān)閉	“全部” Tab
200	交易完成	“全部” Tab

CateID==20 ，即出行票務(wù)類訂單時

出行票務(wù)類訂單，汽車票、火車票、機票等票務(wù)類訂單。

Data.Status	含義	訂單中心狀態(tài) Tab
1	待付款	“全部”、“待付款” Tab
3	出票中	“全部”、“待收貨” Tab
8	出票成功	“全部” Tab
100	交易關(guān)閉	“全部” Tab
200	交易完成	“全部” Tab

CateID==25 ，即打車類訂單時

Data.Status	含義	訂單中心狀態(tài) Tab
1	待付款	“全部”、“待付款” Tab
2	等待接單	“全部”、“待收貨” Tab
4	司機已接單	“全部”、“待收貨” Tab
8	司機已到達	“全部” Tab
9	行程開始	“全部” Tab
100	已取消	“全部” Tab
200	已完成	“全部” Tab

CateID==26，即打車類無金額訂單時
含義和訂單中心狀態(tài) TAB 同 CateID==25 打車類訂單。

開發(fā)者注意：若訂單發(fā)生退換貨，需要導(dǎo)入售后訂單，主訂單狀態(tài)設(shè)置為200 交易完成。

Data.Ext

字段名稱	字段類型	必填	備注
MainOrder	Data.Ext.MainOrder	是	主訂單信息（購買商品訂單）
SubsOrder	Data.Ext.SubsOrder	否	售后訂單信息（退換貨／售后訂單）

Data.Ext.MainOrder

字段名稱	字段類型	必填	備注
Products	Data.Ext.MainOrder.Product	是	數(shù)組，商品信息列表，若商品只有 1 個則數(shù)組長度為 1
Payment	Data.Ext.MainOrder.Payment	是	支付信息
Appraise	Data.Ext.MainOrder.Appraise	否	待評價狀態(tài)訂單的評價頁結(jié)構(gòu)，僅訂單為可評價狀態(tài)，且還未進行評價時提供該信息
OrderDetail	Data.Ext.MainOrder.OrderDetail	否	訂單詳情頁的信息

Data.Ext.MainOrder.Product

字段名稱	字段類型	必填	備注
ID	String	是	商品 ID ，開發(fā)者的唯一商品 ID
Name	String	是	商品名字
Desc	String	否	商品簡述
Quantity	Int	是	本商品的交易數(shù)量
Price	Int	是	本商品原價（單位：分），即`100`代表`1元`
PayPrice	Int	是	實付價（單位：分），即`100`代表`1元`
ImgList	String	否	商品預(yù)覽，值為預(yù)覽圖 URL 地址，最多 5 張
DetailPage	Data.Ext.MainOrder.Product.DetailPage	否	商品詳情的跳轉(zhuǎn)的跳轉(zhuǎn)結(jié)構(gòu)
SkuAttr	Data.Ext.MainOrder.Product.SkuAttr	否	商品規(guī)格，最多 400 個

Data.Ext.MainOrder.Express

字段名稱	字段類型	必填	備注
ID	String	是	快遞單號
Name	String	否	快遞公司名稱
Code	String	是	快遞公司對應(yīng)的編號，具體 Code 列表見下方快遞公司信息碼表
Type	Int	是	快遞類型，1：商家給用戶發(fā)貨，2：用戶給商家退貨；開發(fā)者根據(jù)快遞類型傳 1 或 2

Data.Ext.MainOrder.Product.DetailPage

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

字段名稱	字段類型	必填	備注
Status	Int	否	默認傳 2
SwanSchema	String	否	商品詳情頁的跳轉(zhuǎn)地址，用以小程序跳轉(zhuǎn) Scheme ，小程序跳轉(zhuǎn) Scheme 協(xié)議規(guī)則

Data.Ext.MainOrder.Product.SkuAttr

商品規(guī)格

字段名稱	字段類型	必填	備注
Name	String	是	規(guī)格名稱，例如“顏色”或“尺寸”
Value	String	是	規(guī)格值

 
 
 
  
  
  // Data.Ext.MainOrder.Product.SkuAttr 示例  
  
  [  
  
   {  
  
   "Name": "顏色",  
  
   "Value": "Red"  
  
   },  
  
   {  
  
   "Name": "顏色",  
  
   "Value": "Black"  
  
   }  
  
  ]

Data.Ext.MainOrder.Payment

開發(fā)者須知：為確保給用戶展示正確、有效的訂單價格，訂單相關(guān)的金額會嚴格根據(jù)下方公式進行校驗，即實付金額 = 商品總金額 + 其他付款金額 - 優(yōu)惠金額。
Payment.Amount = (Products.PayPrice * Products.Quantity) + (PaymentInfo.Value * PaymentInfo.Quantity) - (PreferentialInfo.Value * PreferentialInfo.Quantity)

字段名稱	字段類型	必填	備注
Method	Int	是	付款方式，1（在線付），2（貨到付款）
Amount	Int	是	實付金額（單位：分），即`100`為`1元`
IsPayment	Boolean	是	是否已付款
Time	Int	否	付款時間（單位：秒）
PreferentialInfo	Data.Ext.MainOrder.Payment.PaymentSpecInfo	否	優(yōu)惠券信息
PaymentInfo	Data.Ext.MainOrder.Payment.PaymentSpecInfo	否	其他付款信息，如運費、保險等

Data.Ext.MainOrder.Payment.PaymentSpecInfo

字段名稱	字段類型	必填	備注
Name	String	是	展示名稱
Value	Int	是	合計金額（單位：分），即`100`為`1元`
Quantity	Int	是	數(shù)量

Data.Ext.MainOrder.Appraise

當主訂單狀態(tài)為200 交易完成，訂單為可評價狀態(tài)Status為2，并提供訂單評價頁的跳轉(zhuǎn)地址SwanSchema ，訂單會出現(xiàn)在【待評價】tab，并顯示【評價】入口，引導(dǎo)用戶打開小程序進行評價。

字段名稱	字段類型	必填	備注
Status	Int	否	0（不可評價狀態(tài)或已評價狀態(tài)）、2（待評價狀態(tài)，允許跳轉(zhuǎn))
SwanSchema	String	否	評價頁的跳轉(zhuǎn)地址，用以小程序跳轉(zhuǎn) Scheme ，小程序跳轉(zhuǎn) Scheme 協(xié)議規(guī)則

Data.Ext.MainOrder.OrderDetail

字段名稱	字段類型	必填	備注
Status	Int	否	默認傳 2
SwanSchema	String	否	訂單詳情頁的跳轉(zhuǎn)地址，用以小程序跳轉(zhuǎn) Scheme ，小程序跳轉(zhuǎn) Scheme 協(xié)議規(guī)則

Data.Ext.MainOrder.Express

字段名稱	字段類型	必填	備注
ID	String	是	快遞單號
Name	String	否	快遞公司名稱
Code	String	是	快遞公司對應(yīng)的編號，詳情請參考快遞公司信息碼表
Type	Int	是	快遞類型，1：商家給用戶發(fā)貨，2：用戶給商家退貨；開發(fā)者根據(jù)快遞類型傳 1 或 2
Status	Int	是	開發(fā)者默認傳 0

返回值參數(shù)說明

注意：訂單同步文檔中的所有接口返回字段和示例一致，其他接口的返回請參考該說明

字段名稱	字段類型	備注
biz_app_id	String	POST 請求參數(shù)中 BizAPPID
cate_id	Int	POST 請求參數(shù)中 CateID
resource_id	String	POST 請求參數(shù)中 ResourceID
rows_affected	Int	請求受影響行數(shù)（即請求是否成功， 0 為失敗，非 0 為成功）

響應(yīng)示例

JSON

 
 
 
  
  
  {  
  
   "errno": 0,  
  
   "msg": "success",  
  
   "data": [  
  
   {  
  
   "biz_app_id": "IGRshW1EovxlMIoeLXQZkQiGcGGyjsPX",  
  
   "cate_id": "1",  
  
   "resource_id": "aa",  
  
   "rows_affected": "0"  
  
   }  
  
   ]  
  
  }

網(wǎng)站標題：創(chuàng)新互聯(lián)百度小程序教程：導(dǎo)入訂單信息
文章鏈接：http://m.jiaoqi3.com/article/dpgpghj.html

新聞中心

導(dǎo)入訂單信息

接口簡介

接口調(diào)用請求說明

參數(shù)說明

請求示例

訂單類型

POST 請求字段說明

Data

Data.Ext

Data.Ext.MainOrder

Data.Ext.MainOrder.Product

Data.Ext.MainOrder.Express

Data.Ext.MainOrder.Product.DetailPage

Data.Ext.MainOrder.Product.SkuAttr

Data.Ext.MainOrder.Payment

Data.Ext.MainOrder.Payment.PaymentSpecInfo

Data.Ext.MainOrder.Appraise

Data.Ext.MainOrder.OrderDetail

Data.Ext.MainOrder.Express

返回值參數(shù)說明

其他資訊