Integra creación de envíos, tracking y documentos desde una sola API.
Una API para conectar cuentas de courier, generar guías, rastrearlas y descargar sus documentos. Pensada para que un reintento nunca le cueste un envío duplicado.
Integración disponible con Shalom Pro mediante cuentas autorizadas del cliente.
curl -X POST https://shipping-api.drivenbox.example/v1/shipments \
-H "Authorization: Bearer dbs_test_..." \
-H "Idempotency-Key: drivenbox-order:1234:shipment:1" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "ws_...",
"courier_connection_id": "ccn_...",
"external_reference": "ORDER-1234",
"origin": { "agency_id": "agy_..." },
"destination": { "agency_id": "agy_..." },
"package": {
"product_id": "pkg_caja_pequena",
"quantity": 1, "weight_kg": 1.2,
"height_m": 0.2, "length_m": 0.3, "width_m": 0.2
},
"service": { "mode": "terrestrial", "payer": "sender" },
"declared_content": "Accesorios",
"recipient": {
"document_type": "DNI", "document": "********",
"first_name": "Nombre", "last_name": "Apellido"
}
}'Contrato normalizado y propio: no se expone el formato del courier.
Qué resuelve
Todo lo que aparece aquí está implementado y cubierto por pruebas. Lo que todavía no podemos garantizar no aparece.
Creación de envíos idempotente
Envíe una Idempotency-Key y reintente sin miedo. Cincuenta peticiones simultáneas con la misma clave generan una sola guía, no cincuenta.
Resultados sin confirmar, tratados como tales
Si una creación termina sin respuesta del courier, no la marcamos como fallida. Queda en reconciliación hasta saber si la guía existe, para que su reintento no genere un duplicado.
Sincronización automática de tracking
Consultamos el estado con una frecuencia que se adapta a la fase del envío y le notificamos cuando detectamos un cambio. Sin polling de su parte.
Webhooks firmados
HMAC-SHA256 sobre el cuerpo crudo, con ventana anti-replay e identificador de evento estable para que pueda deduplicar. Reintentos con backoff y bandeja de dead-letter.
Sandbox con modos de fallo reales
Diecinueve escenarios deterministas, incluido el de respuesta perdida tras crear la guía. Ensaye en pruebas lo que normalmente sólo descubriría en producción.
Aislamiento por organización y workspace
Un workspace por e-commerce. Las credenciales del courier se cifran ligadas a su organización, y el acceso cruzado responde “no encontrado”, nunca “prohibido”.
Cómo funciona
De una integración nueva a su primera guía.
Cree un workspace por e-commerce
Una unidad aislada: sus conexiones, envíos y webhooks no se mezclan con los de otra tienda.
Conecte la cuenta del courier
El cliente autoriza su propia cuenta. Las credenciales se cifran ligadas a su organización y no vuelven a mostrarse.
Cotice y cree la guía
Envíe una Idempotency-Key que represente el intento lógico del pedido, no la petición HTTP.
Reciba webhooks firmados
Le avisamos cuando detectamos un cambio de estado. Verifique la firma sobre el cuerpo crudo y deduplique por el identificador de evento.
El detalle que más importa
Si una creación termina sin respuesta confirmada del courier, devolvemos 409 con reason: unknown_outcome. No reintente: la guía puede existir y ser cobrable. Consulte la operación y reconciliamos por usted.
Uso interno y externo, el mismo contrato
Drivenbox consume esta plataforma con las mismas rutas /v1 que cualquier cliente externo. Las únicas diferencias son el tipo de organización, el plan y las cuotas — no hay una segunda API privada, porque dos contratos divergen y uno de los dos queda sin probar.
Planes
Todavía no hay planes publicados. Estamos en acceso anticipado con incorporación manual.
Preguntas frecuentes
¿Esto es una API oficial de Shalom?
Drivenbox Shipping es un servicio independiente. No constituye una API oficial de Shalom ni implica afiliación, autorización o patrocinio por parte de Shalom, salvo que exista un acuerdo escrito que se publique expresamente.
¿Qué cuentas de courier usa?
Las suyas. Usted conecta una cuenta de la que es titular o para la que cuenta con autorización de su titular. No compartimos ni revendemos cuentas.
¿El tracking es en tiempo real?
No. Consultamos el estado de forma automática con una frecuencia que se adapta a la fase del envío, y le notificamos cuando detectamos un cambio. No prometemos tiempo real porque no dependemos de eventos enviados por el courier.
¿Puedo probar sin generar guías reales?
Sí. Las credenciales con prefijo dbs_test_ usan siempre el courier simulado y no pueden generar una guía real ni un cargo.
¿Qué pasa si una creación se queda sin respuesta?
Recibirá un 409 con reason unknown_outcome y un identificador de operación. No reintente: consulte la operación. La plataforma reconcilia contra el courier y le dirá si la guía existe, si no se creó nada, o si hace falta revisión humana.
¿Cuánto cuesta?
Todavía no hay precios publicados. Estamos en acceso anticipado con incorporación manual; escríbanos y evaluamos su caso.