API ước tính freight quốc tế
POST /v1/fulfillment/shipping/quotes — calculator nhẹ; số tiền chỉ mang tính tham khảo.
Compatibility alias:
POST /v1/fulfillment/shipments/freight/estimate(same behavior; prefer this path for new integrations).
Quotes are indicative. Exact freight is returned when you create a shipment after parcels are inbound.
Estimate so với preview
| shipping/quotes | preview | |
|---|---|---|
| Khi nào | Trước / không có kiện nhập kho | Sau khi kiện ở trong kho |
| Input | Quốc gia/postal + cân nặng/kích thước | parcel_nos[] + receiver đầy đủ + kênh |
| Output | Giá tham khảo quotes[] | Một freight / services / total |
Request body
{
"destination": {
"country_code": "US",
"region": "California",
"postal_code": "90001"
},
"weight_kg": 2.05,
"length_cm": 30,
"width_cm": 20,
"height_cm": 10,
"attributes": [
"general"
]
}weight_kgvà/hoặclength_cm+width_cm+height_cm(ít nhất một)attributes[]tùy chọn (ví dụgeneral,battery)- Không có
parcel_nos, không có địa chỉ đường đầy đủ
Response
quotes[] với shipping_channel_code, shipping_channel_name, freight, total (fen). Tham chiếu field: response models.
Thuộc tính item {#item-attributes}
GET /v1/fulfillment/shipments/item-attributes — mã attributes[] hợp lệ cho estimate (ví dụ general, battery).
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days