DATEV-Schnittstelle für Odoo 18, 19 und 20: Architektur & Praxis-Guide

Odoo Enterprise liefert eine starke deutsche Lokalisierung für SKR03 und SKR04 – im laufenden Monatsabschluss mit der Steuerkanzlei reicht der eingebaute CSV-Export jedoch selten aus. Dieser Praxis-Guide zeigt, wo der Standard endet und wie eine belastbare Odoo-DATEV-Architektur mit datev_export, datev_online, SmartLogin und Kanzlei-Rückkanal funktioniert.

Veröffentlicht
19. November 2026
Lesezeit
8 Min. Lesezeit
Themenbereich
Odoo 18/19/20 · DATEV & MATE Hub
Gliederung anzeigen (9 Abschnitte)
  1. Warum der Odoo-Standard allein oft nicht reicht
  2. Odoo-Standard vs. Drittmodul vs. MATE Hub
  3. Architektur: datev_export, datev_online & SmartLogin
  4. Belegbild-Transfer, BEDI-GUID & DuoNext-Schutz
  5. Multi-Company, OSS & Steuerschlüssel in Odoo
  6. Rückkanal: Kontoblattbuchungen (DV-IN), OPOS & SuSa
  7. Praxis-Checkliste für Odoo 18, 19 und 20
  8. Nächster Schritt
  9. Häufige Fragen

Warum der Odoo-Standard allein oft nicht reicht

Wer Odoo im deutschsprachigen Mittelstand einführt, entdeckt zunächst das Lokalisierungsmodul l10n_de inklusive SKR03/SKR04 und einem eingebauten DATEV-CSV-Export. In der Demo wirkt das ausreichend – im realen Monatsabschluss zeigen sich jedoch rasch fünf strukturelle Lücken:

  • Kein direkter API-Versand an DATEV: Der Standard erzeugt Dateien zum manuellen Herunterladen. Jede Übergabe per E-Mail, Portal-Upload oder USB-Stick schafft Medienbrüche und erhöht die Gefahr von Doppel- oder Teil-Exporten.
  • Fehlende Belegbild-Verknüpfung (BEDI-GUID): Ohne direkten Belegbilderservice-Upload fehlt im EXTF-Buchungssatz der Beleglink zu DATEV Unternehmen online. Die Kanzlei muss Rechnungs-PDFs getrennt zuordnen.
  • Kein Kanzlei-Rückkanal: Lohnbuchungen, Abschreibungen, Steuerabgrenzungen und Korrekturen aus DATEV Kanzlei-Rechnungswesen fließen nicht zurück in Odoo. Interne Auswertungen und Kanzlei-SuSa driften auseinander.
  • Brüchige Personenkonten-Logik im Detail: Gerade bei gemischten B2B-/B2C-Geschäften, Teilzahlungen, Anzahlungsrechnungen oder Multi-Company-Datenbanken braucht es eindeutige, gesperrte Nummernkreise statt ad-hoc generierter Partner-IDs.
  • Upgrade-Risiko bei unstrukturierten Anpassungen: Wer den DATEV-Export mit punktuellen Hacks in Odoo 18 zusammenbaut, kämpft beim Sprung auf Odoo 19 oder Odoo 20 mit Datenmigration und fehlerhaften Steuerschlüsseln.

Odoo-Standard vs. Drittmodul vs. MATE Hub

Je nach Belegvolumen, Gesellschaftsstruktur und Zusammenarbeit mit der Steuerkanzlei kommen in Odoo drei Ausbaustufen infrage:

Kriterium Odoo-Standard (l10n_de) Reiner Datei-/EXTF-Export MATE Hub (datev_export + datev_online)
Buchungsstapel (EXTF) Basis-CSV zum Download Prüfbarer EXTF inkl. Stammdaten & Sperrlogik Direktversand via accounting:extf-files + GoBD-Protokoll
Belegbilder (PDF) Getrennte manuelle Übergabe ZIP-Paket, manuell hochzuladen API-Upload ≤ 20 MB mit BEDI-GUID & DuoNext-Erkennung
Authentifizierung Keine DATEV-API Keine DATEV-API OAuth direkt über login.datev.de (SmartLogin / SmartCard)
Rückkanal (SuSa / Kontoblatt) Nicht vorhanden Manueller Import / Excel-Abgleich Dedupliziert ins Journal DV-IN + SuSa-Abweichungsklärung
Multi-Company Begrenzte Trennung Mandantenbezogene Exportprofile Saubere Trennung je Gesellschaft (Instanz-Key oder X-Odoo-Company-Ref)

