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

label, voucher y grt se sirven como PDF. 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.

Anulación

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