bimetricsEntwickler
Anlagen

Anlage anlegen

Als Markdown ansehen

Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/assets

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

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

Header-Parameter

Idempotency-Key*string

Stabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

the assets

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

Angelegte Anlagen.

assets?array<>|

Die Anlagen mit Nummer, Plan und Buchungen; bei einer Wiederholung die des ersten Aufrufs.

replayed?boolean

true bei einer Wiederholung.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -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          },          "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      }    }  ]}