Resumen de fulfillment internacional
/v1/fulfillment/* cubre la logística internacional después de que los productos estén en el almacén HIOBuy. Compra nacional: Pedidos de compra.
Requiere fulfillment de almacén en tu app (Autorización del portal). Las apps con fulfillment propio reciben 403 FULFILLMENT_MODE_NOT_SUPPORTED.
Disponibilidad de API {#availability}
| Ruta | Estado |
|---|---|
/v1/fulfillment/shipments/* | Planificado: especificación estable; despliegue de Gateway en curso |
/v1/fulfillment/balance | Planificado |
/v1/shipments (legacy) | Obsoleto |
Flujo de extremo a extremo {#end-to-end-flow}
- Crear pedido de compra → el vendedor envía al almacén
- Detalle de pedido →
parcel_nos[]cuando entra - Estimación de flete → elegir
shipping_channel_code - Preview de envío → precio exacto
- Crear envío →
shipment_id - Pagar envío → deducir billetera
- Tracking internacional
Guía de endpoints
| Tema | Ruta | Doc |
|---|---|---|
| Cotización rápida de flete | POST .../freight/estimate | Estimación de flete |
| Cotización exacta de almacén | POST .../preview | Preview de envío |
| Crear / pagar / cancelar / detalle | POST .../shipments/* | Envíos |
| Trazabilidad internacional | POST .../logistics/trace | Tracking |
| Saldo de billetera | GET /v1/fulfillment/balance | Saldo |
| Campos de respuesta | — | Modelos de respuesta de fulfillment |
| Atributos de artículo | GET .../item-attributes | Estimación de flete |
Compras en modo almacén
Las rutas /v1/orders/* no cambian; Gateway reenvía a HIOBuy. Las API de productos siguen llamando directamente a los marketplaces.
Trazabilidad nacional: trazabilidad logística de pedido (proxied en modo almacén).
Errores
FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE; consulta Errores.