文档中心 > 淘寶台灣開放平台

訂單同步&發貨指南

更新时间:2020/06/10 访问次数:93

 

API介紹

getOrder 獲取訂單的詳細信息,含主訂單和子訂單 正向交易  

getOrders 獲取符合條件的訂單列表,批量查詢多個訂單信息,一次最多查詢100條正向交易

getOrderItems 獲取符合條件的訂單列表正向交易

sendgoods 訂單發貨接口(跨境/本地)

queryPackageStatus 查詢包裹狀態

 

名稱解釋

正向交易:正常下單的流程

逆向交易:申請退貨換貨退款流程

 

實施方案

初始化是把所有的在線訂單全部同步回來,這個需要較長的時間;

增量獲取則是把速賣通發生了變更的訂單同步回來,這個一般需要較短的時間。

一.正向訂單同步流程

image.png

 

 

如何同步訂單:

調用getOrders得到參數trade_order_id(訂單id)通過該參數繼續調用GetOrder(訂單詳情)或GetOrderItems(子訂單信息)

1.jpg

2.jpg

3.jpg

 

如何訂單發貨:

調用getOrders得到參數trade_order_id(訂單ID),通過訂單ID查看訂單狀態,判斷status 是否有未發貨,有則調用發貨接口

4.jpg

5.jpg

 

經驗分享:

通過getOrders只返回了itemId的列表,需要什麼信息,需要通過getOrderItems這個接口傳遞trade_order_line_id_list去查詢;

通過getOrders查詢訂單列表,批量查詢多個訂單信息,一次最多查詢100條;

通過getOrder查詢單個訂單詳情時包含主訂單和子訂單。

 

入參說明:

getReverseOrde支持按照逆向單號或者子訂單編號查詢單個退款詳情,兩個參數不能同時都為空(reverse_order_id,order_item_id二選其一)

 

訂單狀態:

returned:下單成功

unpaid:待支付

pending:待處理

readyToShip:已發貨

shipped:已攬件

arrived:已妥投

delivered:確認收貨品

failed:配送失敗

cancel:交易取消

returned:退貨退款成功

all:全部狀態

 

履約檢驗規則&失敗原因

001 1.跨境場景,子訂單不允許跨邏輯包裹發貨:不同邏輯包裹不能用相同物流公司+運單號發貨;2.本土場景,商家不錄運單號,系統認為是正常分邏輯包裹發貨3.本土-商家宅配

002 跨境發貨,物流服務商+運單號+箱數字段必填

003 本土發貨,寄件方式必填

004 商品是否支持物流方式

005 物流返回的失敗

 

包裹狀態

包裹取消   CANCELLED(-100, "包裹取消"),

新建包裹   NEW_CREATE(100, "新建包裹"),

打包成功   CREATE_SUCCESS(120, "打包成功"),

倉庫生產完畢、下髮菜鳥成功   STORE_FINISH(700, "倉庫生產完畢"),

配送中   DELIVERY(800, "配送中"),

妥投   DELIVERED(900, "妥投"),

妥投失敗   DELIVERED_FAILED(920, "妥投失敗"),

發貨成功、菜鳥攬收成功   DELIVERED_SUCCESS(710, "發貨成功")

FAQ

关于此文档暂时还没有FAQ
返回
顶部