Consultar tus empresas
Obtén las empresas a las que tienes acceso y su identificador público para asociar cada transporte con la empresa correspondiente.
API E INTEGRACIONES
Tus datos de transporte, conectados con DecaSimple.
Si ya gestionas los transportes en un ERP, TMS o aplicación propia, puedes usar nuestra API para crear y consultar documentos DeCA desde ese sistema. Tu equipo técnico puede conectar los datos que ya tienes con la emisión del documento.
La API requiere desarrollar una integración. La documentación es pública y puedes consultarla antes de crear una cuenta.
Qué puedes hacer con la API
Crear documentos
Envía los datos del transporte en JSON. Si están completos, se emite el DeCA y recibes el enlace a su PDF. Si faltan datos necesarios, se crea un borrador y la respuesta indica los campos pendientes.
Consultar el archivo
Lista los borradores y la última versión de los documentos emitidos, con filtros y paginación. Puedes consultar periodos de hasta 30 días por petición.
De la primera prueba a la integración
-
1
Prepara el acceso
Crea tu cuenta, verifica tu correo y elige Pro para tu empresa, incluida su prueba de 30 días y genera un token de pruebas en «API e integraciones» del panel. Los colaboradores necesitan acceso a la empresa y permiso expreso para usar su API.
-
2
Prueba en sandbox
Valida los datos y las respuestas sin guardar documentos. Con todos los datos necesarios, recibirás un PDF marcado como PRUEBA. El listado de documentos de este entorno está siempre vacío.
-
3
Activa producción
Utiliza un token de producción y cambia de entorno cuando tu integración esté preparada. La API, incluidas las consultas y el entorno de pruebas, requiere Pro activo en la empresa. Al bajar a Gratis se conserva el archivo en el panel; la API queda restringida. Los documentos emitidos se guardan en su archivo y son documentos reales.
PARA TU EQUIPO TÉCNICO
Una referencia para implementar la conexión.
La documentación detalla los campos, las respuestas y los errores de cada operación. Incluye ejemplos en cURL, JavaScript, PHP, Python, C# y Java, además de la definición OpenAPI descargable.
Antes de enviar documentos
- La autenticación usa un token Bearer distinto para cada entorno. Guarda el secreto en tu servidor; solo se muestra al crearlo.
- Envía JSON y elige respuestas en JSON o XML. La referencia explica la validación de datos y los límites de peticiones.
- Para evitar duplicados en producción, envía un UUID en Idempotency-Key y reutilízalo al reintentar la misma operación. Sin esa clave, comprueba el archivo antes de repetir una respuesta perdida.
- El enlace al PDF de producción permite acceder sin iniciar sesión. Compártelo con los destinatarios previstos.
Conecta tu próximo transporte.
Empieza con tu empresa o contacta con nosotros si tienes dudas sobre la integración.