# Verfügbare Rechnungskorrektur je Position lesen (https://developer.bimetrics.de/reference/sales/get-correction-capacity)

`GET https://app.bimetrics.de/api/draft/{id}/correction-capacity`

operationId: `getCorrectionCapacity` · Berechtigung (Scope): `sales:read` · Bereich: Ausgangsrechnungen

Akzeptiert die Original- oder Korrekturentwurfs-ID; sourceDraftId verweist immer auf das Original. remainingGrossMinor berücksichtigt nur ausgestellte, nicht aufgehobene Korrekturen. Offene Entwürfe reservieren keine Beträge. Der Zahlungsstand begrenzt die Korrekturkapazität nicht. Ein Abschlag lässt sich aber nur korrigieren, solange nichts bezahlt ist (`409 DownPaymentCorrectionExceedsOpen`), und bei einer Schlussrechnung nennt `remainingGrossMinor` höchstens den Rest ihres Steuersatzes nach den Abzügen; mehrere Positionen desselben Satzes begrenzt erst das Ausstellen.

Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `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 des Objekts dieser Firma (UUID); bei Forderungsständen und neuen Korrekturen die Quellentwurfs-ID. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/draft/{id}/correction-capacity" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `entries` | Array<CorrectionCapacityEntry>, kann null sein | Restkapazität pro Originalposition. |
| `invoiceNumber` | string | Nummer der Originalrechnung. |
| `reversedCorrectionDocumentIds` | Array<string (uuid)>, kann null sein | IDs der ausgestellten Korrekturen, die bereits durch einen Gegenbeleg aufgehoben wurden. |
| `revision` | string | Digest der aktuellen Korrekturkapazität; kann als expectedCapacityRevision beim Finalisieren die geprüfte Kapazität binden. |
| `sourceDraftId` | string (uuid) | ID des ursprünglichen Rechnungsentwurfs. |
| `sourceInvoiceDocumentId` | string (uuid) | ID des unveränderlichen Originalbelegs. |
| `updatedAt` | string (date-time) | Version des Originalentwurfs, bei createInvoiceCorrection verwenden. |

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