Integraciones y ERP

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.

Documento de control por API desde tu ERP: datos, flujo y checklist

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 6De dónde suele salir en el ERP
Cargador: nombre, NIF y domicilioFicha del cliente o de tu empresa
Transportista: nombre y NIFFicha del proveedor de transporte
Origen y destinoDirecciones del pedido o albarán
Naturaleza y peso (o medida alternativa)Líneas del albarán, palets o bultos
FechaFecha de expedición
Matrícula de tractora y remolqueAsignació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

  1. El ERP confirma el porte y envía los datos a la API del servicio de DeCA.
  2. El servicio valida NIF, matrículas y campos obligatorios, y devuelve errores claros si algo falta.
  3. Se genera el PDF nativo con QR y el ERP guarda el identificador y la URL del documento.
  4. Se entrega al conductor por app, WhatsApp o email.
  5. Los cambios en ruta (vehículo, palets) se envían como modificaciones, no como un documento nuevo.
  6. 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ónOpción razonable
ERP propio o con desarrollador disponibleAPI REST con webhooks
Odoo, Holded o Business CentralConector ya hecho, si el plan lo incluye
Sistema antiguo que solo exporta ficherosCarpeta SFTP o importación de Excel
Pocos portes al díaFormulario, 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

  1. Pruebas en sandbox con portes de todos los tipos que haces.
  2. Los datos del artículo 6 llegan completos o el sistema bloquea la emisión.
  3. El PDF es nativo, pesa menos de 5 MB y el QR descarga sin login.
  4. Los cambios generan versión nueva con el mismo QR.
  5. Los webhooks se verifican y se reintentan.
  6. 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.

¿Emites DeCA a diario? DecaSync genera el documento de control en PDF con QR, lo manda al conductor y guarda cada versión. Pruébalo con 10 envíos gratis o mira los precios.

Emite tu primer DeCA electrónico hoy

PDF con QR para la inspección, versiones con historial y app del conductor. 10 envíos gratis, sin tarjeta.

Crear cuenta gratis Ver precios

WhatsApp