Nutzungsdauer einer Anlage ändern prüfen
Benötigte Berechtigung:read(Daten lesen)
Prüft eine neue Restnutzungsdauer wie POST /api/assets/{id}/plan und zeigt, was sie ändert, ohne etwas zu speichern: den ersten noch nicht gebuchten Monat, ab dem sie gilt, den Restwert, der ab dort verteilt wird, den letzten Monat und den Plan je Kalenderjahr vorher und nachher. Nur bei linear und degressive; eine degressive Anlage schreibt danach linear weiter (§ 7 Abs. 3 EStG). Gebuchte Monate bleiben, auch festgeschriebene und an DATEV übergebene.
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).
uuidthe new remaining useful life, as for changing it
application/json- body
Neue Restnutzungsdauer einer Anlage.
confirmPriorYear?booleanBestätigt eine neue Dauer, die in einem früheren Jahr beginnt; sie ändert dessen Gewinn. Ohne Bestätigung lehnt die Route dann ab.
expectedVersion?stringversion der Anlage, wie gelesen; hat sie sich inzwischen geändert, lehnt die Route ab.
from?stringBeim Ändern Pflicht: from aus der Vorschau (YYYY-MM). Ist dieser Monat inzwischen gebucht, etwa nachts durch die monatliche Abschreibung, lehnt die Route mit 409 ab; dann neu prüfen.
reason?stringBeim Ändern Pflicht: der Grund der neuen Dauer, höchstens 500 Zeichen. Eine kürzere Nutzungsdauer braucht steuerlich einen Grund.
length <= 500remainingMonths?integerNeue Restnutzungsdauer in Monaten ab dem ersten noch nicht gebuchten Monat, 1 bis 1200.
1 <= value <= 1200Erfolg.
application/json- response
Was eine neue Restnutzungsdauer ändert.
after?array<>|Der Plan je Kalenderjahr nach der Änderung.
before?array<>|Der Plan je Kalenderjahr jetzt.
bookValueCents?integerRestwert, der ab from verteilt wird in Cent.
bookings?array<>|Buchungen, die die Änderung sofort schreibt: Monate des neuen Plans bis heute, die noch nicht gebucht sind, meist keine.
from?stringErster noch nicht gebuchter Monat (YYYY-MM): Ab ihm gilt die neue Dauer.
lastMonth?stringLetzter Monat des neuen Plans (YYYY-MM).
messages?array<string>|Was die App dazu sagt, etwa der Wechsel von degressiv zu linear.
priorYear?booleantrue, wenn die neue Dauer in einem früheren Jahr beginnt; dann ist confirmPriorYear Pflicht.
remainingMonths?integerDie neue Restnutzungsdauer in Monaten.
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/plan/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "after": [ { "bookValueEndCents": 553333, "bookValueStartCents": 800000, "bookedCents": 200000, "depreciationCents": 246667, "profitEffectCents": -246667, "year": 2028 } ], "before": [ { "bookValueEndCents": 560000, "bookValueStartCents": 800000, "bookedCents": 200000, "depreciationCents": 240000, "profitEffectCents": -240000, "year": 2028 } ], "bookValueCents": 560000, "bookings": [], "from": "2028-11", "lastMonth": "2030-10", "messages": [], "remainingMonths": 24}Nutzungsdauer einer Anlage ändern POST
Gibt der Anlage wie die Vorschau eine neue Restnutzungsdauer ab dem ersten noch nicht gebuchten Monat: Der Restwert ab dort wird gleichmäßig auf die neuen Monate verteilt, Gebuchtes bleibt, die monatliche Abschreibung bucht den neuen Plan. Eine zweite Änderung im selben Monat ersetzt die erste. `expectedVersion`, `from` aus der Vorschau und `reason` sind Pflicht, eine neue Dauer ab einem früheren Jahr braucht `confirmPriorYear`. Weichen gebuchte Abschreibungen vom Plan ab, lehnt die Route ab. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.
Anlage zurücknehmen oder stornieren POST
Nimmt eine Anlage zurück (`undo`) oder storniert sie mit Grund (`cancel`), wie die Vorschau es sagt. `expectedMode` ist Pflicht: Gilt der Weg der Vorschau nicht mehr, etwa weil inzwischen eine Buchung festgeschrieben ist, antwortet die Route mit `409 AssetUndoNotPossible` und storniert nicht still. Ändert ein Storno den Gewinn eines früheren Jahres (`priorYears` der Vorschau), braucht es `confirmPriorYear`. Danach ist die Anlage `undone` oder `cancelled`, ihre Positionen im Beleg sind wieder frei. Gelöscht wird nie: Die Anlage bleibt mit ihrer Nummer erhalten, jede Änderung steht im Änderungsprotokoll. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.