国際配送の作成と管理

POST /v1/fulfillment/shipments/create {#create}

preview と同じ主要フィールドに加えて、以下を任意で指定できます。

  • external_shipment_id — 冪等性キー
  • remark

total.payment は preview の total と一致している必要があります。

"total": {
  "freight": { "amount": 8900, "currency": "CNY" },
  "services": { "amount": 1500, "currency": "CNY" },
  "discount": { "amount": 200, "currency": "CNY" },
  "payment": { "amount": 10200, "currency": "CNY" }
}

shipment_idstatus (例: wait_payment) を返します。

POST /v1/fulfillment/shipments/pay {#pay}

{
  "shipment_id": "shp_01HXYZ"
}

fulfillment wallet から請求されます。残高不足の場合は INSUFFICIENT_BALANCE です。

POST /v1/fulfillment/shipments/cancel {#cancel}

{
  "shipment_id": "shp_01HXYZ",
  "cancel_reason": "buyer_request"
}

POST /v1/fulfillment/shipments/detail {#detail}

{
  "shipment_id": "shp_01HXYZ"
}