Rücknahme einer Anlage prüfen
Benötigte Berechtigung:read(Daten lesen)
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.
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).
uuidErfolg.
application/json- response
Wie sich eine Anlage jetzt zurücknehmen lässt.
messages?array<string>Die Sätze der App zur Vorschau.
mode?stringundo (Rückgängig) oder cancel (Storno).
"undo""cancel"priorYears?booleantrue, wenn ein früheres Jahr betroffen ist. Frag dann vorher deine Kanzlei. Ein Storno (cancel) braucht zusätzlich confirmPriorYear, ein Rückgängig (undo) nicht.
receipt?Bei einer Anlage mit Nebenkosten: in welchen Monaten der festgeschriebene Beleg storniert und neu gebucht wird; fehlt, wenn davon nichts festgeschrieben ist.
undoRefusal?stringWarum es kein Rückgängig ist: finalized, expired oder gwg.
"finalized""expired""gwg"years?array<>|Was je Kalenderjahr geschrieben wird.
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/reverse/preview" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "messages": [ "Rückgängig geht nicht mehr, weil eine Buchung dieser Anlage schon festgeschrieben ist. Storniere die Anlage stattdessen und nenne einen Grund." ], "mode": "cancel", "undoRefusal": "finalized", "years": [ { "profitChangeCents": 1038, "removed": [ { "account": 4830, "accountContra": 400, "amountCents": 519, "date": { "day": 30, "month": 6, "year": 2026 }, "id": "9a7c5e3b-1d4f-4b28-8e6a-0c2e4f6a8b35", "kind": "depreciation", "label": "AfA A-0007 Bürostuhl", "month": "2026-06" } ], "reversals": [ { "account": 4830, "accountContra": 400, "amountCents": -519, "date": { "day": 31, "month": 5, "year": 2026 }, "kind": "depreciation", "label": "AfA A-0007 Bürostuhl", "month": "2026-05", "reverses": "9a7c5e3b-1d4f-4b28-8e6a-0c2e4f6a8b35" } ], "year": 2026 } ]}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`.
DATEV-Weg der Abschreibungen lesen GET
Liefert die Antwort auf „Rechnet deine Kanzlei die Abschreibungen selbst in DATEV?“ (`assetDepreciation`): die heute geltende (`current`), eine ab einem späteren 1. Januar (`upcoming`), alle bisherigen (`history`) und den 1. Januar, ab dem eine neue gälte (`proposedFrom`). Ohne Antwort, mit `firm` und mit `unknown` hält der DATEV-Export laufende Abschreibungen, GWG-Sofortabschreibungen und Restbuchwerte beim Abgang zurück; mit `bimetrics` liefert er alle Anlagenbuchungen, die Inventarnummer in Belegfeld 1. Lesen dürfen alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.