bimetricsEntwickler
Anlagen

Anlage lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/assets/{id}

Liefert eine Anlage mit ihrem Plan je Kalenderjahr bis 0 €, ihren Buchungen und dem Weg, auf dem sie sich jetzt zurücknehmen ließe (reverseMode): undo (Rückgängig) bis undoUntil, sonst cancel (Storno). Auch eine zurückgenommene Anlage ist so zu finden; ihre Inventarnummer bleibt vergeben. Eine ID einer anderen Firma ergibt 404 AssetNotFound.

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.

Pfadparameter

id*string

ID der Anlage (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Anlage mit Plan und Buchungen.

account?integer

Anlagekonto im Kontenrahmen der Firma, das die AfA im Haben bucht.

acquired?

Anschaffungstag: Beginn eines eigenen Zeitraums der Position, sonst Lieferdatum, sonst Beginn des Leistungszeitraums, sonst Rechnungsdatum; beim Altbestand das Kaufdatum, bei einer Einlage der Tag der Einlage.

afaAccount?integer

AfA-Konto der Anlage im Kontenrahmen der Firma, im Soll gebucht.

afaTableEntry?string

Eintrag der amtlichen AfA-Tabelle, dem die Nutzungsdauer folgt.

automatic?boolean

true für ein GWG, das der Beleg von selbst anlegt; false für eine ausdrücklich angelegte Anlage.

aveuerGroup?string

Gruppe der Anlage AVEÜR: intangible (immaterielle Wirtschaftsgüter), vehicle (Kfz), office (Büroausstattung) oder other; leer bei einem GWG.

bookings?array<>

Nur beim Lesen einer Anlage: ihre Buchungen in den Büchern samt Gegenbuchungen, ohne die mit Löschvermerk.

cancelReason?string

Grund des Stornos, beim Rückgängig freiwillig.

category?string

Art der Anlage: software, website, machine, car, truck, equipment (Betriebsausstattung), office_furniture (Büroeinrichtung) oder gwg. Bei einem Kauf folgt sie der Kategorie der Position.

channel?string

Wo die Anlage angelegt wurde: web, api oder mcp.

companyId?string

ID der Firma.

Formatuuid
computer?boolean

true für Computer und Software nach dem BMF-Schreiben vom 22.02.2022; nur dann geht full_year.

costCenterId?string

Kostenstelle der Anlage, beim Kauf die des Belegs; die AfA bucht auf sie.

Formatuuid
costCents?integer

Anschaffungskosten samt Nebenkosten, netto, beim Kleinunternehmer brutto; beim Altbestand der Kaufpreis, bei einer Einlage der Einlagewert in Cent.

createdAt?string

Anlage in bimetrics.

Formatdate-time
createdByMembershipId?string

Wer die Anlage angelegt hat.

Formatuuid
degressivePercent?number

Nur bei degressive: der Satz je Jahr in Prozent mit zwei Nachkommastellen, das Dreifache des linearen Satzes, höchstens 30 % (§ 7 Abs. 2 EStG). Fehlt nach einer Änderung der Nutzungsdauer.

disposalContraAccount?integer

Kreditor des Händlers, gegen den der Erlös eines Verkaufs ohne Rechnung bucht.

disposalDate?

Abgangstag, der Tag der Lieferung; fehlt ohne Abgang.

disposalDocumentId?string

Die Rechnung oder Gutschrift des Händlers, mit der ein Verkauf ohne Rechnung verrechnet ist.

Formatuuid
disposalInvoiceId?string

Die Ausgangsrechnung, die die Anlage verkauft.

Formatuuid
disposalKind?string

Art des Abgangs: sale (Verkauf) oder scrap (Verschrottung).

disposalPositions?array<integer>

Die Positionen dieser Rechnung, die die Anlage verkaufen, ab 0.

disposalProceedsCents?integer

Erlös netto eines Verkaufs in Cent.

disposalReason?string

Grund einer Verschrottung.

disposalVatCents?integer

Umsatzsteuer eines Verkaufs ohne Rechnung in Cent.

disposalsTakenBack?array<>

Die Tage der zurückgenommenen Abgänge, in ihrer Reihenfolge.

documentId?string

Der Beleg eines Kaufs oder eines Altbestands aus einem Beleg. Die AfA-Buchungen tragen ihn nicht.

Formatuuid
drive?string

Antrieb eines Fahrzeugs: combustion, electric oder plug_in_hybrid; leer bei anderen Anlagen.

enteredAt?string

Zeitpunkt des Anlegens. Ab ihm laufen die 30 Tage für Rückgängig und die Schonfrist vor der Festschreibung.

Formatdate-time
gross?boolean

true, wenn die Anschaffungskosten brutto sind (Kleinunternehmer).

id?string

ID der Anlage.

Formatuuid
inputTaxCents?integer

Umsatzsteuer der Position: abziehbare Vorsteuer, beim Kleinunternehmer der nicht abziehbare Teil der Anschaffungskosten in Cent.

label?string

Bezeichnung, höchstens 120 Zeichen. Bei mehreren Stücken mit „(1/3)“.

linearFrom?string

Nur bei degressive nach einer Änderung der Nutzungsdauer: der Monat (YYYY-MM), seit dem die Anlage linear abgeschrieben wird.

method?string

Methode der AfA: linear, degressive (30 % für bewegliche Güter, angeschafft von Juli 2025 bis Ende 2027), full_year (Computer und Software im Anschaffungsjahr voll), electric_vehicle (75/10/5/5/3/2 % für reine E-Fahrzeuge, angeschafft von Juli 2025 bis Ende 2027) oder gwg (bis 800 € netto je Stück im Anschaffungsmonat voll).

netCents?integer

Nettobetrag samt Nebenkosten, für die GWG-Grenze in Cent.

number?string

Inventarnummer A-0001, je Firma fortlaufend und nie wiederverwendet, auch nicht nach Storno oder Rückgängig.

openingBookValueCents?integer

Beim Altbestand der Restwert am Stichtag in Cent.

openingDate?

Beim Altbestand der Stichtag 1. Januar, ab dem bimetrics die Anlage fortführt.

openingRemainingMonths?integer

Beim Altbestand die Restmonate ab dem Stichtag.

origin?string

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

plan?array<>

Nur beim Lesen einer Anlage: der Plan je Kalenderjahr bis 0 €.

planChanges?array<>

Die Änderungen der Nutzungsdauer in ihrer Reihenfolge (POST /api/assets/{id}/plan).

positions?array<>

Die Positionen des Belegs, die zur Anlage gehören, mit ihrem Anteil.

priorYearAnswer?string

Bei einer Anschaffung im Vorjahr die Antwort, ob dessen Steuererklärung (Bilanzierer: Jahresabschluss) schon abgegeben ist: filed oder not_filed.

quantity?integer

Stückzahl: 1, nur ein GWG mit Menge bleibt eine Anlage.

reverseMode?string

Wie sie sich jetzt zurücknehmen ließe: undo (Rückgängig) oder cancel (Storno). Fehlt, wenn sie storniert oder zurückgenommen ist.

Wert in"undo""cancel"
status?string

Stand: active, disposed (abgegangen), cancelled (storniert) oder undone (zurückgenommen).

undoUntil?string

Solange Rückgängig geht: der späteste Zeitpunkt dafür. Eine Festschreibung beendet es früher.

Formatdate-time
updatedAt?string

Letzte Änderung.

Formatdate-time
usefulLifeMonths?integer

Nutzungsdauer in Monaten bei linear und degressive, sonst 0.

usefulLifeReason?string

Grund für eine eigene, kürzere Nutzungsdauer, etwa „gebraucht gekauft“.

version?string

Version der Anlage, wie gelesen; ein Abgang und seine Rücknahme nennen sie als expectedVersion.

year?

Zahlen des Jahres: im Verzeichnis des angefragten, sonst des laufenden. Fehlt bei einer stornierten Anlage im Verzeichnis.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "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      },      "id": "9a7c5e3b-1d4f-4b28-8e6a-0c2e4f6a8b35",      "kind": "depreciation",      "label": "AfA A-0007 Bürostuhl",      "month": "2026-05"    }  ],  "category": "equipment",  "channel": "api",  "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",  "computer": false,  "costCents": 81000,  "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": 15010,  "label": "Bürostuhl",  "method": "linear",  "netCents": 81000,  "number": "A-0007",  "openingBookValueCents": 0,  "openingRemainingMonths": 0,  "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    }  ],  "quantity": 1,  "reverseMode": "undo",  "status": "active",  "undoUntil": "2026-12-15T10:00:00Z",  "updatedAt": "2026-11-15T10:00:00Z",  "usefulLifeMonths": 156,  "year": {    "additionCents": 81000,    "bookValueEndCents": 76846,    "bookValueStartCents": 0,    "bookedCents": 3114,    "depreciationCents": 4154,    "profitEffectCents": -4154,    "year": 2026  }}