# Wartenden DATEV-Export abbrechen (https://developer.bimetrics.de/reference/accounting/cancel-export-job)

`POST https://app.bimetrics.de/api/export/jobs/{id}/cancel`

operationId: `cancelExportJob` · Berechtigung (Scope): `datev:export` · Bereich: Buchhaltung

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

> **Achtung:** Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
>
> KI-Agenten fragen vor diesem Aufruf beim Nutzer nach.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `id` | path | ja | string (uuid) | ID des Exports (UUID), `id` aus der Antwort von `startDatevExport`. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/export/jobs/{id}/cancel" -X POST \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: ExportJob |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 404 | Nicht gefunden (`NotFound`). | `application/json`: Error |
| 409 | Der Export wartet nicht mehr (`ExportJobNotWaiting`): Er läuft schon oder ist beendet. Per API lässt er sich nur abbrechen, solange er wartet. `getExportJob` zeigt seinen Stand. | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`ExportJob`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `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 (date-time) | Auftrag gestartet am. |
| `downloads` | Array<ExportDownload>, kann null sein | Wer welche Datei wann geladen hat. |
| `errorCode` | string, kann null sein | 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` | string (date-time), kann null sein | Tag, an dem die Datei gelöscht wird, sonst `null`. |
| `files` | Array<ExportFile>, kann null sein | Dateien des fertigen Exports. |
| `finishedAt` | string (date-time), kann null sein | Beendet am, sonst `null`. |
| `id` | string (uuid) | ID des Exports. |
| `kind` | string | Immer `export_datev`. |
| `label` | beliebig | 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` | ExportJobProgress | Fortschritt des Schritts, sofern er sich zählen lässt. |
| `startedAt` | string (date-time), kann null sein | Lauf begonnen am, sonst `null`. |
| `startedBy` | ExportJobStarter | Wer ihn gestartet hat. |
| `status` | string | `waiting`, `running`, `done`, `failed`, `cancelled` oder `expired` (Datei gelöscht). |
| `waitReason` | string, kann null sein | 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`. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
