Offene Buchungen vor dem DATEV-Export zählen
Benötigte Berechtigung:datev:export(DATEV-Export starten und Buchungen festschreiben)
Echte Wirkung
/api/export/datev/openKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Zählt die offenen, also noch nicht festgeschriebenen Buchungen, die ein DATEV-Export dieses Zeitraums festschreiben würde. Das Zählen selbst schreibt nichts fest. Vorher bucht bimetrics, was noch nicht gebucht ist, so wie der Export selbst. Die Zahl gibst du beim Start als open mit. Ändert sich bis dahin etwas, schreibt startDatevExport nichts fest und antwortet mit der neuen Zahl. Gezählt wird immer für den Buchungsstapel; documents, protocol, open und all sind beim Zählen ohne Bedeutung. Beide Tage liegen im selben Kalenderjahr (sonst 400 DatevExportYears).
Benötigt einen Schlüssel mit der Berechtigung datev:export.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Period and parts
application/json- body
Zeitraum und Umfang des DATEV-Exports.
all?booleanStatt open: festschreiben, was beim Lauf des Exports offen ist, ohne Vergleich mit einer gezählten Zahl. Nur bewusst einsetzen.
bookings?booleanBuchungsstapel (EXTF): schreibt die offenen Buchungen des Zeitraums fest. Das lässt sich nicht rückgängig machen.
documents?booleanBelege des Zeitraums als Dateien.
from?stringErster Tag, YYYY-MM-DD.
onlyNew?booleanNur, was DATEV noch nicht bekommen hat, wie „Nur noch nicht exportierte“ in der App, dort vorgewählt. Fehlt onlyNew oder ist es false, enthält der Export alle Buchungen des Zeitraums, auch schon exportierte. Importiert die Kanzlei beide Dateien, stehen sie in DATEV doppelt. Nimm false nur, wenn die Kanzlei den alten Stapel verworfen hat.
open?|Mit bookings Pflicht beim Start, außer mit all: die Zahl offener Buchungen aus countDatevOpenBookings. Beim Zählen ohne Bedeutung.
protocol?booleanÄnderungsprotokoll als CSV (Aenderungsprotokoll.csv): alle Änderungen an den exportierten Belegen, Umsätzen und Zuordnungen.
to?stringLetzter Tag, YYYY-MM-DD, nicht vor from und im selben Kalenderjahr.
Erfolg.
application/json- response
Offene Buchungen, die ein DATEV-Export des Zeitraums festschreibt.
assetDepreciation?stringNur mit Anlagen und Buchungen, solange offen ist, ob die Kanzlei die Abschreibungen selbst in DATEV rechnet: der Satz dazu. Bis zur Antwort (PUT /api/settings/datev) gehen laufende Abschreibungen, GWG und Restwerte beim Abgang nicht an DATEV.
open?integerAnzahl; beim Start als open mitgeben.
curl --fail-with-body "https://app.bimetrics.de/api/export/datev/open" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "open": 42}DATEV-Export starten und Buchungen festschreiben POST
Startet den DATEV-Export eines Zeitraums wie in der App, als Auftrag im Hintergrund. Die Antwort ist `202` mit dem Auftrag; `getExportJob` zeigt, wie weit er ist. **Mit `bookings: true` schreibt der Export die offenen Buchungen des Zeitraums fest, die er an DATEV gibt. Das lässt sich nicht rückgängig machen:** Festgeschriebene Buchungen ändert danach niemand mehr, auch nicht in der App. Eine Korrektur geht nur noch per Storno und Neubuchung. Beide liegen im Monat der alten Buchung und gehen erst an DATEV, wenn dieser Monat noch einmal mit `onlyNew: true` exportiert wird; ein Export späterer Monate nimmt sie nicht mit. bimetrics sendet nichts an die Kanzlei: Sie bekommt die Buchungen mit der Datei, die du lädst und weitergibst. Mit `bookings: true` ist `open` Pflicht: die Zahl aus `countDatevOpenBookings`. Stimmt sie beim Start nicht mehr, antwortet bimetrics mit `409 DatevExportChanged`. Dieser Aufruf hat nichts festgeschrieben; `context.open` nennt die neue Zahl. Ist sie kleiner als gezählt, hat vielleicht ein anderer Export des Zeitraums inzwischen festgeschrieben, auch dein eigener früherer Aufruf. Nach einem Netzwerkfehler wiederholst du immer mit demselben `Idempotency-Key`. Willst du die neue Zahl übernehmen, startest du mit ihr neu, mit einem neuen Idempotency-Key. `all: true` statt `open` schreibt fest, was beim Lauf des Exports offen ist, ohne Vergleich mit einer gezählten Zahl. Läuft schon ein DATEV-Export mit Buchungen, wartet der neue und startet danach von selbst. Startet derselbe Inhaber dasselbe noch einmal, bevor der Auftrag festgeschrieben hat, mit einem seiner Schlüssel oder in der App, kommt dieser Auftrag zurück. Beide Tage liegen im selben Kalenderjahr, sonst antwortet die Route mit `400 DatevExportYears`, wie die App. Teile so einen Zeitraum am Jahreswechsel und starte je Kalenderjahr einen eigenen Export. Der Idempotency-Key ist Pflicht (`400 IdempotencyKeyRequired`); eine Wiederholung mit demselben Key startet nichts doppelt. Benötigt einen Schlüssel mit der Berechtigung `datev:export`.
Stornos auf Konten, die DATEV nicht mehr annimmt GET
Zählt die Stornos, die ein Export von `from` bis `to` mit „Nur noch nicht exportierte“ an DATEV schickt, zu Buchungen, die DATEV schon bekommen hat. Gezählt werden nur Buchungen auf Konten, die DATEV für das Buchungsjahr nicht mehr annimmt: laut DATEV-Kontenrahmen 2026 SKR03 8195 und 8600, SKR04 4185 und 3850, dazu Konto 0. Daneben steht jeweils die Neubuchung auf dem heutigen Konto. DATEV meldet die Zeilen dieser Stornos beim Import als fehlerhaft. Die Meldungen.csv im Export nennt die Belege und Umsätze dazu, bei „Alle im Zeitraum“ auch die schon einmal gesendeten Stornos. Benötigt einen Schlüssel mit der Berechtigung `read`.