bimetricsEntwickler
Anlagen

Abgang zurücknehmen

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

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

Nimmt den Abgang zurück wie die Vorschau: Festgeschriebenes bekommt eine Gegenbuchung mit dem Datum des Originals, Offenes einen Löschvermerk. Eine Rechnung bekommt die Kategorien zurück, die ihre Positionen vor dem Verkauf hatten, und bucht neu: Offenes wird ersetzt, Festgeschriebenes mit seinem Datum storniert und neu gebucht. Ein Abgang im Vorjahr geht nur mit confirmPriorYear, ältere nicht. expectedVersion ist Pflicht. 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 version

application/json
  1. body

Rücknahme eines Abgangs.

confirmPriorYear?boolean

true bestätigt die Rücknahme eines Abgangs im Vorjahr.

expectedVersion?string

Pflicht: version der Anlage, wie zuletzt gelesen.

Antworten

Erfolg.

application/json
  1. response

Anlage nach dem Abgang oder seiner Rücknahme.

asset?

Die Anlage.

replayed?boolean

true bei einer Wiederholung.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/disposal/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",    "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": "active",    "updatedAt": "2026-11-15T10:00:00Z",    "usefulLifeMonths": 156  }}