PATCH /v1/orders/{id}/trackings/{tid}

scope

write_shipping

リクエストパラメーター

名前	位置	型	必須	説明
id	パス	integer	必須	order_id
tid	パス	integer	必須	tracking_id
Idempotency-Key	ヘッダー	string	必須	冪等キー（必須・ADR-010）。UUID v4 推奨。同一キー再送は保存レスポンスを再生
carrier_id	ボディ	integer	任意
tracking_num	ボディ	string	任意
delivery_date	ボディ	string	任意	null で消去

レスポンスの例

{
  "tracking_id": 0,
  "order_id": 0,
  "order_shipping_id": 0,
  "carrier_id": 0,
  "tracking_num": "string",
  "delivery_date": "string"
}

解説

登録済みの送り状を訂正します（配送業者・追跡番号・配達日のいずれか 1 つ以上）。実際に変化したフィールドだけが修正ログに差分記録されます。Idempotency-Key 必須。

エラーレスポンスの例

{
  "error": {
    "code": "insufficient_scope",
    "message": "requires scope 'read_orders'",
    "request_id": "req_01H..."
  }
}

返しうるエラー: 401 / 403 / 404 / 503