Datei eines DATEV-Exports laden
Benötigte Berechtigung:datev:export(DATEV-Export starten und Buchungen festschreiben)
Echte Wirkung
/api/export/jobs/{id}/files/{name}/ticketKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
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.
uuidname*stringName einer Datei aus files des fertigen Exports.
Erfolg.
application/json- response
Ticket für eine Datei.
expiresAt?stringGültig bis.
date-timeurl?stringPfad zum Laden, relativ zu https://app.bimetrics.de, ohne Schlüssel.
curl --fail-with-body "https://app.bimetrics.de/api/export/jobs/497f6eca-6276-4993-bfeb-53cbbbba6f08/files/string/ticket" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "expiresAt": "2026-11-03T09:18:00Z", "url": "/api/export/download/cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd"}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`.
Tarif und Kontingent lesen GET
Liefert Tarif, Grenzen und die aktuelle Nutzung der Firma. Ein einfacher erster Aufruf, um Schlüssel und Verbindung zu prüfen. Benötigt einen Schlüssel mit der Berechtigung `read`.