DeCA para Dolibarr: el documento de control del transporte, listo antes del 5 de octubre de 2026
EasyDocControl genera, emite y publica el DeCA (documento electrónico de control administrativo) del transporte de mercancías por carretera: PDF nativo con QR, URL HTTPS en tu propio repositorio y todo dentro de Dolibarr.
|
5/10/2026
obligatorio (Ley 9/2025)
|
PDF + QR
URL HTTPS en tu repositorio
|
V14–V24
PHP 7.4 a 8.4
|
8
idiomas en la interfaz
|
Qué es el DeCA y quién tiene que llevarlo
El DeCA es el documento electrónico de control administrativo que acompaña a cada transporte público de mercancías por carretera. Lo exige la Ley 9/2025, de 3 de diciembre, de Movilidad Sostenible, y es obligatorio a partir del 5 de octubre de 2026 (disposición transitoria octava: diez meses desde su entrada en vigor). Su forma la fija la Resolución de 5 de junio de 2026 (BOE del 12 de junio) y su contenido, la Orden FOM/2861/2012, modificada por la Orden TRM/282/2026.
Esto es lo que pide la Resolución y cómo lo resuelve EasyDocControl:
| Lo que exige la Resolución |
Cómo lo resuelve el módulo |
| PDF nativo (no escaneado) de 5 MB como máximo |
PDF generado por el propio módulo con TCPDF, con tope de 5 MB, en una sola página |
| QR y URL HTTPS que descarga el PDF |
URL única por documento que abre el PDF directamente: sin login, sin botón y sin página intermedia |
| Repositorio propio y conservación mínima de un año |
Los documentos viven en tu Dolibarr; una tarea programada los archiva (mínimo 12 meses) sin borrar nada |
| Entrega al conductor antes del servicio, en el móvil o impreso con QR |
Copia por correo con el PDF y el QR, y registro de entrega con destinatario y fecha |
| Dos vías para modificarlo durante el servicio: misma URL con versión, o PDF nuevo |
Las dos: Modificar durante el servicio (misma URL y mismo QR, versión anterior conservada) y Anular y sustituir |
| Agrupación de envíos en un solo documento |
Varias expediciones del mismo cargador y transportista, cada una identificada por destino y mercancía |
| Firma no obligatoria; si se firma con finalidad contractual, avanzada o cualificada |
Firma opcional del PDF con tu propio certificado (PKCS#12), en formato CMS/PKCS#7 |
| Datos del art. 6 de la Orden FOM/2861/2012 |
Campos a)–h) completos y validados al emitir (NIF, matrícula, fechas, peso) |
EasyDocControl no es una plantilla de PDF: es el flujo completo del DeCA —borrador, emisión, QR, versiones, entrega al conductor y conservación— dentro de tu Dolibarr.
NOVEDAD
Rellenas el documento sin teclear y metes varios albaranes en uno
Cargador, transportista y destinatario se eligen de tus terceros o de tu propia empresa; origen y destino, de sus direcciones, contactos, almacenes o las más usadas; el remolque y el conductor, de tu flota. Desde un DeCA, un botón crea la carta de porte ya rellena.
En el listado de albaranes o de pedidos de Dolibarr marcas los que van en el mismo camión y sale un solo documento, con la mercancía de cada uno y el peso sumado. Lo de antes sigue: modificación en ruta con el mismo QR, sustitución y conductores con pasaporte.
Así se ve dentro de Dolibarr
Capturas del módulo en Dolibarr 22 con datos de ejemplo.
Panel: envíos sin DeCA, documentos en ruta con sus matrículas y estado de la configuración.
|
Ficha del DeCA: ruta, matrículas, QR, versiones durante el servicio y actividad del documento.
|
El documento en carretera
El conductor lleva el DeCA en el móvil o impreso con el QR. El agente lo escanea y el navegador abre el PDF directamente, sin login. La vista HTML del portal sigue disponible para las personas (se pide con &view=html).
El PDF del DeCA: campos del art. 6 de la Orden FOM/2861/2012 y el QR que abre el documento en tu repositorio.
Comparativa frente a no tener sistema
| Dimensión |
Sin sistema / papel |
EasyDocControl |
| Cumplimiento |
Plantillas sueltas que no cubren los campos a)–h) del art. 6 |
Campos a)–h) completos según la Orden FOM/2861/2012 y la Orden TRM/282/2026 |
| Publicación |
PDF por email o impreso, sin URL pública verificable |
PDF + QR sobre HTTPS en tu propio repositorio |
| Integridad |
Ninguna: cualquiera puede alterar el documento |
CSV interno SHA-256, hash del PDF por versión y firma CMS/PKCS#7 opcional con tu certificado |
| Cambios en ruta |
Se rehace el papel y nadie sabe cuál vale |
Versiones con la misma URL y el mismo QR, o sustitución con el original conservado |
| Cobertura |
No se sabe qué envíos han salido sin documento |
Listado de expediciones sin documento, con régimen por expedición y aviso diario |
| Integración |
Transcribir datos del albarán o de la expedición |
Pre-rellenado desde Expediciones y Pedidos de Dolibarr; API REST propia y recurso EasyAPI |
Así se usa
Creas el DeCA desde el menú del módulo o desde una expedición, pulsas Emitir y el módulo genera el PDF, el QR con la URL pública y el CSV. También puedes emitir por API:
EMITIR UN DOCUMENTO, EN UNA LLAMADA
curl -X POST https://tu-dolibarr.com/custom/easydoccontrol/api/v1/documents/4417/emit \
-H "X-API-Key: tu_clave" \
-H "Content-Type: application/json"
La API se activa en la configuración del módulo (genera tu X-API-Key) y trae spec OpenAPI 3.0 con Swagger UI. Con EasyAPI instalado, el recurso se invoca con tu DOLAPIKEY y aparece en el visor.
200 OK — DOCUMENTO EMITIDO
{
"id": 4417,
"ref": "DCD-2026-00001",
"status": 1,
"csv": "F291B49597C20CD9D73D419FEFEF8B3E",
"public_url": "https://..."
}
422 — TE DICE QUÉ ARREGLAR
{
"error": "validation_error",
"fields": {
"cargador_nif": "bad check letter"
}
}
Qué incluye
PDF + QR + CSV inmutable
Generación nativa con TCPDF (incluido en Dolibarr), hash SHA-256 del PDF, QR con la URL pública y CSV interno de verificación. Emitir publica el PDF en la misma operación.
Versiones y agrupación
Modificación durante el servicio con PDF por versión, sustitución con enlace cruzado en el PDF y agrupación de expediciones en un solo documento.
Varios puntos de entrega en un DeCA
Escribes el viaje a mano y vas añadiendo cada entrega con su mercancía y su dirección de destino, sin montar un pedido con una línea por mercancía, sin un albarán por cada punto y sin dar de alta un contacto por dirección. Lo permite el apartado sexto.1 de la Resolución de 5 de junio de 2026.
Cobertura de expediciones
Cada envío declara con qué régimen se documenta, y el módulo te dice cuáles se han quedado sin documento, con clasificación en bloque y exportación a CSV.
Documento de un tercero
Si el DeCA lo emite el transportista efectivo o la agencia, lo registras con su enlace y una copia archivada, que se valida como PDF real y no escaneado.
Carta de porte electrónica
Carta de porte de la Ley 15/2009 por cada envío de más de 150 €, con la firma de la otra parte por código de un solo uso desde una página pública.
Maestros de flota
Vehículos (matrícula, tipo, MMA, autorización) y conductores, nacionales o extranjeros, con diccionario de 12 tipos de vehículo editable.
Portal con auditoría
URL pública con UUID no adivinable, sin login, con registro de accesos (IP, fecha, navegador) y apertura directa del PDF.
API REST y EasyAPI
Endpoints propios con X-API-Key (list, create, emit, cancel), OpenAPI 3.0 + Swagger y recurso EasyAPI con DOLAPIKEY, incluido el combinado from-order.
Para qué se usa
- Empresas con flota propia que transportan mercancía de terceros: emiten el DeCA desde la propia expedición.
- Transportistas puros (titulares de tarjeta de transporte): documentos independientes, sin expedición.
- Operadores logísticos, agencias y cooperativas que actúan como intermediarios y a veces reciben el documento de otro.
- Hormigón, áridos, fruta, paquetería pesada: transporte por carretera de cualquier mercancía.
- Flotas mixtas con plantas u orígenes distintos, con conductores nacionales y extranjeros: cada transporte genera su documento y su QR.
- Transporte con empresas de otros países: el cargador, el transportista o el expedidor pueden ser extranjeros. Su NIF-IVA vale con o sin código de país, y los vehículos con matrícula extranjera también entran en la flota.
Puesta en marcha
1
Instala y activa EasyDocControl desde Módulos/Aplicaciones. Se crean las tablas del módulo y la sal del CSV.
2
Configura la URL pública HTTPS del repositorio y el prefijo de referencia.
3
Da de alta vehículos y conductores en los maestros del módulo.
4
Crea el documento (o desde una expedición) y pulsa Emitir: PDF + QR + CSV + URL pública.
Requisitos
| Dolibarr |
14.0 a 24.x (verificado en 14.0.5, 18.0.8, 23.0.1 y 24.0.1) |
| PHP |
7.4 a 8.4 |
| Base de datos |
MariaDB / MySQL / PostgreSQL |
| Dominio |
HTTPS en el repositorio (Resolución de 5 de junio de 2026) |
| Dependencias |
PDF y QR con TCPDF, ya incluido en Dolibarr. Composer solo si activas la API REST |
Preguntas frecuentes sobre el DeCA
¿Qué es el DeCA y desde cuándo es obligatorio?
Es el documento electrónico de control administrativo del transporte público de mercancías por carretera. La Ley 9/2025 lo hace obligatorio desde el 5 de octubre de 2026. Si tu empresa transporta, o contrata transporte, este módulo deja el documento resuelto antes de esa fecha.
¿Qué formato exige la Resolución?
PDF nativo, no escaneado, de 5 MB como máximo, con un QR y una URL HTTPS que descarga el PDF desde tu propio repositorio, conservado al menos un año. El módulo genera exactamente eso.
¿Hay que firmar el documento?
No es obligatorio. Si lo firmas con finalidad contractual, la Resolución pide firma avanzada o cualificada. El módulo firma el PDF con tu certificado en formato CMS/PKCS#7; no es el perfil PAdES ni lleva sellado de tiempo, así que si tu uso contractual lo exige, consúltalo con tu certificadora.
¿Y si hay que cambiar el documento con el camión en ruta?
Hay dos vías y el módulo las tiene: modificar manteniendo la misma URL y el mismo QR (con la versión anterior conservada) o anular y sustituir con un PDF nuevo. En ambas, con motivo y aviso al conductor.
¿Necesito el módulo de Expediciones de Dolibarr?
No. Puedes crear documentos desde el menú Doc Control. La integración con Expediciones y Pedidos es opcional y solo añade el pre-rellenado.
¿Cómo lo pruebo sin arriesgar mis datos?
Instálalo en una copia de tu Dolibarr y emite un documento de prueba: el PDF, el QR y el portal público se generan al momento. Si algo no encaja, escríbenos antes de comprar y lo miramos contigo.
¿Qué incluye la compra?
El módulo completo con su código fuente completo, 365 días de acceso a actualizaciones y descargas desde Dolistore, y soporte por correo para instalación y configuración.
Mantenimiento activo
EasyDocControl no es un módulo publicado y olvidado. La versión actual es la 2.6.5, con el ciclo completo verificado contra Dolibarr 14.0.5, 18.0.8, 23.0.1 y 24.0.1 (ciclo verificado el 1-oct-2026):
- Polyfills de compatibilidad (isModEnabled y permisos) para Dolibarr 14 y 15, sin tocar el core.
- Menús y permisos con expresiones nativas evaluables en todas las versiones soportadas.
- Suite de tests: unitarios (PHPUnit, en verde de PHP 7.4 a 8.4), smoke (PowerShell) y E2E (Playwright) incluidos en el paquete.
- El detalle versión a versión está en el ChangeLog, accesible desde la pestaña de administración del módulo.
|
5/10
de 2026, fecha de obligatoriedad
|
V14–V24
Dolibarr compatible
|
8
idiomas en la interfaz
|
365
días de actualizaciones
|
¿Te encaja el DeCA para tu flota?
Cuéntanos tu caso y te decimos si EasyDocControl te sirve — y si no, te lo decimos igual. Respondemos sobre instalación, configuración y cumplimiento normativo.
Escíbenos a info@easysoft.es