API介紹
getOrder 獲取訂單的詳細信息,含主訂單和子訂單 正向交易
getOrders 獲取符合條件的訂單列表,批量查詢多個訂單信息,一次最多查詢100條正向交易
getOrderItems 獲取符合條件的訂單列表正向交易
sendgoods 訂單發貨接口(跨境/本地)
queryPackageStatus 查詢包裹狀態
名稱解釋
正向交易:正常下單的流程
逆向交易:申請退貨換貨退款流程
實施方案
初始化是把所有的在線訂單全部同步回來,這個需要較長的時間;
增量獲取則是把速賣通發生了變更的訂單同步回來,這個一般需要較短的時間。
一.正向訂單同步流程
如何同步訂單:
調用getOrders得到參數trade_order_id(訂單id)通過該參數繼續調用GetOrder(訂單詳情)或GetOrderItems(子訂單信息)
如何訂單發貨:
調用getOrders得到參數trade_order_id(訂單ID),通過訂單ID查看訂單狀態,判斷status 是否有未發貨,有則調用發貨接口
經驗分享:
通過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, "發貨成功")