Integra con los campos mínimos: la API resuelve la versión y revisión actuales cuando omites esos controles. No necesitas almacenar todos los metadatos de respuesta. Conserva los identificadores que necesites y el mismo requestId al reintentar; los controles explícitos siguen disponibles para operaciones basadas en una consulta previa.
Integra el DeCA en tu operativa actual
La API REST de DecaDoc permite que un ERP, TMS, WMS o desarrollo propio envíe la información del transporte y gestione el ciclo documental mediante JSON. Así, tráfico y administración siguen trabajando en su sistema habitual mientras DecaDoc se ocupa de generar, publicar, versionar y conservar el PDF con su QR.
La integración resulta especialmente útil cuando los datos de cargadores, transportistas, direcciones, mercancías y vehículos ya existen en otra aplicación y no tiene sentido volver a introducirlos manualmente.
Qué puedes automatizar
- Crear DeCA y guardar borradores desde una orden de transporte.
- Consultar, actualizar, publicar, corregir y archivar documentos.
- Relacionar cada documento con tu identificador interno mediante
externalId. - Gestionar intervinientes y reutilizar datos operativos.
- Crear o reutilizar conductores, asignarlos y gestionar sus enlaces al portal.
- Recibir eventos mediante webhooks cuando cambie el estado de un documento.
- Descargar el PDF publicado y compartirlo con el conductor desde tu propio flujo.
Del documento al conductor desde tu sistema
Prepara el portal del conductor en la misma llamada que crea y publica el DeCA, o sobre un documento existente. Tu sistema puede consultar su URL cuando termine la publicación, regenerar el enlace o revocarlo. La ficha se identifica por NIF o por su identificador; el correo se conserva como contacto. También puedes preparar un portal sin ficha de conductor.
El enlace corresponde a un documento y no crea una cuenta ni envía mensajes automáticamente. Tu ERP o TMS decide cómo compartirlo. Ver la guía del portal del conductor por API →
Diseñada para integraciones fiables
| Capacidad | Para qué sirve |
|---|---|
| API REST y JSON | Intercambio predecible con aplicaciones web, móviles y sistemas de gestión. |
| Claves y permisos | Separar credenciales y limitar las operaciones autorizadas. |
| Idempotencia | Evitar documentos duplicados cuando una petición se reintenta. |
| Webhooks firmados | Verificar el origen de los eventos recibidos por tu sistema. |
| Versionado | Corregir un DeCA manteniendo la trazabilidad exigida. |
| OpenAPI y Postman | Probar los endpoints y acelerar el desarrollo de la integración. |
API o importación: elige el nivel adecuado
Si necesitas sincronización continua y publicación automática, utiliza la API. Para una puesta en marcha más sencilla, DecaDoc también permite trasladar datos de directorios y flota mediante archivos Excel o CSV. Y para las excepciones siempre queda disponible el formulario web.
Disponible desde A tu ritmo
La API y los webhooks tienen el mismo contrato en A tu ritmo e Impulsa. A tu ritmo admite hasta 1.000 publicaciones mediante API al mes, facturadas como publicaciones normales; Impulsa incluye hasta 5.000. Los límites y condiciones vigentes se muestran antes de contratar.
Preguntas frecuentes
¿DecaDoc tiene una API para crear DeCA?
Sí. DecaDoc ofrece una API REST que permite crear, consultar, actualizar, publicar, corregir y archivar documentos desde un ERP, TMS, WMS o desarrollo propio.
¿Puedo obtener el enlace del portal del conductor por API?
Sí. Puedes preparar el portal al crear y publicar el DeCA o sobre un documento existente, y consultar su URL cuando esté disponible. La API también permite gestionar fichas y asignaciones, regenerar el enlace y revocarlo. Necesitas las funciones API y portal del plan y los permisos correspondientes en la clave.
¿La integración dispone de webhooks?
Sí. Los webhooks permiten recibir eventos de la aplicación y verificar su procedencia mediante firma.
¿Puedo evitar duplicados si reintento una petición?
Sí. La API admite idempotencia para que un reintento controlado no genere documentos duplicados.
¿Hay documentación OpenAPI y Postman?
Sí. La documentación para desarrolladores incluye una especificación OpenAPI y una colección de Postman para explorar y probar la integración.