国際配送プレビュー 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 でこの金額と一致させます。