bimetricsEntwickler
Anlagen

Anlage AVEÜR lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/assets/aveuer

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.

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

Kalenderjahr, ab 2025.

Antworten

Erfolg.

application/json
  1. response

Anlage AVEÜR eines Jahres.

electricVehicle?boolean

true, wenn ein Elektro- oder extern aufladbares Hybridfahrzeug vorhanden ist (Kennzahl 407).

euer?

Die Werte für die Anlage EÜR.

groups?array<>|

Die Gruppen in der Reihenfolge des Vordrucks.

messages?array<string>

Hinweise der App.

movableDepreciationCents?integer

AfA beweglicher Wirtschaftsgüter gesamt (Kennzahl 490) in Cent.

sales?array<>|

Verkäufe des Jahres und im Jahr bezahlte, für Kennzahl 102.

year?integer

Kalenderjahr.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets/aveuer?year=0" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "electricVehicle": false,  "euer": {    "bookValueCents": 600000,    "gwgCents": 0,    "intangibleCents": 0,    "movableCents": 160000,    "proceedsCents": 700000  },  "groups": [    {      "additionCents": 0,      "bookValueEndCents": 0,      "bookValueStartCents": 760000,      "codes": {        "addition": "422",        "bookValueEnd": "426",        "bookValueStart": "421",        "costStart": "420",        "depreciation": "424",        "disposal": "425",        "special": "423"      },      "costStartCents": 1200000,      "depreciationCents": 160000,      "disposalCents": 600000,      "group": "other",      "specialCents": 0,      "title": "Andere bewegliche Wirtschaftsgüter"    }  ],  "movableDepreciationCents": 160000,  "sales": [    {      "assetId": "6f1d2c3b-4a5e-4f60-8a7b-9c0d1e2f3a4b",      "date": {        "day": 20,        "month": 8,        "year": 2028      },      "label": "Fräsmaschine",      "number": "A-0001",      "openCents": 0,      "payments": [        {          "date": {            "day": 20,            "month": 8,            "year": 2028          },          "netCents": 700000        }      ],      "proceedsNetCents": 700000    }  ],  "year": 2028}

Anlage anlegen POST

Legt Anlagen aus Positionen einer Eingangsrechnung an, je Stück eine, übernimmt eine als Altbestand (`origin` `opening`) oder legt sie aus dem Privatvermögen ein (`origin` `contribution`, nur bei Einzelunternehmen, GbR und OHG). Anschaffungstag ist der Beginn eines eigenen Zeitraums der Position, sonst das Lieferdatum, sonst der Beginn des Leistungszeitraums, sonst das Rechnungsdatum. Die Anschaffungskosten sind netto, beim Kleinunternehmer brutto. Sofort gebucht wird die AfA jedes Monats vom Anschaffungsmonat bis heute, mit dem Datum ihres Monats, auf das AfA-Konto gegen das Anlagekonto. Eine Anschaffung im Vorjahr geht nur mit `priorYear`; ihre AfA steht dann im Vorjahr. Ältere Käufe sind Altbestand. Zugerechnete Nebenkosten (`incidentals`) bucht der Beleg danach auf die Anlagekonten. Solange die Anlage besteht, sind Betrag, Kategorie und Datum ihrer Positionen gesperrt (`409 AssetPositionLocked`). Verstößt die Anfrage gegen eine Regel, antwortet die Route mit `400` oder `409 AssetRejected`, `context.message` nennt den Satz der App. Läuft gerade eine Neubuchung nach einem Wechsel des Steuerstatus, lehnt sie ab. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.

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`.