Skip to main content
Glama

MaxRechnung

DATEV-Buchungsstapel (EXTF-CSV)

export_datev
Read-only

Tarif: 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

NameRequiredDescriptionDefault
toNoEnde des Zeitraums, `YYYY-MM-DD`, im Wirtschaftsjahr von `from`.
skrNoKontenrahmen; Default aus den Kanzlei-Stammdaten (sonst 04).
fromNoBeginn des Zeitraums, `YYYY-MM-DD`. `from` und `to` müssen im selben Wirtschaftsjahr liegen — DATEV nimmt je Stapel nur eines an (400 sonst).
lockNoHeader-Feld Festschreibung; Default aus den Stammdaten (1).
yearNoWirtschaftsjahr, 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).
periodNoZeitraum 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
senderNoNur 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.
pendingNoUmfang 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
disputedNo0 = 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
paymentsNo1 = Zahlungen als Bankbuchungen mit aufnehmen (alle mit Zahldatum im Zeitraum, unabhängig vom Belegdatum).0
directionNoout = Ausgangsrechnungen, in = Eingangsrechnungen, both = beides.out
service_datesNo1 = 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).

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.3/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses real, persistent state changes: 'jeder Download vermerkt an Erlös-, Aufwands- und Bankbuchung den Export-Zeitpunkt und schreibt eine Zeile ins Protokoll' and 'Der Download setzt die Marken', which then alters the result set of future pending=1 calls. The annotations declare readOnlyHint=true, i.e. the tool does not modify its environment, which directly conflicts with this described mutation of bookings, marks and the download log. The description is admirably transparent about the side effect, but it contradicts the supplied annotation, so this is scored per the contradiction rule.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single enormous paragraph of dense German accounting jargon, delivered as a wall of text with no headings or bullets, and it is even cut off mid-word ('Berater-/Mandante'). Substantial content duplicates the already complete schema descriptions (pending, direction, payments, disputed), inflating length without adding decision-relevant information. Only the plan-requirement sentence is properly front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 12-parameter financial export with no output schema, this is substantively complete: accounting rules, tax keys, OPOS handling, Sammel-Debitor/Kreditor fallbacks, currency exclusions, prepayment limits and export-mark/pending mechanics are all covered. The gaps are the truncated tail (Berater-/Mandant… guidance) and the absence of any statement about the response format/shape, which must be inferred. Otherwise nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the 12 parameter descriptions are unusually thorough (year vs. from/to precedence and the 400 on mismatch, period semantics, sender pattern meaning, lock/pending/disputed defaults, payments at Zahldatum). The description mostly restates the same semantics for direction, pending, payments and disputed rather than adding non-schema meaning; the genuinely additive parts (Skonto-Konten, Reverse-Charge-Konten, Sammel-Debitor/Kreditor logic) are business logic, not parameter semantics. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Stated as a specific verb+resource: creating a DATEV 'Buchungsstapel' as EXTF-CSV (Formatversion 13, Kategorie 21, 125 Spalten, CP1252), with the three directions explicitly enumerated (out = Erlösbuchungen, in = Eingangsrechnungen, both = beides). This is enough for an agent to separate it from export_datev_creditors, which is explicitly named as the source of the creditor master data ('Stammdaten dazu: `GET /exports/datev/creditors`').

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear operational guidance exists: 'Eine zweite Firma unter demselben Konto ist in DATEV ein eigener Mandant — je Absender einen Stapel abrufen', 'nur bei Soll-Versteuerung sinnvoll' for service_dates, and when to use pending=1 ('nur seit dem letzten Export'). What is missing is an explicit statement of when NOT to use this export (e.g. versus other export tools) — the guidance is contextual rather than exclusionary. Plan gating ('Tarif: ab Business … plan_required') is correctly surfaced up front.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources