bimetricsEntwickler
Anlagen

Abgang einer Anlage buchen

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

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

Bucht den Abgang wie die Vorschau: die AfA bis zum Abgangsmonat (er zählt voll und trägt den Abgangstag), den Restwert am Abgangstag auf das Konto nach Art und Ergebnis gegen das Anlagekonto. Spätere Monate werden entfernt oder storniert. Beim Verkauf an der Rechnung bekommen ihre Positionen die Kategorie asset_sale (Anlagenverkauf), und die Rechnung bucht neu: Offenes wird ersetzt, Festgeschriebenes mit seinem Datum storniert und neu gebucht. 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

the disposal

application/json
  1. body

Abgang einer Anlage.

confirmPriorYear?boolean

true bestätigt einen Abgangstag im Vorjahr; er ändert dessen Gewinn.

date?

Abgangstag, der Tag der Lieferung, nicht in der Zukunft. Beim Verkauf an der Rechnung ohne Angabe ihr Lieferdatum, sonst Pflicht.

dealerDocumentId?string

Verkauf, den der Händler mit seiner Rechnung oder Gutschrift (Eingangsbeleg) verrechnet. Noch nicht möglich: Die Route lehnt ihn ab.

Formatuuid
expectedVersion?string

Pflicht: version der Anlage, wie zuletzt gelesen.

invoiceId?string

Verkauf an einer Ausgangsrechnung: die Rechnung.

Formatuuid
invoiceVersion?string

Mit invoiceId Pflicht: die zuletzt gelesene Version der Rechnung.

kind?string

Pflicht: sale (Verkauf) oder scrap (Verschrottung).

Wert in"sale""scrap"
positions?array<integer>

Mit invoiceId Pflicht: die Positionen, die die Anlage verkaufen, ab 0; 19 % oder als Kleinunternehmer ohne Umsatzsteuer.

proceedsNetCents?integer

Verkauf ohne eigene Rechnung: Erlös netto in Cent.

reason?string

Bei der Verschrottung Pflicht: der Grund, höchstens 500 Zeichen.

vatCents?integer

Verkauf ohne eigene Rechnung: 19 % Umsatzsteuer auf den Erlös, beim Kleinunternehmer keine in Cent.

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" \  -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",    "disposalDate": {      "day": 10,      "month": 11,      "year": 2026    },    "disposalKind": "scrap",    "disposalReason": "Wasserschaden",    "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": "disposed",    "updatedAt": "2026-11-15T10:00:00Z",    "usefulLifeMonths": 156  }}