bimetricsEntwickler
Anlagen

Nutzungsdauer einer Anlage ändern

Als Markdown ansehen

Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/assets/{id}/plan

Kein 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.

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

Header-Parameter

Idempotency-Key*string

Stabiler 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.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

the new remaining useful life

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

Anlage mit neuer Nutzungsdauer.

asset?

Die Anlage mit ihrem neuen Plan.

replayed?boolean

true bei einer Wiederholung.

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