bimetricsEntwickler
Buchhaltung

Wartenden DATEV-Export abbrechen

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/jobs/{id}/cancel

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

Authentifizierung

headerAuthentifizierungBearer <bm_…>

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

Pfadparameter

id*string

ID des Exports (UUID), id aus der Antwort von startDatevExport.

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Ein DATEV-Export im Hintergrund.

canCancel?boolean

Ob er sich in der App abbrechen lässt. Per API geht das nur bei waiting.

canDownload?boolean

Ob es eine Datei zum Laden gibt.

createdAt?string

Auftrag gestartet am.

Formatdate-time
downloads?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.

Formatdate-time
files?array<>|

Dateien des fertigen Exports.

finishedAt?|

Beendet am, sonst null.

Formatdate-time
id?string

ID des Exports.

Formatuuid
kind?string

Immer export_datev.

label?unknown

Was exportiert wird: from, to, bookings, documents, protocol, onlyNew und open, die bestätigte Zahl offener Buchungen.

phase?string

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

Formatdate-time
startedBy?|

Wer ihn gestartet hat.

status?string

waiting, 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.

Beispielanfrage
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"
Beispielantwort
{  "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}