Anlage prüfen
Benötigte Berechtigung:read(Daten lesen)
Prüft Anlagen wie POST /api/assets und zeigt, was das Anlegen schreiben würde, ohne etwas zu speichern: die Anlagen mit den möglichen Methoden und dem Vorschlag (options), den Plan je Jahr mit seiner Wirkung auf den Gewinn, die Buchungen, die sofort entstehen (jeder Monat bis heute mit dem Letzten des Monats, eine Sofortabschreibung mit dem Anschaffungstag, bei einer Einlage dazu die Einlage selbst), wohin zugerechnete Nebenkosten wandern, und bei einer Anschaffung im Vorjahr die Frage nach der Steuererklärung. POST /api/assets bucht danach genau diese Zeilen; nur die Inventarnummer vergibt bimetrics erst beim Anlegen.
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.
the assets, as for creating them
application/json- body
Neue Anlagen.
contribution?Bei der Einlage Pflicht: die Angaben zur Anlage. Sie bucht auf das Anlagekonto gegen die Privateinlage (1890 in SKR03, 2180 in SKR04).
documentId?stringBeim Kauf Pflicht: die Eingangsrechnung. Beim Altbestand aus einem älteren Beleg (GET /api/assets/opening-candidates) dieser Beleg, mit positions.
uuidexpectedVersion?stringDie zuletzt gelesene Version des Belegs, beim Anlegen über API-Schlüssel Pflicht; hat er sich geändert, lehnt die Route mit 409 AssetRejected ab.
incidentals?array<integer>Positionen mit Nebenkosten wie Lieferung oder Montage, als Stelle ab 0: verteilt auf alle Anlagen der Anfrage nach ihren Kosten, die letzte nimmt den Rest. Ihre Buchung wandert auf die Anlagekonten.
opening?Beim Altbestand ohne Beleg Pflicht: die Angaben zur Anlage. Aus einem älteren Beleg stattdessen documentId und positions.
origin?stringpurchase (aus einem Beleg, ohne Angabe), opening (Altbestand) oder contribution (Einlage aus dem Privatvermögen).
"purchase""opening""contribution"positions?array<>Beim Kauf Pflicht: die Positionen, die zur Anlage werden, zusammen höchstens 100 Anlagen. Beim Altbestand aus einem Beleg je Position eine Anlage, gesperrt wie bei einem Kauf.
priorYear?stringBei einer Anschaffung im Vorjahr Pflicht: filed, wenn die Steuererklärung (Bilanzierer: der Jahresabschluss) des Vorjahres schon abgegeben ist, sonst not_filed. Die AfA des Vorjahres steht in beiden Fällen im Vorjahr; bei filed zählt sie nur über eine Änderung der Erklärung.
"filed""not_filed"Erfolg.
application/json- response
Was das Anlegen schreiben würde.
assets?array<>|Die Anlagen, je Stück eine.
exported?booleantrue, wenn eine Buchung in einem Zeitraum liegt, der schon an DATEV übergeben ist, und der Export sie an DATEV übergibt.
incidentals?array<>Wohin zugerechnete Nebenkosten wandern.
messages?array<string>Die Sätze der App zur Vorschau.
priorYear?Bei einer Anschaffung im Vorjahr die Frage und der Hinweis.
priorYearExported?booleantrue, wenn das Vorjahr schon an DATEV übergeben ist und der Export eine neue Buchung dieses Jahres an DATEV übergibt: Sie erreicht DATEV nur mit einem eigenen Export für dieses Jahr.
receipt?Fehlt, wenn vom Beleg nichts festgeschrieben ist; sonst, in welchen Monaten das Anlegen ihn storniert und neu bucht.
curl --fail-with-body "https://app.bimetrics.de/api/assets/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "assets": [ { "account": 400, "acquired": { "day": 12, "month": 5, "year": 2026 }, "afaAccount": 4830, "afaTableEntry": "6.15 Büromöbel", "automatic": false, "aveuerGroup": "office", "bookings": [ { "account": 4830, "accountContra": 400, "amountCents": 519, "date": { "day": 31, "month": 5, "year": 2026 }, "kind": "depreciation", "label": "AfA Bürostuhl", "month": "2026-05" } ], "category": "equipment", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "computer": false, "costCents": 81000, "documentId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d13", "gross": false, "inputTaxCents": 15010, "label": "Bürostuhl", "method": "linear", "netCents": 81000, "openingBookValueCents": 0, "openingRemainingMonths": 0, "options": { "methods": [ "linear", "degressive" ], "proposed": "linear" }, "origin": "purchase", "plan": [ { "additionCents": 81000, "bookValueEndCents": 76846, "bookValueStartCents": 0, "bookedCents": 3114, "depreciationCents": 4154, "profitEffectCents": -4154, "year": 2026 }, { "bookValueEndCents": 70615, "bookValueStartCents": 76846, "bookedCents": 0, "depreciationCents": 6231, "profitEffectCents": -6231, "year": 2027 } ], "positions": [ { "costCents": 79000, "index": 0 }, { "costCents": 2000, "incidental": true, "index": 1 } ], "proposedUsefulLife": { "computer": false, "entry": "6.15 Büromöbel", "months": 156, "name": "Büromöbel", "ref": "6.15", "years": 13 }, "quantity": 1, "status": "active", "usefulLifeMonths": 156 } ], "incidentals": [ { "accounts": [ { "account": 400, "grossCents": 2380 } ], "index": 1, "label": "Lieferung" } ]}Altbestand aus Belegen GET
Liefert die Positionen älterer Eingangsbelege mit Anlagekategorie, die noch keine Anlage sind und sich als Altbestand übernehmen lassen: gekauft vor dem Startjahr 2026, später vor dem Vorjahr; über einen Leistungszeitraum abgegrenzt gebuchte nicht. Je Position Beleg, Text, Anschaffungstag und Kosten, mit einem Vorschlag aus der AfA-Tabelle dazu Restwert und Restmonate zum 1. Januar, linear gerechnet. Übernommen wird mit `POST /api/assets`, `origin` `opening`, `documentId`, `expectedVersion` (`documentVersion`) und den Positionen; die Positionen sind danach gesperrt wie bei einem Kauf. Lesen dürfen alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Anlagenbericht als PDF oder CSV GET
Liefert die Anlage AVEÜR oder den Anlagenspiegel eines Kalenderjahres als PDF oder CSV, mit denselben Werten wie `GET /api/assets/aveuer` und `GET /api/assets/schedule`. Ein anderer Bericht oder ein anderes Format ergibt `400 AssetRejected`. Benötigt einen Schlüssel mit der Berechtigung `read`.