Wartenden DATEV-Export abbrechen
Benötigte Berechtigung:datev:export(DATEV-Export starten und Buchungen festschreiben)
Echte Wirkung
/api/export/jobs/{id}/cancelKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
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/cancel" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "canCancel": false, "canDownload": false, "createdAt": "2026-11-03T09:15:00Z", "downloads": [], "errorCode": null, "expiresAt": null, "files": [], "finishedAt": "2026-11-03T09:15:30Z", "id": "3b9e6f1c-2d4a-4c8e-9f7b-5a1d0e2c4b68", "kind": "export_datev", "label": {}, "phase": "book", "progress": { "done": 0, "total": 0 }, "startedAt": null, "startedBy": { "name": "Erika Beispiel", "self": true }, "status": "cancelled", "waitReason": null}Stand eines DATEV-Exports abrufen GET
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`.
Datei eines DATEV-Exports laden POST
Stellt ein Ticket für eine Datei eines fertigen Exports aus. Die Datei lädst du mit `GET` auf `url`, relativ zu `https://app.bimetrics.de`, ohne Schlüssel: Das Ticket ist der Zugang. Es gilt 60 Sekunden; in dieser Zeit beginnst du den Download, ein laufender Download bricht danach nicht ab. Mit `Range` setzt du einen abgebrochenen Download fort, nach Ablauf mit einem neuen Ticket. Benötigt einen Schlüssel mit der Berechtigung `datev:export`.