問題1：各接口含義及必要串接接口？
答：
推送接口：
| 序號 | 接口名稱 | 業務類型 | 接口描述 | 調用方 | 接收方 |
| ※1 |
商品同步接口 |
商品 |
OneWarehouse通過此接口推送 新增/更新 商品檔案給WMS |
OneWarehouse | WMS |
| ※2 |
採購入庫單下單接口 |
入庫 |
OneWarehouse通過此接口推送「採購入庫單」給WMS |
||
| ※3 | 退貨入庫單下單接口 | OneWarehouse通過此接口推送「退貨入庫單」給WMS | |||
| ※4 |
入庫單取消接口 |
OneWarehouse通過此接口推送 入庫單取消（含採購/退貨）請求給WMS |
|||
| ※5 |
出庫單下單接口 |
出庫
|
OneWarehouse通過此接口推送「出庫訂單」給WMS |
||
| ※6 |
出庫單取消接口 |
OneWarehouse通過此接口推送取消出庫訂單 請求給WMS |
|||
| ※7 |
出庫單回調接口 |
WMS通過此接口推送「出庫單出庫狀態/明細」給OneWarehouse |
WMS | OneWarehouse | |
| ※8 | 倉庫取消出貨接口 | WMS通過此接口推送 出庫單取消請求 給OneWarehouse（可用於倉庫出貨過程中，倉庫端發現意外，需要主動中斷該訂單出貨場景） | |||
| ※9 | 入庫單回調接口 | 入庫 | WMS通過此接口推送「入庫單入庫狀態/明細」給OneWarehouse |
查詢接口：
| 序號 | 接口名稱 | 業務類型 | 接口描述 | 調用方 |
| ※1 |
獲取面單接口 |
出庫 |
WMS通過此接口查詢「出庫訂單」的運單圖片（非倉庫物流，返回圖片下載鏈接，圖片默認PDF格式） |
WMS |
| 2 | 獲取自畫面單參數接口 | 如倉庫希望不直接獲取運單圖片時，可調用該接口獲取到運單組成的參數，可用該資訊倉庫自行繪畫運單圖片 | ||
| 3 | 申請拆包接口 | 當倉庫出庫時發現一個訂單有多包裹情況，需獲取新的運單號時使用，每調用一次代表申請一個運單號 | ||
| 4 | 獲取商家信息接口 | 貨主資料 | WMS通過此接口查詢貨主的公司名稱等資料 |
注意：紅色星號※接口建議必接
問題2：回調key 和下發key 對應用途，以什麼為基準去檢查webhook request？
答：
回調key的用途及檢查基准
用途：
- 回調key主要用於WMS（倉庫管理系統）在入庫單或出庫單操作成功後，回調OneWarehouse系統時進行身份驗證。OneWarehouse系統在接收到回調請求時，會解析請求中的密鑰，並與預設或存儲的回調key進行對比，以確認請求的來源是否合法，從而防止未經授權的訪問。
檢查基准：
- 密鑰一致性：檢查請求中的密鑰與OneWarehouse系統中存儲的回調key是否完全一致。
- 請求來源驗證：通過驗證密鑰，確認請求確實來自WMS系統，而非其他惡意來源。
- 時間戳與簽名驗證（如適用）：除了密鑰外，還可以結合請求中的時間戳和簽名進行進一步的驗證，確保請求的實時性和數據的完整性。
下發key的用途及檢查基准
用途：
- 下發key主要用於OneWarehouse系統在調用WMS系統時進行身份驗證。OneWarehouse系統會將包含sign、timestamp等字段的請求發送給WMS系統，WMS系統則根據OneWarehouse下發的密鑰、指定的加密方式及請求參數進行加密處理，並將結果與請求中的sign進行對比，以確認請求的合法性。
檢查基准：
- 加密結果一致性：WMS系統使用下發key對請求參數進行加密處理後，得到的結果應與請求中的sign完全一致。
- 請求參數驗證：除了加密結果外，WMS系統還應驗證請求中的其他參數，如timestamp（時間戳），以確保請求的實時性和數據的準確性。
- 安全性考慮：在使用下發key進行加密驗證時，應確保加密方式的安全性，避免使用已知存在漏洞的加密算法或協議。
總之，回調key和下發key在系統間的交互中起到了關鍵的驗證作用。通過對這些密鑰的嚴格管理和使用，可以確保系統間數據傳輸的安全性和可靠性。
問題3：是否要IP白名單限制?
答：
如果WMS系統有相關的訪問限制需求，我們可以為OneWarehouse系統提供以下的IP白名單列表，以便WMS系統進行配置。而當WMS系統回調OneWarehouse網關時，是不需要設置IP白名單限制的。
OneWarehouse系統的固定出口IP地址如下：
- 121.11.221.130
- 121.11.221.131
- 52.77.143.211
- 122.248.196.11
- 46.51.219.5
- 13.214.244.173
- 18.143.33.165
- 13.215.123.123
- 120.78.70.56
- 120.78.69.89
- 120.78.67.40
- 120.78.71.91
問題4：申請測試環境需要準備哪些內容？
答：
1. 準備測試環境
A. 提供接收URL
- 任務：您需要準備6個測試用的URL地址，這些地址將作為OneWarehouse推送接口的目標。這6個地址對應以下6個接口：
-
- 商品同步接口
- 採購入庫單下單接口
- 退貨入庫單下單接口
- 入庫單取消接口
- 出庫單下單接口
- 出庫單取消接口
- 建議：這些URL可以指向您內部的一個mock服務，該服務能夠接收請求並返回模擬的響應。
B. Mock內部實現
- 任務：設置mock服務以接收和處理來自OneWarehouse的推送請求。
- 建議：mock服務應能夠模擬真實的業務邏輯，包括返回成功狀態碼、模擬資料庫操作等，以便驗證接口通訊的正確性和資料的準確性。
2. 接口對接與測試
A. 配置OneWarehouse推送接口
- 任務：在收到並確認您的接收URL後，OneWarehouse將配置其推送接口以指向您提供的URL。
B. 執行接口對接測試
- 任務：進行一系列接口對接測試
- 目的：驗證每個接口的功能是否按預期工作，資料是否正確傳輸和處理。
3. 問題反饋與調整
- 任務：在測試過程中，如果發現任何問題（如資料格式錯誤、響應超時、邏輯處理錯誤等），雙方應及時溝通並提供詳細的錯誤資訊和日誌。
- 行動：根據問題反饋，雙方共同協作，調整接口實現或mock服務的配置，直至所有接口都能正常通訊並滿足業務需求。
問題5：在沙盒環境中測試的流程在怎樣的？
答：
1. 環境準備
- 設置沙盒環境：確保沙盒環境已經配置完成，並與生產環境隔離，以避免測試數據影響實際業務。
- 數據準備：根據測試需求，在沙盒環境中準備必要的測試數據，如商品分類、供應商信息等。
2. 創建商品檔案
- 步驟：
- 在系統中手動創建幾個商品檔案，包括商品的基本信息、庫存設置等。
- 注意記錄商品ID和創建時間，以便後續跟蹤和驗證。
- 驗證點：
- 確認商品檔案是否成功創建，且信息準確無誤。
- 確認此時並未立即調用創建商品介面（根據業務邏輯）。
3. 入庫過程測試
- 步驟：
- 創建入庫單，並輸入相關商品信息和數量。
- 調用創建入庫單流程，觀察系統反應。
- 調用入庫單回調介面，將入庫單狀態改變為完成狀態。
- 驗證點：
- 確認入庫單是否成功創建並被系統接受。
- 驗證庫存是否根據入庫單數量正確增加。
- 檢查系統日誌和回調記錄，確保流程無誤。
4. 出庫過程測試
- 步驟：
- 創建出庫單，選擇需要出庫的商品和數量。
- 模擬倉庫出庫完成，記錄相關信息（如出庫時間、操作員等）。
- 調用出庫單回調介面，將訂單狀態變為已出庫狀態。
- 驗證點：
- 確認出庫單是否成功創建並被系統接受。
- 驗證庫存是否根據出庫單數量正確減少。
- 確保物流面單介面能夠正常獲取面單圖片（如適用）。
- 檢查系統日誌和回調記錄，確保流程無誤。
5. 完整性測試
- 步驟：
- 模擬實際操作場景，結合商品創建、入庫、出庫等多個環節進行測試。
- 測試系統在異常情況下的反應，如網絡中斷、數據異常等。
- 進行負載測試，驗證系統在高併發情況下的性能和穩定性。
- 驗證點：
- 確認系統在各個環節之間的數據傳輸和處理是否準確無誤。
- 驗證系統在異常情況下的恢復能力和錯誤處理機制。
- 確保系統在高負載情況下仍能保持良好的性能和穩定性。
6. 記錄與反饋
- 記錄測試結果：詳細記錄每個測試步驟的結果和發現的問題。
- 問題反饋與跟蹤：及時向開發團隊反饋測試中發現的問題，並跟蹤問題的解決進度。
- 總結測試報告：在測試結束後，總結測試結果和經驗教訓，編寫測試報告以供後續參考。
問題6：貨主身份如何區分？
答：
在API中，我們使用字段"account_no"作為貨主的身份ID，用於區分不同的貨主。在貴司系統中可以建立相關貨主檔案與"account_no"進行關聯，這樣實現根據"account_no"來區分不同的貨主身份。通過這種方式，貴方能夠準確地識別和處理來自不同貨主的商品、單據和相關資訊。
評論
0 條評論
請登入寫評論。