Originaldatei eines Belegs laden
Benötigte Berechtigung:read(Daten lesen)
Liefert die hochgeladene Originaldatei als Binärdaten. PDFs und Bilder kommen mit ihrem Typ (application/pdf, image/png, image/jpeg), alles andere, etwa XML-E-Rechnungen, als application/octet-stream. Der ETag ist der SHA-256 der Datei (Hex, ohne Anführungszeichen); mit genau diesem Wert in If-None-Match antwortet die Route mit 304 ohne Inhalt. 404, wenn der Beleg keine Originaldatei hat.
Benötigt einen Schlüssel mit der Berechtigung read.
Unveränderte Datei (304)
If-None-Match und lädt die Datei immer. Schickst du den ETag einer früheren Antwort in If-None-Match mit und ist die Datei unverändert, antwortet die API mit 304 ohne Inhalt und ohne ETag. Behalte dann die gespeicherte Datei, statt sie mit der leeren Antwort zu überschreiben. Ein vollständiges Beispiel steht im Monatsexport.Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
In: header
Pfadparameter
ID des Belegs (UUID).
uuidQuery-Parameter
Beliebiger nicht leerer Wert, z. B. 1: Die Antwort trägt Content-Disposition: attachment mit dem ursprünglichen Dateinamen.
Header-Parameter
ETag einer früheren Antwort; stimmt er, antwortet die Route mit 304.
Antworten
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl --fail-with-body "https://app.bimetrics.de/api/document/497f6eca-6276-4993-bfeb-53cbbbba6f08/content" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ --output beleg.pdfBinärdaten: die Datei selbst, kein JSON.
Beleg lesen GET
Liefert einen Beleg mit erkannten Daten, Positionen, Zuordnung (`match`) und Buchungen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Kontakte suchen POST
Sucht Kontakte (Kunden und Lieferanten) der Firma mit einem Filter und liefert eine Seite der Treffer. Benötigt einen Schlüssel mit der Berechtigung `read`.