---
title: "Update Order Delivery"
method: PUT
path: "/order_deliveries/{id}"
tags: ["Order Deliveries"]
---

# Update Order Delivery

`PUT /order_deliveries/{id}`

## Request

- Base URL: `https://open.shopline.io/v1`
- URL: `https://open.shopline.io/v1/order_deliveries/{id}`
- Auth: HTTP bearer

To update a specific order delivery with its ID<br>使用訂單ID配送更新特定一筆訂單配送的資料

## Path parameters

- `id` string, required

## Request body

- object
  - `remark` string: Delivery remark<br>出貨備註 Up to 255 words.<br>最多只能填寫255個字。
  - `status` string: Order delivery status<br>訂單送貨狀態 Order delivery Status only allows<br>訂單送貨狀態只可以填入 pending 備貨中<br> shipping 發貨中<br> shipped 已發貨<br> arrived 已到達<br> collected 已取貨<br> returned 已退貨<br> returning 退貨中

## Response `200`

OK

- OrderDelivery
  - `id` string: Order Delivery ID<br>訂單配送ID
  - `delivery_option_id` string: Delivery Option ID<br>送貨方式ID
  - `platform` string: Delivery platform<br>送貨方式類別
  - `status` 'pending' | 'shipping' | 'shipped' | 'arrived' | 'collected' | 'returned' | 'returning': Delivery Status<br>送貨狀態<br><br> Status allows:<br> pending 備貨中<br> shipping 發貨中<br> shipped 已發貨<br> arrived 已到達<br> collected 已取貨<br> returned 已退貨<br> * returning 退貨中
  - `delivery_status` 'arrived' | 'collected' | 'expired' | 'failed' | 'pending' | 'request_accepted' | 'request_authorized' | 'request_submitted' | 'returned' | 'returning' | 'returning_store_closed' | 'shipped' | 'store_closed': Logistic Service Order Status<br>配送狀態<br><br> Status allows:<br> arrived 已到達<br> collected 已取貨<br> expired 已過出貨期限<br> failed 失敗<br> pending 未執行<br> request_accepted 可供出貨<br> request_authorized 待處理<br> request_submitted 處理中<br> returned 已退貨<br> returning 退貨中<br> returning_store_closed 退貨門市關轉<br> shipped 已出貨<br> * store_closed 門市關閉
  - `name_translations` object: 送貨方式名稱
    - `en` string: Merchant defined English name<br>店家定義英文名稱
    - `zh-hant` string: Merchant defined Traditional Chinese name<br>店家定義繁體中文名稱
    - `zh-cn` string: Merchant defined Simplified Chinese name<br>店家定義簡體中文名稱
    - `vi` string: Merchant defined Vietnamese name<br>店家定義越南文名稱
    - `ms` string: Merchant defined Malaysian name<br>店家定義馬來西亞文名稱
    - `ja` string: Merchant defined Japanese name<br>店家定義日文名稱
    - `th` string: Merchant defined Thai name<br>店家定義泰文名稱
    - `id` string: Merchant defined Indian name<br>店家定義印度文名稱
    - `de` string: Merchant defined Deutsch name<br>店家定義德文名稱
    - `fr` string: Merchant defined France name<br>店家定義法文名稱
  - `total` object: Delivery fee<br>運費
    - `en` string: Merchant defined English name<br>店家定義英文名稱
    - `zh-hant` string: Merchant defined Traditional Chinese name<br>店家定義繁體中文名稱
    - `zh-cn` string: Merchant defined Simplified Chinese name<br>店家定義簡體中文名稱
    - `vi` string: Merchant defined Vietnamese name<br>店家定義越南文名稱
    - `ms` string: Merchant defined Malaysian name<br>店家定義馬來西亞文名稱
    - `ja` string: Merchant defined Japanese name<br>店家定義日文名稱
    - `th` string: Merchant defined Thai name<br>店家定義泰文名稱
    - `id` string: Merchant defined Indian name<br>店家定義印度文名稱
    - `de` string: Merchant defined Deutsch name<br>店家定義德文名稱
    - `fr` string: Merchant defined France name<br>店家定義法文名稱
  - `shipped_at` string: Shipped Time<br>已送貨時間<br>(UTC +0)
  - `arrived_at` string: Arrived Time<br>已到達時間<br>(UTC +0)
  - `collected_at` string: Collected Time<br>已取貨時間<br>(UTC +0)
  - `returned_at` string: Returned Time<br>已退貨時間<br>(UTC +0)
  - `updated_at` string: Updated Time<br>更新時間<br>(UTC +0)
  - `remark` string: Order remark<br>訂單出貨備註
  - `request_accepted_at` string: Logistic accepted shipment time<br>物流商收到出貨時間
  - `request_authorized_at` string: Logistic authorized shipment time<br>物流商接受出貨時間
  - `request_submitted_at` string: Logistic proceeded shipment time<br>物流商處理出貨時間
  - `requested_fmt_at` string: Shipment execution time (Family Mart)<br>執行出貨時間 (全家)
  - `return_order_id` string: Return order ID<br>退貨訂單編號
  - `store_closed_at` string: Pick up store closed time<br>訂單取貨門市關轉時間
  - `require_expired_upload` boolean: Check if delivery needs reupload and schedule aggregation upload
  - `require_storeclosed_upload` boolean: whether scheduled upload to 7-11 B2C FTP, SUP
  - `storeclosed_upload_at` string: prevent duplicated update storeclosed (EIN.36) for 7-11 B2C
  - `exp_type` string: exp type
  - `requires_customer_address` boolean: Whether the customer address is required<br>是否需要顧客提供地址

## Other responses

- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `d2518391b149`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shoplineapp/apis/shopline-open-api/changes/order_deliveries/:id/put.md)

---

[API](https://skmtc.dev/shoplineapp/apis/shopline-open-api.md) - [All operations](https://skmtc.dev/shoplineapp/apis/shopline-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shoplineapp/apis/shopline-open-api/revisions/d2518391b149?raw)