bimetricsEntwickler
Anlagen

Altbestand aus Belegen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/assets/opening-candidates

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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Query-Parameter

year*integer

Jahr des 1. Januar, zu dem die Zahlen gelten, das laufende Jahr.

Antworten

Erfolg.

application/json
  1. response

Positionen älterer Belege, die sich als Altbestand übernehmen lassen.

items?array<>|

Die Positionen, älteste Belege zuerst.

truncated?boolean

true, wenn es mehr Belege gibt, als eine Liste liest (500); übernimm zuerst diese.

year?integer

Jahr des 1. Januar der Übernahme, zu dem die Zahlen gelten.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets/opening-candidates?year=0" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "items": [    {      "acquired": {        "day": 10,        "month": 3,        "year": 2024      },      "afaTableEntry": "6.15 Büromöbel",      "category": "equipment",      "costCents": 130000,      "documentId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d13",      "documentVersion": "b4f1c2",      "invoiceNumber": "RE-2024-118",      "issuer": "Büromöbel Schmidt GmbH",      "label": "Schreibtisch",      "openingBookValueCents": 111667,      "openingRemainingMonths": 134,      "position": 0,      "usefulLifeMonths": 156    }  ],  "year": 2026}