Resumen de fulfillment internacional

/v1/fulfillment/* cubre la logística internacional después de que la mercancía entra en el almacén HIOBuy. Compras domésticas: pedidos de compra.

La app debe usar fulfillment de almacén(autorización del portal). Las apps de autofulfillment reciben 403 FULFILLMENT_MODE_NOT_SUPPORTED.

Unidad monetaria {#monetary-unit}

Las respuestas JSON estándar de las rutas de fulfillment con importes incluyen monetary_unit: "CNY_minor" en el nivel superior. Todos los { amount, currency } usan fen CNY(1 yuan = 100 fen). Véase modelos de respuesta de fulfillment.

Disponibilidad de las API {#availability}

RutaEstado
/v1/fulfillment/inbounds/createLive almacén simple-store en modo almacén; mock en sandbox
/v1/fulfillment/packagesLive almacén packages/index en modo almacén; mock en sandbox
/v1/fulfillment/packages/{package_id}Live almacén packages/detail/{id} en modo almacén; mock en sandbox
/v1/fulfillment/packages/{package_id}/trackingLive almacén packages/logs/{id} en modo almacén; mock en sandbox
/v1/fulfillment/unclaimed-packagesLive lista + reclamación en modo almacén; mock en sandbox
/v1/fulfillment/returnsMock — crear / listar / confirmar / cancelar devoluciones al vendedor
/v1/fulfillment/locationsLive almacén warehouse en modo almacén; mock en sandbox
/v1/fulfillment/value-added-servicesLive almacén services en modo almacén; mock en sandbox
/v1/fulfillment/service-requestsMock — crear / listar / detalle / confirmar
/v1/fulfillment/shipments/{id}/interceptLive almacén shipments/set-exceptional en modo almacén; mock en sandbox
/v1/fulfillment/shipmentsLive almacén shipments/index en modo almacén; mock en sandbox
/v1/fulfillment/shipping/channelsCatálogo de canales live en modo almacén; mock en sandbox
/v1/fulfillment/shipping/quotesCotizaciones live en modo almacén; mock en sandbox
/v1/fulfillment/shipments/*Disponible(HTTP de almacén si está configurado; si no, mock)
/v1/fulfillment/balanceDisponible
/v1/shipments(legado)Obsoleto

Flujo de extremo a extremo {#end-to-end-flow}

  1. Crear pedido de compra → el vendedor envía al almacén
    o aviso de entrada para paquetes que ya controla
  2. Detalle / seguimiento del paquete → mediciones / excepciones / VAS / cronología
    o detalle del pedido → tracking_numbers[] tras la entrada por compra
  3. Canales de envío para capacidades, luego cotizaciones de envío → elija quotes[].channel.code
  4. Crear envío → id / order_sn(PENDING)
  5. Embalaje y medición final en almacén → boxes[], peso / dimensiones / flete finales
  6. Envío listo para pagar(WAIT_PAYMENT)→ véase el detalle; pagar antes devuelve 409 SHIPMENT_NOT_READY_FOR_PAYMENT
  7. Pagar el envío → cargo a la billetera
  8. Lista / detalle → filas ligeras, o cajas / archivos de embalaje / timeline / números de primera y última milla
    Opcional: interceptar para retener un envío WAIT_SHIP / SHIPPED
  9. Seguimiento internacional → eventos de escaneo

¿Es nuevo en el fulfillment de almacén? Siga la guía de pruebas WH-DEV para recorrer el flujo completo, incluido el embalaje y la liquidación.

Empezar la prueba WH-DEV →

Guía de endpoints

TemaRutaDoc
Aviso de entradaPOST .../inbounds/createEntradas
Detalle / seguimiento / no reclamadosGET .../packages/* · unclaimed-packagesPaquetes
DevolucionesPOST/GET .../returns · confirm/cancelDevoluciones
UbicacionesGET .../locationsUbicaciones
Servicios de valor añadidoGET .../value-added-servicesVAS
Solicitudes de servicioPOST/GET .../service-requests · confirmSolicitudes de servicio
Canales de envíoGET .../shipping/channelsCanales de envío
Cotizaciones de envíoPOST .../shipping/quotesCotizaciones de envío
Crear / pagar / cancelar / interceptarPOST .../shipments/create · {id}/pay · {id}/cancel · {id}/interceptEnvíos
Lista de envíosGET .../shipmentsEnvíos · lista
Detalle de envíoGET .../shipments/{id}Envíos · detalle
Seguimiento internacionalGET .../shipments/{id}/trackingSeguimiento
Saldo de billeteraGET /v1/fulfillment/balanceSaldo
Campos de respuesta—Modelos de respuesta
Atributos de artículoGET .../item-attributesCotizaciones de envío

Compras en modo almacén

Las rutas /v1/orders/* no cambian; la pasarela reenvía a HIOBuy. Las API de producto siguen llamando a los marketplaces directamente.

Seguimiento doméstico: trazado logístico del pedido(proxificado en modo almacén).

Diagramas de ciclo de vida {#lifecycle}

Diagramas de estados: Paquetes, Envíos, Devoluciones.

Errores

FULFILLMENT_MODE_NOT_SUPPORTED, SHIPMENT_CREATE_EXCEPTION, SHIPMENT_CREATE_FAILED, PARCEL_NOT_FOUND, EXTERNAL_ORDER_ID_ALREADY_EXISTS, SHIPMENT_NOT_READY_FOR_PAYMENT, SHIPMENT_ALREADY_PAID, INSUFFICIENT_BALANCE, NOT_FOUND(SHIPMENT_NOT_EXISTS), códigos de interceptación(SHIPMENT_NOT_FOUND, SHIPMENT_NOT_INTERCEPTABLE, SHIPMENT_INTERCEPTION_ALREADY_REQUESTED)— véase Errores y Envíos.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support