Altbestand übernehmen
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/api/assets/importKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Ü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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Idempotency-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 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
Angelegte Anlagen.
assets?array<>|Die Anlagen mit Nummer, Plan und Buchungen; bei einer Wiederholung die des ersten Aufrufs.
replayed?booleantrue bei einer Wiederholung.
curl --fail-with-body "https://app.bimetrics.de/api/assets/import" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -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", "channel": "api", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "computer": false, "costCents": 130000, "createdAt": "2026-11-15T10:00:00Z", "documentId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d13", "enteredAt": "2026-11-15T10:00:00Z", "gross": false, "id": "5e8c1a3f-7b2d-4c69-a0e4-9d1f3b5c7e82", "inputTaxCents": 24700, "label": "Schreibtisch", "method": "linear", "netCents": 130000, "number": "A-0007", "openingBookValueCents": 111667, "openingDate": { "day": 1, "month": 1, "year": 2026 }, "openingRemainingMonths": 134, "origin": "opening", "plan": [ { "bookValueEndCents": 101667, "bookValueStartCents": 111667, "bookedCents": 9167, "depreciationCents": 10000, "profitEffectCents": -10000, "year": 2026 } ], "positions": [ { "costCents": 130000, "index": 0 } ], "quantity": 1, "reverseMode": "undo", "status": "active", "undoUntil": "2026-12-15T10:00:00Z", "updatedAt": "2026-11-15T10:00:00Z", "usefulLifeMonths": 156, "year": { "bookValueEndCents": 101667, "bookValueStartCents": 111667, "bookedCents": 9167, "depreciationCents": 10000, "profitEffectCents": -10000, "year": 2026 } } ]}Anlage AVEÜR lesen GET
Liefert die Anlage AVEÜR eines Kalenderjahres aus den gebuchten Werten: je Gruppe (immaterielle Wirtschaftsgüter, Kfz, Büroausstattung, andere) AK-Summe und Buchwert zu Beginn, Zugänge, AfA, Abgänge (Restbuchwerte) und Buchwert am Ende, mit den Kennzahlen des Vordrucks in `codes`. Dazu die AfA beweglicher Wirtschaftsgüter gesamt (490), ob ein Elektro- oder extern aufladbares Hybridfahrzeug vorhanden ist (407), und für die Anlage EÜR AfA (130, 131), GWG (132) und Restbuchwerte (135). GWG stehen nicht in den Gruppen. Die Kennzahlen bleiben, die Zeilen des Vordrucks wandern jedes Jahr. Benötigt einen Schlüssel mit der Berechtigung `read`.
Altbestand prüfen POST
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`.