update_order_status
Update the main status, delivery status, or payment status of an order. Supports updating multiple statuses simultaneously.
Instructions
[WRITE] 更新訂單狀態(支援同時更新多種狀態)。
【用途】 分別或同時更新訂單的主狀態、配送狀態、付款狀態。 僅傳入非 None 的參數,每個非 None 參數會各自呼叫一支 API。
【呼叫的 Shopline API】
PATCH /v1/orders/{order_id}/status(若 status 非 None)
PATCH /v1/orders/{order_id}/delivery-status(若 delivery_status 非 None)
PATCH /v1/orders/{order_id}/payment-status(若 payment_status 非 None)
【回傳結構】 dict 含 success: bool, resource_id: str, message: str, updated_fields: list。
【副作用】
訂單狀態立即變更,影響前台顯示與後台報表
狀態變更可能觸發客戶通知(取決於商店設定)
非法的狀態值或不合法的狀態轉換會導致 API 回傳錯誤
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | 訂單 ID | |
| status | No | 訂單狀態(如 confirmed / cancelled) | |
| delivery_status | No | 配送狀態(如 shipped / delivered) | |
| payment_status | No | 付款狀態(如 paid / unpaid) |