bimetricsEntwickler
Buchhaltung

Datei eines DATEV-Exports laden

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}/files/{name}/ticket

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

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
name*string

Name einer Datei aus files des fertigen Exports.

Antworten

Erfolg.

application/json
  1. response

Ticket für eine Datei.

expiresAt?string

Gültig bis.

Formatdate-time
url?string

Pfad zum Laden, relativ zu https://app.bimetrics.de, ohne Schlüssel.

Beispielanfrage
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"
Beispielantwort
{  "expiresAt": "2026-11-03T09:18:00Z",  "url": "/api/export/download/cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd"}