> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.returnhelper.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consolidate Shipping 流程

> Consolidate Shipping Order 如何在您與倉庫之間推進

> [!WARNING]
>
> 此頁面由 AI 自動翻譯。如有任何疑問或不一致之處，請以英文版本為準。

Consolidate Shipping Order 把庫存從一個 Return Helper 倉庫運往一個目的地。您建立並提交訂單，倉庫打包並寄出，每一步都會透過 webhook 通知您。

| `destinationType` | 目的地 | 運費 |
| - | - | - |
| `CUSTOM_ADDRESS` | 您在 `shipTo` 中填寫的地址 | 由倉庫報價，您在出貨前接受報價。 |
| `RH_WAREHOUSE` | 在 [Get all warehouses](/zh-Hant/api-reference/warehouse/get-all-warehouses-accessible-to-user) 中 `isConsolidateShippingDestination` 為 `true` 的 Return Helper 倉庫 | 沒有報價。每個 Shipment 到達時依其計費重量收費。 |

> [!NOTE]
>
> 目前香港倉庫是唯一的 `RH_WAREHOUSE` 目的地。

## 自訂地址（`CUSTOM_ADDRESS`）

| # | 執行方 | 操作 | 操作後的訂單狀態 | Webhook |
| - | - | - | - | - |
| 1 | 您 | [建立訂單](/zh-Hant/api-reference/consolidateshippingorder/create-consolidate-shipping-order) | `CREATED` | — |
| 2 | 您 | [加入庫存](/zh-Hant/api-reference/consolidateshippinginventory/add-inventory-to-consolidate-shipping-order)：RMA 依 `returnInventoryId`，FBA 庫存依 FNSKU | `CREATED` | — |
| 3 | 您 | [確認訂單](/zh-Hant/api-reference/consolidateshippingorder/confirm-consolidate-shipping-order) | `CONFIRMED` | — |
| 4 | 倉庫 | 將所有明細打包到 Shipment 和箱子中 | `CONFIRMED` | [All packed](/zh-Hant/webhooks#consolidate-shipping-all-packed) |
| 5 | 倉庫 | 報運費 | `CONFIRMED` | [Cost updated](/zh-Hant/webhooks#consolidate-shipping-cost-updated) |
| 6 | 您 | [確認運費報價](/zh-Hant/api-reference/consolidateshippingorder/confirm-consolidate-shipping-quote) | `CONFIRMED_QUOTE` | — |
| 7 | 您 | [標記為可出貨](/zh-Hant/api-reference/consolidateshippingorder/mark-consolidate-shipping-order-ready-to-ship) | `READY_TO_SHIP` | — |
| 8 | 倉庫 | 寄出 Shipment 並記錄 AWB | 仍有其他明細時為 `PARTIALLY_SHIPPED`；所有明細寄出後為 `SHIPPED` | [AWB updated](/zh-Hant/webhooks#consolidate-shipping-awb-updated)；訂單變為 `SHIPPED` 時另有 [Order completed](/zh-Hant/webhooks#consolidate-order-completed) |

Shipment 狀態：`CREATED` → `SHIPPED`。

## Return Helper 倉庫（`RH_WAREHOUSE`）

| # | 執行方 | 操作 | 操作後的訂單狀態 | Webhook |
| - | - | - | - | - |
| 1–3 | 您 | 與上方相同：建立、加入庫存、確認 | `CONFIRMED` | — |
| 4 | 倉庫 | 將每個 Shipment 打包成一個箱子 | `CONFIRMED` | [All packed](/zh-Hant/webhooks#consolidate-shipping-all-packed) |
| 5 | 倉庫 | 寄出 Shipment 並記錄 AWB | `PARTIALLY_SHIPPED` | [AWB updated](/zh-Hant/webhooks#consolidate-shipping-awb-updated)，Shipment 為 `IN_TRANSIT` |
| 6 | Return Helper | Shipment 到達，記錄其計費重量並收費 | 其他 Shipment 仍在途時為 `PARTIALLY_SHIPPED`；所有含明細的 Shipment 都到達後為 `SHIPPED` | [Shipment arrived](/zh-Hant/webhooks#consolidate-shipment-arrived)；訂單變為 `SHIPPED` 時另有 [Order completed](/zh-Hant/webhooks#consolidate-order-completed) |

Shipment 狀態：`CREATED` → `IN_TRANSIT` → `READY_TO_PICKUP`。

訂單的 `shipTo` 為目的地倉庫地址。[確認運費報價](/zh-Hant/api-reference/consolidateshippingorder/confirm-consolidate-shipping-quote)、[標記為可出貨](/zh-Hant/api-reference/consolidateshippingorder/mark-consolidate-shipping-order-ready-to-ship)、[更新收件資訊](/zh-Hant/api-reference/consolidateshippingorder/update-ship-to-information-of-consolidate-shipping-order) 和 [更新包裝類型](/zh-Hant/api-reference/consolidateshippingorder/update-packaging-type-of-consolidate-shipping-order) 會拒絕 `RH_WAREHOUSE` 訂單。

## 明細與箱子

| 對象 | 狀態流程 |
| - | - |
| 明細（訂單上的 RMA 或 FNSKU） | `PENDING` → `IN_PROGRESS`（部分打包） → `PACKED` → `SHIPPED` |
| 箱子 | `IN_PROGRESS` → `SHIPPED` |

在 [取得 Consolidate Shipping Order](/zh-Hant/api-reference/consolidateshippingorder/get-consolidate-shipping-order) 中，未打包的明細位於 `pendingInventoryList` 和 `inProgressInventoryList`；已打包的明細列在 `shipmentList[].boxList[]` 的對應箱子中。

## 修改或取消訂單

| 修改 | 允許的狀態 | 影響 |
| - | - | - |
| 加入或移除庫存 | `CREATED` | — |
| 更新收件資訊或包裝類型（`CUSTOM_ADDRESS`） | `CREATED`、`CONFIRMED` | 訂單和每個 Shipment 的運費重設為 `0`；`CONFIRMED` 的訂單會重新報價 |
| [取消](/zh-Hant/api-reference/consolidateshippingorder/cancel-consolidate-shipping-order) | `CREATED` | 訂單變為 `CANCELED`；FNSKU 件數退回庫存 |

確認後只有倉庫可以取消訂單，您會收到 [Order cancelled](/zh-Hant/webhooks#consolidate-order-cancelled)。

## 分批寄出

倉庫可能把一張訂單分成多個 Shipment 寄出。在所有明細寄出、且（`RH_WAREHOUSE` 時）所有含明細的 Shipment 都到達之前，訂單維持 `PARTIALLY_SHIPPED`。請以上述 webhook 追蹤進度；如需單次查詢，可使用 [取得 Consolidate Shipping Order](/zh-Hant/api-reference/consolidateshippingorder/get-consolidate-shipping-order)。

## 費用

訂單的 `shippingFee` 為各 Shipment 運費總和。每筆費用會以一筆 Transaction 記錄在您的帳戶中。對於合箱費 Transaction，可用其 `apiTransactionId` [列出每個箱子中的 FNSKU](/zh-Hant/api-reference/apitransaction/get-fnskus-of-consolidate-shipping-merge-fee-transaction)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.