Architektur: datev_export, datev_online & SmartLogin

Unsere DATEV-Architektur für Odoo 19 und Odoo 20 trennt bewusst die fachliche Buchhaltungslogik von der DATEV-API-Transportebene:

  1. datev_export in Odoo: Erzeugt normierte, prüfbare EXTF-Buchungsstapel sowie Debitoren- und Kreditoren-Stammdaten direkt aus gebuchten Odoo-Belegen. Beraternummer, Mandantennummer, 4-stellige Sachkontenlänge, SKR03/SKR04-Automatikkonten und das GoBD-Exportprotokoll verbleiben vollständig in Ihrer Odoo-Datenbank.
  2. datev_online + MATE Hub: Übernimmt die sichere OAuth- und Transportstrecke zu den offiziellen DATEV-Datenservices. Die Freigabe erfolgt einmalig direkt auf login.datev.de per SmartLogin oder SmartCard – weder Odoo noch der MATE Hub sehen jemals Passwort oder PIN.
  3. Sicherheits- und Störungs-Resilienz: Tokens liegen verschlüsselt im AES-256-GCM-Vault. Jede EXTF-Datei und jedes Beleg-PDF durchläuft vor Übergabe an DATEV einen fail-closed ClamAV-Virenscan. Bei DATEV-Wartungsfenstern zeigt das Cockpit ein klares Statusbanner, während offene Jobs mit Retry-After-Backoff automatisch nachgeholt werden.

Fehlt auf Mandantenseite ein ausgewählter Datenservice (etwa der Belegbilderservice oder der Rückkanal), erkennt der Hub dies direkt beim Scope-Abgleich, widerruft fehlerhafte Tokens sauber und nennt exakt die fehlende DATEV-Freischaltung für die Kanzlei.

Belegbild-Transfer, BEDI-GUID & DuoNext-Schutz

In der Kanzleipraxis zählt, dass Ausgangs- und Eingangsrechnungen nicht nur als Zahlenzeile ankommen, sondern direkt mit dem prüfbaren PDF-Dokument verbunden sind. Genau hier lösen datev_online und der DATEV-Belegbilderservice (accounting:documents) den klassischen Engpass:

  • Stabile BEDI-GUID pro Beleg: Beim Upload des Rechnungs-PDFs (bis 20 MB) wird die eindeutige BEDI-GUID gespeichert und in das Beleglink-Feld der EXTF-Buchung geschrieben.
  • Automatische DuoNext-Erkennung: Über GET duo-version prüft das Modul, ob beim Mandanten noch DuoNow oder bereits DuoNext aktiv ist. So wird verhindert, dass hochgeladene Eingangsrechnungen vorzeitig als „gebucht“ markiert und aus der Arbeitsliste der Kanzlei ausgeblendet werden.
  • Rollentrennung im Cockpit: System-Administratoren verwalten Zugänge, Buchhaltungs-Manager konfigurieren Konten-Mappings und Buchhalter führen geprüfte Exporte sowie den Belegupload mit vollständiger Protokollierung aus.

Multi-Company, OSS & Steuerschlüssel in Odoo

Gerade wachsende Mittelständler mit mehreren Gesellschaften (z. B. Betriebs-GmbH, Vertriebsgesellschaft, Auslands-Tochter) oder EU-weitem E-Commerce profitieren von Odoos Multi-Company-Fähigkeit – sofern drei Detailfragen sauber gelöst werden:

Anforderung in Odoo Saubere Umsetzung Typischer Fehler ohne Konzept
Multi-Company-Mandanten Eigene Berater-/Mandantennummer, eigener Instanz-Key oder Bridge-Key mit X-Odoo-Company-Ref je Gesellschaft Vermischte Exporte oder falsch zugeordnete Tokens zwischen Tochtergesellschaften
SKR03/SKR04 & Automatikkonten Eindeutige Trennung zwischen Automatikkonto (ohne Zusatz-BU) und freiem Konto mit explizitem Steuerschlüssel Doppelte Steuerberechnung in DATEV durch doppelte Schlüsselung
OSS & innergemeinschaftlich Saubere Odoo-Steuerpositionen (Fiscal Positions) je Zielland mit geprüfter USt-IdNr. und separaten Erlöskonten B2C-EU-Umsätze landen auf dem 19-%-Inlandskonto statt im OSS-Kreis
Fremdwährung & Skonto Kursdifferenzen und Skontoerträge/-aufwendungen auf abgestimmten Differenzkonten mit korrekter Steuerberichtigung Cent-Differenzen blockieren den OPOS-Ausgleich in der Kanzlei

