DeCA for Dolibarr: Spain's road freight control document, ready before 5 October 2026
EasyDocControl generates, issues and publishes the DeCA (documento electrónico de control administrativo, Spain's electronic administrative control document) for road freight transport in Spain: native PDF with QR, an HTTPS URL on your own repository, all inside Dolibarr.
|
5 Oct 2026
mandatory (Law 9/2025)
|
PDF + QR
HTTPS URL on your repository
|
V14–V24
PHP 7.4 a 8.4
|
8
interface languages
|
What the DeCA is and who has to carry it
The DeCA (documento electrónico de control administrativo) is the electronic administrative control document that travels with every public road freight transport in Spain. It is required by Law 9/2025 of 3 December on Sustainable Mobility and is mandatory from 5 October 2026 (eighth transitional provision: ten months after the law came into force). Its format is set by the Resolution of 5 June 2026 (published in the BOE, Spain's official gazette, on 12 June) and its content by Order FOM/2861/2012, as amended by Order TRM/282/2026.
Here is what the Resolution asks for and how EasyDocControl covers it:
| What the Resolution requires |
How the module covers it |
| Native (not scanned) PDF, 5 MB maximum |
PDF generated by the module itself with TCPDF, capped at 5 MB, on a single page |
| QR code and an HTTPS URL that downloads the PDF |
One URL per document that opens the PDF directly: no login, no button, no intermediate page |
| Own repository and a minimum retention of one year |
Documents live in your Dolibarr; a scheduled task archives them (12 months minimum) without deleting anything |
| Delivery to the driver before the service, on a phone or printed with the QR |
Copy by email with the PDF and the QR, and a delivery log with recipient and date |
| Two ways to change it during the service: same URL with a new version, or a new PDF |
Both: Modify during service (same URL and same QR, previous version kept) and Cancel and replace |
| Grouping of shipments in a single document |
Several shipments from the same shipper and carrier, each identified by destination and goods |
| Signature not mandatory; if signed for contractual purposes, advanced or qualified |
Optional PDF signature with your own certificate (PKCS#12), in CMS/PKCS#7 format |
| Data required by art. 6 of Order FOM/2861/2012 |
Fields a)–h) complete and validated on issue (tax ID, plate, dates, weight) |
EasyDocControl is not a PDF template: it is the complete DeCA workflow —draft, issuance, QR, versions, delivery to the driver and retention— inside your Dolibarr.
NEW
Fill in the document without typing, and put several shipments in one
Shipper, carrier and consignee are picked from your third parties or your own company; origin and destination from their addresses, contacts, warehouses or the most used ones; trailer and driver from your fleet. From a control document, one button creates the consignment note already filled in.
In the Dolibarr shipment or order list you tick the ones travelling in the same truck and get a single document, with the goods of each one and the total weight. Everything else stays: changes en route with the same QR, replacement and drivers with a passport.
How it looks inside Dolibarr
Screenshots of the module on Dolibarr 22 with sample data.
Dashboard: shipments without a DeCA, documents on the road with their plates, and configuration status.
|
DeCA record: route, plates, QR code, in-service versions and document activity.
|
The document on the road
The driver carries the DeCA on a phone or printed with the QR. The officer scans it and the browser opens the PDF directly, no login. The portal's HTML view is still available for people (request it with &view=html).
The DeCA PDF: the fields of article 6 of Order FOM/2861/2012 and the QR code that opens the document in your repository.
Comparison vs. having no system
| Dimension |
No system / paper |
EasyDocControl |
| Compliance |
Loose templates that do not cover fields a)–h) of art. 6 |
Complete a)–h) fields per Order FOM/2861/2012 and Order TRM/282/2026 |
| Publication |
PDF by email or printed, with no verifiable public URL |
PDF + QR over HTTPS on your own repository |
| Integrity |
None: anyone can alter the document |
Internal SHA-256 CSV, PDF hash per version and optional CMS/PKCS#7 signature with your certificate |
| Changes en route |
The paper is redone and nobody knows which copy is valid |
Versions with the same URL and QR, or replacement with the original kept |
| Coverage |
No way to know which shipments left without a document |
List of shipments without a document, with a regime per shipment and a daily alert |
| Integration |
Retyping data from the delivery note or shipment |
Prefill from Dolibarr Shipments and Orders; own REST API and EasyAPI resource |
How it is used
Create the DeCA from the module menu or from a shipment, click Issue and the module generates the PDF, the QR with the public URL and the CSV. You can also issue it via API:
ISSUE A DOCUMENT IN ONE CALL
curl -X POST https://your-dolibarr.com/custom/easydoccontrol/api/v1/documents/4417/emit \
-H "X-API-Key: your_key" \
-H "Content-Type: application/json"
Enable the API in the module setup (generate your X-API-Key) and get the OpenAPI 3.0 spec with Swagger UI. With EasyAPI installed, the resource is called with your DOLAPIKEY and appears in the viewer.
200 OK — DOCUMENT ISSUED
{
"id": 4417,
"ref": "DCD-2026-00001",
"status": 1,
"csv": "F291B49597C20CD9D73D419FEFEF8B3E",
"public_url": "https://..."
}
422 — TELLS YOU WHAT TO FIX
{
"error": "validation_error",
"fields": {
"cargador_nif": "bad check letter"
}
}
What is included
Immutable PDF + QR + CSV
Native generation with TCPDF (bundled with Dolibarr), SHA-256 hash of the PDF, QR with the public URL and an internal verification CSV. Issuing publishes the PDF in the same operation.
Versions and grouping
Modification during the service with one PDF per version, replacement with a cross-link in the PDF, and grouping of shipments in a single document.
Several delivery points in one DeCA
You write the trip by hand and add each delivery with its goods and its destination address, without building an order with one line per item, without a delivery note per stop and without creating a contact for every address. Section 6.1 of the Resolution of 5 June 2026 allows it.
Shipment coverage
Each shipment declares which regime it is documented under, and the module tells you which ones were left without a document, with bulk classification and CSV export.
Third-party document
If the DeCA is issued by the actual carrier or the agency, you register it with its link and an archived copy, which is validated as a real, non-scanned PDF.
Electronic consignment note
Consignment note under Law 15/2009 for every shipment above 150 €, with the other party's signature by one-time code from a public page.
Fleet masters
Vehicles (plate, type, GVW, authorization) and drivers, Spanish or foreign, with an editable dictionary of 12 vehicle types.
Portal with audit trail
Public URL with an unguessable UUID, no login, an access log (IP, date, browser) and direct opening of the PDF.
REST API and EasyAPI
Own endpoints with X-API-Key (list, create, emit, cancel), OpenAPI 3.0 + Swagger and an EasyAPI resource with DOLAPIKEY, including the combined from-order call.
What it is for
- Companies with their own fleet moving third-party goods: they issue the DeCA straight from the shipment.
- Pure carriers (holders of a transport card): standalone documents, no shipment needed.
- Logistics operators, agencies and cooperatives acting as intermediaries, who sometimes receive the document from someone else.
- Concrete, aggregates, fruit, heavy parcel: road transport of any goods.
- Mixed fleets with different plants or origins and Spanish and foreign drivers: every transport gets its own document and QR.
- Work with companies from other countries: the shipper, the carrier or the consignor can be foreign. Their VAT number is accepted with or without the country code, and foreign-plated vehicles go into the fleet too.
Getting started
1
Install and enable EasyDocControl from Modules/Applications. The module tables and the CSV salt are created.
2
Set the HTTPS public URL of the repository and the reference prefix.
3
Register vehicles and drivers in the module masters.
4
Create the document (or from a shipment) and click Issue: PDF + QR + CSV + public URL.
Requirements
| Dolibarr |
14.0 to 24.x (verified on 14.0.5, 18.0.8, 23.0.1 and 24.0.1) |
| PHP |
7.4 to 8.4 |
| Database |
MariaDB / MySQL / PostgreSQL |
| Domain |
HTTPS on the repository (Resolution of 5 June 2026) |
| Dependencies |
PDF and QR with TCPDF, already bundled with Dolibarr. Composer only if you enable the REST API |
DeCA frequently asked questions
What is the DeCA and since when is it mandatory?
It is the electronic administrative control document for public road freight transport in Spain. Law 9/2025 makes it mandatory from 5 October 2026. If your company transports goods, or hires transport, this module gets the document sorted before that date.
What format does the Resolution require?
A native, non-scanned PDF of 5 MB at most, with a QR code and an HTTPS URL that downloads the PDF from your own repository, kept for at least one year. The module generates exactly that.
Does the document have to be signed?
It is not mandatory. If you sign it for contractual purposes, the Resolution asks for an advanced or qualified signature. The module signs the PDF with your certificate in CMS/PKCS#7 format; it is not the PAdES profile and carries no timestamp, so if your contractual use requires that, check with your certificate provider.
And if the document has to change while the truck is on the road?
There are two routes and the module supports both: modify keeping the same URL and the same QR (with the previous version kept), or cancel and replace with a new PDF. In both cases, with a stated reason and a notice to the driver.
Do I need the Dolibarr Shipments module?
No. You can create documents from the Doc Control menu. The Shipments and Orders integration is optional and only adds prefilling.
How can I test it without risking my data?
Install it on a copy of your Dolibarr and issue a test document: the PDF, the QR and the public portal are generated on the spot. If something does not fit, write to us before buying and we will look at it with you.
What does the purchase include?
The complete module with its full source code, 365 days of access to updates and downloads from Dolistore, and email support for installation and configuration.
Active maintenance
EasyDocControl is not a published-and-forgotten module. The current version is 2.6.5, with the full cycle verified against Dolibarr 14.0.5, 18.0.8, 23.0.1 and 24.0.1 (cycle verified on 1 Oct 2026):
- Compatibility polyfills (isModEnabled and permissions) for Dolibarr 14 and 15, without touching the core.
- Menus and permissions with native expressions that evaluate on every supported version.
- Test suite: unit (PHPUnit, green from PHP 7.4 to 8.4), smoke (PowerShell) and E2E (Playwright) bundled with the package.
- Version-by-version details are in the ChangeLog, reachable from the module admin tab.
|
5 Oct
2026, date it becomes mandatory
|
V14–V24
compatible Dolibarr
|
8
interface languages
|
365
days of updates
|
Does the DeCA fit your fleet?
Tell us your case and we will tell you whether EasyDocControl works for you — and if it does not, we will tell you that too. We answer about installation, configuration and regulatory compliance.
Write to us at info@easysoft.es