Update Order Delivery Status

Function

To update order's delivery status
更新訂單運送狀態

📘

After return_order_revamp feature key on/啟用「return_order_revamp」功能後

• 訂單狀態已完成，不可更新運送狀態。

❗️

限制：特定物流不允許手動更改出貨狀態

您可透過 Get Delivery Option API 裡的欄位 region_type 取得物流類型，當訂單的物流類型 region_type 屬於以下任一類型時，不允許透過此 API 手動更新 Delivery Status：

• 7-ELEVEN：tw_711_nopay (7-11 取貨不付款 C2C)、tw_711_pay (7-11 取貨付款 C2C)、tw_711_b2c_nopay (7-11 取貨不付款 B2C)、tw_711_b2c_pay (7-11 取貨付款 B2C)、711_return_nopay (7-11 退貨便 C2B)
• 7-ELEVEN 跨境：cross_border_711_store_pick_up (7-11 跨境門市取貨不付款)、cross_border_711_home_delivery (7-11 跨境宅配)
• 全家：tw_fm_b2c_nopay (全家取貨不付款 B2C)、tw_fm_b2c_pay (全家取貨付款 B2C)、tw_fm_c2c_nopay (全家取貨不付款 C2C)、tw_fm_c2c_pay (全家取貨付款 C2C)
• 黑貓：tw_tcat_roomtemp (黑貓宅配 - 常溫)、tw_tcat_refrigerated (黑貓宅配 - 冷藏)、tw_tcat_frozen (黑貓宅配 - 冷凍)、tw_tcat_roomtemp_cod (黑貓宅配 - 常溫貨到付款)、tw_tcat_refrigerated_cod (黑貓宅配 - 冷藏貨到付款)、tw_tcat_frozen_cod (黑貓宅配 - 冷凍 貨到付款)
• 順豐：hk_integrated_sfexpress (順豐速運)、hk_integrated_sf_pickup (順豐速運)
• SL Logistics：sl_logistics_fmt_freeze_pay (全家冷凍取貨付款 B2C)、sl_logistics_fmt_freeze_nopay (全家 冷凍取貨不付款 B2C)、sl_logistics_kerry_th_nd (Kerry ND - 經由 SL logistics)、 sl_logistics_kerry_th_nd_cod (Kerry ND 貨到付款 - 經由 SL logistics)、sl_logistics_kerry_th_2d (Kerry 宅配 - 標準)、sl_logistics_kerry_th_2d_cod (Kerry 宅配 - 貨到付款 - 標準)、sl_logistics_kerry_th_3d (Kerry 3D - 經由 SL logistics)、sl_logistics_kerry_th_3d_cod (Kerry 3D 貨到付款 - 經由 SL logistics)、 sl_logistics_yto_home (中國 - 台灣物流專線宅配 標準 - 普貨)、sl_logistics_yto_home_cod (中國 - 台灣物流專線宅配- 貨到付款 標準 - 普貨)、sl_logistics_yto_store (中國 - 台灣物流專線超取 - 取貨不付款 標準 - 普貨)、sl_logistics_yto_store_cod (中國 - 台灣物流專線超取 - 取貨付款 標準 - 普貨)、sl_logistics_yto_special_home (中國 - 台灣物流專線宅配 標準 - 特貨)、sl_logistics_yto_special_home_cod (中國 - 台灣物流專線宅配- 貨到付款 標準 - 特貨)、sl_logistics_yto_special_store (中國 - 台灣物流專線超取 - 取貨不付款 標準 - 特貨)、sl_logistics_yto_special_store_cod (中國 - 台灣物流專線超取 - 取貨付款 標準 - 特貨)
• Ninja Van：ninja_van (僅適用於馬來西亞境內)

例外：若當前 delivery_status = request_accepted，則允許在 pending ↔ shipping 之間互相切換（僅限這兩個狀態）

URL

PATCH <<api_domain>>/v1/orders/:id/order_delivery_status

Request Parameters

ruby
59e97965e388095314000010

ruby
"status": "arrived"

ruby
"mail_notify": "true"

Response Field

Response Example

{
    "order_id": "59e97965e388095314000010",
    "status": "arrived",
    "updated_at": "2018-05-17T11:38:56.473+00:00"
}