Tổng quan fulfillment quốc tế
/v1/fulfillment/* bao phủ logistics quốc tế sau khi hàng đã ở trong kho HIOBuy. Mua hàng nội địa: Procurement orders.
Yêu cầu warehouse fulfillment trên app của bạn (Portal authorization). App self-fulfillment nhận 403 FULFILLMENT_MODE_NOT_SUPPORTED.
Khả dụng API {#availability}
| Path | Status |
|---|---|
/v1/fulfillment/shipments/* | Planned — spec ổn định; Gateway rollout đang diễn ra |
/v1/fulfillment/balance | Planned |
/v1/shipments (legacy) | Deprecated |
Luồng đầu cuối {#end-to-end-flow}
- Create procurement order → người bán gửi hàng đến kho
- Order detail →
parcel_nos[]khi nhập kho - Freight estimate → chọn
shipping_channel_code - Shipment preview → giá chính xác
- Create shipment →
shipment_id - Pay shipment → trừ ví
- International tracking
Hướng dẫn endpoint
| Chủ đề | Path | Tài liệu |
|---|---|---|
| Báo giá freight nhanh | POST .../freight/estimate | Freight estimate |
| Báo giá kho chính xác | POST .../preview | Shipment preview |
| Create / pay / cancel / detail | POST .../shipments/* | Shipments |
| Trace quốc tế | POST .../logistics/trace | Tracking |
| Số dư ví | GET /v1/fulfillment/balance | Balance |
| Field phản hồi | — | Fulfillment response models |
| Thuộc tính item | GET .../item-attributes | Freight estimate |
Mua hộ ở chế độ kho
Các path /v1/orders/* không đổi; Gateway chuyển tiếp đến HIOBuy. Product APIs vẫn gọi trực tiếp marketplace.
Domestic trace: order logistics trace (được proxy ở chế độ kho).
Lỗi
FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE — xem Errors.