Kategorien auflisten
Benötigte Berechtigung:read(Daten lesen)
Liefert die Kategorien, die die App der Firma zur Auswahl anbietet. Der Schlüssel (key) ist der Wert von category in Belegpositionen, Buchungsvorlagen und Zuordnungen; die Kategorie einer Position bestimmt das Konto ihrer Buchung. attributes sagt, wofür eine Kategorie taugt.
Benötigt einen Schlüssel mit der Berechtigung read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Erfolg.
application/json- response
[index: integer]?Eine Kategorie für Positionen, Buchungsvorlagen oder Zuordnungen.
curl --fail-with-body "https://app.bimetrics.de/api/category/" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"[ { "attributes": { "receipt": true }, "description": "Ausgaben für Büromaterialien wie Papier, Stifte und Notizblöcke.", "key": "office_supplies", "keywords": "Bürobedarf, Papier, Stift, Notizblock, Druckerpapier, Schreibwaren, Ordner", "title": "Bürobedarf" }, { "attributes": { "match": { "document": "one_to_many", "minimum": 2, "transaction": "many" } }, "description": "Zuordnung von Zahlungen zu einer oder mehreren Rechnungen bzw. Belegen.", "key": "payment", "keywords": "", "title": "Zahlung" }]Buchung lesen GET
Liefert eine Buchung mit Buchungsart, Stand gegenüber DATEV und Herkunft. Benötigt einen Schlüssel mit der Berechtigung `read`.
Nachträge in schon exportierten Monaten GET
Zählt je Monat die Nachträge außerhalb des Zeitraums `from` bis `to`, also Buchungen, die in den Zeitraum eines schon zugestellten Exports fallen und in DATEV trotzdem noch fehlen, etwa die Buchung eines Belegs vom 31.10., der erst nach dem Export des Oktobers kam. Maßgeblich ist der Zeitraum, für den exportiert wurde. Ein Export ohne gespeicherten Zeitraum (vor dem 04.11.2026) gilt für die ganzen Monate seiner Buchungen. Ein Export von `from` bis `to` nimmt diese Nachträge nicht mit, nur ein erneuter Export ihrer Monate mit „Nur noch nicht exportierte“. `export.addendum` an der einzelnen Buchung folgt derselben Regel. Benötigt einen Schlüssel mit der Berechtigung `read`.