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.

Benötigt einen Schlüssel mit der Berechtigung sales:read oder read.

Authentifizierung

AuthentifizierungBearer <token>

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

In: header

Pfadparameter

id*string

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

Formatuuid

Antworten

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl --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. Optional layoutId für modern oder classic; ohne Angabe bleibt die Layoutwahl des Entwurfs erhalten. 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`.