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

`POST https://app.bimetrics.de/api/assets/{id}/disposal/preview`

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

Prüft einen Abgang wie `POST /api/assets/{id}/disposal` und zeigt, was er schreiben würde, ohne etwas zu speichern: die AfA bis zum Abgangsmonat, den Restwert am Abgangstag, Erlös und Ergebnis mit ihren Konten, die Buchungen und bei einer festgeschriebenen Rechnung die Monate, in denen sie storniert und neu gebucht wird. Abgänge sind ein Verkauf an einer Ausgangsrechnung (`invoiceId` mit Positionen) oder eine Verschrottung (Tag und Grund). Einen Verkauf, den der Händler mit seiner Rechnung verrechnet (`dealerDocumentId`), lehnt die Route noch ab: Lade die Gutschrift des Händlers als Ausgangsrechnung hoch oder schreib ihm eine Rechnung, und verkaufe an ihr. Nur 19 % und Kleinunternehmer; Ausfuhr und innergemeinschaftliche Lieferung bucht die Kanzlei.

Benötigt einen Schlüssel mit der Berechtigung `read`.

### Authentifizierung

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

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `id` | path | ja | string (uuid) | ID der Anlage (UUID). |

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

the disposal, as for writing it

Schema `AssetDisposalRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `confirmPriorYear` | boolean | `true` bestätigt einen Abgangstag im Vorjahr; er ändert dessen Gewinn. |
| `date` | NaiveDate | Abgangstag, der Tag der Lieferung, nicht in der Zukunft. Beim Verkauf an der Rechnung ohne Angabe ihr Lieferdatum, sonst Pflicht. |
| `dealerDocumentId` | string (uuid) | Verkauf, den der Händler mit seiner Rechnung oder Gutschrift (Eingangsbeleg) verrechnet. Noch nicht möglich: Die Route lehnt ihn ab. |
| `expectedVersion` | string | Pflicht: `version` der Anlage, wie zuletzt gelesen. |
| `invoiceId` | string (uuid) | Verkauf an einer Ausgangsrechnung: die Rechnung. |
| `invoiceVersion` | string | Mit `invoiceId` Pflicht: die zuletzt gelesene Version der Rechnung. |
| `kind` | string: `sale`, `scrap` | Pflicht: `sale` (Verkauf) oder `scrap` (Verschrottung). |
| `positions` | Array<integer> | Mit `invoiceId` Pflicht: die Positionen, die die Anlage verkaufen, ab 0; 19 % oder als Kleinunternehmer ohne Umsatzsteuer. |
| `proceedsNetCents` | integer | Verkauf ohne eigene Rechnung: Erlös netto in Cent. |
| `reason` | string | Bei der Verschrottung Pflicht: der Grund, höchstens 500 Zeichen. |
| `vatCents` | integer | Verkauf ohne eigene Rechnung: 19 % Umsatzsteuer auf den Erlös, beim Kleinunternehmer keine in Cent. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/assets/{id}/disposal/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`: AssetDisposalPreview |
| 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 |
| 404 | Nicht gefunden (`NotFound`). | `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 (`AssetDisposalPreview`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `bookValueAccount` | integer | Konto des Restwerts nach Art und Ergebnis. |
| `bookValueCents` | integer | Restwert am Abgangstag, als Aufwand gebucht in Cent. |
| `bookings` | Array<AssetBooking>, kann null sein | Buchungen der Anlage, die geschrieben werden, ohne ID. |
| `date` | NaiveDate | Abgangstag. |
| `depreciationCents` | integer | AfA des Abgangsjahres bis einschließlich Abgangsmonat in Cent. |
| `exported` | boolean | `true`, wenn eine Buchung in einem Zeitraum liegt, der schon an DATEV übergeben ist, und der Export sie an DATEV übergibt. |
| `invoice` | AssetReceiptRebook | Bei einer festgeschriebenen Rechnung: in welchen Monaten sie storniert und neu gebucht wird. |
| `kind` | string: `sale`, `scrap` | `sale` oder `scrap`; fehlt bei einer Rücknahme. |
| `messages` | Array<string> | Die Sätze der App zur Vorschau. |
| `priorYear` | boolean | `true`, wenn der Abgangstag im Vorjahr liegt; dann ist `confirmPriorYear` Pflicht. |
| `proceedsAccount` | integer | Erlöskonto des Verkaufs. |
| `proceedsNetCents` | integer | Erlös netto in Cent. |
| `removed` | Array<AssetBooking>, kann null sein | Offene Buchungen, die einen Löschvermerk bekommen. |
| `resultCents` | integer | Erlös abzüglich Restwert: Gewinn, wenn positiv in Cent. |
| `reversals` | Array<AssetBooking>, kann null sein | Gegenbuchungen festgeschriebener Buchungen, mit deren Datum. |
| `vatCents` | integer | Umsatzsteuer eines Verkaufs ohne Rechnung in Cent. |

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