국제 배송 생성 및 관리

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_id와 status를 반환합니다(예: 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"
}