Abgang einer Anlage prüfen
Benötigte Berechtigung:read(Daten lesen)
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.
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).
uuidthe disposal, as for writing it
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
Was ein Abgang oder seine Rücknahme schreibt.
bookValueAccount?integerKonto des Restwerts nach Art und Ergebnis.
bookValueCents?integerRestwert am Abgangstag, als Aufwand gebucht in Cent.
bookings?array<>|Buchungen der Anlage, die geschrieben werden, ohne ID.
date?Abgangstag.
depreciationCents?integerAfA des Abgangsjahres bis einschließlich Abgangsmonat in Cent.
exported?booleantrue, wenn eine Buchung in einem Zeitraum liegt, der schon an DATEV übergeben ist, und der Export sie an DATEV übergibt.
invoice?Bei einer festgeschriebenen Rechnung: in welchen Monaten sie storniert und neu gebucht wird.
kind?stringsale oder scrap; fehlt bei einer Rücknahme.
"sale""scrap"messages?array<string>Die Sätze der App zur Vorschau.
priorYear?booleantrue, wenn der Abgangstag im Vorjahr liegt; dann ist confirmPriorYear Pflicht.
proceedsAccount?integerErlöskonto des Verkaufs.
proceedsNetCents?integerErlös netto in Cent.
removed?array<>|Offene Buchungen, die einen Löschvermerk bekommen.
resultCents?integerErlös abzüglich Restwert: Gewinn, wenn positiv in Cent.
reversals?array<>|Gegenbuchungen festgeschriebener Buchungen, mit deren Datum.
vatCents?integerUmsatzsteuer eines Verkaufs ohne Rechnung in Cent.
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/disposal/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "bookValueAccount": 2310, "bookValueCents": 77367, "bookings": [ { "account": 2310, "accountContra": 400, "amountCents": 77367, "date": { "day": 10, "month": 11, "year": 2026 }, "kind": "book_value", "label": "Abgang A-0007 Bürostuhl", "month": "2026-11" } ], "date": { "day": 10, "month": 11, "year": 2026 }, "depreciationCents": 3633, "kind": "scrap", "messages": [ "Sag deiner Kanzlei Bescheid, falls sie die Anlage in DATEV führt." ], "removed": [], "resultCents": -77367, "reversals": []}Abgang einer Anlage buchen POST
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`.
Abgang zurücknehmen POST
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`.