bimetricsEntwickler
Anlagen

Altbestand prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/assets/import/preview

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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

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

Request-Body

the assets of the list

application/json
  1. body

Altbestand als Liste.

items?array<>|

Pflicht: die Anlagen, mindestens eine und höchstens 100, je wie opening beim Anlegen.

Antworten

Erfolg.

application/json
  1. 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?boolean

true, 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“.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets/import/preview" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "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    }  ]}