Abgang einer Anlage buchen
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/api/assets/{id}/disposalKein 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.
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).
uuidIdempotency-Key*stringStabiler 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.
^[!-~]+$1 <= length <= 128the disposal
application/json- body
Abgang einer Anlage.
confirmPriorYear?booleantrue 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?stringVerkauf, den der Händler mit seiner Rechnung oder Gutschrift (Eingangsbeleg) verrechnet. Noch nicht möglich: Die Route lehnt ihn ab.
uuidexpectedVersion?stringPflicht: version der Anlage, wie zuletzt gelesen.
invoiceId?stringVerkauf an einer Ausgangsrechnung: die Rechnung.
uuidinvoiceVersion?stringMit invoiceId Pflicht: die zuletzt gelesene Version der Rechnung.
kind?stringPflicht: sale (Verkauf) oder scrap (Verschrottung).
"sale""scrap"positions?array<integer>Mit invoiceId Pflicht: die Positionen, die die Anlage verkaufen, ab 0; 19 % oder als Kleinunternehmer ohne Umsatzsteuer.
proceedsNetCents?integerVerkauf ohne eigene Rechnung: Erlös netto in Cent.
reason?stringBei der Verschrottung Pflicht: der Grund, höchstens 500 Zeichen.
vatCents?integerVerkauf ohne eigene Rechnung: 19 % Umsatzsteuer auf den Erlös, beim Kleinunternehmer keine in Cent.
Erfolg.
application/json- response
Anlage nach dem Abgang oder seiner Rücknahme.
asset?Die Anlage.
replayed?booleantrue bei einer Wiederholung.
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 '{}'{ "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 }}Anlage lesen GET
Liefert eine Anlage mit ihrem Plan je Kalenderjahr bis 0 €, ihren Buchungen und dem Weg, auf dem sie sich jetzt zurücknehmen ließe (`reverseMode`): `undo` (Rückgängig) bis `undoUntil`, sonst `cancel` (Storno). Auch eine zurückgenommene Anlage ist so zu finden; ihre Inventarnummer bleibt vergeben. Eine ID einer anderen Firma ergibt `404 AssetNotFound`. Benötigt einen Schlüssel mit der Berechtigung `read`.
Abgang einer Anlage prüfen POST
Prüft einen Abgang wie `POST /api/assets/{id}/disposal` und zeigt, was er schreiben würde, ohne etwas zu speichern: die AfA bis zum Abgangsmonat, den Restwert am Abgangstag, Erlös und Ergebnis mit ihren Konten, die Buchungen und bei einer festgeschriebenen Rechnung die Monate, in denen sie storniert und neu gebucht wird. Abgänge sind ein Verkauf an einer Ausgangsrechnung (`invoiceId` mit Positionen) oder eine Verschrottung (Tag und Grund). Einen Verkauf, den der Händler mit seiner Rechnung verrechnet (`dealerDocumentId`), lehnt die Route noch ab: Lade die Gutschrift des Händlers als Ausgangsrechnung hoch oder schreib ihm eine Rechnung, und verkaufe an ihr. Nur 19 % und Kleinunternehmer; Ausfuhr und innergemeinschaftliche Lieferung bucht die Kanzlei. Benötigt einen Schlüssel mit der Berechtigung `read`.