Anlage lesen
Benötigte Berechtigung:read(Daten lesen)
Liefert eine Anlage mit ihrem Plan je Kalenderjahr bis 0 €, ihren Buchungen und dem Weg, auf dem sie sich jetzt zurücknehmen ließe (reverseMode): undo (Rückgängig) bis undoUntil, sonst cancel (Storno). Auch eine zurückgenommene Anlage ist so zu finden; ihre Inventarnummer bleibt vergeben. Eine ID einer anderen Firma ergibt 404 AssetNotFound.
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.
id*stringID der Anlage (UUID).
uuidErfolg.
application/json- response
Anlage mit Plan und Buchungen.
account?integerAnlagekonto im Kontenrahmen der Firma, das die AfA im Haben bucht.
acquired?Anschaffungstag: Beginn eines eigenen Zeitraums der Position, sonst Lieferdatum, sonst Beginn des Leistungszeitraums, sonst Rechnungsdatum; beim Altbestand das Kaufdatum, bei einer Einlage der Tag der Einlage.
afaAccount?integerAfA-Konto der Anlage im Kontenrahmen der Firma, im Soll gebucht.
afaTableEntry?stringEintrag der amtlichen AfA-Tabelle, dem die Nutzungsdauer folgt.
automatic?booleantrue für ein GWG, das der Beleg von selbst anlegt; false für eine ausdrücklich angelegte Anlage.
aveuerGroup?stringGruppe der Anlage AVEÜR: intangible (immaterielle Wirtschaftsgüter), vehicle (Kfz), office (Büroausstattung) oder other; leer bei einem GWG.
bookings?array<>Nur beim Lesen einer Anlage: ihre Buchungen in den Büchern samt Gegenbuchungen, ohne die mit Löschvermerk.
cancelReason?stringGrund des Stornos, beim Rückgängig freiwillig.
category?stringArt der Anlage: software, website, machine, car, truck, equipment (Betriebsausstattung), office_furniture (Büroeinrichtung) oder gwg. Bei einem Kauf folgt sie der Kategorie der Position.
channel?stringWo die Anlage angelegt wurde: web, api oder mcp.
companyId?stringID der Firma.
uuidcomputer?booleantrue für Computer und Software nach dem BMF-Schreiben vom 22.02.2022; nur dann geht full_year.
costCenterId?stringKostenstelle der Anlage, beim Kauf die des Belegs; die AfA bucht auf sie.
uuidcostCents?integerAnschaffungskosten samt Nebenkosten, netto, beim Kleinunternehmer brutto; beim Altbestand der Kaufpreis, bei einer Einlage der Einlagewert in Cent.
createdAt?stringAnlage in bimetrics.
date-timecreatedByMembershipId?stringWer die Anlage angelegt hat.
uuiddegressivePercent?numberNur bei degressive: der Satz je Jahr in Prozent mit zwei Nachkommastellen, das Dreifache des linearen Satzes, höchstens 30 % (§ 7 Abs. 2 EStG). Fehlt nach einer Änderung der Nutzungsdauer.
disposalContraAccount?integerKreditor des Händlers, gegen den der Erlös eines Verkaufs ohne Rechnung bucht.
disposalDate?Abgangstag, der Tag der Lieferung; fehlt ohne Abgang.
disposalDocumentId?stringDie Rechnung oder Gutschrift des Händlers, mit der ein Verkauf ohne Rechnung verrechnet ist.
uuiddisposalInvoiceId?stringDie Ausgangsrechnung, die die Anlage verkauft.
uuiddisposalKind?stringArt des Abgangs: sale (Verkauf) oder scrap (Verschrottung).
disposalPositions?array<integer>Die Positionen dieser Rechnung, die die Anlage verkaufen, ab 0.
disposalProceedsCents?integerErlös netto eines Verkaufs in Cent.
disposalReason?stringGrund einer Verschrottung.
disposalVatCents?integerUmsatzsteuer eines Verkaufs ohne Rechnung in Cent.
disposalsTakenBack?array<>Die Tage der zurückgenommenen Abgänge, in ihrer Reihenfolge.
documentId?stringDer Beleg eines Kaufs oder eines Altbestands aus einem Beleg. Die AfA-Buchungen tragen ihn nicht.
uuiddrive?stringAntrieb eines Fahrzeugs: combustion, electric oder plug_in_hybrid; leer bei anderen Anlagen.
enteredAt?stringZeitpunkt des Anlegens. Ab ihm laufen die 30 Tage für Rückgängig und die Schonfrist vor der Festschreibung.
date-timegross?booleantrue, wenn die Anschaffungskosten brutto sind (Kleinunternehmer).
id?stringID der Anlage.
uuidinputTaxCents?integerUmsatzsteuer der Position: abziehbare Vorsteuer, beim Kleinunternehmer der nicht abziehbare Teil der Anschaffungskosten in Cent.
label?stringBezeichnung, höchstens 120 Zeichen. Bei mehreren Stücken mit „(1/3)“.
linearFrom?stringNur bei degressive nach einer Änderung der Nutzungsdauer: der Monat (YYYY-MM), seit dem die Anlage linear abgeschrieben wird.
method?stringMethode der AfA: linear, degressive (30 % für bewegliche Güter, angeschafft von Juli 2025 bis Ende 2027), full_year (Computer und Software im Anschaffungsjahr voll), electric_vehicle (75/10/5/5/3/2 % für reine E-Fahrzeuge, angeschafft von Juli 2025 bis Ende 2027) oder gwg (bis 800 € netto je Stück im Anschaffungsmonat voll).
netCents?integerNettobetrag samt Nebenkosten, für die GWG-Grenze in Cent.
number?stringInventarnummer A-0001, je Firma fortlaufend und nie wiederverwendet, auch nicht nach Storno oder Rückgängig.
openingBookValueCents?integerBeim Altbestand der Restwert am Stichtag in Cent.
openingDate?Beim Altbestand der Stichtag 1. Januar, ab dem bimetrics die Anlage fortführt.
openingRemainingMonths?integerBeim Altbestand die Restmonate ab dem Stichtag.
origin?stringHerkunft: purchase (aus einem Beleg), opening (Altbestand) oder contribution (Einlage aus dem Privatvermögen).
plan?array<>Nur beim Lesen einer Anlage: der Plan je Kalenderjahr bis 0 €.
planChanges?array<>Die Änderungen der Nutzungsdauer in ihrer Reihenfolge (POST /api/assets/{id}/plan).
positions?array<>Die Positionen des Belegs, die zur Anlage gehören, mit ihrem Anteil.
priorYearAnswer?stringBei einer Anschaffung im Vorjahr die Antwort, ob dessen Steuererklärung (Bilanzierer: Jahresabschluss) schon abgegeben ist: filed oder not_filed.
quantity?integerStückzahl: 1, nur ein GWG mit Menge bleibt eine Anlage.
reverseMode?stringWie sie sich jetzt zurücknehmen ließe: undo (Rückgängig) oder cancel (Storno). Fehlt, wenn sie storniert oder zurückgenommen ist.
"undo""cancel"status?stringStand: active, disposed (abgegangen), cancelled (storniert) oder undone (zurückgenommen).
undoUntil?stringSolange Rückgängig geht: der späteste Zeitpunkt dafür. Eine Festschreibung beendet es früher.
date-timeupdatedAt?stringLetzte Änderung.
date-timeusefulLifeMonths?integerNutzungsdauer in Monaten bei linear und degressive, sonst 0.
usefulLifeReason?stringGrund für eine eigene, kürzere Nutzungsdauer, etwa „gebraucht gekauft“.
version?stringVersion der Anlage, wie gelesen; ein Abgang und seine Rücknahme nennen sie als expectedVersion.
year?Zahlen des Jahres: im Verzeichnis des angefragten, sonst des laufenden. Fehlt bei einer stornierten Anlage im Verzeichnis.
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "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 }, "id": "9a7c5e3b-1d4f-4b28-8e6a-0c2e4f6a8b35", "kind": "depreciation", "label": "AfA A-0007 Bürostuhl", "month": "2026-05" } ], "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", "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 } ], "quantity": 1, "reverseMode": "undo", "status": "active", "undoUntil": "2026-12-15T10:00:00Z", "updatedAt": "2026-11-15T10:00:00Z", "usefulLifeMonths": 156, "year": { "additionCents": 81000, "bookValueEndCents": 76846, "bookValueStartCents": 0, "bookedCents": 3114, "depreciationCents": 4154, "profitEffectCents": -4154, "year": 2026 }}Nutzungsdauer in der AfA-Tabelle suchen GET
Sucht in der amtlichen AfA-Tabelle für allgemein verwendbare Anlagegüter (AfA-Tabelle AV des BMF) mit Wörtern aus dem Alltag, wie die Suche im Block „Anlage“ der App. Liefert höchstens acht Einträge, den besten zuerst, je mit Fundstelle, Nutzungsdauer und der Angabe, ob es Computer-Hardware ist. `entry`, `months` und `computer` gehen als `afaTableEntry`, `usefulLifeMonths` und `computer` in `POST /api/assets/preview`. Passt nichts, braucht eine eigene Nutzungsdauer einen Grund (`usefulLifeReason`). Lesen dürfen alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Abgang einer Anlage buchen POST
Bucht den Abgang wie die Vorschau: die AfA bis zum Abgangsmonat (er zählt voll und trägt den Abgangstag), den Restwert am Abgangstag auf das Konto nach Art und Ergebnis gegen das Anlagekonto. Spätere Monate werden entfernt oder storniert. Beim Verkauf an der Rechnung bekommen ihre Positionen die Kategorie `asset_sale` (Anlagenverkauf), und die Rechnung bucht neu: Offenes wird ersetzt, Festgeschriebenes mit seinem Datum storniert und neu gebucht. `expectedVersion` ist Pflicht. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.