Openapi For Merchant FAQ

1.如何查詢訂單的出庫狀態及物流軌跡？

答：要查詢訂單的出庫狀態以及物流軌跡，可以使用​​【出庫單明細查詢】API。這個API提供了兩個重要的字段來獲取相關信息：

1. order_status（訂單狀態）：這個字段反映了訂單在倉庫處理的狀態，可能包括待處理（pending）、待出庫（to_outbound）、已出庫（completed）以及已作廢（cancelled）等狀態。通過檢查這個字段，您可以了解訂單的當前處理階段。

2. logistics_status（物流狀態）：這個字段提供了關於訂單物流軌跡的信息。它包括不同的狀態，如備貨中、已發貨、已簽收、退貨中、已退貨、問題件、已到達等。通過檢查這個字段，您可以追蹤訂單的物流狀態節點。

結合這兩個字段的信息，您可以全面了解訂單的出庫狀態以及物流軌跡。

2.物流軌跡是多久時間會進行更新？

答：物流軌跡的更新時間與物流商的系統串接相關。我司已與物流商系統進行了串接，當物流商推送最新的軌跡數據給我方後，我方提供的物流狀態也會同步更新。通常，這使得我方提供的物流軌跡數據能夠與物流商官方網站上的數據保持一致。

需要注意的是，對於店配，由於物流商推送數據的頻率原因，可能會存在一定的延遲，通常在1-2小時內。因此，用戶在查詢物流軌跡時應該考慮到可能的延遲情況。

3.【出庫單明細查詢】API中的order_status傳值及含義？

答：在「出庫單明細查詢」API中，order_status 字段包含4個可能的狀態，分別為：

1. pending（待處理）：

   • 含義：訂單剛創建，從​​API進入到 OneWarehouse 系統的初始狀態。
   • 特點：這個狀態的訂單尚未下發到倉庫。可以在 OneWarehouse 系統中對這個狀態的訂單進行二次編輯和人工審核下發倉庫動作。

2. to_outbound（待出庫）：

   • 含義：出庫指令已經到達倉庫，並處於出庫操作過程中的訂單。
   • 特點：在操作完成前，如果不想出貨，可以嘗試拦截訂單（方法一：在 OneWarehouse 系統中操作「攔截訂單」；方法二：通過​​「取消出庫單」接口攔截訂單），實際是否可攔截成功會根據倉庫進度匯報返回是否拦截成功。

3. completed（已出庫）：

   • 含義：倉庫作業已完成並成功出貨的訂單。
   • 特點：代表訂單在庫內的生命週期完結，不可進行系統攔截。

4. cancelled（已作廢）：

   • 含義：表示訂單處於作廢狀態，不會進行出貨。
   • 操作：
     • 方法一：可以通過​​「創建出庫單」接口，將​​狀態為「待處理」的訂單變更為​​「已作廢」。
     • 方法二：在OneWarehouse系統中操作將「待處理」的訂單變更為​​「已作廢」。

4.【出庫單明細查詢】API中的logistics_status傳值及含義？

答：在「出庫單明細查詢」API中，logistics_status 字段包含七個可能的狀態，分別為：

1. undelivery（備貨中）：表示貨物目前正在備貨過程中，尚未交接給物流端。

2. delivered（已發貨）：表示貨物已經成功交接到物流端，開始進行物流運輸。

3. received（已簽收）：表示貨物已被消費者成功簽收，交易完成。

4. returning（退貨中）：表示貨物正在進行退貨流程，即消費者發起了退貨申請，但退貨尚未完成。

5. returned（已退貨）：表示貨物已經發生退貨，並且退貨過程已經完成。

6. problem（問題件）：表示在貨物物流過程中發生了異常問題，具體問題需要聯絡物流商進一步了解。

7. arrived（已到達）：表示貨物已經順利到達目的地門市。

需要注意的是，只有當order_status為 completed 時，logistics_status 才會被生成。這一條件確保了僅在訂單完成的情況下才有相應的物流狀態信息。

5.【查詢庫存】API中各類庫存含義

1. qty_good（良品庫存）：

   • 商品屬性：良品
   • 意義：總庫存數，即倉庫內實際存在的良品數量。

2. qty_lock（良品預佔庫存）：

   • 商品屬性：良品
   • 意義：被等待發貨的訂單佔用的良品數量，即尚未出庫的訂單佔用的良品。

3. qty_freezed（良品凍結庫存）：

   • 商品屬性：良品
   • 意義：在OW系統中被凍結的良品庫存，凍結庫存等同於佔用庫存，不能被訂單使用。

4. qty_available（良品可用庫存）：

   • 商品屬性：良品
   • 意義：計算方式為良品庫存 - 良品預佔庫存 - 良品凍結庫存，代表未被訂單使用的良品剩餘庫存。

5. qty_on_way（待驗收庫存）：

   • 意義：已建立入庫單但尚未完成入庫的庫存，即待驗收的庫存。

6. qty_bad（不良品庫存）：

   • 商品屬性：不良品
   • 意義：總的不良品庫存數量，包括採購入庫單、退貨入庫單、盤盈的庫存，以及次品出庫和盤虧的庫存減少。

7. qty_bad_lock（不良品預佔庫存）：

   • 商品屬性：不良品
   • 意義：被等待發貨的訂單佔用的不良品數量，即尚未出庫的訂單佔用的不良品。

8. qty_bad_available（不良品可用庫存）：

   • 意義：可用不良品庫存，計算方式為不良品庫存減去不良品預佔庫存，代表未被訂單使用的不良品剩餘庫存。

6.店配物流的門市編碼、門市名稱相關資訊可以用什麼方式獲取？

答：如果你想要獲取店配物流的門市編碼和門市名稱相關資訊，你可以使用「門店列表分頁查詢」API。這個API通常提供了一個分頁查詢的方式，讓你能夠獲取門店的相關資訊，包括門市編碼、門市名稱以及其他可能的相關資訊。通过调用这个API，你可以方便地获取你需要的門店資訊，以便進行相應的業務操作或者查詢。

7. 倉配物流編碼是由您們提供嗎？

答：是的，倉配物流編碼是由我方提供的。在測試階段和上線過程中，我們會提供相應的倉配物流編碼，以確保順利的系統整合和正確的業務操作。如果您有任何相關的需求或疑問，請隨時與我們聯繫，我們將竭誠協助您。

8.是否可以透過API編輯訂單？

答：是的，您可透過​​【創建出庫單】接口來再次更新訂單信息。然而，需要注意的是，只有在訂單處於「待處理」或「已作廢」這兩個狀態時，才能夠進行再次更新。

9.【創建出庫單】API中的warehouse_express_code傳值？

答：

測試環境：

正式环境：