International shipment preview API

POST /v1/fulfillment/shipments/preview — exact warehouse pricing for a chosen carrier channel and inbound parcels.

Use freight estimate first to discover shipping_channel_code options.

Request body

{
  "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
    }
  ]
}

Optional services[] — see value-added services.

Response

{
  "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. Match this on create.