DATEV-Export

Der DATEV-Export macht aus den Belegen eines Verkäufers für einen Zeitraum Dateien für den Import in DATEV:

• Buchungsstapel (EXTF_Buchungsstapel_<von>_<bis>.csv) im DATEV-Format: eine Buchungszeile je Steuersatz und Beleg für Rechnungen, Stornorechnungen, Rechnungskorrekturen und Gutschriften im Gutschriftverfahren (§ 14 Abs. 2 Satz 5 UStG). Rechnungen stehen auf dem Debitor des Kunden gegen das Erlöskonto, Gutschriften auf dem Kreditor des Lieferanten gegen das Aufwandskonto.
• Debitoren/Kreditoren (EXTF_Debitoren_Kreditoren.csv): Name, Anschrift, USt-IdNr. und Kontonummer jedes Kunden und Lieferanten im Stapel.
• Belege (Belege-1.zip, bei großen Zeiträumen weitere Teile) für die DATEV XML-Schnittstelle: die archivierte Originaldatei jeder Rechnung, bei reinen XML-Dateien dazu die lesbare PDF, mit document.xml. Jede Buchungszeile verweist über den Beleglink auf ihren Beleg.
• Protokoll (Protokoll.pdf, Protokoll.csv): was exportiert wurde, Summen je Steuerfall, nicht gebuchte Belege und gekürzte Texte mit Grund.

Ein Export ändert das Archiv nie. Die Dateien werden verschlüsselt gespeichert und nach 7 Tagen gelöscht. Derselbe Zeitraum ergibt bei unveränderten Belegen dieselben Dateien, Byte für Byte.

Enthalten in Starter, Growth, Scale und Enterprise (402 plan.feature-not-included sonst, auch im Testzeitraum); Testschlüssel exportieren auf jedem Tarif die Sandbox. Je Kunde und Schlüsselart laufen höchstens drei Exporte gleichzeitig und 20 am Tag; ein Export umfasst höchstens 10.000 Belege und 500 MB Belege.

Kontenzuordnung

Vor dem ersten Export mit einem Live-Schlüssel speichern Sie die Kontenzuordnung (Berechtigung admin). Ohne gespeicherte Werte liefert GET die Standardkonten von DATEV (SKR 03 oder SKR 04, Stand 2026) als Vorschlag:

curl -s "$BASE/sellers/$SELLER/datev-settings?chart=SKR03" -H "Authorization: Bearer $ADMIN_KEY"
curl -s -X PUT "$BASE/sellers/$SELLER/datev-settings" -H "Authorization: Bearer $ADMIN_KEY" \
  -H 'Content-Type: application/json' -d @kontenzuordnung.json

Pflicht sind Kontenrahmen, Beraternummer, Mandantennummer, Beginn des Wirtschaftsjahres, Sachkontenlänge, ein Erlös- und ein Aufwandskonto je Steuerfall (S19, S7, E, AE, K, G, Z, O) und die Nummernkreise der Debitoren und Kreditoren (oder ein Sammeldebitor). Jeder Kunde erhält einmal eine Debitorennummer, die in allen späteren Exporten gleich bleibt. Testschlüssel exportieren mit der Live-Kontenzuordnung oder, ohne sie, mit den Vorschlägen.

Keine Steuerberatung: Die Kontenzuordnung ist ein Vorschlag – bitte mit Ihrer Steuerkanzlei abstimmen.

Export erstellen

curl -s -X POST $BASE/exports/datev -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: datev-2026-10' \
  -d '{"sellerId": "'$SELLER'", "from": "2026-10-01", "to": "2026-10-31", "includeReceived": false}'

Die Antwort ist 202 mit der Auftrags-ID; derselbe Idempotency-Key liefert denselben Auftrag. Ein Zeitraum umfasst höchstens ein Jahr; über ein Wirtschaftsjahr hinaus entsteht je Wirtschaftsjahr ein Buchungsstapel. Mit includeReceived: true kommen empfangene Rechnungen ohne Buchungszeilen in die Belege. Höchstens drei Exporte warten oder laufen gleichzeitig (429 datev.export-limit).

GET /exports/datev/{id} zeigt status (pending, running, completed, failed, expired), die Zusammenfassung des Protokolls und die Dateien mit Download-Adresse; GET /exports/datev/{id}/files/{name} lädt eine Datei. Das Webhook-Ereignis export.datev.completed meldet den fertigen Export einmal. Ein neuer Export desselben Verkäufers, Zeitraums und includeReceived ersetzt den früheren, sobald er fertig ist: Der frühere wird expired. Ist der Speicher für Exporte aller Kunden gerade voll, antwortet die API 503 datev.busy mit Retry-After; ein angenommener Export bleibt dann länger pending.

Formate und Quellen

Umgesetzt nach den Beschreibungen auf developer.datev.de (abgerufen am 1. November 2026): DATEV-Format mit Header-Version 700, Buchungsstapel Version 13, Debitoren/Kreditoren Version 5, Zeichensatz Codepage 1252; DATEV XML-Schnittstelle online, document.xml Version 6.0. Standardkonten aus den DATEV-Kontenrahmen SKR 03 (Art.-Nr. 11174) und SKR 04 (Art.-Nr. 11175), gültig für 2026. Zu lange Texte werden gekürzt und im Protokoll genannt, nie abgelehnt; Belege in anderen Währungen als EUR und Steuersätze ohne Konto werden nicht gebucht und im Protokoll mit Grund aufgeführt. Fakturnaut ist kein DATEV-Produkt; die Dateien sind für den Import in DATEV gedacht.