bimetricsEntwickler
Anlagen

Rücknahme eines Abgangs prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

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

Zeigt, was das Zurücknehmen eines Abgangs schreibt, ohne etwas zu speichern: Der Restwert wird storniert, die AfA bis zum Abgangsmonat bleibt, die Monate danach bucht bimetrics bis heute nach.

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

as for taking it back

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

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/reverse/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,  "removed": [],  "resultCents": -77367,  "reversals": []}