Anlagenverzeichnis lesen
Benötigte Berechtigung:read(Daten lesen)
Liefert das Anlagenverzeichnis eines Kalenderjahres: jede Anlage, die in dem Jahr zum Betrieb gehört, mit den Zahlen des Jahres (year): Restwert am 1. Januar, Zugang, Abschreibung laut Plan und gebucht, Restwert am 31. Dezember. Eine stornierte Anlage steht in ihrem Anschaffungsjahr ohne Zahlen darin, eine zurückgenommene gar nicht. Mit documentId statt year liefert sie die Anlagen eines Belegs, das automatische GWG eingeschlossen, in jedem Stand außer undone, mit den Zahlen des laufenden Jahres und dem Weg der Rücknahme (reverseMode). Lesen dürfen alle Rollen.
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.
year?integerKalenderjahr des Verzeichnisses, etwa 2026. Ohne documentId Pflicht.
documentId?stringStatt eines Jahres: der Beleg, dessen Anlagen die Route liefert.
Erfolg.
application/json- response
Anlagenverzeichnis eines Jahres oder Anlagen eines Belegs.
documentId?stringDer angefragte Beleg; fehlt beim Verzeichnis eines Jahres.
uuiditems?array<>|Die Anlagen nach Inventarnummer.
year?integerKalenderjahr; bei documentId das laufende.
curl --fail-with-body "https://app.bimetrics.de/api/assets" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "items": [ { "account": 400, "acquired": { "day": 12, "month": 5, "year": 2026 }, "afaAccount": 4830, "afaTableEntry": "6.15 Büromöbel", "automatic": false, "aveuerGroup": "office", "category": "equipment", "channel": "api", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "computer": false, "costCents": 81000, "createdAt": "2026-11-15T10:00:00Z", "documentId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d13", "enteredAt": "2026-11-15T10:00:00Z", "gross": false, "id": "5e8c1a3f-7b2d-4c69-a0e4-9d1f3b5c7e82", "inputTaxCents": 15010, "label": "Bürostuhl", "method": "linear", "netCents": 81000, "number": "A-0007", "openingBookValueCents": 0, "openingRemainingMonths": 0, "origin": "purchase", "positions": [ { "costCents": 79000, "index": 0 }, { "costCents": 2000, "incidental": true, "index": 1 } ], "quantity": 1, "status": "active", "updatedAt": "2026-11-15T10:00:00Z", "usefulLifeMonths": 156, "year": { "additionCents": 81000, "bookValueEndCents": 76846, "bookValueStartCents": 0, "bookedCents": 3114, "depreciationCents": 4154, "profitEffectCents": -4154, "year": 2026 } } ], "year": 2026}Kontoauszug hochladen POST
Speichert eine Datei der Bank, gelesen und gebucht wird noch nichts. Eine Datei, die bimetrics nicht lesen kann, wird mit dem Grund abgelehnt (`422`), zu große mit `413 BankStatementTooLarge`. Dieselbe Datei, noch nicht übernommen, ergibt denselben Upload und keine neue Zeile. `sameFile` nennt einen Import, der diese Datei schon übernommen hat. Nicht übernommene Dateien löscht bimetrics nicht von selbst. Benötigt einen Schlüssel mit der Berechtigung `statements:import`.
Anlage anlegen POST
Legt Anlagen aus Positionen einer Eingangsrechnung an, je Stück eine, übernimmt eine als Altbestand (`origin` `opening`) oder legt sie aus dem Privatvermögen ein (`origin` `contribution`, nur bei Einzelunternehmen, GbR und OHG). Anschaffungstag ist der Beginn eines eigenen Zeitraums der Position, sonst das Lieferdatum, sonst der Beginn des Leistungszeitraums, sonst das Rechnungsdatum. Die Anschaffungskosten sind netto, beim Kleinunternehmer brutto. Sofort gebucht wird die AfA jedes Monats vom Anschaffungsmonat bis heute, mit dem Datum ihres Monats, auf das AfA-Konto gegen das Anlagekonto. Eine Anschaffung im Vorjahr geht nur mit `priorYear`; ihre AfA steht dann im Vorjahr. Ältere Käufe sind Altbestand. Zugerechnete Nebenkosten (`incidentals`) bucht der Beleg danach auf die Anlagekonten. Solange die Anlage besteht, sind Betrag, Kategorie und Datum ihrer Positionen gesperrt (`409 AssetPositionLocked`). Verstößt die Anfrage gegen eine Regel, antwortet die Route mit `400` oder `409 AssetRejected`, `context.message` nennt den Satz der App. Läuft gerade eine Neubuchung nach einem Wechsel des Steuerstatus, lehnt sie ab. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.