Altbestand prüfen
Benötigte Berechtigung:read(Daten lesen)
Prüft eine Liste von Anlagen, die vor dem 1. Januar des laufenden Jahres gekauft wurden (Altbestand), wie POST /api/assets/import und zeigt, was die Übernahme schreiben würde, ohne etwas zu speichern: je Anlage Restwert und Restmonate am 1. Januar, ohne Angabe aus dem Kauf gerechnet, die Methode und die AfA, die sofort bucht. Eine degressive Anlage, die schon auf linear gewechselt ist, übernimmt bimetrics linear. Eine Ablehnung nennt die Zeile. Positionen älterer Belege in bimetrics liefert GET /api/assets/opening-candidates.
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.
the assets of the list
application/json- body
Altbestand als Liste.
items?array<>|Pflicht: die Anlagen, mindestens eine und höchstens 100, je wie opening beim Anlegen.
Erfolg.
application/json- response
Was die Übernahme des Altbestands schreiben würde.
assets?array<>|Die Anlagen in der Reihenfolge der Liste; Inventarnummern vergibt bimetrics bei der Übernahme.
exported?booleantrue, wenn eine Buchung in einem Zeitraum liegt, der schon an DATEV übergeben ist, und der Export sie an DATEV übergibt.
messages?array<string>Die Sätze der App zur Vorschau, je Anlage mit „Zeile n“.
curl --fail-with-body "https://app.bimetrics.de/api/assets/import/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "assets": [ { "account": 400, "acquired": { "day": 10, "month": 3, "year": 2024 }, "afaAccount": 4830, "afaTableEntry": "6.15 Büromöbel", "automatic": false, "aveuerGroup": "office", "bookings": [ { "account": 4830, "accountContra": 400, "amountCents": 833, "date": { "day": 30, "month": 11, "year": 2026 }, "kind": "depreciation", "label": "AfA Schreibtisch", "month": "2026-11" } ], "category": "equipment", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "computer": false, "costCents": 130000, "documentId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d13", "gross": false, "inputTaxCents": 24700, "label": "Schreibtisch", "method": "linear", "netCents": 130000, "openingBookValueCents": 111667, "openingDate": { "day": 1, "month": 1, "year": 2026 }, "openingRemainingMonths": 134, "options": { "methods": [ "linear" ], "proposed": "linear" }, "origin": "opening", "plan": [ { "bookValueEndCents": 101667, "bookValueStartCents": 111667, "bookedCents": 9167, "depreciationCents": 10000, "profitEffectCents": -10000, "year": 2026 } ], "quantity": 1, "status": "active", "usefulLifeMonths": 156 } ]}Altbestand übernehmen POST
Übernimmt die Anlagen der Liste wie die Vorschau, höchstens 100, je eine Anlage wie `POST /api/assets` mit `origin` `opening`. Auf dem Anlagekonto bucht nichts; sofort gebucht wird die AfA jedes Monats des laufenden Jahres bis heute. Eine Anlage aus einem Beleg (`documentId`, `position`, `documentVersion`) sperrt dessen Position wie ein Kauf, so wird keine Position zweimal Anlage. Lehnt die Route eine Zeile ab, wird nichts übernommen; `context.message` beginnt mit „Zeile n“. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.
Altbestand aus Belegen GET
Liefert die Positionen älterer Eingangsbelege mit Anlagekategorie, die noch keine Anlage sind und sich als Altbestand übernehmen lassen: gekauft vor dem Startjahr 2026, später vor dem Vorjahr; über einen Leistungszeitraum abgegrenzt gebuchte nicht. Je Position Beleg, Text, Anschaffungstag und Kosten, mit einem Vorschlag aus der AfA-Tabelle dazu Restwert und Restmonate zum 1. Januar, linear gerechnet. Übernommen wird mit `POST /api/assets`, `origin` `opening`, `documentId`, `expectedVersion` (`documentVersion`) und den Positionen; die Positionen sind danach gesperrt wie bei einem Kauf. Lesen dürfen alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.