消息通知 · 全球云商供應鏈

### 1.消息說明開放平臺向接入商的系統實時推送業務變更消息，接入商系統收到消息后，進行相應的處理，實現數據同步，從而滿足接入商系統業務功能。 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#2%E6%8E%A8%E9%80%81%E6%96%B9%E5%BC%8F)2.推送方式為避免接入商輪詢，開放平臺采用推送的方式，以`http post`的形式向商戶指定的回調地址(自行在聚合供應鏈商戶后臺的應用上配置)進行推送。推送的消息數據(Body中除sign以外的部分)會進行消息摘要([詳見簽名規則](簽名規則.md))，接收方收到數據后，需對數據進行驗簽，以保證數據的可靠性。接收方正常處理完消息后，需回執`SUCCESS`，若接收或處理失敗，消息會自動重發(參見生命周期) ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#3%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F)3.生命周期正常情況下，每條消息最多會進行8次通知 (通知的間隔頻率一般是：`立即`,`10s`,`30s`,`1m`,`2m`,`3m`,`4m`,`5m`) ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#4%E5%B9%82%E7%AD%89%E5%A4%84%E7%90%86)4.冪等處理由于網絡原因、接入商系統原因，或接入商系統接收成功但未正常回執等，會觸發消息的重試機制，接收方需要對同一個id的消息多次投遞結果實現冪等。 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#5%E6%8E%A8%E9%80%81%E6%95%B0%E6%8D%AE%E6%A0%BC%E5%BC%8F)5.推送數據格式 **請求方式：**`POST` **請求參數** Headers | 參數名稱 | 參數值 | 必填 | 類型 | 備注 | | --- | --- | --- | --- | --- | | Content-Type | application/json | 是 | String | | Body | 名稱 | 類型 | 必須 | 示例值 | 備注 | | --- | --- | --- | --- | --- | | id | java.lang.Long | 是 | 1601051353780715520 | 消息唯一標識 | | pushTime | java.lang.Long | 是 | 1670555403922 | 消息推送時間 | | type | java.lang.String | 是 | order.status.change | 消息類型 | | data | java.lang.String | 是 | {“dbyOrderId”:“1411601040867127328768”} | 推送數據 (json字符串) | | sign | java.lang.String | 是 | 21A5C3C007A5998166602C6B1133E47C | 簽名 | 示例 ~~~json { "id":1601051353780715520, "pushTime":1670555403922, "type":"order.status.change", "data":"{\"dbyOrderId\":\"1411601040867127328768\"}", "sign":"21A5C3C007A5998166602C6B1133E47C" } ~~~ > 基于`type`字段值，區分不同的消息類型，各種類型的消息，`data`字段對應的json字符串格式不同 ## [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E6%B6%88%E6%81%AF%E7%B1%BB%E5%9E%8B)消息類型 * * * ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%95%86%E5%93%81)商品 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%95%86%E5%93%81%E6%B1%A0%E6%B7%BB%E5%8A%A0%E5%95%86%E5%93%81)商品池添加商品 > type:`goods.pool.add` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | goodsIds | String\[\] | \[“50165434620”,“50165241120”\] | 商品skuCode數組 | **收到消息后的處理方式：** 通過[查詢商品詳情](查詢商品詳情.md)接口，獲取商品詳細信息，保存到接入方系統商品庫中 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%95%86%E5%93%81%E6%B1%A0%E7%A7%BB%E9%99%A4%E5%95%86%E5%93%81)商品池移除商品 > type:`goods.pool.remove` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | goodsIds | String\[\] | \[“50165434620”,“50165241120”\] | 商品skuCode數組 | **收到消息后的處理方式：** 移除接入方系統商品庫中對應的商品 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%95%86%E5%93%81%E4%B8%8A%E6%9E%B6)商品上架 > type:`goods.publish` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | goodsIds | String\[\] | \[“50165434620”,“50165241120”\] | 商品skuCode數組 | **收到消息后的處理方式：** 變更對應商品的狀態為`上架`。為避免因消息推送延遲，對應商品的最新狀態已發生變化，建議在收到消息后，通過[查詢商品上下架狀態](查詢商戶商品上下架狀態.md)接口，獲取商品當前最新的上下架狀態 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%95%86%E5%93%81%E4%B8%8B%E6%9E%B6)商品下架 > type:`goods.un.publish` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | goodsIds | String\[\] | \[“50165434620”,“50165241120”\] | 商品skuCode數組 | **收到消息后的處理方式：** 變更對應商品的狀態為`下架`。為避免因消息推送延遲，對應商品的最新狀態已發生變化，建議在收到消息后，通過[查詢商品上下架狀態](查詢商戶商品上下架狀態.md)接口，獲取商品當前最新的上下架狀態 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%95%86%E5%93%81%E4%BF%A1%E6%81%AF%E5%8F%98%E6%9B%B4)商品信息變更 > type:`goods.detail.alter` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | goodsIds | String\[\] | \[“50165434620”,“50165241120”\] | 商品skuCode數組 | **收到消息后的處理方式：** 通過[查詢商品詳情](查詢商品詳情.md)接口，獲取商品最新的信息進行更新 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%95%86%E5%93%81%E4%BB%B7%E6%A0%BC%E5%8F%98%E6%9B%B4)商品價格變更 > type:`goods.price.alter` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | goodsIds | String\[\] | \[“50165434620”,“50165241120”\] | 商品skuCode數組 | **收到消息后的處理方式：** 通過[查詢商品價格](查詢商品價格.md)接口，獲取商品最新的價格進行更新 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E8%AE%A2%E5%8D%95)訂單 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E8%AE%A2%E5%8D%95%E6%8B%86%E5%8D%95)訂單拆單 > type:`order.split` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | dbyOrderId | String | 1411601121460812906496 | 小象訂單號 | **收到消息后的處理方式：** 通過[查詢訂單詳情](查詢訂單詳情.md)接口，獲取訂單最新的信息，將訂單詳情中的子訂單列表，覆蓋更新到接入方系統中。 `注意`：確認下單后，系統會進行異步拆單，推送拆單消息。但一個訂單可能會出現**多次拆單**的情況（按渠道—>按商家—>按倉庫…），每次收到拆單消息時，都應通過訂單詳情去獲取最新的訂單數據，和本地系統里的數據進行對比更新。例如：一批商品下單后，第一次拆單，通過訂單詳情查詢到的子訂單有\[1、2\]，后續發生了二次拆單，此時訂單詳情查詢到的子訂單可能會是\[1、3、4\]，子訂單2 中的商品被再次拆分，變成了子訂單3和4。接入商系統需要對數據做更新。**訂單發貨后，不會在再出現拆單的情況**。 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E8%AE%A2%E5%8D%95%E7%8A%B6%E6%80%81%E5%8F%98%E6%9B%B4)訂單狀態變更 > type:`order.status.change` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | dbyOrderId | String | 1411601121460812906496 | 小象訂單號 | **收到消息后的處理方式：** 通過[查詢訂單詳情](查詢訂單詳情.md)接口，獲取訂單最新的信息，將每個子訂單的最新狀態更新到接入方系統中，結合接入方系統的業務，對不同的狀態做其他處理 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E8%AE%A2%E5%8D%95%E5%8F%91%E8%B4%A7)訂單發貨 > type:`order.deliver` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | dbyOrderId | String | 1411601121460812906496 | 小象訂單號 | **收到消息后的處理方式：** 通過[查詢訂單物流信息](查詢訂單物流信息.md)接口，獲取子訂單的物流信息 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%94%AE%E5%90%8E)售后 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%94%AE%E5%90%8E%E7%8A%B6%E6%80%81%E5%8F%98%E6%9B%B4)售后狀態變更 > type:`after-sales.status.change` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | afterSaleOrderId | String | 1411601149457016160256 | 售后訂單號 | **收到消息后的處理方式：** 通過[查詢售后訂單詳情](查詢售后訂單詳情.md)接口，獲取售后訂單的最新狀態，更新到接入方系統中 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%94%AE%E5%90%8E%E9%80%80%E6%AC%BE)售后退款 > type:`after-sales.refund` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | afterSaleOrderId | String | 1411601149457016160256 | 售后訂單號 | **收到消息后的處理方式：** 通過[查詢售后退款詳情](查詢售后退款詳情.md)接口，獲取售后訂單的退款信息，結合接入方自身的業務邏輯，進行相應的退款操作 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%9C%B0%E5%9D%80%E5%BA%93)地址庫 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=f0d7549de2ab52f3eac45d6384c00476#%E5%9C%B0%E5%9D%80%E5%BA%93%E5%8F%98%E6%9B%B4)地址庫變更 > type:`area-code.change` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | operation | Integer | 2 | 變動類型 2-修改 3-刪除 | | level | Integer | 4 | 當前變更的地址等級 | | originalAreaCode | String | 11010100111 | 原來的地址編號 | | changeAreaCode | String | 11010100112 | 改變后的地址編號 | | parentAreaCode | String | 110101 | 改變后的上級地址編號 | **收到消息后的處理方式：** 方案一（全量更新）：通過[省市區街道4級地址查詢](省市區街道4級地址查詢.md)接口，重新從一級地區開始，逐級同步最新的省市區code信息，保存到本地系統方案二（局部更新）：基于變動類型，針對性處理變動類型為`修改`: 根據 originalAreaCode 找到本地系統中對應的地址信息，將其地址code更新為 changeAreaCode，上級地址code更新為 parentAreaCode。如果當前變更的地址level不是4（縣/街道）,還需通過[省市區街道4級地址查詢](省市區街道4級地址查詢.md)接口,同步更新下級地址信息；變動類型為`刪除`: 根據 originalAreaCode 找到本地系統中對應的地址信息，刪除對應的地址信息。如果當前變更的地址level不是4（縣/街道）,還需通過[省市區街道4級地址查詢](省市區街道4級地址查詢.md)接口,同步更新下級地址信息；