Envíos

Cotizar, crear, anular y descargar documentos.

Referencias a su sistema

Dos campos opacos que nunca interpretamos ni resolvemos contra su base de datos:

external_reference — su id de pedido. Único por workspace.
external_tenant_reference — su id de tienda.

Estados normalizados

Vocabulario propio, no el del courier. Así no tiene que aprender la terminología de cada transportista ni reescribir su código si añadimos otro.

unknown no es un error: significa que el resultado upstream no pudo confirmarse y está en reconciliación. No cambie el estado del pedido cuando lo reciba.

Documentos

El rótulo y el ticket son documentos distintos. Haga proxy desde su backend en lugar de exponer la clave al navegador. Un 409 significa que el documento aún no existe; reintente más tarde.

label — el rótulo: la etiqueta que se pega al paquete. Está disponible desde que se crea la guía, sin esperar el pago.
voucher — el ticket de la orden (Ticket_OS_<orden>_<fecha>.pdf): comprobante con remitente, destinatario, paquete y total. Pídalo al recibir shipment.paid; si Shalom aún no lo tiene responde 409.
grt — guía de remisión: no disponible (501).

Anulación

Sólo mientras el courier lo permita. Si el paquete ya se movió, responde 409 y el envío queda intacto.