DeCA per Dolibarr: il documento di controllo del trasporto, pronto prima del 5 ottobre 2026
EasyDocControl genera, emette e pubblica il DeCA (documento electrónico de control administrativo, il documento elettronico di controllo amministrativo spagnolo) del trasporto di merci su strada in Spagna: PDF nativo con QR, URL HTTPS nel tuo repository e tutto dentro Dolibarr.
|
5/10/2026
obbligatorio (legge spagnola 9/2025)
|
PDF + QR
URL HTTPS nel tuo repository
|
V14–V24
PHP 7.4 a 8.4
|
8
lingue nell’interfaccia
|
Cos’è il DeCA e chi deve portarlo
Il DeCA è il documento elettronico di controllo amministrativo che accompagna ogni trasporto pubblico di merci su strada in Spagna. Lo richiede la legge spagnola 9/2025, del 3 dicembre, sulla Mobilità Sostenibile ed è obbligatorio a partire dal 5 ottobre 2026 (disposizione transitoria ottava: dieci mesi dall’entrata in vigore). La sua forma è fissata dalla Risoluzione del 5 giugno 2026 (pubblicata sulla Gazzetta ufficiale spagnola, BOE, il 12 giugno) e il suo contenuto dall’ordinanza FOM/2861/2012, modificata dall’ordinanza TRM/282/2026.
Ecco cosa richiede la Risoluzione e come lo risolve EasyDocControl:
| Cosa richiede la Risoluzione |
Come lo risolve il modulo |
| PDF nativo (non scansionato) di 5 MB al massimo |
PDF generato dal modulo stesso con TCPDF, con limite di 5 MB, in una sola pagina |
| QR e URL HTTPS che scarica il PDF |
URL unica per documento che apre direttamente il PDF: senza login, senza pulsante e senza pagina intermedia |
| Repository proprio e conservazione minima di un anno |
I documenti restano nel tuo Dolibarr; un’attività pianificata li archivia (minimo 12 mesi) senza cancellare nulla |
| Consegna all’autista prima del servizio, sul telefono o stampato con QR |
Copia via email con il PDF e il QR, e registro di consegna con destinatario e data |
| Due modi per modificarlo durante il servizio: stessa URL con versione, oppure PDF nuovo |
Entrambi: Modificare durante il servizio (stessa URL e stesso QR, versione precedente conservata) e Annullare e sostituire |
| Raggruppamento di più spedizioni in un solo documento |
Più spedizioni dello stesso caricatore e vettore, ciascuna identificata da destinazione e merce |
| Firma non obbligatoria; se si firma con finalità contrattuale, avanzata o qualificata |
Firma opzionale del PDF con il tuo certificato (PKCS#12), in formato CMS/PKCS#7 |
| Dati dell’art. 6 dell’ordinanza FOM/2861/2012 |
Campi a)–h) completi e validati all’emissione (NIF, targa, date, peso) |
EasyDocControl non è un modello di PDF: è il flusso completo del DeCA —bozza, emissione, QR, versioni, consegna all’autista e conservazione— dentro il tuo Dolibarr.
NOVITÀ
Il documento si compila senza digitare e più spedizioni stanno in uno solo
Caricatore, vettore e destinatario si scelgono tra i tuoi soggetti terzi o la tua azienda; origine e destinazione tra i loro indirizzi, contatti, magazzini o i più usati; rimorchio e conducente dalla tua flotta. Da un documento di controllo, un pulsante crea la lettera di vettura già compilata.
Nell'elenco delle spedizioni o degli ordini di Dolibarr selezioni quelle che viaggiano sullo stesso camion e ottieni un solo documento, con la merce di ognuna e il peso totale. Il resto rimane: modifica in viaggio con lo stesso QR, sostituzione e conducenti con passaporto.
Come appare dentro Dolibarr
Schermate del modulo su Dolibarr 22 con dati di esempio.
Cruscotto: spedizioni senza DeCA, documenti in viaggio con le targhe e stato della configurazione.
|
Scheda del DeCA: percorso, targhe, QR, versioni durante il servizio e attività del documento.
|
Il documento in strada
L’autista porta il DeCA sul telefono o stampato con il QR. L’agente lo scansiona e il browser apre direttamente il PDF, senza login. La vista HTML del portale resta disponibile per le persone (si richiede con &view=html).
Il PDF del DeCA: i campi dell’articolo 6 dell’Ordine FOM/2861/2012 e il QR che apre il documento nel tuo repository.
Confronto con l’assenza di un sistema
| Dimensione |
Nessun sistema / carta |
EasyDocControl |
| Conformità |
Modelli sparsi che non coprono i campi a)–h) dell’art. 6 |
Campi a)–h) completi secondo l’ordinanza FOM/2861/2012 e l’ordinanza TRM/282/2026 |
| Pubblicazione |
PDF via email o stampato, senza URL pubblica verificabile |
PDF + QR su HTTPS nel tuo repository |
| Integrità |
Nessuna: chiunque può alterare il documento |
CSV interno SHA-256, hash del PDF per versione e firma CMS/PKCS#7 opzionale con il tuo certificato |
| Modifiche in viaggio |
Si rifà il cartaceo e nessuno sa quale sia valido |
Versioni con la stessa URL e lo stesso QR, oppure sostituzione con originale conservato |
| Copertura |
Non si sa quali spedizioni sono partite senza documento |
Elenco delle spedizioni senza documento, con regime per spedizione e avviso giornaliero |
| Integrazione |
Trascrivere i dati dalla bolla o dalla spedizione |
Precompilazione da Spedizioni e Ordini di Dolibarr; API REST propria e risorsa EasyAPI |
Come si usa
Crei il DeCA dal menu del modulo o da una spedizione, clicchi su Emettere e il modulo genera il PDF, il QR con l’URL pubblica e il CSV. Puoi anche emettere via API:
EMETTERE UN DOCUMENTO, IN UNA CHIAMATA
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"
Attivi l’API nella configurazione del modulo (genera la tua X-API-Key) e ottieni la spec OpenAPI 3.0 con Swagger UI. Con EasyAPI installato, la risorsa si invoca con la tua DOLAPIKEY e compare nel visualizzatore.
200 OK — DOCUMENTO EMITIDO
{
"id": 4417,
"ref": "DCD-2026-00001",
"status": 1,
"csv": "F291B49597C20CD9D73D419FEFEF8B3E",
"public_url": "https://..."
}
422 — TI DICE COSA CORREGGERE
{
"error": "validation_error",
"fields": {
"cargador_nif": "bad check letter"
}
}
Cosa include
PDF + QR + CSV immutabile
Generazione nativa con TCPDF (incluso in Dolibarr), hash SHA-256 del PDF, QR con l’URL pubblica e CSV interno di verifica. Emettere pubblica il PDF nella stessa operazione.
Versioni e raggruppamento
Modifica durante il servizio con un PDF per versione, sostituzione con collegamento incrociato nel PDF e raggruppamento di spedizioni in un solo documento.
Più punti di consegna in un DeCA
Scrivi il viaggio a mano e aggiungi ogni consegna con la sua merce e il suo indirizzo di destinazione, senza creare un ordine con una riga per articolo, senza un documento di trasporto per ogni punto e senza creare un contatto per ogni indirizzo. Lo consente il punto 6.1 della Risoluzione del 5 giugno 2026.
Copertura delle spedizioni
Ogni spedizione dichiara con quale regime viene documentata, e il modulo ti dice quali sono rimaste senza documento, con classificazione in blocco ed esportazione in CSV.
Documento di un terzo
Se il DeCA lo emette il vettore effettivo o l’agenzia, lo registri con il suo link e una copia archiviata, che viene validata come PDF reale e non scansionato.
Lettera di vettura elettronica
Lettera di vettura della legge spagnola 15/2009 per ogni spedizione di oltre 150 €, con la firma dell’altra parte tramite codice monouso da una pagina pubblica.
Anagrafiche della flotta
Veicoli (targa, tipo, MMA, autorizzazione) e autisti, nazionali o stranieri, con dizionario modificabile di 12 tipi di veicolo.
Portale con audit
URL pubblica con UUID non indovinabile, senza login, con registro degli accessi (IP, data, browser) e apertura diretta del PDF.
API REST ed EasyAPI
Endpoint propri con X-API-Key (list, create, emit, cancel), OpenAPI 3.0 + Swagger e risorsa EasyAPI con DOLAPIKEY, compreso il combinato from-order.
A cosa serve
- Aziende con flotta propria che trasportano merce di terzi: emettono il DeCA direttamente dalla spedizione.
- Vettori puri (titolari di tessera di trasporto): documenti indipendenti, senza spedizione.
- Operatori logistici, agenzie e cooperative che agiscono da intermediari e a volte ricevono il documento di un altro.
- Calcestruzzo, inerti, frutta, collettame pesante: trasporto su strada di qualsiasi merce.
- Flotte miste con stabilimenti o origini diversi, con autisti nazionali e stranieri: ogni trasporto genera il suo documento e il suo QR.
- Trasporti con aziende di altri paesi: il caricatore, il vettore o lo speditore possono essere stranieri. La loro partita IVA è accettata con o senza codice paese, e anche i veicoli con targa estera entrano nella flotta.
Messa in servizio
1
Installa e attiva EasyDocControl da Moduli/Applicazioni. Vengono create le tabelle del modulo e il salt del CSV.
2
Configura l’URL pubblica HTTPS del repository e il prefisso dei riferimenti.
3
Registra veicoli e autisti nelle anagrafiche del modulo.
4
Crea il documento (o da una spedizione) e clicca su Emettere: PDF + QR + CSV + URL pubblica.
Requisiti
| Dolibarr |
14.0 a 24.x (verificato su 14.0.5, 18.0.8, 23.0.1 e 24.0.1) |
| PHP |
7.4 a 8.4 |
| Database |
MariaDB / MySQL / PostgreSQL |
| Dominio |
HTTPS sul repository (Risoluzione del 5 giugno 2026) |
| Dipendenze |
PDF e QR con TCPDF, già incluso in Dolibarr. Composer solo se attivi l’API REST |
Domande frequenti sul DeCA
Cos’è il DeCA e da quando è obbligatorio?
È il documento elettronico di controllo amministrativo del trasporto pubblico di merci su strada in Spagna. La legge spagnola 9/2025 lo rende obbligatorio dal 5 ottobre 2026. Se la tua azienda trasporta, o affida trasporti, in Spagna, questo modulo ti lascia il documento risolto prima di quella data.
Che formato richiede la Risoluzione?
PDF nativo, non scansionato, di 5 MB al massimo, con un QR e una URL HTTPS che scarica il PDF dal tuo repository, conservato per almeno un anno. Il modulo genera esattamente questo.
Il documento va firmato?
Non è obbligatorio. Se lo firmi con finalità contrattuale, la Risoluzione richiede una firma avanzata o qualificata. Il modulo firma il PDF con il tuo certificato in formato CMS/PKCS#7; non è il profilo PAdES e non include la marca temporale, quindi se il tuo uso contrattuale lo richiede, verificalo con la tua autorità di certificazione.
E se bisogna cambiare il documento con il camion in viaggio?
Ci sono due strade e il modulo le prevede entrambe: modificare mantenendo la stessa URL e lo stesso QR (con la versione precedente conservata) oppure annullare e sostituire con un PDF nuovo. In entrambi i casi, con motivo e avviso all’autista.
Mi serve il modulo Spedizioni di Dolibarr?
No. Puoi creare documenti dal menu Doc Control. L’integrazione con Spedizioni e Ordini è opzionale e aggiunge solo la precompilazione.
Come lo provo senza rischiare i miei dati?
Installalo su una copia del tuo Dolibarr ed emetti un documento di prova: PDF, QR e portale pubblico vengono generati all’istante. Se qualcosa non torna, scrivici prima di acquistare e lo valutiamo insieme.
Cosa comprende l’acquisto?
Il modulo completo con il suo codice sorgente completo, 365 giorni di accesso agli aggiornamenti e download da Dolistore, più supporto via email per installazione e configurazione.
Manutenzione attiva
EasyDocControl non è un modulo pubblicato e dimenticato. La versione attuale è la 2.6.5, con il ciclo completo verificato su Dolibarr 14.0.5, 18.0.8, 23.0.1 e 24.0.1 (ciclo verificato il 1 ott 2026):
- Polyfill di compatibilità (isModEnabled e permessi) per Dolibarr 14 e 15, senza toccare il core.
- Menu e permessi con espressioni native valutabili su tutte le versioni supportate.
- Suite di test: unitari (PHPUnit, in verde da PHP 7.4 a 8.4), smoke (PowerShell) ed E2E (Playwright) inclusi nel pacchetto.
- Il dettaglio versione per versione è nel ChangeLog, raggiungibile dalla scheda di amministrazione del modulo.
|
5/10
del 2026, data di entrata in obbligo
|
V14–V24
Dolibarr compatibile
|
8
lingue nell’interfaccia
|
365
giorni di aggiornamenti
|
Il DeCA fa al caso della tua flotta?
Raccontaci il tuo caso e ti diciamo se EasyDocControl fa per te — e se non va bene, te lo diciamo lo stesso. Rispondiamo su installazione, configurazione e conformità normativa.
Scrivici a info@easysoft.es