# Anlage anlegen (https://developer.bimetrics.de/reference/assets/create-asset)

`POST https://app.bimetrics.de/api/assets`

operationId: `createAsset` · Berechtigung (Scope): `documents:write` · Bereich: Anlagen

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

> **Achtung:** Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
>
> KI-Agenten fragen vor diesem Aufruf beim Nutzer nach.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `Idempotency-Key` | header | ja | 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. |

### Request-Body (`application/json`)

the assets

Schema `AssetCreateRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `contribution` | AssetContributionRequest | Bei der Einlage Pflicht: die Angaben zur Anlage. Sie bucht auf das Anlagekonto gegen die Privateinlage (1890 in SKR03, 2180 in SKR04). |
| `documentId` | string (uuid) | Beim Kauf Pflicht: die Eingangsrechnung. Beim Altbestand aus einem älteren Beleg (`GET /api/assets/opening-candidates`) dieser Beleg, mit `positions`. |
| `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` | AssetOpeningRequest | Beim Altbestand ohne Beleg Pflicht: die Angaben zur Anlage. Aus einem älteren Beleg stattdessen `documentId` und `positions`. |
| `origin` | string: `purchase`, `opening`, `contribution` | `purchase` (aus einem Beleg, ohne Angabe), `opening` (Altbestand) oder `contribution` (Einlage aus dem Privatvermögen). |
| `positions` | Array<AssetPositionRequest> | 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: `filed`, `not_filed` | 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. |

### Beispiel

```sh
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 '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: AssetsCreated |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 409 | Versionskonflikt (`VersionConflict`), abweichender Inhalt für denselben Idempotency-Key (`IdempotencyConflict`), Dublette (`ContactDuplicate`) oder fachlich gesperrte Änderung. Aktuellen Zustand laden und prüfen; keinen anderen Schlüssel verwenden, um einen Konflikt zu umgehen. | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`AssetsCreated`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `assets` | Array<Asset>, kann null sein | Die Anlagen mit Nummer, Plan und Buchungen; bei einer Wiederholung die des ersten Aufrufs. |
| `replayed` | boolean | `true` bei einer Wiederholung. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
