Anlage anlegen
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/api/assetsKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Idempotency-Key*stringStabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.
^[!-~]+$1 <= length <= 128the assets
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
Angelegte Anlagen.
assets?array<>|Die Anlagen mit Nummer, Plan und Buchungen; bei einer Wiederholung die des ersten Aufrufs.
replayed?booleantrue bei einer Wiederholung.
curl --fail-with-body "https://app.bimetrics.de/api/assets" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -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 }, "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 } } ]}Anlagenverzeichnis lesen GET
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`.
Anlage AVEÜR lesen GET
Liefert die Anlage AVEÜR eines Kalenderjahres aus den gebuchten Werten: je Gruppe (immaterielle Wirtschaftsgüter, Kfz, Büroausstattung, andere) AK-Summe und Buchwert zu Beginn, Zugänge, AfA, Abgänge (Restbuchwerte) und Buchwert am Ende, mit den Kennzahlen des Vordrucks in `codes`. Dazu die AfA beweglicher Wirtschaftsgüter gesamt (490), ob ein Elektro- oder extern aufladbares Hybridfahrzeug vorhanden ist (407), und für die Anlage EÜR AfA (130, 131), GWG (132) und Restbuchwerte (135). GWG stehen nicht in den Gruppen. Die Kennzahlen bleiben, die Zeilen des Vordrucks wandern jedes Jahr. Benötigt einen Schlüssel mit der Berechtigung `read`.