国际发货预览 API

POST /v1/fulfillment/shipments/preview — 针对指定承运渠道与入库包裹的仓库精确报价。

建议先使用运费估算获取可选的 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[] — 见增值服务。

响应

{
  "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。