Anlage zurücknehmen oder stornieren
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/api/assets/{id}/reverseKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
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 <= 128expected mode and reason
application/json- body
Rücknahme einer Anlage.
confirmPriorYear?booleantrue bestätigt ein Storno (cancel), das den Gewinn eines früheren Jahres ändert (priorYears der Vorschau). Fehlt die Bestätigung, lehnt die Route ein solches Storno ab.
expectedMode?stringPflicht: der Weg der Vorschau, undo oder cancel.
"undo""cancel"reason?stringGrund, bei cancel Pflicht, höchstens 500 Zeichen.
Erfolg.
application/json- response
Anlage nach der Rücknahme.
asset?Die Anlage.
mode?stringDer Weg: undo oder cancel.
replayed?booleantrue bei einer Wiederholung.
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/reverse" \ -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", "cancelReason": "Falsche Rechnung erfasst", "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", "positions": [ { "costCents": 79000, "index": 0 }, { "costCents": 2000, "incidental": true, "index": 1 } ], "quantity": 1, "status": "cancelled", "updatedAt": "2026-11-15T10:00:00Z", "usefulLifeMonths": 156 }, "mode": "cancel"}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`.
Rücknahme einer Anlage prüfen POST
Sagt, wie sich eine Anlage jetzt zurücknehmen lässt, und was das je Kalenderjahr schreibt, ohne etwas zu speichern. `undo` (Rückgängig) geht in den ersten 30 Tagen nach dem Anlegen, solange keine Buchung der Anlage je festgeschrieben war und sie kein GWG ist; dann bekommen alle offenen Buchungen einen Löschvermerk. Sonst ist es `cancel` (Storno): Festgeschriebene Buchungen bekommen eine Gegenbuchung mit ihrem eigenen Datum, offene einen Löschvermerk. Betrifft das ein Vorjahr, nennt `messages` die Änderung seines Gewinns. Benötigt einen Schlüssel mit der Berechtigung `read`.