bimetricsEntwickler
Buchhaltung

Offene Buchungen vor dem DATEV-Export zählen

Als Markdown ansehen

Benötigte Berechtigung:datev:export(DATEV-Export starten und Buchungen festschreiben)

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
post/api/export/datev/open

Kein 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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Request-Body

Period and parts

application/json
  1. body

Zeitraum und Umfang des DATEV-Exports.

all?boolean

Statt open: festschreiben, was beim Lauf des Exports offen ist, ohne Vergleich mit einer gezählten Zahl. Nur bewusst einsetzen.

bookings?boolean

Buchungsstapel (EXTF): schreibt die offenen Buchungen des Zeitraums fest. Das lässt sich nicht rückgängig machen.

documents?boolean

Belege des Zeitraums als Dateien.

from?string

Erster Tag, YYYY-MM-DD.

onlyNew?boolean

Nur, 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?string

Letzter Tag, YYYY-MM-DD, nicht vor from und im selben Kalenderjahr.

Antworten

Erfolg.

application/json
  1. response

Offene Buchungen, die ein DATEV-Export des Zeitraums festschreibt.

assetDepreciation?string

Nur 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?integer

Anzahl; beim Start als open mitgeben.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/export/datev/open" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "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`.