# Anlage prüfen (https://developer.bimetrics.de/reference/assets/preview-asset)

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

operationId: `previewAsset` · Berechtigung (Scope): `read` · Bereich: Anlagen

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

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

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

the assets, as for creating them

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/preview" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: AssetPreview |
| 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 |
| 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 (`AssetPreview`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `assets` | Array<AssetPreviewItem>, kann null sein | 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<AssetIncidentalMove> | Wohin zugerechnete Nebenkosten wandern. |
| `messages` | Array<string> | Die Sätze der App zur Vorschau. |
| `priorYear` | AssetPriorYear | 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` | AssetReceiptRebook | Fehlt, wenn vom Beleg nichts festgeschrieben ist; sonst, in welchen Monaten das Anlegen ihn storniert und neu bucht. |

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