Nutzungsdauer einer Anlage ändern
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/api/assets/{id}/planKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
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).
uuidIdempotency-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 new remaining useful life
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
Anlage mit neuer Nutzungsdauer.
asset?Die Anlage mit ihrem neuen Plan.
replayed?booleantrue bei einer Wiederholung.
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/plan" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "asset": { "account": 400, "acquired": { "day": 12, "month": 5, "year": 2026 }, "afaAccount": 4830, "afaTableEntry": "6.15 Büromöbel", "automatic": false, "aveuerGroup": "office", "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", "planChanges": [ { "from": "2028-11", "reason": "Wird früher ersetzt als geplant.", "remainingMonths": 24 } ], "positions": [ { "costCents": 79000, "index": 0 }, { "costCents": 2000, "incidental": true, "index": 1 } ], "quantity": 1, "status": "active", "updatedAt": "2026-11-15T10:00:00Z", "usefulLifeMonths": 156 }}Rücknahme eines Abgangs prüfen POST
Zeigt, was das Zurücknehmen eines Abgangs schreibt, ohne etwas zu speichern: Der Restwert wird storniert, die AfA bis zum Abgangsmonat bleibt, die Monate danach bucht bimetrics bis heute nach. Benötigt einen Schlüssel mit der Berechtigung `read`.
Nutzungsdauer einer Anlage ändern prüfen POST
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`.