bimetricsEntwickler
Ausgangsrechnungen

Verfügbare Rechnungskorrektur je Position lesen

Als Markdown ansehen

Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)

GET
/api/draft/{id}/correction-capacity

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

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des Objekts dieser Firma (UUID); bei Forderungsständen und neuen Korrekturen die Quellentwurfs-ID.

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Aktuelle Korrekturkapazität des Originals. Offene Entwürfe reservieren keine Beträge.

entries?array<>|

Restkapazität pro Originalposition.

invoiceNumber?string

Nummer der Originalrechnung.

reversedCorrectionDocumentIds?array<>|

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

ID des ursprünglichen Rechnungsentwurfs.

Formatuuid
sourceInvoiceDocumentId?string

ID des unveränderlichen Originalbelegs.

Formatuuid
updatedAt?string

Version des Originalentwurfs, bei createInvoiceCorrection verwenden.

Formatdate-time
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/draft/497f6eca-6276-4993-bfeb-53cbbbba6f08/correction-capacity" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "entries": [    {      "correctedGrossMinor": 0,      "label": "Fassadenbeschriftung Entwurf und Montage",      "originalGrossMinor": 178500,      "originalQuantity": "1",      "remainingGrossMinor": 178500,      "sourceLineIndex": 0,      "taxRate": "19",      "unitCode": "C62"    }  ],  "invoiceNumber": "RE-2026-0142",  "reversedCorrectionDocumentIds": [],  "revision": "0e8ca8e3db88d8d5b74c965d0e17598a5909240c88376e0b0a4a23e53ee9356f",  "sourceDraftId": "821c3664-640a-4e10-b120-a4ff713532f8",  "sourceInvoiceDocumentId": "3026096b-614f-40d3-8749-8acf9b529480",  "updatedAt": "2026-09-01T08:01:02.123456Z"}