### 使用描述 查詢訂單的物流信息 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E6%96%B9%E6%B3%95%E5%90%8D)方法名 dby.scm.delivery.query ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E7%BD%91%E5%85%B3%E5%9C%B0%E5%9D%80)網關地址 | 環境 | 地址 | 請求方式 | | --- | --- | --- | | 生產環境 | `https://openapi.duobaoyu.com.cn/open/api` | post+json | | 測試環境 | `https://openapi.duobaoyu88.cn/open/api` | post+json | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E5%85%AC%E5%85%B1query%E5%8F%82%E6%95%B0)公共Query參數 * * * | 名稱 | 類型 | 必填 | 描述 | | --- | --- | --- | --- | | method | String | 是 | 方法名稱 | | sign | String | 是 | [簽名](簽名規則.md) | | timestamp | String | 是 | 時間戳,格式為13位,例如:1670223623000 | | version | String | 是 | 版本號,現固定為v1 | | appKey | String | 是 | 申請的應用appKey | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E4%B8%9A%E5%8A%A1body%E5%8F%82%E6%95%B0applicationjson)業務Body參數(application/json) * * * | 名稱 | 類型 | 必填 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | orderItemId | java.lang.String | 是 | 123456 | 小象子訂單號 | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0)響應參數 * * * | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | code | java.lang.String | 0 | 業務編碼處理結果編碼 | | msg | java.lang.String | 請求成功 | 業務處理結果結果說明 | | data | java.lang.Object | | 響應結果 | | ??├─orderItemId | java.lang.String | 365124824 | 小象子訂單號 | | ??├─logisticInfos | java.util.List | | 物流信息列表 | | ????├─expressCompany | java.lang.String | 丹鳥快遞 | 快遞公司名稱 | | ????├─logisticNumber | java.lang.String | 598741122 | 物流單號 | | ????├─trackInfos | java.util.List | | 路由信息列表 | | ??????├─trackContent | java.lang.String | 商品已攬件 | 路由內容 | | ??????├─trackMsgTime | java.lang.Long | 1670320080549 | 記錄時間 | | ??????├─trackOperator | java.lang.String | 張三 | 操作人 | | msgId | java.lang.String | efd7f07011124adf | 消息id | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B)請求示例 curljavaphp ~~~json curl -XPOST -H "Content-type: application/json" -d '{ "orderItemId": "123" }' 'http://xxxxx/open/api?method=dby.scm.delivery.query&version=v1&appKey=your appKey&timestamp=1670057525000&sign=123' ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B)響應示例 ~~~json { "code": "0", "data": { "orderItemId": "123", "logisticInfos": [ { "expressCompany": "中通", "logisticNumber": "zt001", "trackInfos": [ { "trackContent": "您的訂單已經進入倉庫,準備出庫", "trackMsgTime": 1670057525000, "trackOperator": "系統" }, { "trackContent": "揀貨完成", "trackMsgTime": 1670057525000, "trackOperator": "張三" } ] }, { "expressCompany": "中通", "logisticNumber": "zt002", "trackInfos": [ { "trackContent": "您的訂單已經進入倉庫,準備出庫", "trackMsgTime": 1670057525000, "trackOperator": "系統" }, { "trackContent": "揀貨完成", "trackMsgTime": 1670057525000, "trackOperator": "張三" }, { "trackContent": "您的訂單正在配送途中", "trackMsgTime": 1670057525000, "trackOperator": "李四" } ] } ] }, "msg": "", "msgId": "" } ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=7a00f726f06eaa2e633060f8b8b20e6a#%E5%BC%82%E5%B8%B8%E7%A4%BA%E4%BE%8B)異常示例 ~~~json { "code": "1", "msg": "請求失敗", "data": null, "msgId": "efd7f07011124adf" } ~~~