bimetricsEntwickler
Anlagen

Rücknahme einer Anlage prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

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

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.

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

Antworten

Erfolg.

application/json
  1. response

Wie sich eine Anlage jetzt zurücknehmen lässt.

messages?array<string>

Die Sätze der App zur Vorschau.

mode?string

undo (Rückgängig) oder cancel (Storno).

Wert in"undo""cancel"
priorYears?boolean

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

Warum es kein Rückgängig ist: finalized, expired oder gwg.

Wert in"finalized""expired""gwg"
years?array<>|

Was je Kalenderjahr geschrieben wird.

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