Rückkanal: Kontoblattbuchungen (DV-IN), OPOS & SuSa

Viele ERP-Projekte denken DATEV nur als Einbahnstraße: Odoo schickt Rechnungen raus, und damit endet die Sichtbarkeit. In der Folge stimmen Bilanz- und GuV-Zahlen in Odoo nach wenigen Monaten nicht mehr mit der BWA der Steuerkanzlei überein, weil Lohn- und Gehaltsbuchungen, Abschreibungen (AfA), Rückstellungen oder manuelle Umbuchungen ausschließlich in DATEV entstehen.

Über den DATEV Datenservice Export Rechnungswesen (accounting:dataexchange) schließt der Rückkanal diese Lücke:

  • Eigenes Journal DV-IN mit Re-Export-Schutz: Kontoblattbuchungen der Kanzlei werden dedupliziert in das dedizierte Journal DV-IN importiert. Dieses Journal ist technisch gegen einen erneuten Export gesperrt – Zirkelbuchungen sind ausgeschlossen.
  • SuSa-Snapshot & Abweichungsklärung: Buchhalter ziehen einen Summen- und Salden-Snapshot direkt aus DATEV und vergleichen ihn je Sachkonto mit dem Odoo-Saldo. Stichtagsabgrenzungen, noch nicht angelegte Sachkonten und wartende Steuerberater-Buchungen werden strukturiert geklärt statt in Excel gesucht.
  • Belastbare OPOS-Sicht: Zusammen mit sauberem Bank- und Zahlungsabgleich bleiben offene Posten in Odoo und DATEV synchron – eine enorme Entlastung für Mahnwesen und Liquiditätsplanung.

Praxis-Checkliste für Odoo 18, 19 und 20

Bevor Sie Ihre Odoo-DATEV-Strecke produktiv schalten – oder ein bestehendes Odoo 18 auf Odoo 19/20 anheben –, prüfen Sie diese sechs Punkte gemeinsam mit Ihrer Buchhaltung und Steuerkanzlei:

  1. Kontenrahmen & Wirtschaftsjahr finalisieren: Stimmen SKR03/SKR04, Sachkontenlänge und Wirtschaftsjahresbeginn zwischen Odoo und Kanzlei exakt überein?
  2. Personenkonten-Regel festlegen: Bekommen alle B2B-Debitoren und Kreditoren feste Nummernkreise, und sind B2C-Shop-Kanäle sauber über Sammel- und PSP-Verrechnungskonten abgebildet?
  3. DATEV-Datenservices vorab aktivieren: Sind Buchungsdatenservice, Belegbilderservice und optional der Datenservice Export Rechnungswesen für die Mandantennummer freigeschaltet?
  4. SmartLogin-Berechtigung testen: Verfügt die verantwortliche Person in Buchhaltung oder Geschäftsführung über die korrekten DATEV-Rechte Online?
  5. Vollständigen Probe-Monat abgleichen: Wurden Ausgangsrechnungen, Eingangsrechnungen, Gutschriften, EU-/OSS-Fälle und Zahlungen im Testbestand bis auf den Cent verifiziert?
  6. Upgrade-Pfad bei Odoo 18 früh mitdenken: Nutzen Sie heute noch Odoo 18, lohnt sich vor individuellen DATEV-Sonderentwicklungen die Prüfung, ob der direkte Wechsel auf Odoo 19/20 mit kanonischem Modul-Stack wirtschaftlicher und langfristig wartungsärmer ist.

Nächster Schritt

Alle technischen Details zu unseren Produktmodulen datev_export und datev_online finden Sie auf der Modulseite DATEV-Schnittstelle (DATEV MATE) sowie auf unserer Plattformseite als Odoo Gold Partner. Den plattformübergreifenden Überblick zu EXTF, BEDI-GUID, GoBD und Kanzlei-Abstimmung lesen Sie im Master-Leitfaden DATEV-Anbindung im Mittelstand.

