DATEV-Buchungsstapel (EXTF-CSV)
export_datevTarif: ab Business (darunter antwortet die API mit plan_required).
DATEV-Buchungsstapel (EXTF-CSV)
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-/Mandante
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "export_datev"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Ende des Zeitraums, `YYYY-MM-DD`, im Wirtschaftsjahr von `from`. | |
| skr | No | Kontenrahmen; Default aus den Kanzlei-Stammdaten (sonst 04). | |
| from | No | Beginn des Zeitraums, `YYYY-MM-DD`. `from` und `to` müssen im selben Wirtschaftsjahr liegen — DATEV nimmt je Stapel nur eines an (400 sonst). | |
| lock | No | Header-Feld Festschreibung; Default aus den Stammdaten (1). | |
| year | No | Wirtschaftsjahr, 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 | No | 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. | year |
| sender | No | Nur 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. | |
| pending | No | 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). | 0 |
| disputed | No | 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. | 1 |
| payments | No | 1 = Zahlungen als Bankbuchungen mit aufnehmen (alle mit Zahldatum im Zeitraum, unabhängig vom Belegdatum). | 0 |
| direction | No | out = Ausgangsrechnungen, in = Eingangsrechnungen, both = beides. | out |
| service_dates | No | 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). |