bimetricsEntwickler
Buchhaltung

Stand eines DATEV-Exports abrufen

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.
get/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.

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" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "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}