Documento de control por API desde tu ERP: datos, flujo y checklist
Cómo emitir el documento de control digital directamente desde tu ERP: qué datos enviar, cómo organizar el flujo y qué probar antes de ir a producción.
Emitir el documento de control por API desde tu ERP evita teclear cada porte dos veces: el ERP ya tiene cargador, transportista, origen, destino, mercancía y fecha, y solo falta generar el PDF nativo con QR que exige la normativa. Este artículo explica qué datos tiene que enviar el sistema, cómo organizar el flujo y qué comprobar antes de dar el desarrollo por bueno. Si todavía trabajas con hojas de cálculo, empieza por cómo crear el DeCA desde Excel.
Cuándo compensa integrar el ERP con el documento de control
Desde el 5 de octubre de 2026 el documento de control debe ser digital (Ley 9/2025, disposición transitoria octava) y debe crearse antes del servicio, con registro de fecha y hora de creación y de cambios (Resolución de 5 de junio de 2026, BOE-A-2026-12784). Con pocos portes al mes, un formulario basta. La integración compensa cuando:
- Emites decenas de portes al día y cada uno ya existe como pedido o albarán en el ERP.
- Varias personas crean portes y quieres que los datos salgan siempre del mismo sitio.
- Necesitas que el estado (creado, entregado al conductor, modificado) vuelva a tu sistema.
Qué datos tiene que enviar el ERP
El contenido mínimo lo fija el artículo 6 de la Orden FOM/2861/2012. Tu ERP tiene que poder aportar, para cada envío:
| Dato del artículo 6 | De dónde suele salir en el ERP |
|---|---|
| Cargador: nombre, NIF y domicilio | Ficha del cliente o de tu empresa |
| Transportista: nombre y NIF | Ficha del proveedor de transporte |
| Origen y destino | Direcciones del pedido o albarán |
| Naturaleza y peso (o medida alternativa) | Líneas del albarán, palets o bultos |
| Fecha | Fecha de expedición |
| Matrícula de tractora y remolque | Asignación del vehículo (a menudo falta en el ERP) |
El dato que más suele faltar es la matrícula, porque se decide tarde. Prevé un paso donde se complete antes de emitir. Cada campo, con ejemplos, está en cómo rellenar el documento de control.
Flujo recomendado: del pedido al conductor
- El ERP confirma el porte y envía los datos a la API del servicio de DeCA.
- El servicio valida NIF, matrículas y campos obligatorios, y devuelve errores claros si algo falta.
- Se genera el PDF nativo con QR y el ERP guarda el identificador y la URL del documento.
- Se entrega al conductor por app, WhatsApp o email.
- Los cambios en ruta (vehículo, palets) se envían como modificaciones, no como un documento nuevo.
- El ERP recibe avisos de cada evento por webhook.
Haz que el ERP no pueda marcar un porte como «salido» si el documento aún no está creado. Es la forma más simple de cumplir la regla de crearlo antes del servicio.
Webhooks y sandbox: probar sin tocar producción
Una buena API de DeCA ofrece un entorno de pruebas (sandbox) para desarrollar con datos ficticios, y webhooks firmados para que tu ERP se entere de los cambios sin consultar cada minuto. La firma permite comprobar que el aviso viene del servicio y no de un tercero: valídala siempre antes de actualizar nada. Plantéate también reintentos: si tu ERP está caído cuando llega un aviso, debe poder recuperarlo después.
Qué hacer con las correcciones y la conservación
Un cambio no debería sobrescribir el documento sin dejar rastro. Lo coherente es que cada modificación cree una versión nueva con campo, valor anterior, valor nuevo, motivo y hora, y que el QR siga descargando la última (cambio de vehículo en ruta). Guarda en el ERP la referencia al documento y conserva el original digital al menos un año (conservación). Lo que se escribe a mano en una copia impresa no cuenta como modificación.
Ejemplo: una distribuidora con Odoo y portes diarios
Ejemplo ficticio. Una distribuidora de bebidas de Zaragoza prepara cada tarde unos 40 pedidos que salen al día siguiente con transportistas contratados. En su ERP, cuando el responsable de logística confirma un pedido y asigna transportista, el sistema envía los datos a la API del servicio de DeCA. Si falta la matrícula, el pedido queda en «pendiente de vehículo» y no se puede marcar como cargado.
El servicio devuelve el identificador y la URL del documento, que el ERP guarda en el pedido. A las siete de la mañana el transportista recibe el enlace por WhatsApp. Si por la mañana cambia el camión, el administrativo edita la matrícula en el ERP y este manda la modificación, no un documento nuevo. El conductor sigue con el mismo QR.
Qué decidir antes de empezar el desarrollo
- Quién es el cargador contractual en cada porte, porque de eso depende qué NIF y domicilio van en el documento y quién responde de cada dato.
- Dónde se guarda la referencia al documento (identificador y URL) para localizarlo en una inspección o una reclamación.
- Cómo se entrega al conductor, sobre todo si es autónomo y no tiene cuenta en tu sistema. Lo explicamos en la página para transportistas.
- Qué pasa con los envíos exentos del artículo 2 (paquetería, envíos de pocos bultos), que no deberían generar documento.
- Quién vigila los errores: una persona concreta que reciba los rechazos de validación cada día.
Conectores, API o carpeta SFTP: cuál elegir
| Situación | Opción razonable |
|---|---|
| ERP propio o con desarrollador disponible | API REST con webhooks |
| Odoo, Holded o Business Central | Conector ya hecho, si el plan lo incluye |
| Sistema antiguo que solo exporta ficheros | Carpeta SFTP o importación de Excel |
| Pocos portes al día | Formulario, sin integrar |
Si trabajas con Odoo, tienes el detalle en documento de control con Odoo, y si usas Dynamics 365, en documento de control con Business Central.
No integres por integrar. Si tu volumen es bajo, el coste de mantener una integración supera al de teclear los datos.
Errores frecuentes al integrar
- Emitir al salir el camión en vez de al confirmar el porte.
- Mandar un PDF propio o un escaneo en lugar de dejar que el servicio genere el PDF nativo con QR (por qué no vale el escaneado).
- No tratar los errores de validación: un NIF mal escrito debe volver al operador, no perderse.
- Crear un documento nuevo por cada cambio, con un QR distinto al que lleva el conductor.
- No comprobar la firma de los webhooks.
- Olvidar quién es el cargador contractual si el ERP lo hace una agencia (quién emite el documento).
Lista de comprobación antes de ir a producción
- Pruebas en sandbox con portes de todos los tipos que haces.
- Los datos del artículo 6 llegan completos o el sistema bloquea la emisión.
- El PDF es nativo, pesa menos de 5 MB y el QR descarga sin login.
- Los cambios generan versión nueva con el mismo QR.
- Los webhooks se verifican y se reintentan.
- Hay una vía manual para los días en que el ERP falle.
Cómo lo resuelve DecaSync
DecaSync ofrece una API REST (OpenAPI 3.1) con webhooks firmados y entorno sandbox desde el plan Pyme. El plan Empresa añade conectores para Odoo, Holded y Business Central y una carpeta SFTP. Valida NIF, matrículas y campos obligatorios, genera el PDF nativo con QR y lo entrega al conductor por app, WhatsApp o email. Cada cambio queda como versión nueva y el QR no cambia. Tienes el detalle en integraciones y los planes en precios. Para agencias con rutas, mira la página para agencias. DecaSync no es una plataforma eFTI certificada y su asistente de cumplimiento es orientativo.
Base normativa: Ley 9/2025 de Movilidad Sostenible, disposición transitoria octava; Resolución de 5 de junio de 2026 (BOE-A-2026-12784); Orden FOM/2861/2012 (BOE-A-2013-154), artículo 6.
Preguntas frecuentes
¿Puedo emitir el documento de control directamente desde mi ERP?
Sí, si el ERP envía los datos del artículo 6 a una API que genere el PDF nativo con QR. El documento debe crearse antes del servicio.
¿Qué datos suele faltar en el ERP?
Con más frecuencia, la matrícula de tractora y remolque, que se decide tarde. Conviene un paso que la complete antes de emitir.
¿Hay que crear un documento nuevo si cambia algo en ruta?
No. Se registra una modificación con campo, valor anterior, valor nuevo, motivo y hora, y el QR sigue descargando la última versión.
¿Para qué sirven los webhooks en esta integración?
Para que el ERP se entere de cada evento (documento creado, entregado, modificado) sin consultar la API continuamente. Hay que verificar su firma.
Sigue leyendo
Documento de control con Holded: cómo emitir el DeCA desde tus albaranes
Si facturas y haces albaranes en Holded, el DeCA digital se puede generar a partir de esos datos sin escribir cada porte dos veces. Qué datos hacen falta, el flujo y los errores habituales.
7 de noviembre de 2026 · 6 min de lectura
Documento de control desde un albarán en PDF o foto: cómo hacerlo bien
Un albarán en PDF o foto puede alimentar el documento de control, pero el DeCA válido es un PDF nativo nuevo con QR. Te contamos qué se lee y qué revisar antes de emitir.
5 de noviembre de 2026 · 6 min de lectura
Documento de control con Business Central: cómo emitir el DeCA desde tu ERP
Si usas Business Central, el DeCA digital se genera desde tus envíos de venta sin duplicar datos. Te contamos qué falta en el ERP, el flujo recomendado y los errores habituales.
2 de noviembre de 2026 · 5 min de lectura