Verfügbare Rechnungskorrektur je Position lesen
Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Objekts dieser Firma (UUID); bei Forderungsständen und neuen Korrekturen die Quellentwurfs-ID.
uuidErfolg.
application/json- response
Aktuelle Korrekturkapazität des Originals. Offene Entwürfe reservieren keine Beträge.
entries?array<>|Restkapazität pro Originalposition.
invoiceNumber?stringNummer der Originalrechnung.
reversedCorrectionDocumentIds?array<>|IDs der ausgestellten Korrekturen, die bereits durch einen Gegenbeleg aufgehoben wurden.
revision?stringDigest der aktuellen Korrekturkapazität; kann als expectedCapacityRevision beim Finalisieren die geprüfte Kapazität binden.
sourceDraftId?stringID des ursprünglichen Rechnungsentwurfs.
uuidsourceInvoiceDocumentId?stringID des unveränderlichen Originalbelegs.
uuidupdatedAt?stringVersion des Originalentwurfs, bei createInvoiceCorrection verwenden.
date-timecurl --fail-with-body "https://app.bimetrics.de/api/draft/497f6eca-6276-4993-bfeb-53cbbbba6f08/correction-capacity" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "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"}Korrekturentwurf ändern PUT
Die ID bezeichnet den offenen Korrekturentwurf; expectedUpdatedAt dessen aktuelle Version. Ersetzt Grund, Datum und Korrekturbeträge. layoutId am besten weglassen, dann bleibt das Layout des Entwurfs. Generisches updateDraft nimmt Korrekturen nicht an. Nach PDF-Prüfung stellt finalizeDraft den gespeicherten Entwurf aus und erzeugt Korrekturbuchungen, aber keine Auszahlung. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.
Ausgestellte Rechnungskorrektur vollständig aufheben POST
Erstellt und stellt einen positiven Gegenbeleg correction_reversal zur ausdrücklich gewählten Korrektur aus. Die ursprüngliche Rechnung und beide Korrekturbelege bleiben erhalten. Erzeugt Gegenbuchungen, keine Auszahlung oder Abbuchung. expectedUpdatedAt bezeichnet den ausgestellten Korrekturentwurf. Benötigt einen Schlüssel mit der Berechtigung `invoices:finalize`.