DeCA für Dolibarr: das Kontrolldokument für den Gütertransport, bereit vor dem 5. Oktober 2026
EasyDocControl erzeugt, stellt aus und veröffentlicht das DeCA (documento electrónico de control administrativo, das elektronische Verwaltungskontrolldokument nach spanischem Recht) für den Straßengüterverkehr in Spanien: natives PDF mit QR-Code, HTTPS-URL in Ihrem eigenen Repository, alles innerhalb von Dolibarr.
|
5.10.2026
Pflicht (Gesetz 9/2025)
|
PDF + QR
HTTPS-URL in Ihrem Repository
|
V14–V24
PHP 7.4 bis 8.4
|
8
Sprachen der Oberfläche
|
Was das DeCA ist und wer es mitführen muss
Das DeCA ist das elektronische Verwaltungskontrolldokument, das in Spanien jeden öffentlichen Güterkraftverkehr begleitet. Es wird vom spanischen Gesetz 9/2025 vom 3. Dezember über nachhaltige Mobilität verlangt und ist ab dem 5. Oktober 2026 Pflicht (achte Übergangsbestimmung: zehn Monate nach Inkrafttreten). Seine Form legt die Resolution vom 5. Juni 2026 fest (BOE, das spanische Amtsblatt, vom 12. Juni), seinen Inhalt die Verordnung FOM/2861/2012 in der Fassung der Verordnung TRM/282/2026.
Das verlangt die Resolution und so löst EasyDocControl es:
| Was die Resolution verlangt |
Wie das Modul es löst |
| Natives PDF (nicht gescannt), höchstens 5 MB |
Vom Modul selbst mit TCPDF erzeugtes PDF, auf 5 MB begrenzt, auf einer einzigen Seite |
| QR-Code und HTTPS-URL, über die das PDF heruntergeladen wird |
Eindeutige URL pro Dokument, die das PDF direkt öffnet: ohne Login, ohne Button und ohne Zwischenseite |
| Eigenes Repository und Aufbewahrung von mindestens einem Jahr |
Die Dokumente liegen in Ihrem Dolibarr; ein geplanter Task archiviert sie (mindestens 12 Monate), ohne etwas zu löschen |
| Übergabe an den Fahrer vor dem Transport, auf dem Handy oder ausgedruckt mit QR |
Kopie per E-Mail mit PDF und QR sowie Übergabeprotokoll mit Empfänger und Datum |
| Zwei Wege für Änderungen während des Transports: dieselbe URL mit Version oder ein neues PDF |
Beide: Während des Transports ändern (gleiche URL und gleicher QR, vorherige Version bleibt erhalten) und Stornieren und ersetzen |
| Bündelung von Sendungen in einem Dokument |
Mehrere Versände desselben Verladers und Transportunternehmers, jeder nach Ziel und Ware gekennzeichnet |
| Signatur nicht verpflichtend; bei Signatur zu vertraglichen Zwecken fortgeschritten oder qualifiziert |
Optionale Signatur des PDFs mit Ihrem eigenen Zertifikat (PKCS#12), im Format CMS/PKCS#7 |
| Angaben nach Art. 6 der Verordnung FOM/2861/2012 |
Felder a)–h) vollständig und bei der Ausstellung geprüft (NIF, Kennzeichen, Daten, Gewicht) |
EasyDocControl ist keine PDF-Vorlage, sondern der komplette DeCA-Workflow — Entwurf, Ausstellung, QR, Versionen, Übergabe an den Fahrer und Aufbewahrung — innerhalb Ihres Dolibarr.
NEU
Das Dokument füllt sich ohne Tippen, und mehrere Sendungen passen in eines
Verlader, Frachtführer und Empfänger wählen Sie aus Ihren Geschäftspartnern oder Ihrem eigenen Unternehmen; Herkunft und Ziel aus deren Adressen, Kontakten, Lagern oder den meistgenutzten; Anhänger und Fahrer aus Ihrem Fuhrpark. Aus einem Kontrolldokument erstellt ein Klick den bereits ausgefüllten Frachtbrief.
In der Sendungs- oder Auftragsliste von Dolibarr markieren Sie die, die im selben LKW fahren, und erhalten ein einziges Dokument mit der Ware jeder Sendung und dem Gesamtgewicht. Alles andere bleibt: Änderung unterwegs mit demselben QR, Ersetzung und Fahrer mit Reisepass.
So sieht es in Dolibarr aus
Screenshots des Moduls in Dolibarr 22 mit Beispieldaten.
Übersicht: Sendungen ohne DeCA, Dokumente unterwegs mit Kennzeichen und Status der Konfiguration.
|
DeCA-Datensatz: Route, Kennzeichen, QR-Code, Versionen während der Fahrt und Aktivität des Dokuments.
|
Das Dokument unterwegs
Der Fahrer trägt das DeCA auf dem Handy oder ausgedruckt mit dem QR bei sich. Der Kontrollbeamte scannt ihn, und der Browser öffnet das PDF direkt, ohne Login. Die HTML-Ansicht des Portals bleibt für Menschen verfügbar (Aufruf mit &view=html).
Das DeCA-PDF: die Felder aus Artikel 6 der Order FOM/2861/2012 und der QR-Code, der das Dokument in Ihrem Repository öffnet.
Vergleich mit dem Verzicht auf ein System
| Dimension |
Kein System / Papier |
EasyDocControl |
| Konformität |
Lose Vorlagen, die die Felder a)–h) des Art. 6 nicht abdecken |
Felder a)–h) vollständig nach Verordnung FOM/2861/2012 und Verordnung TRM/282/2026 |
| Veröffentlichung |
PDF per E-Mail oder gedruckt, ohne prüfbare öffentliche URL |
PDF + QR über HTTPS in Ihrem eigenen Repository |
| Integrität |
Keine: Jeder kann das Dokument verändern |
Internes SHA-256-CSV, PDF-Hash je Version und optionale CMS/PKCS#7-Signatur mit Ihrem Zertifikat |
| Änderungen unterwegs |
Das Papier wird neu erstellt und niemand weiß, welches gilt |
Versionen mit derselben URL und demselben QR oder Ersetzung unter Beibehaltung des Originals |
| Abdeckung |
Unklar, welche Sendungen ohne Dokument unterwegs waren |
Liste der Versände ohne Dokument, mit Regime je Versand und täglicher Benachrichtigung |
| Integration |
Daten aus Lieferschein oder Versand abtippen |
Vorausfüllung aus Dolibarr-Versänden und -Aufträgen; eigene REST-API und EasyAPI-Ressource |
So wird es verwendet
Sie erstellen das DeCA über das Modulmenü oder aus einem Versand, klicken auf Ausstellen, und das Modul erzeugt das PDF, den QR mit der öffentlichen URL und das CSV. Sie können auch per API ausstellen:
EIN DOKUMENT IN EINEM AUFRUF AUSSTELLEN
curl -X POST https://ihr-dolibarr.com/custom/easydoccontrol/api/v1/documents/4417/emit \
-H "X-API-Key: ihr_schluessel" \
-H "Content-Type: application/json"
Die API aktivieren Sie in der Modulkonfiguration (dort erzeugen Sie Ihren X-API-Key); sie bringt die Spezifikation OpenAPI 3.0 mit Swagger UI mit. Ist EasyAPI installiert, rufen Sie die Ressource mit Ihrem DOLAPIKEY auf, und sie erscheint im Viewer.
200 OK — DOKUMENT AUSGESTELLT
{
"id": 4417,
"ref": "DCD-2026-00001",
"status": 1,
"csv": "F291B49597C20CD9D73D419FEFEF8B3E",
"public_url": "https://..."
}
422 — SAGT IHNEN, WAS ZU BEHEBEN IST
{
"error": "validation_error",
"fields": {
"cargador_nif": "bad check letter"
}
}
Was enthalten ist
Unveränderliches PDF + QR + CSV
Native Erzeugung mit TCPDF (in Dolibarr enthalten), SHA-256-Hash des PDFs, QR mit der öffentlichen URL und internes Prüf-CSV. Das Ausstellen veröffentlicht das PDF im selben Vorgang.
Versionen und Bündelung
Änderung während des Transports mit eigenem PDF je Version, Ersetzung mit Querverweis im PDF und Bündelung von Versänden in einem Dokument.
Mehrere Lieferpunkte in einem DeCA
Sie schreiben die Fahrt von Hand und fügen jede Lieferung mit ihrer Ware und ihrer Zieladresse hinzu, ohne einen Auftrag mit einer Position je Artikel, ohne einen Lieferschein je Stopp und ohne einen Kontakt je Adresse anzulegen. Abschnitt 6.1 der Resolution vom 5. Juni 2026 erlaubt es.
Abdeckung der Versände
Jede Sendung gibt an, mit welchem Regime sie dokumentiert wird, und das Modul zeigt Ihnen, welche ohne Dokument geblieben sind, mit Massenklassifizierung und CSV-Export.
Dokument eines Dritten
Wird das DeCA vom ausführenden Transportunternehmer oder von der Agentur ausgestellt, erfassen Sie es mit seinem Link und einer archivierten Kopie, die als echtes, nicht gescanntes PDF geprüft wird.
Elektronischer Frachtbrief
Frachtbrief nach dem spanischen Gesetz 15/2009 für jede Sendung über 150 €, mit Signatur der Gegenseite per Einmalcode über eine öffentliche Seite.
Flotten-Stammdaten
Fahrzeuge (Kennzeichen, Typ, zGM, Genehmigung) und Fahrer, inländisch oder ausländisch, mit editierbarem Wörterbuch von 12 Fahrzeugtypen.
Portal mit Audit-Trail
Öffentliche URL mit nicht erratbarer UUID, ohne Login, mit Zugriffsprotokoll (IP, Datum, Browser) und direkter Öffnung des PDFs.
REST-API und EasyAPI
Eigene Endpunkte mit X-API-Key (list, create, emit, cancel), OpenAPI 3.0 + Swagger und EasyAPI-Ressource mit DOLAPIKEY, einschließlich des kombinierten from-order.
Wofür es verwendet wird
- Unternehmen mit eigener Flotte, die Fremdgüter transportieren: Sie stellen das DeCA direkt aus dem Versand aus.
- Reine Transportunternehmer (Inhaber einer Transportkarte): eigenständige Dokumente ohne Versand.
- Logistikdienstleister, Agenturen und Genossenschaften, die als Vermittler auftreten und das Dokument mitunter von einem anderen erhalten.
- Beton, Gesteinskörnungen, Obst, schwere Pakete: Straßentransport jeder Ware.
- Gemischte Flotten mit verschiedenen Werken oder Ursprungsorten und inländischen wie ausländischen Fahrern: Jeder Transport erzeugt sein Dokument und seinen QR.
- Transporte mit Unternehmen aus anderen Ländern: Absender, Frachtführer oder Versender können ausländisch sein. Ihre USt-IdNr. wird mit oder ohne Ländercode akzeptiert, und Fahrzeuge mit ausländischem Kennzeichen kommen ebenfalls in den Fuhrpark.
Erste Schritte
1
Installieren und aktivieren Sie EasyDocControl unter Module/Anwendungen. Die Tabellen des Moduls und das CSV-Salt werden angelegt.
2
Legen Sie die öffentliche HTTPS-URL des Repositorys und das Referenzpräfix fest.
3
Erfassen Sie Fahrzeuge und Fahrer in den Stammdaten des Moduls.
4
Erstellen Sie das Dokument (oder aus einem Versand) und klicken Sie auf Ausstellen: PDF + QR + CSV + öffentliche URL.
Voraussetzungen
| Dolibarr |
14.0 bis 24.x (geprüft auf 14.0.5, 18.0.8, 23.0.1 und 24.0.1) |
| PHP |
7.4 bis 8.4 |
| Datenbank |
MariaDB / MySQL / PostgreSQL |
| Domain |
HTTPS für das Repository (Resolution vom 5. Juni 2026) |
| Abhängigkeiten |
PDF und QR mit TCPDF, bereits in Dolibarr enthalten. Composer nur, wenn Sie die REST-API aktivieren |
Häufige Fragen zum DeCA
Was ist das DeCA und ab wann ist es Pflicht?
Es ist das elektronische Verwaltungskontrolldokument (documento electrónico de control administrativo) für den öffentlichen Güterkraftverkehr in Spanien. Das spanische Gesetz 9/2025 macht es ab dem 5. Oktober 2026 zur Pflicht. Wenn Ihr Unternehmen transportiert oder Transporte beauftragt, erledigt dieses Modul das Dokument vor diesem Datum.
Welches Format verlangt die Resolution?
Ein natives, nicht gescanntes PDF von höchstens 5 MB, mit einem QR und einer HTTPS-URL, über die das PDF aus Ihrem eigenen Repository heruntergeladen wird und das mindestens ein Jahr aufbewahrt wird. Genau das erzeugt das Modul.
Muss das Dokument signiert werden?
Nein, das ist nicht verpflichtend. Signieren Sie es zu vertraglichen Zwecken, verlangt die Resolution eine fortgeschrittene oder qualifizierte Signatur. Das Modul signiert das PDF mit Ihrem Zertifikat im Format CMS/PKCS#7; das ist nicht das PAdES-Profil und enthält keinen Zeitstempel. Verlangt Ihr vertraglicher Einsatz mehr, klären Sie das mit Ihrem Zertifizierungsanbieter.
Und wenn das Dokument geändert werden muss, während der Lkw unterwegs ist?
Es gibt zwei Wege, und das Modul bietet beide: Ändern unter Beibehaltung derselben URL und desselben QR (die vorherige Version bleibt erhalten) oder Stornieren und Ersetzen mit einem neuen PDF. In beiden Fällen mit Begründung und Benachrichtigung des Fahrers.
Brauche ich das Dolibarr-Modul Versand?
Nein. Sie können Dokumente über das Menü Doc Control erstellen. Die Integration mit Versänden und Aufträgen ist optional und fügt nur die Vorausfüllung hinzu.
Wie teste ich es, ohne meine Daten zu riskieren?
Installieren Sie es auf einer Kopie Ihres Dolibarr und stellen Sie ein Testdokument aus: PDF, QR und öffentliches Portal werden sofort erzeugt. Wenn etwas nicht passt, schreiben Sie uns vor dem Kauf, und wir prüfen es gemeinsam mit Ihnen.
Was umfasst der Kauf?
Das komplette Modul mit seinem vollständigen Quellcode, 365 Tage Zugriff auf Updates und Downloads über Dolistore sowie E-Mail-Support für Installation und Konfiguration.
Aktive Wartung
EasyDocControl ist kein Modul, das veröffentlicht und dann vergessen wird. Die aktuelle Version ist 2.6.5, mit dem kompletten Ablauf geprüft gegen Dolibarr 14.0.5, 18.0.8, 23.0.1 und 24.0.1 (Zyklus geprüft am 1. Okt. 2026):
- Kompatibilitäts-Polyfills (isModEnabled und Berechtigungen) für Dolibarr 14 und 15, ohne den Core anzufassen.
- Menüs und Berechtigungen mit nativen Ausdrücken, die in allen unterstützten Versionen ausgewertet werden.
- Test-Suite: Unit-Tests (PHPUnit, grün von PHP 7.4 bis 8.4), Smoke-Tests (PowerShell) und E2E (Playwright) im Paket enthalten.
- Die Details von Version zu Version stehen im ChangeLog, erreichbar über den Admin-Tab des Moduls.
|
5.10.
2026, Stichtag der Pflicht
|
V14–V24
kompatibles Dolibarr
|
8
Sprachen der Oberfläche
|
365
Tage Updates
|
Passt das DeCA zu Ihrer Flotte?
Schildern Sie uns Ihren Fall, und wir sagen Ihnen, ob EasyDocControl für Sie passt — und wenn nicht, sagen wir Ihnen das ebenfalls. Wir antworten zu Installation, Konfiguration und regulatorischer Konformität in Spanien.
Schreiben Sie uns: info@easysoft.es