DeCA pour Dolibarr : le document de contrôle du transport, prêt avant le 5 octobre 2026
EasyDocControl génère, émet et publie le DeCA (documento electrónico de control administrativo, document électronique de contrôle administratif espagnol) du transport routier de marchandises en Espagne : PDF natif avec QR, URL HTTPS dans votre propre dépôt, le tout dans Dolibarr.
|
5/10/2026
obligatoire (loi 9/2025)
|
PDF + QR
URL HTTPS dans votre dépôt
|
V14–V24
PHP 7.4 à 8.4
|
8
langues dans l’interface
|
Ce qu’est le DeCA et qui doit l’avoir à bord
Le DeCA est le document électronique de contrôle administratif qui accompagne chaque transport public de marchandises par route en Espagne. Il s’agit d’une règle espagnole : elle découle de la loi espagnole 9/2025 du 3 décembre sur la mobilité durable (Ley 9/2025, de Movilidad Sostenible) et le document est obligatoire à partir du 5 octobre 2026 (huitième disposition transitoire : dix mois après l’entrée en vigueur de la loi). Sa forme est fixée par la résolution du 5 juin 2026 (BOE du 12 juin) et son contenu par l’ordonnance FOM/2861/2012, modifiée par l’ordonnance TRM/282/2026.
Voici ce que demande la résolution et comment EasyDocControl y répond :
| Ce qu’exige la résolution |
Comment le module y répond |
| PDF natif (non scanné) de 5 Mo maximum |
PDF généré par le module lui-même avec TCPDF, plafonné à 5 Mo, sur une seule page |
| QR et URL HTTPS qui télécharge le PDF |
URL unique par document qui ouvre directement le PDF : sans connexion, sans bouton et sans page intermédiaire |
| Dépôt propre et conservation d’un an minimum |
Les documents restent dans votre Dolibarr ; une tâche planifiée les archive (12 mois minimum) sans rien supprimer |
| Remise au conducteur avant le service, sur téléphone ou imprimé avec QR |
Copie par e-mail avec le PDF et le QR, et journal de remise avec destinataire et date |
| Deux voies pour le modifier pendant le service : même URL avec version, ou nouveau PDF |
Les deux : Modifier pendant le service (même URL et même QR, version précédente conservée) et Annuler et remplacer |
| Regroupement d’envois dans un seul document |
Plusieurs expéditions du même chargeur et du même transporteur, chacune identifiée par sa destination et sa marchandise |
| Signature non obligatoire ; si elle a une finalité contractuelle, avancée ou qualifiée |
Signature optionnelle du PDF avec votre propre certificat (PKCS#12), au format CMS/PKCS#7 |
| Données de l’art. 6 de l’ordonnance FOM/2861/2012 |
Champs a)–h) complets et validés à l’émission (NIF, immatriculation, dates, poids) |
EasyDocControl n’est pas un modèle de PDF : c’est le flux complet du DeCA —brouillon, émission, QR, versions, remise au conducteur et conservation— au sein de votre Dolibarr.
NOUVEAUTÉ
Le document se remplit sans saisie, et plusieurs expéditions tiennent dans un seul
Chargeur, transporteur et destinataire se choisissent parmi vos tiers ou votre propre société ; origine et destination parmi leurs adresses, contacts, entrepôts ou les plus utilisées ; la remorque et le conducteur dans votre flotte. Depuis un document de contrôle, un bouton crée la lettre de voiture déjà remplie.
Dans la liste des expéditions ou des commandes de Dolibarr, vous cochez celles qui partent dans le même camion et vous obtenez un seul document, avec la marchandise de chacune et le poids total. Le reste ne change pas : modification en route avec le même QR, remplacement et conducteurs avec passeport.
Ce que vous verrez dans Dolibarr
Captures du module sur Dolibarr 22 avec des données d’exemple.
Tableau de bord : expéditions sans DeCA, documents en route avec leurs immatriculations et état de la configuration.
|
Fiche du DeCA : itinéraire, immatriculations, QR, versions en cours de service et activité du document.
|
Le document sur la route
Le conducteur a le DeCA sur son téléphone ou imprimé avec le QR. L’agent le scanne et le navigateur ouvre directement le PDF, sans connexion. La vue HTML du portail reste disponible pour les personnes (on la demande avec &view=html).
Le PDF du DeCA : les champs de l’article 6 de l’Ordre FOM/2861/2012 et le QR qui ouvre le document dans votre dépôt.
Comparatif face à l’absence de système
| Dimension |
Sans système / papier |
EasyDocControl |
| Conformité |
Modèles épars qui ne couvrent pas les champs a)–h) de l’art. 6 |
Champs a)–h) complets selon l’ordonnance FOM/2861/2012 et l’ordonnance TRM/282/2026 |
| Publication |
PDF par e-mail ou imprimé, sans URL publique vérifiable |
PDF + QR sur HTTPS dans votre propre dépôt |
| Intégrité |
Aucune : n’importe qui peut altérer le document |
CSV interne SHA-256, hash du PDF par version et signature CMS/PKCS#7 en option avec votre certificat |
| Changements en route |
On refait le papier et personne ne sait lequel fait foi |
Versions avec la même URL et le même QR, ou remplacement avec l’original conservé |
| Couverture |
On ignore quels envois sont partis sans document |
Liste des expéditions sans document, avec régime par expédition et alerte quotidienne |
| Intégration |
Recopier les données du bon de livraison ou de l’expédition |
Préremplissage depuis les Expéditions et Commandes de Dolibarr ; API REST propre et ressource EasyAPI |
Comment on l’utilise
Vous créez le DeCA depuis le menu du module ou depuis une expédition, cliquez sur Émettre et le module génère le PDF, le QR avec l’URL publique et le CSV. Vous pouvez aussi émettre par API :
ÉMETTRE UN DOCUMENT, EN UN SEUL APPEL
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"
L’API s’active dans la configuration du module (générez votre X-API-Key) et fournit une spec OpenAPI 3.0 avec Swagger UI. Avec EasyAPI installé, la ressource s’appelle avec votre DOLAPIKEY et apparaît dans le visualiseur.
200 OK — DOCUMENT ÉMIS
{
"id": 4417,
"ref": "DCD-2026-00001",
"status": 1,
"csv": "F291B49597C20CD9D73D419FEFEF8B3E",
"public_url": "https://..."
}
422 — VOUS DIT QUOI CORRIGER
{
"error": "validation_error",
"fields": {
"cargador_nif": "bad check letter"
}
}
Ce qui est inclus
PDF + QR + CSV immuable
Génération native avec TCPDF (inclus dans Dolibarr), hash SHA-256 du PDF, QR avec l’URL publique et CSV interne de vérification. Émettre publie le PDF dans la même opération.
Versions et regroupement
Modification pendant le service avec un PDF par version, remplacement avec lien croisé dans le PDF et regroupement d’expéditions dans un seul document.
Plusieurs points de livraison dans un DeCA
Vous écrivez le voyage à la main et vous ajoutez chaque livraison avec sa marchandise et son adresse de destination, sans monter une commande avec une ligne par article, sans un bon de livraison par point et sans créer un contact par adresse. Le point 6.1 de la Résolution du 5 juin 2026 le permet.
Couverture des expéditions
Chaque envoi déclare sous quel régime il est documenté, et le module vous indique lesquels sont restés sans document, avec classement en lot et export CSV.
Document d’un tiers
Si le DeCA est émis par le transporteur effectif ou par l’agence, vous l’enregistrez avec son lien et une copie archivée, validée comme vrai PDF et non scanné.
Lettre de voiture électronique
Lettre de voiture de la loi espagnole 15/2009 pour chaque envoi de plus de 150 €, avec la signature de l’autre partie par code à usage unique depuis une page publique.
Maîtres de flotte
Véhicules (immatriculation, type, PTAC, autorisation) et conducteurs, nationaux ou étrangers, avec un dictionnaire de 12 types de véhicule éditable.
Portail avec audit
URL publique avec UUID impossible à deviner, sans connexion, avec journal des accès (IP, date, navigateur) et ouverture directe du PDF.
API REST et EasyAPI
Endpoints propres avec X-API-Key (list, create, emit, cancel), OpenAPI 3.0 + Swagger et ressource EasyAPI avec DOLAPIKEY, y compris le combiné from-order.
À quoi cela sert
- Entreprises avec flotte propre qui transportent des marchandises de tiers : elles émettent le DeCA depuis l’expédition elle-même.
- Transporteurs purs (titulaires de la carte de transport) : documents indépendants, sans expédition.
- Opérateurs logistiques, agences et coopératives qui agissent comme intermédiaires et reçoivent parfois le document d’un autre.
- Béton, granulats, fruits, colis lourds : transport routier de toute marchandise.
- Flottes mixtes avec des usines ou des origines différentes, avec des conducteurs nationaux et étrangers : chaque transport génère son document et son QR.
- Transport avec des entreprises d'autres pays : le chargeur, le transporteur ou l'expéditeur peuvent être étrangers. Leur numéro de TVA est accepté avec ou sans code pays, et les véhicules immatriculés à l'étranger entrent aussi dans la flotte.
Mise en route
1
Installez et activez EasyDocControl depuis Modules/Applications. Les tables du module et le sel du CSV sont créés.
2
Configurez l’URL publique HTTPS du dépôt et le préfixe de référence.
3
Enregistrez les véhicules et les conducteurs dans les maîtres du module.
4
Créez le document (ou depuis une expédition) et cliquez sur Émettre : PDF + QR + CSV + URL publique.
Prérequis
| Dolibarr |
14.0 à 24.x (vérifié sur 14.0.5, 18.0.8, 23.0.1 et 24.0.1) |
| PHP |
7.4 à 8.4 |
| Base de données |
MariaDB / MySQL / PostgreSQL |
| Domaine |
HTTPS sur le dépôt (résolution du 5 juin 2026) |
| Dépendances |
PDF et QR avec TCPDF, déjà inclus dans Dolibarr. Composer uniquement si vous activez l’API REST |
Questions fréquentes sur le DeCA
Qu’est-ce que le DeCA et depuis quand est-il obligatoire ?
C’est le document électronique de contrôle administratif du transport public de marchandises par route en Espagne. La loi espagnole 9/2025 le rend obligatoire depuis le 5 octobre 2026. Si votre entreprise transporte, ou fait transporter, ce module règle le document avant cette date.
Quel format exige la résolution ?
Un PDF natif, non scanné, de 5 Mo maximum, avec un QR et une URL HTTPS qui télécharge le PDF depuis votre propre dépôt, conservé au moins un an. Le module génère exactement cela.
Faut-il signer le document ?
Ce n’est pas obligatoire. Si vous le signez avec une finalité contractuelle, la résolution demande une signature avancée ou qualifiée. Le module signe le PDF avec votre certificat au format CMS/PKCS#7 ; ce n’est pas le profil PAdES et il n’y a pas d’horodatage, donc si votre usage contractuel l’exige, vérifiez auprès de votre autorité de certification.
Et s’il faut modifier le document alors que le camion est en route ?
Il y a deux voies et le module offre les deux : modifier en gardant la même URL et le même QR (avec la version précédente conservée) ou annuler et remplacer par un nouveau PDF. Dans les deux cas, avec un motif et une alerte au conducteur.
Ai-je besoin du module Expéditions de Dolibarr ?
Non. Vous pouvez créer des documents depuis le menu Doc Control. L’intégration avec Expéditions et Commandes est optionnelle et n’ajoute que le préremplissage.
Comment le tester sans risquer mes données ?
Installez-le sur une copie de votre Dolibarr et émettez un document de test : le PDF, le QR et le portail public sont générés sur-le-champ. Si quelque chose ne colle pas, écrivez-nous avant d’acheter et nous l’étudions avec vous.
Que comprend l’achat ?
Le module complet avec son code source complet, 365 jours d’accès aux mises à jour et téléchargements depuis Dolistore, et un support par e-mail pour l’installation et la configuration.
Maintenance active
EasyDocControl n’est pas un module publié puis oublié. La version actuelle est la 2.6.5, avec le cycle complet vérifié sur Dolibarr 14.0.5, 18.0.8, 23.0.1 et 24.0.1 (cycle vérifié le 1er oct. 2026) :
- Polyfills de compatibilité (isModEnabled et permissions) pour Dolibarr 14 et 15, sans toucher au core.
- Menus et permissions avec des expressions natives évaluables sur toutes les versions prises en charge.
- Suite de tests : unitaires (PHPUnit, au vert de PHP 7.4 à 8.4), smoke (PowerShell) et E2E (Playwright) inclus dans le paquet.
- Le détail version par version est dans le ChangeLog, accessible depuis l’onglet d’administration du module.
|
5/10
2026, date d’entrée en vigueur de l’obligation
|
V14–V24
Dolibarr compatible
|
8
langues dans l’interface
|
365
jours de mises à jour
|
Le DeCA est-il adapté à votre flotte ?
Racontez-nous votre cas et nous vous dirons si EasyDocControl vous convient — et si ce n’est pas le cas, nous vous le dirons aussi. Nous répondons sur l’installation, la configuration et la conformité réglementaire.
Écrivez-nous à info@easysoft.es