국제 배송 Preview API

POST /v1/fulfillment/shipments/preview — 선택한 운송사 채널과 입고 소포에 대한 정확한 창고 가격입니다.

먼저 freight estimate를 사용해 shipping_channel_code 옵션을 확인하세요.

요청 본문

{
  "parcel_nos": [
    "CNPKG20260520001",
    "CNPKG20260520002"
  ],
  "receiver": {
    "name": "John Doe",
    "mobile": "+12025550123",
    "email": "john@example.com",
    "country_code": "US",
    "province": "California",
    "city": "Los Angeles",
    "postal_code": "90001",
    "address_line1": "123 Main St",
    "address_line2": "Apt 4B"
  },
  "shipping_channel_code": "DHL-ECONOMY",
  "services": [
    {
      "code": "photo",
      "quantity": 2
    },
    {
      "code": "qc",
      "quantity": 1
    }
  ]
}

선택적 services[] — value-added services를 참고하세요.

응답

{
  "success": true,
  "quote_type": "warehouse",
  "shipping_channel_code": "DHL-ECONOMY",
  "freight": {
    "amount": 8900,
    "currency": "CNY"
  },
  "services": {
    "amount": 1500,
    "currency": "CNY"
  },
  "discount": {
    "amount": 200,
    "currency": "CNY"
  },
  "total": {
    "amount": 10200,
    "currency": "CNY"
  },
  "request_id": "req_..."
}

total = freight + services − discount입니다. create에서 이 값과 맞추세요.