Modelo común
Tu sistema habla logística. Los adaptadores hablan con cada red.
El contrato público evita que tu aplicación dependa de nombres, códigos o particularidades técnicas del transportista.
Tu aplicaciónConexión + artículo + envío
ConectorValida y resuelve equivalencias
AdaptadorTraduce al contrato de la red
Vocabulario esencial
- Cliente
- Empresa que consume el producto. Su identidad se obtiene de la credencial y aísla datos, cuotas y conexiones.
- CarrierConnection
- Contrato operativo de un cliente con un transportista. Contiene la referencia segura a sus credenciales y configuración.
- Artículo canónico
- Código estable ofrecido por SendingBay, por ejemplo 24. Es el modo habitual; algunas conexiones publican códigos propios habilitados para ese contrato.
- Opción canónica
- Servicio adicional estable, como SATURDAY_DELIVERY. La traducción técnica depende de la conexión y el artículo.
- Origin code
- Identificador opcional del origen del cliente. Permite resolver una delegación técnica sin sustituir los datos del remitente.
- Envío
- Operación logística perteneciente a un cliente, creada con idempotencia y conservada con la configuración efectiva utilizada.
Cómo se resuelve un artículo
- IdentidadEl API obtiene el cliente desde la credencial autenticada.
- ConexiónComprueba que pertenece al cliente y está activa.
- ArtículoSegún el sistema de códigos de la conexión, busca la equivalencia canónica o comprueba que el servicio propio esté habilitado.
- PolíticaValida opciones, cobertura, bultos, pesos, dimensiones y datos obligatorios.
- InstantáneaConserva la versión y configuración efectiva antes de llamar a la red.
Remitente y centro de expedición
Tu sistema continúa siendo la fuente maestra de almacenes y remitentes. En cada envío envías los datos completos de sender. Elorigin_code es una referencia opcional para resolver la configuración interna que una red pueda exigir; no reemplaza la dirección.
El envío guarda una instantánea del remitente y de las equivalencias usadas. Así, una modificación posterior del catálogo no cambia el significado de un envío histórico ni de un reintento.