bimetricsEntwickler
Anlagen

Abgang einer Anlage prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/assets/{id}/disposal/preview

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.

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

Request-Body

the disposal, as for writing it

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

Was ein Abgang oder seine Rücknahme schreibt.

bookValueAccount?integer

Konto des Restwerts nach Art und Ergebnis.

bookValueCents?integer

Restwert am Abgangstag, als Aufwand gebucht in Cent.

bookings?array<>|

Buchungen der Anlage, die geschrieben werden, ohne ID.

date?

Abgangstag.

depreciationCents?integer

AfA des Abgangsjahres bis einschließlich Abgangsmonat in Cent.

exported?boolean

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

sale oder scrap; fehlt bei einer Rücknahme.

Wert in"sale""scrap"
messages?array<string>

Die Sätze der App zur Vorschau.

priorYear?boolean

true, wenn der Abgangstag im Vorjahr liegt; dann ist confirmPriorYear Pflicht.

proceedsAccount?integer

Erlöskonto des Verkaufs.

proceedsNetCents?integer

Erlös netto in Cent.

removed?array<>|

Offene Buchungen, die einen Löschvermerk bekommen.

resultCents?integer

Erlös abzüglich Restwert: Gewinn, wenn positiv in Cent.

reversals?array<>|

Gegenbuchungen festgeschriebener Buchungen, mit deren Datum.

vatCents?integer

Umsatzsteuer eines Verkaufs ohne Rechnung in Cent.

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