Integrations-Guide
DATEV anbinden: Belege an die Kanzlei übergeben
Was im DATEV-Export von Belegschmied tatsächlich drin ist, wie die Begleitliste aufgebaut ist, welche Spalten sie trägt und wie die Kanzlei das Paket importiert. Mit Spaltentabelle, Steuerschlüsseln und den Grenzen des Exports.
Kurze Antwort: Unter Export → DATEV wählen Sie einen Zeitraum und die Belegarten und laden ein ZIP herunter. Darin liegen die Belege selbst unter belege/, eine Begleitliste belege.csv mit einer Zeile je Beleg und eine README.txt für die Kanzlei. Der Import läuft über DATEV Unternehmen online, Bereich „Belege online", als Beleg-Upload.
Ein Satz vorweg, weil er den Nutzen bestimmt: Das ist ein Belegtransfer, kein Buchungsstapel. Konten und Kostenstellen werden nicht vorgebucht. Die Belege kommen vollständig, sauber benannt und mit den Metadaten an, die für die Zuordnung nötig sind; gebucht wird in der Kanzlei. Wer das weiß, spart sich die Enttäuschung und die Rückfrage.
Was im ZIP liegt
belege.csv Begleitliste, eine Zeile je Beleg
belege/AR_2026-1042.pdf Ausgangsrechnungen, ZUGFeRD-PDF
belege/AR_2026-1043.xml Ausgangsrechnungen im XRechnungs-Format
belege/ER_RE-88213.pdf Eingangsrechnungen, Originaldatei
README.txt Kurzanleitung für die Kanzlei
Die Dateinamen tragen das Präfix AR für Ausgangs- und ER für Eingangsrechnungen, gefolgt von der Rechnungsnummer. Bei Ausgangsrechnungen ist das Belegbild die erzeugte E-Rechnung: eine ZUGFeRD-PDF mit eingebettetem XML nach PDF/A-3 oder, wenn der Arbeitsbereich auf XRechnung steht, die XML-Datei selbst. Bei Eingangsrechnungen ist es die Originaldatei, so wie sie angekommen ist.
Die README.txt nennt Mandant, Zeitraum, Belegzahl und den Importweg. Sie liegt bei, damit die Kanzlei das Paket ohne Rückfrage einordnen kann.
Die Begleitliste
belege.csv ist semikolongetrennt und UTF-8 mit BOM kodiert, also die Kombination, die deutsches Excel ohne Nachfrage richtig öffnet. Elf Spalten:
| Spalte | Inhalt | Anmerkung |
|---|---|---|
Belegnummer | Rechnungsnummer | Bei Eingangsrechnungen ohne erkannte Nummer die ersten acht Zeichen der internen Kennung |
Belegdatum | Rechnungsdatum | Format TT.MM.JJJJ |
Buchungstext | „Ausgangsrechnung an …" bzw. „Eingangsrechnung von …" | Name aus den Stammdaten, ersatzweise die Empfängeradresse |
Betrag_Brutto | Bruttobetrag | Dezimalkomma |
Betrag_Netto | Nettobetrag | Dezimalkomma |
Betrag_USt | Steuerbetrag | Dezimalkomma |
USt_Satz | Steuersatz | Nur bei Ausgangsrechnungen gefüllt; bei mehreren Sätzen der dominierende |
USt_Schluessel | DATEV-Steuerschlüssel | Nur bei Ausgangsrechnungen gefüllt |
Belegart | AR oder ER | — |
Debitor_Kreditor_Nr | Debitoren- bzw. Kreditorennummer | Leer, solange keine vergeben ist |
Belegbild | Relativer Pfad in das belege/-Verzeichnis | Verknüpft die Zeile mit der Datei |
Die Steuerschlüssel werden konventionell vergeben: 9 für 19 Prozent, 8 für 7 Prozent, 0 für steuerfrei. Weicht Ihr Kanzlei-Setup davon ab, ist die Spalte eine Zahl in einer CSV und schnell umgesetzt. Bei Eingangsrechnungen bleiben Satz und Schlüssel leer, weil die Vorsteuerbehandlung eine Buchungsentscheidung ist und nicht aus dem Beleg folgt.
Bei gemischten Steuersätzen trägt USt_Satz nur den dominierenden Satz. Die vollständige Aufschlüsselung steckt im Beleg selbst, bei ZUGFeRD im eingebetteten XML. Für die Buchung ist der Beleg maßgeblich, nicht die Begleitzeile.
Debitoren- und Kreditorennummern
Belegschmied vergibt sie automatisch je Arbeitsbereich nach DATEV-Konvention, sobald ein Kunde oder Lieferant angelegt wird. Kunden und Lieferanten entstehen dabei beim Verarbeiten von selbst und werden dedupliziert, Sie müssen keine Stammdaten pflegen, damit die Nummern entstehen.
Wer sie in eigenen Auswertungen braucht, holt sie über die REST-API:
curl "https://belegschmied.de/api/v1/customers?search=Muster" \
-H "Authorization: Bearer bs_live_dein_key"
/customers und /suppliers liefern die Stammdaten samt Debitoren- und Kreditorennummer, Details in der REST-API-Dokumentation.
Export ziehen und übergeben
- Export → DATEV öffnen.
- Zeitraum wählen, „Von" und „Bis".
- Häkchen bei Ausgangsrechnungen, Eingangsrechnungen oder beiden.
- Export starten. Er läuft im Hintergrund, das fertige ZIP steht in der Liste darunter zum Download.
- ZIP an die Kanzlei geben, per Mail, DATEV-Belegupload oder Fileshare.
Der Export ist in allen bezahlten Tarifen enthalten. Arbeitsbereiche ohne aktiven Tarif, die noch historische Belege halten, können ihn weiter ziehen: die gesetzliche Aufbewahrungspflicht endet nicht mit einem Abo.
Import in der Kanzlei
Über DATEV Unternehmen online → Belege online → Beleg-Upload. Die Dateien aus belege/ werden hochgeladen, die belege.csv kann als Begleitliste dienen. Alternativ läuft der Weg über Kanzlei-Rechnungswesen.
Für die Kanzlei ist der wichtigste Punkt, dass die Ausgangsbelege E-Rechnungen nach EN 16931 sind: ZUGFeRD-PDFs tragen die strukturierten Daten im eingebetteten XML, XRechnungen sind reine XML-Dateien. Das ist mehr als ein Belegbild, weil sich daraus maschinell buchen lässt, wenn die Kanzlei-Software das unterstützt.
Grenzen, die man vorher kennen sollte
- Kein Buchungsstapel und keine Kontierung. Es gibt keinen Kontenrahmen in Belegschmied, keinen automatischen Kontenvorschlag und keine Kostenstellen. Die Buchungslogik bleibt in der Kanzlei.
- Kein automatischer Versand. Der Export wird ausgelöst, nicht terminiert. Wer monatlich übergibt, macht das nach Monatsende von Hand.
- Kein Filter auf Freigabestatus. Der Export nimmt den gewählten Zeitraum, wie er ist. Ziehen Sie ihn deshalb, wenn die Freigaben des Zeitraums erledigt sind.
- Keine Exportformate für andere Buchhaltungssoftware. Es gibt kein eigenes Lexoffice-, sevDesk- oder BMD-Format. Für diese Programme ist die Begleit-CSV der Weg: sie ist eine gewöhnliche Rechnungsliste mit Datum, Nummer, Beträgen und Steuersatz.
Wenn etwas nicht passt
| Symptom | Ursache | Abhilfe |
|---|---|---|
| Export ist leer | Im gewählten Zeitraum liegt kein Beleg, oder es wurde die falsche Belegart angehakt | Zeitraum und Häkchen prüfen |
Debitor_Kreditor_Nr ist leer | Für diesen Kunden oder Lieferanten ist noch keine Nummer vergeben | In den Stammdaten der App nachsehen und ergänzen |
| Kanzlei meldet „Konto nicht zugeordnet" | Erwartungsfehler: der Export kontiert nicht | Kontierung erfolgt in der Kanzlei; die Begleitliste liefert die Zuordnungsdaten |
| Beleg fehlt zum CSV-Eintrag | Die Datei wurde archiviert gelöscht, weil der Arbeitsbereich die Archivierung deaktiviert hat | Archivierungseinstellung prüfen |
| Doppelter Buchungsstoff | Derselbe Zeitraum wurde zweimal übergeben | Mit der Kanzlei abstimmen, welcher Export gilt |
Wo der DATEV-Weg im Gesamtbild steht
Der Export ist die Weitergabe ans Rechnungswesen und damit das Ende der Kette. Davor stehen die Einlieferung und der Versand: aus einem beobachteten Ordner per Power Automate, aus einer Fachanwendung neben SAP oder aus Word- und Excel-Vorlagen. Die Übersicht aller Wege steht auf der Integrationsseite, die Archivierungsseite dazu unter GoBD-Archiv.
Häufige Fragen
Erzeugt Belegschmied eine DATEV-Buchungsstapel-Datei?
Nein. Der Export ist ein Belegtransfer-Bundle: die Belege selbst plus eine Begleitliste als CSV. Konten und Kostenstellen werden nicht vorgebucht, die Buchungslogik bleibt bei der Kanzlei. Wer einen fertigen Buchungsstapel erwartet, bekommt ihn hier nicht.
Woher kommen Debitoren- und Kreditorennummern?
Belegschmied vergibt sie automatisch je Arbeitsbereich nach DATEV-Konvention, sobald ein Kunde oder Lieferant angelegt wird. Sie stehen in der Begleitliste und sind über die REST-API unter /customers und /suppliers abrufbar.
Wie oft sollte exportiert werden?
Üblich ist monatlich nach Monatsende. Der Zeitraum ist frei wählbar, es gibt keinen automatischen Versand: Sie ziehen den Export, wenn Sie ihn brauchen.
Was ist mit Steuerberatern, die kein DATEV nutzen?
Die Begleitliste ist eine gewöhnliche Semikolon-CSV in UTF-8 mit BOM und lässt sich in jedes Buchhaltungsprogramm und in Excel einlesen. Die Belege selbst sind ZUGFeRD-PDFs oder XRechnungs-XML nach EN 16931 und damit ohnehin maschinenlesbar.
Weitere Integrations-Guides
SAP anbinden: die Rechnungen, die SAP nicht abbildet
Wie Sie die Restmenge neben SAP – Rechnungen aus Word, Excel und Fachanwendungen – ohne SAP-Projekt in ZUGFeRD oder XRechnung überführen. Mit REST-API-Aufrufen, Statusabfrage, Feldabgleich und den Fehlerbildern, die bei hohem Volumen tatsächlich auftreten.
Microsoft 365 anbinden: Power Automate und Graph API
Einen SharePoint-Ordner per Power Automate an die E-Rechnungs-Konvertierung anbinden, mit und ohne Premium-Lizenz, und den Versand über die Graph API aus dem eigenen Postfach einrichten. Mit Flow-Schritten, HTTP-Body, Entra-Berechtigungen und den Fehlerbildern 401 und 403.
Word- und Excel-Rechnungen: der Feldabgleich
Welche Angabe auf einer Word- oder Excel-Rechnung in welchem Feld der E-Rechnung landet, welche Felder EN 16931 erzwingt und was passiert, wenn eine fehlt. Vollständige Zuordnungstabelle mit BT-Nummern, dazu die typischen Vorlagenfehler.
Anbindung besprechen
Sagen Sie uns, welches System die Rechnungen erzeugt und wie sie heute verschickt werden. Wir sagen Ihnen, welcher Weg passt und was er kostet.