Wenn Sie prüfen möchten, wie Ihre aktuelle Odoo-Instanz sauber mit Ihrer Steuerkanzlei verbunden wird, buchen Sie über unsere Kontaktseite direkt ein kostenloses Erstgespräch.

Häufige Fragen

Reicht der eingebaute DATEV-Export von Odoo Enterprise für den DACH-Mittelstand aus?

Für sehr kleine Gesellschaften mit wenigen monatlichen Belegen kann der manuelle Standard-CSV-Export aus Odoo Enterprise als Einstieg genügen. Sobald PDF-Belegbilder mit BEDI-GUID direkt nach DATEV Unternehmen online übergeben, Multi-Company-Mandanten sauber getrennt oder Kanzleibuchungen per Rückkanal abgeglichen werden sollen, stößt der Standard schnell an Grenzen.

Welche Odoo-Versionen unterstützt die MATE Hub DATEV-Schnittstelle?

Unsere Produktmodule datev_export und datev_online sind für Odoo 19 und Odoo 20 Enterprise ausgelegt. Für bestehende Odoo-18-Instanzen klären wir im Rahmen der Upgrade- oder Projektplanung den saubersten Übergangspfad, damit bestehende Kontenpläne, Personenkonten und Exportprotokolle ohne Bruch übernommen werden.

Wie sicher ist die SmartLogin-Freigabe über den MATE Hub?

Die OAuth-Anmeldung erfolgt direkt auf login.datev.de mittels DATEV SmartLogin oder SmartCard. Weder Odoo noch der MATE Hub erhalten zu irgendeinem Zeitpunkt Passwort oder PIN. OAuth-Tokens liegen verschlüsselt im AES-256-GCM-Vault, und jede ausgehende EXTF-Datei sowie jedes Beleg-PDF durchläuft vor dem Versand an DATEV einen fail-closed ClamAV-Scan.

Wie verhindert der Rückkanal doppelte Buchungen oder versehentliche Re-Exporte?

Kontoblattbuchungen aus dem DATEV Datenservice Export Rechnungswesen landen in Odoo dedupliziert in einem eigenen Journal (DV-IN). Dieses Journal ist technisch vom EXTF-Export ausgeschlossen, sodass Kanzleibuchungen wie Lohn, Abschreibungen oder Abgrenzungen niemals zurück nach DATEV exportiert werden können.

Funktioniert die DATEV-Schnittstelle in Odoo auch bei mehreren Gesellschaften (Multi-Company)?

Ja. Beraternummer, Mandantennummer, Kontenrahmen, Wirtschaftsjahr und GoBD-Exportprotokolle werden strikt je Gesellschaft geführt. In Multi-Company-Datenbanken trennt entweder ein eigener Instanz-Key je Gesellschaft oder ein Bridge-Key über den Header X-Odoo-Company-Ref die DATEV-Verbindungen sauber voneinander.

Kann Odoo mit DATEV auch EU-OSS-Umsätze und Reverse-Charge-Fälle abbilden?

Ja, vorausgesetzt Steuerpositionen, Erlöskonten und Steuerschlüssel sind vor dem ersten Produktivlauf sauber mit der Steuerkanzlei abgestimmt. Odoo steuert die steuerliche Zuordnung über länderspezifische Steuerpositionen (Fiscal Positions), und datev_export prüft vor dem Versand, dass keine unzulässigen Kombinationen aus Automatikkonto und zusätzlichem BU-Schlüssel entstehen.

Ein echter Vorgang genügt.

Sie nutzen Odoo 18, 19 oder 20 und möchten EXTF-Buchungsstapel, Belegbilder und Kanzlei-Rückkanal ohne manuelle Nacharbeit betreiben? Bringen Sie Ihr Konten- und Mandanten-Setup ins Erstgespräch mit.

Matthias GrdanGeschäftsführung · Prozess- & ERP-Architektur
Architektur- & IntegrationsteamFeste Projektleitung · Villingen-Schwenningen

Das Erstgespräch ist kostenlos. Ihre Anfrage wird direkt über unseren Google-Workspace-Mailservice an sales@mateit.de übermittelt – in der Offline-Vorschau öffnet sich automatisch ein vorbereiteter E-Mail-Entwurf oder Sie kopieren den Text per Klick.

Übermittlung über unseren Google-Workspace-Mailservice an sales@mateit.de (Art. 6 Abs. 1 lit. b / f DSGVO) oder lokal als E-Mail-Entwurf. Datenschutzhinweise

Erstgespräch anfragen