Stand eines DATEV-Exports abrufen
Benötigte Berechtigung:datev:export(DATEV-Export starten und Buchungen festschreiben)
Echte Wirkung
/api/export/jobs/{id}Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Liefert den Stand eines DATEV-Exports: waiting, running, done, failed, cancelled oder expired. Ist er fertig (done), stehen seine Dateien in files; jede lädst du über ein Ticket von issueExportFileTicket.
Ob die Buchungen festgeschrieben sind (nur mit bookings: true): bei waiting nein, bei running ab dem Schritt write, bei done und expired ja. Läuft ein Auftrag nach einem abgebrochenen Versuch erneut, kann er schon vor write festgeschrieben sein. Bei failed oder cancelled nur mit errorCode datev_interrupted. In diesem Fall ist die Datei nicht fertig geworden. Exportiere den Zeitraum noch einmal mit onlyNew: true; die Buchungen sind dann dabei. Jeder andere errorCode heißt: nichts festgeschrieben.
Andere Exporte der App, etwa Beleg-ZIPs, liefert die Route nicht (404).
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.
id*stringID des Exports (UUID), id aus der Antwort von startDatevExport.
uuidErfolg.
application/json- response
Ein DATEV-Export im Hintergrund.
canCancel?booleanOb er sich in der App abbrechen lässt. Per API geht das nur bei waiting.
canDownload?booleanOb es eine Datei zum Laden gibt.
createdAt?stringAuftrag gestartet am.
date-timedownloads?array<>|Wer welche Datei wann geladen hat.
errorCode?|Bei failed oder cancelled: datev_interrupted heißt, die Buchungen sind festgeschrieben, die Datei aber nicht fertig. Jeder andere Code heißt, nichts ist festgeschrieben, etwa datev_changed (die offenen Buchungen haben sich geändert), storage_full (zu wenig Speicher), tax_rebook_running (bimetrics bucht nach einem Wechsel der Versteuerung neu) oder starter_inactive (wer ihn gestartet hat, gehört nicht mehr zur Firma).
expiresAt?|Tag, an dem die Datei gelöscht wird, sonst null.
date-timefiles?array<>|Dateien des fertigen Exports.
finishedAt?|Beendet am, sonst null.
date-timeid?stringID des Exports.
uuidkind?stringImmer export_datev.
label?unknownWas exportiert wird: from, to, bookings, documents, protocol, onlyNew und open, die bestätigte Zahl offener Buchungen.
phase?stringSchritt eines laufenden Exports: book (bucht, was fehlt), plan (bereitet das Festschreiben vor; erst sein Ende schreibt fest), write (schreibt die Datei; die Buchungen sind festgeschrieben).
progress?Fortschritt des Schritts, sofern er sich zählen lässt.
startedAt?|Lauf begonnen am, sonst null.
date-timestartedBy?|Wer ihn gestartet hat.
status?stringwaiting, running, done, failed, cancelled oder expired (Datei gelöscht).
waitReason?|Warum er wartet: datev_running oder lock:bookings (ein anderer DATEV-Export der Firma läuft), tax_rebook (bimetrics bucht nach einem Wechsel der Versteuerung neu) oder slot (er wartet auf einen freien Platz). Er startet von selbst. Sonst null.
curl --fail-with-body "https://app.bimetrics.de/api/export/jobs/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "canCancel": false, "canDownload": true, "createdAt": "2026-11-03T09:15:00Z", "downloads": [], "errorCode": null, "expiresAt": "2026-12-03T09:16:40Z", "files": [ { "name": "BUCHUNGEN_2026-10-01_-_2026-10-31_BITTE_ENTPACKEN-NEU.zip", "sha256": "abababababababababababababababababababababababababababababababab", "size": 1834512 } ], "finishedAt": "2026-11-03T09:16:40Z", "id": "3b9e6f1c-2d4a-4c8e-9f7b-5a1d0e2c4b68", "kind": "export_datev", "label": {}, "phase": "write", "progress": { "done": 0, "total": 0 }, "startedAt": "2026-11-03T09:15:02Z", "startedBy": { "name": "Erika Beispiel", "self": true }, "status": "done", "waitReason": null}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`.
Wartenden DATEV-Export abbrechen POST
Bricht einen DATEV-Export ab, solange er wartet (`status` `waiting`). Dann ist nichts festgeschrieben. Läuft er schon oder ist er beendet, antwortet die Route mit `409 ExportJobNotWaiting`. Einen laufenden Export brichst du nur in der App ab; sie zeigt, in welchem Schritt er ist. Ist er schon im Schritt `write`, bleiben die Buchungen festgeschrieben. Benötigt einen Schlüssel mit der Berechtigung `datev:export`.