bimetricsEntwickler
Anlagen

Nutzungsdauer einer Anlage ändern prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/assets/{id}/plan/preview

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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID der Anlage (UUID).

Formatuuid

Request-Body

the new remaining useful life, as for changing it

application/json
  1. body

Neue Restnutzungsdauer einer Anlage.

confirmPriorYear?boolean

Bestätigt eine neue Dauer, die in einem früheren Jahr beginnt; sie ändert dessen Gewinn. Ohne Bestätigung lehnt die Route dann ab.

expectedVersion?string

version der Anlage, wie gelesen; hat sie sich inzwischen geändert, lehnt die Route ab.

from?string

Beim Ä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?string

Beim Ändern Pflicht: der Grund der neuen Dauer, höchstens 500 Zeichen. Eine kürzere Nutzungsdauer braucht steuerlich einen Grund.

Längelength <= 500
remainingMonths?integer

Neue Restnutzungsdauer in Monaten ab dem ersten noch nicht gebuchten Monat, 1 bis 1200.

Bereich1 <= value <= 1200

Antworten

Erfolg.

application/json
  1. response

Was eine neue Restnutzungsdauer ändert.

after?array<>|

Der Plan je Kalenderjahr nach der Änderung.

before?array<>|

Der Plan je Kalenderjahr jetzt.

bookValueCents?integer

Restwert, 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?string

Erster noch nicht gebuchter Monat (YYYY-MM): Ab ihm gilt die neue Dauer.

lastMonth?string

Letzter Monat des neuen Plans (YYYY-MM).

messages?array<string>|

Was die App dazu sagt, etwa der Wechsel von degressiv zu linear.

priorYear?boolean

true, wenn die neue Dauer in einem früheren Jahr beginnt; dann ist confirmPriorYear Pflicht.

remainingMonths?integer

Die neue Restnutzungsdauer in Monaten.

Beispielanfrage
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 '{}'
Beispielantwort
{  "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}