Anlage AVEÜR lesen
Benötigte Berechtigung:read(Daten lesen)
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
year*integerKalenderjahr, ab 2025.
Erfolg.
application/json- response
Anlage AVEÜR eines Jahres.
electricVehicle?booleantrue, wenn ein Elektro- oder extern aufladbares Hybridfahrzeug vorhanden ist (Kennzahl 407).
euer?Die Werte für die Anlage EÜR.
groups?array<>|Die Gruppen in der Reihenfolge des Vordrucks.
messages?array<string>Hinweise der App.
movableDepreciationCents?integerAfA beweglicher Wirtschaftsgüter gesamt (Kennzahl 490) in Cent.
sales?array<>|Verkäufe des Jahres und im Jahr bezahlte, für Kennzahl 102.
year?integerKalenderjahr.
curl --fail-with-body "https://app.bimetrics.de/api/assets/aveuer?year=0" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "electricVehicle": false, "euer": { "bookValueCents": 600000, "gwgCents": 0, "intangibleCents": 0, "movableCents": 160000, "proceedsCents": 700000 }, "groups": [ { "additionCents": 0, "bookValueEndCents": 0, "bookValueStartCents": 760000, "codes": { "addition": "422", "bookValueEnd": "426", "bookValueStart": "421", "costStart": "420", "depreciation": "424", "disposal": "425", "special": "423" }, "costStartCents": 1200000, "depreciationCents": 160000, "disposalCents": 600000, "group": "other", "specialCents": 0, "title": "Andere bewegliche Wirtschaftsgüter" } ], "movableDepreciationCents": 160000, "sales": [ { "assetId": "6f1d2c3b-4a5e-4f60-8a7b-9c0d1e2f3a4b", "date": { "day": 20, "month": 8, "year": 2028 }, "label": "Fräsmaschine", "number": "A-0001", "openCents": 0, "payments": [ { "date": { "day": 20, "month": 8, "year": 2028 }, "netCents": 700000 } ], "proceedsNetCents": 700000 } ], "year": 2028}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`.
Altbestand übernehmen POST
Übernimmt die Anlagen der Liste wie die Vorschau, höchstens 100, je eine Anlage wie `POST /api/assets` mit `origin` `opening`. Auf dem Anlagekonto bucht nichts; sofort gebucht wird die AfA jedes Monats des laufenden Jahres bis heute. Eine Anlage aus einem Beleg (`documentId`, `position`, `documentVersion`) sperrt dessen Position wie ein Kauf, so wird keine Position zweimal Anlage. Lehnt die Route eine Zeile ab, wird nichts übernommen; `context.message` beginnt mit „Zeile n“. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.