DATEV-Buchungsstapel (EXTF-CSV)
get/api/v1/exports/datev
Buchungsstapel im DATEV-Format (EXTF, Formatversion 13, Kategorie 21: 31-Feld-Verwaltungssatz, 125 Spalten, CP1252, Dateiname EXTF_Buchungsstapel_…csv). direction=out (Default): Erlösbuchungen aller ausgestellten Belege (sent/partial/paid/void — stornierte Ursprungsrechnung und Stornobeleg gemeinsam als S/H-Paar), je USt.-Satz eine Zeile gegen den Debitor des Kunden (Sammel-Debitor aus den Stammdaten, Vorgabe 10000, plus laufende Nummer je Kunde; Kunde = Kundennummer, sonst USt-IdNr., sonst Name; ist das in den Stammdaten ausgeschaltet oder fehlt eine Kennung, der Sammel-Debitor selbst); Soll/Haben aus dem Vorzeichen (Stornobelege wahlweise als Generalumkehr, Feld 118 = 1, Stammdaten), § 19/§ 13b/ig. Lieferung/Ausfuhr/§ 4-Befreiung auf eigene Erlöskonten, Fälligkeit in Feld 117. Storno, Korrektur und ihre Zahlungen tragen in Belegfeld 1 die Nummer der Ursprungsrechnung (OPOS-Ausgleich), die eigene Nummer in Belegfeld 2 (bis 12 Zeichen) und im Buchungstext. direction=in: Eingangsrechnungen (alle außer ignored; mit disputed=0 auch ohne „In Klärung“) als Aufwandsbuchung gegen den Kreditor des Lieferanten (Sammel-Kreditor aus den Stammdaten, Vorgabe 70000, plus laufende Nummer je Lieferant; Stammdaten dazu: GET /exports/datev/creditors; ist das in den Stammdaten ausgeschaltet oder fehlt eine Kennung, der Sammel-Kreditor selbst), je Zeile der Steueraufschlüsselung (BG-23) eine Buchung mit Vorsteuer-Schlüssel (9 = 19 %, 8 = 7 %; anderer oder unklarer Satz ohne Schlüssel), Reverse-Charge-Leistungen (Kategorie AE) eines Lieferanten aus dem Ausland netto auf die § 13b-Automatikkonten (EU: 5923/3123, sonst 5925/3125; 19 %), Reverse-Charge im Inland und innergemeinschaftlicher Erwerb ohne Steuerbuchung; Gutschriften (381 und die übrige Gutschrift-Gruppe) und Storno (458) mindern den Aufwand, Rechnung, korrigierte Rechnung (384) und 457 buchen nach dem Vorzeichen ihrer Beträge. Ohne Vorsteuerabzug (Stammdaten; Vorgabe aus den Rechnungsvorgaben: Kleinunternehmer oder steuerbefreit = ohne) brutto ohne Schlüssel und Reverse-Charge auf die § 13b-Konten ohne Vorsteuer (5943/3143, 5945/3145). Eingangsrechnungen in fremder Währung fehlen (kein Kurs gespeichert), ebenso eigene Belege: Gutschriften im Gutschriftverfahren (389, 261, 527) und Rechnungen mit eigener USt-IdNr., Steuernummer oder eigenem Namen als Verkäufer — Erlös, kein Aufwand. Bei einer Anzahlung (BT-113) bucht die Zahlung höchstens Brutto − Anzahlung. Konten in der Sachkontenlänge der Stammdaten (rechts mit Nullen aufgefüllt). direction=both: beides. Export-Marken und Nachbuchung: jeder Download vermerkt an Erlös-, Aufwands- und Bankbuchung den Export-Zeitpunkt und schreibt eine Zeile ins Protokoll (/app/datev, „Bisherige Downloads“: Zeitpunkt, Auswahl, Zeilen, Festschreibung, Quelle App/API). pending=1 („nur seit dem letzten Export“) liefert nur, was im Zeitraum noch in keinem Download war — Belege ohne Marke (nachgetragen, rückdatiert, geklärt), mit payments=1 die noch nicht exportierten Zahlungen auch zu schon exportierten Belegen und als Gegenbuchung („Storno Zahlung“, zum ursprünglichen Zahldatum) Zahlungen, die nach ihrem Export storniert wurden; Stapel-Kennung mit Zusatz -NB. Ein normaler Export des Zeitraums enthält alles; die Vorschau nennt, wie viele Buchungen der Auswahl schon in einem früheren Download standen. Mit payments=1 zusätzlich je Zahlung eine Bankbuchung zum Zahldatum (immer Bank, keine Zahlungsart), ein Skonto-Ausgleich als „Gewährte Skonti an Debitor“ (anteilig je Satz: 4736/8736 bzw. 4731/8731, steuerfreie Anteile 4730/8730) und im Eingang ein Skonto als „Kreditor an Erhaltene Skonti“ (5736/3736, 5731/3731, sonst 5730/3730); maßgeblich ist das Zahldatum, nicht das Belegdatum: enthalten sind genau die Zahlungen im Zeitraum, auch zu Belegen von außerhalb (für die dann keine Erlös-/Aufwandsbuchung entsteht). Berater-/Mandantennummer, Sachkontenlänge, SKR-Vorgabe, Sammel-Personenkonten, Festschreibung, Leistungsdatum, Vorsteuerabzug und Beginn des Wirtschaftsjahres (Kopf-Feld 13) kommen aus den Kanzlei-Stammdaten (/app/datev); skr, lock, service_dates übersteuern sie je Abruf. Leistungsdatum (115/116) nur bis zum Rechnungsdatum, ein späteres bleibt leer. Zeichen außerhalb von Windows-1252 werden umgeschrieben (€ → EUR, Š → S, č → c, sonst „?“); im Buchungstext werden doppelte Anführungszeichen zu einfachen, führende = + - @ entfallen. Max. 99.999 Buchungszeilen je Datei (400 darüber). Unbekannte Werte für skr, direction, period und die Schalter ergeben 400, statt still durch die Vorgabe ersetzt zu werden. Last: je Nutzer höchstens 60 Abrufe in 10 Minuten (App und API zusammen, zusätzlich zum Minutenlimit des Keys), je Server wenige Exporte gleichzeitig; darüber 429 mit Retry-After. Scope datev:read: ein eigener Scope, weil die Datei Ausgangs- und Eingangsrechnungen samt Namen und Beträgen enthält; Keys, die vor seiner Einführung invoices:read trugen, haben ihn bekommen, KI-Agenten nur, wenn er in ihrer Konfiguration gewählt ist.
Scope
datev:read
Parameter
- year query · integerWirtschaftsjahr, benannt nach dem Jahr seines Beginns (Default: das laufende). Beginn aus den Kanzlei-Stammdaten, Vorgabe 1. Januar = Kalenderjahr; bei Beginn 1. Juli ist
year=2026der Zeitraum 01.07.2026–30.06.2027. Alternativ from/to — dann folgt das Wirtschaftsjahrfrom; ein angegebenesyearmuss dazu passen (sonst 400). - period query · "year" | "q1" | "q2" | "q3" | "q4" | "m1" | "m2" | "m3" | "m4" | "m5" | "m6" | "m7" | "m8" | "m9" | "m10" | "m11" | "m12"Zeitraum innerhalb von
year: das ganze Wirtschaftsjahr, ein Kalenderquartal oder ein Kalendermonat, jeweils im Kalenderjahr, in dem es zu diesem Wirtschaftsjahr gehört. Ein Quartal über den Beginn des Wirtschaftsjahres ergibt 400. from/to haben Vorrang. - from query · string · dateBeginn des Zeitraums,
YYYY-MM-DD.fromundtomüssen im selben Wirtschaftsjahr liegen — DATEV nimmt je Stapel nur eines an (400 sonst). - to query · string · dateEnde des Zeitraums,
YYYY-MM-DD, im Wirtschaftsjahr vonfrom. - skr query · "03" | "04"Kontenrahmen; Default aus den Kanzlei-Stammdaten (sonst 04).
- lock query · "0" | "1" | "true" | "false"Header-Feld Festschreibung; Default aus den Stammdaten (1).
- service_dates query · "0" | "1" | "true" | "false"1 = Leistungsdatum + Datum Zuord. Steuerperiode (Felder 115/116) mitgeben, nur bei Soll-Versteuerung sinnvoll; liegt das Leistungsdatum nach dem Rechnungsdatum, bleiben die Felder leer. Default aus den Stammdaten (0).
- disputed query · "0" | "1" | "true" | "false"0 = Eingangsrechnungen „In Klärung“ ausklammern; sie bleiben ohne Export-Marke, nach der Klärung (Status open/paid) holt
pending=1sie nach. Default 1 = mitbuchen, mit Hinweis in der Vorschau. - pending query · "0" | "1" | "true" | "false"Umfang wie im Formular unter
/app/datev: 0 (Default) = vollständig, der ganze Zeitraum; 1 = nur seit dem letzten Export (Nachbuchung): nur, was im Zeitraum noch in keinem Download war — Ausgangs- und Eingangsbelege ohne Export-Marke (auch der Stornobeleg einer schon exportierten Rechnung, mit dem Stammdaten-Schalter Generalumkehr als GU-Zeile, Feld 118 = 1), mitpayments=1noch nicht exportierte Zahlungen (auch zu schon exportierten Belegen) und Gegenbuchungen nach dem Export stornierter Zahlungen. In jeder Richtung; Stapel-Kennung mit-NB. Der Download setzt die Marken; das Protokoll („Bisherige Downloads“) nennt je Download den vorigen, der sich mit ihm überschneidet (Zeitraum und Inhalt). - payments query · "0" | "1" | "true" | "false"1 = Zahlungen als Bankbuchungen mit aufnehmen (alle mit Zahldatum im Zeitraum, unabhängig vom Belegdatum).
- direction query · "out" | "in" | "both"out = Ausgangsrechnungen, in = Eingangsrechnungen, both = beides.
- sender query · stringNur Ausgangsbelege dieses Absenders:
tax:+ USt-IdNr. oder Steuernummer des Absenders ohne Trennzeichen in Großbuchstaben (z. B.tax:DE123456789), sonstname:+ Firmenname klein ohne Leer- und Sonderzeichen. Eine zweite Firma unter demselben Konto ist in DATEV ein eigener Mandant — je Absender einen Stapel abrufen. Eingangsrechnungen bleiben ungefiltert. Default: alle Absender.
curl -X GET "https://maxrechnung.de/api/v1/exports/datev" \ -H "Authorization: Bearer $MXR_API_KEY"
MXR_API_KEY als Umgebungsvariable setzen. GUI-Clients (Postman, Insomnia, Bruno …): /api/openapi.json importieren.
Antworten
- 200 DATEV-CSV in Windows-1252 als Download (
Content-Disposition: attachment) - 400 Ungültiger Parameter oder Zeitraum, oder Stapel über 99.999 Zeilen
- 401 Kein oder ungültiger API-Key
- 403 Scope datev:read fehlt oder kein Business-Tarif (
plan_required) - 429 Minutenlimit des Keys, DATEV-Limit je Nutzer (60 Abrufe in 10 Minuten) oder zu viele gleichzeitige Exporte
- 500 Daten konnten nicht gelesen werden