Trabajar con una cuenta

Conectar un ERP o TMS con la API de DecaDoc

Utiliza el panel de desarrolladores y la documentación técnica para integrar DecaDoc sin exponer secretos ni procesar eventos dos veces.

5 min de lectura

Cómo integrar DecaDoc con un ERP o TMS mediante API y webhooks

Conecta un ERP o TMS mediante claves con permisos mínimos, webhooks firmados y la documentación OpenAPI de DecaDoc.

Antes de empezar

Un plan de DecaDoc que incluya integraciones.
Acceso seguro al servidor del ERP, TMS o sistema que vas a conectar.

Abre Desarrolladores
Consulta en el panel la versión estable, la dirección base y el límite de peticiones aplicable a la integración.
Crea una clave específica
Genera una clave diferente para cada sistema y concede únicamente los permisos necesarios. Para gestionar documentos y accesos del conductor, utiliza el preset «Documentos y portal del conductor». Las claves existentes no reciben los nuevos permisos automáticamente.
Ten en cuentaEl secreto completo se muestra una sola vez. Guárdalo en el servidor como una variable segura; nunca lo incluyas en el navegador ni en el código de una aplicación pública.
Revoca las claves que ya no se utilicen
Elimina el acceso de una integración cuando deje de estar activa para que una credencial antigua no siga funcionando.
Automatiza el portal del conductor
Tu ERP o TMS puede preparar el portal al crear y publicar el DeCA, o para un documento existente. Identifica la ficha por NIF o driverId; el correo es un dato de contacto. Puedes reutilizarla o crearla con nombre y móvil español válido, o preparar el portal sin ficha. La API también permite editar fichas, asignar y desasignar, consultar el enlace, regenerarlo o revocarlo. No crea cuentas ni envía mensajes; tu sistema comparte la URL.
Ver la guía de integración del portal del conductor →
Espera a que el enlace esté disponible
Si el portal está pendiente, la URL todavía no está disponible. Consulta su estado tras el aviso de publicación existente o periódicamente. No hace falta otra orden de activación ni nuevos tipos de webhook. Conserva el mismo requestId y cuerpo al reintentar; una acción nueva lleva un identificador nuevo.
Configura los webhooks
Añade una dirección HTTPS y selecciona los eventos necesarios para recibir avisos cuando un documento se publique, se corrija o cambie de estado.
Verifica cada entrega
Comprueba la firma del webhook y evita procesar dos veces la misma entrega. Sigue la documentación para gestionar errores y reintentos.
Consulta los recursos técnicos
Utiliza los ejemplos, el control de versiones, el contrato OpenAPI y la colección de Postman disponibles en la documentación para desarrolladores.
Prueba antes de pasar a producción
Valida el flujo en un espacio controlado y mantén la versión, los permisos, las claves y los eventos alineados cada vez que cambie la integración.

Listo

La integración queda planteada con credenciales limitadas, webhooks verificables y una versión documentada de la API.

Actualizado el 22 de septiembre de 2026