bimetricsEntwickler
Anlagen

Anlage prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/assets/preview

Prüft Anlagen wie POST /api/assets und zeigt, was das Anlegen schreiben würde, ohne etwas zu speichern: die Anlagen mit den möglichen Methoden und dem Vorschlag (options), den Plan je Jahr mit seiner Wirkung auf den Gewinn, die Buchungen, die sofort entstehen (jeder Monat bis heute mit dem Letzten des Monats, eine Sofortabschreibung mit dem Anschaffungstag, bei einer Einlage dazu die Einlage selbst), wohin zugerechnete Nebenkosten wandern, und bei einer Anschaffung im Vorjahr die Frage nach der Steuererklärung. POST /api/assets bucht danach genau diese Zeilen; nur die Inventarnummer vergibt bimetrics erst beim Anlegen.

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, as for creating them

application/json
  1. body

Neue Anlagen.

contribution?

Bei der Einlage Pflicht: die Angaben zur Anlage. Sie bucht auf das Anlagekonto gegen die Privateinlage (1890 in SKR03, 2180 in SKR04).

documentId?string

Beim Kauf Pflicht: die Eingangsrechnung. Beim Altbestand aus einem älteren Beleg (GET /api/assets/opening-candidates) dieser Beleg, mit positions.

Formatuuid
expectedVersion?string

Die zuletzt gelesene Version des Belegs, beim Anlegen über API-Schlüssel Pflicht; hat er sich geändert, lehnt die Route mit 409 AssetRejected ab.

incidentals?array<integer>

Positionen mit Nebenkosten wie Lieferung oder Montage, als Stelle ab 0: verteilt auf alle Anlagen der Anfrage nach ihren Kosten, die letzte nimmt den Rest. Ihre Buchung wandert auf die Anlagekonten.

opening?

Beim Altbestand ohne Beleg Pflicht: die Angaben zur Anlage. Aus einem älteren Beleg stattdessen documentId und positions.

origin?string

purchase (aus einem Beleg, ohne Angabe), opening (Altbestand) oder contribution (Einlage aus dem Privatvermögen).

Wert in"purchase""opening""contribution"
positions?array<>

Beim Kauf Pflicht: die Positionen, die zur Anlage werden, zusammen höchstens 100 Anlagen. Beim Altbestand aus einem Beleg je Position eine Anlage, gesperrt wie bei einem Kauf.

priorYear?string

Bei einer Anschaffung im Vorjahr Pflicht: filed, wenn die Steuererklärung (Bilanzierer: der Jahresabschluss) des Vorjahres schon abgegeben ist, sonst not_filed. Die AfA des Vorjahres steht in beiden Fällen im Vorjahr; bei filed zählt sie nur über eine Änderung der Erklärung.

Wert in"filed""not_filed"

Antworten

Erfolg.

application/json
  1. response

Was das Anlegen schreiben würde.

assets?array<>|

Die Anlagen, je Stück eine.

exported?boolean

true, wenn eine Buchung in einem Zeitraum liegt, der schon an DATEV übergeben ist, und der Export sie an DATEV übergibt.

incidentals?array<>

Wohin zugerechnete Nebenkosten wandern.

messages?array<string>

Die Sätze der App zur Vorschau.

priorYear?

Bei einer Anschaffung im Vorjahr die Frage und der Hinweis.

priorYearExported?boolean

true, wenn das Vorjahr schon an DATEV übergeben ist und der Export eine neue Buchung dieses Jahres an DATEV übergibt: Sie erreicht DATEV nur mit einem eigenen Export für dieses Jahr.

receipt?

Fehlt, wenn vom Beleg nichts festgeschrieben ist; sonst, in welchen Monaten das Anlegen ihn storniert und neu bucht.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets/preview" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "assets": [    {      "account": 400,      "acquired": {        "day": 12,        "month": 5,        "year": 2026      },      "afaAccount": 4830,      "afaTableEntry": "6.15 Büromöbel",      "automatic": false,      "aveuerGroup": "office",      "bookings": [        {          "account": 4830,          "accountContra": 400,          "amountCents": 519,          "date": {            "day": 31,            "month": 5,            "year": 2026          },          "kind": "depreciation",          "label": "AfA Bürostuhl",          "month": "2026-05"        }      ],      "category": "equipment",      "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",      "computer": false,      "costCents": 81000,      "documentId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d13",      "gross": false,      "inputTaxCents": 15010,      "label": "Bürostuhl",      "method": "linear",      "netCents": 81000,      "openingBookValueCents": 0,      "openingRemainingMonths": 0,      "options": {        "methods": [          "linear",          "degressive"        ],        "proposed": "linear"      },      "origin": "purchase",      "plan": [        {          "additionCents": 81000,          "bookValueEndCents": 76846,          "bookValueStartCents": 0,          "bookedCents": 3114,          "depreciationCents": 4154,          "profitEffectCents": -4154,          "year": 2026        },        {          "bookValueEndCents": 70615,          "bookValueStartCents": 76846,          "bookedCents": 0,          "depreciationCents": 6231,          "profitEffectCents": -6231,          "year": 2027        }      ],      "positions": [        {          "costCents": 79000,          "index": 0        },        {          "costCents": 2000,          "incidental": true,          "index": 1        }      ],      "proposedUsefulLife": {        "computer": false,        "entry": "6.15 Büromöbel",        "months": 156,        "name": "Büromöbel",        "ref": "6.15",        "years": 13      },      "quantity": 1,      "status": "active",      "usefulLifeMonths": 156    }  ],  "incidentals": [    {      "accounts": [        {          "account": 400,          "grossCents": 2380        }      ],      "index": 1,      "label": "Lieferung"    }  ]}