DATEV-Export

DATEV-Buchungsstapel (EXTF-CSV) für einen Zeitraum und die Personenkonten-Stammdaten abrufen.

Authentifizierung

Jeder Request braucht einen API-Key im Header. Keys entstehen unter Einstellungen → API (nur Business-Tarif). Details zu Scopes, Idempotenz und Rate-Limits auf der Übersichtsseite.

Authorization: Bearer mxr_live_…

Bleibt in diesem Browser-Tab (sessionStorage), nur für „Ausprobieren“ auf dieser Seite, und geht direkt aus deinem Browser an /api/v1 — kein Versand an unseren Server, kein Log.

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=2026 der Zeitraum 01.07.2026–30.06.2027. Alternativ from/to — dann folgt das Wirtschaftsjahr from; ein angegebenes year muss 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. from und to mü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 von from.
  • 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=1 sie 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), mit payments=1 noch 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), sonst name: + 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

DATEV-Stammdaten der Personenkonten (Debitoren und Kreditoren)

get/api/v1/exports/datev/creditors

Stammdaten im DATEV-Format (EXTF, Kategorie 16 „Debitoren/Kreditoren“, Formatversion 5, 254 Spalten, CP1252, Dateiname EXTF_Debitoren_Kreditoren_…csv): Sammel-Debitor und Sammel-Kreditor mit Namen; je Kunde der ausgestellten Rechnungen sein Debitor — Sammel-Debitor aus den Kanzlei-Stammdaten plus laufende Nummer, die sich nie ändert (10001, 10002 …) — mit Name, USt-IdNr., Anschrift und E-Mail aus der jüngsten Rechnung (Kunde = Kundennummer, sonst USt-IdNr., sonst Name); je Lieferant im Eingang (ohne ignorierte, eigene und Fremdwährungsbelege) sein Kreditor — Sammel-Kreditor plus laufende Nummer (70001, 70002 …) — mit Name, Kurzbezeichnung, USt-IdNr., Steuernummer, Anschrift, E-Mail und IBAN aus dem jüngsten Beleg (Lieferant = USt-IdNr., sonst Steuernummer, sonst Name). Ist eine Art in den Stammdaten ausgeschaltet, fehlen ihre Einzelkonten. Die Kanzlei importiert die Datei vor dem ersten Buchungsstapel. Scope datev:read, Limit wie GET /exports/datev.

Scope

datev:read

curl -X GET "https://maxrechnung.de/api/v1/exports/datev/creditors" \
  -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)
  • 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 oder zu viele gleichzeitige Exporte
  • 500 Daten konnten nicht gelesen werden

Schemas

Von den Endpunkten oben referenzierte Objekte. Vollständig auch in der OpenAPI-Spezifikation.