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

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

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

Prüft eine Liste von Anlagen, die vor dem 1. Januar des laufenden Jahres gekauft wurden (Altbestand), wie `POST /api/assets/import` und zeigt, was die Übernahme schreiben würde, ohne etwas zu speichern: je Anlage Restwert und Restmonate am 1. Januar, ohne Angabe aus dem Kauf gerechnet, die Methode und die AfA, die sofort bucht. Eine degressive Anlage, die schon auf linear gewechselt ist, übernimmt bimetrics linear. Eine Ablehnung nennt die Zeile. Positionen älterer Belege in bimetrics liefert `GET /api/assets/opening-candidates`.

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 of the list

Schema `AssetImportRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `items` | Array<AssetOpeningRequest>, kann null sein | Pflicht: die Anlagen, mindestens eine und höchstens 100, je wie `opening` beim Anlegen. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/assets/import/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`: AssetImportPreview |
| 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 (`AssetImportPreview`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `assets` | Array<AssetPreviewItem>, kann null sein | Die Anlagen in der Reihenfolge der Liste; Inventarnummern vergibt bimetrics bei der Übernahme. |
| `exported` | boolean | `true`, wenn eine Buchung in einem Zeitraum liegt, der schon an DATEV übergeben ist, und der Export sie an DATEV übergibt. |
| `messages` | Array<string> | Die Sätze der App zur Vorschau, je Anlage mit „Zeile n“. |

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