bimetricsEntwickler
Anlagen

Anlage zurücknehmen oder stornieren

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}/reverse

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

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

expected mode and reason

application/json
  1. body

Rücknahme einer Anlage.

confirmPriorYear?boolean

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

Pflicht: der Weg der Vorschau, undo oder cancel.

Wert in"undo""cancel"
reason?string

Grund, bei cancel Pflicht, höchstens 500 Zeichen.

Antworten

Erfolg.

application/json
  1. response

Anlage nach der Rücknahme.

asset?

Die Anlage.

mode?string

Der Weg: undo oder cancel.

replayed?boolean

true bei einer Wiederholung.

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