bimetricsEntwickler
Ausgangsrechnungen

Ausgestellte Rechnungskorrektur vollständig aufheben

Als Markdown ansehen

Benötigte Berechtigung:invoices:finalize(Ausgangsrechnungen erstellen und stornieren)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/draft/{id}/correction/cancel

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

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.

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

Header-Parameter

Idempotency-Key*string

Stabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

application/json
  1. body

Versionsbedingung ohne frei veränderbaren Rechnungsinhalt.

expectedUpdatedAt?|

Exakter zuletzt gelesener updatedAt-Wert einschließlich Sekundenbruchteilen.

Formatdate-time

Antworten

Erfolg.

application/json
  1. response

Ergebnis einer Rechnung, Rechnungskorrektur, deren Gegenbeleg, eines Angebots, einer Auftragsbestätigung oder eines Vollstornos.

document?

Ausgestellter Rechnungs-, Korrektur-, Gegen- oder Stornobeleg.

orderConfirmation?

Ausgestellte Auftragsbestätigung ohne Buchung oder XML.

quotaNotice?

Nur bei einer Rechnung, nach der das Dokumentkontingent ausgeschöpft ist; die Rechnung ist trotzdem ausgestellt.

salesProposal?

Ausgestelltes Angebot ohne Buchung oder XML.

warnings?array<>

Hinweise, die das Ausstellen nicht verhindert haben: IssueDateBeforeLastInvoice, wenn das Rechnungsdatum vor deiner letzten Rechnung liegt. Das ist erlaubt, fällt aber bei einer Betriebsprüfung auf. Fehlt ohne Hinweis und bei einer Wiederholung mit demselben Idempotency-Key.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/draft/497f6eca-6276-4993-bfeb-53cbbbba6f08/correction/cancel" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "document": {    "bookingErrors": null,    "bookings": [],    "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",    "contentSource": "auto",    "createdAt": "2026-09-01T09:12:44Z",    "deletedAt": null,    "deliveryDate": null,    "documentContract": null,    "documentContractId": null,    "documentSeries": null,    "documentSeriesId": null,    "dueDate": {      "day": 15,      "month": 9,      "year": 2026    },    "id": "b7bd5664-05df-4b23-8155-c2995cb330ae",    "importOrigin": "upload",    "invoiceDate": {      "day": 1,      "month": 9,      "year": 2026    },    "invoiceNumber": "RE-2026-0144",    "invoicePositions": [      {        "additionalInfo": {          "freeOfVat": false,          "reverseCharge": false        },        "category": "sales_income",        "label": "Aufhebung der Rechnungskorrektur",        "subPositions": null,        "total": 23800,        "vatPercentage": "19"      }    ],    "issuedInvoice": {      "cancellation": false,      "correctionReversal": true,      "draftId": "895394db-2b8b-4b25-a36f-c4b7c14c6653"    },    "issuer": {      "address": "Mühlenkamp 31, 22303 Hamburg",      "customerNumber": null,      "iban": "DE89370400440532013000",      "name": "Hansen & Kowalski Werbetechnik GmbH",      "taxId": "DE123456789"    },    "kind": "invoice",    "match": null,    "paymentTerms": "Zahlbar innerhalb von 14 Tagen ohne Abzug.",    "performancePeriodFrom": null,    "performancePeriodTo": null,    "recipient": {      "address": "Am Sandtorkai 12, 20457 Hamburg",      "customerNumber": 1004,      "iban": "DE02120300000000202051",      "name": "Brauhaus Elbwiese GmbH",      "taxId": "DE987654321"    },    "reversesCorrectionDocumentId": "895394db-2b8b-4b25-a36f-c4b7c14c6653",    "source": "",    "sourceInvoiceDocumentId": "3026096b-614f-40d3-8749-8acf9b529480",    "updatedAt": "2026-09-12T07:30:19Z",    "uploadDocument": {      "blob": {        "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",        "createdAt": "2026-09-01T09:12:44Z",        "id": "cd47afe0-7d1b-4c2a-8f7b-cbd58d92a54a",        "length": 84213,        "mime": "application/pdf",        "originalFilename": "RE-2026-0144.pdf",        "sha256": "1ca20000989555ec85b52711c84520f26bac2604307222e5cd978605783f6bc2",        "updatedAt": "2026-09-01T09:12:44Z"      },      "blobId": "cd47afe0-7d1b-4c2a-8f7b-cbd58d92a54a",      "creatorUserCompanyId": "53cd10a9-c864-4dc3-a777-9860d59efe6c",      "ocrFinishedAt": "2026-09-01T09:13:02Z",      "ocrStartedAt": "2026-09-01T09:12:45Z",      "ocrStatus": "success",      "pageCount": 2,      "pagesRead": 2    },    "uploadDocumentId": "e0ba087b-4b49-4137-8bb8-555a24619eae",    "version": ""  }}

Verfügbare Rechnungskorrektur je Position lesen GET

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`.

Folgedokument aus gewählter Quelle erstellen POST

Mit targetKind order_confirmation entsteht aus einem finalisierten Angebot eine optionale Auftragsbestätigung als Entwurf. Mit targetKind invoice entsteht ausdrücklich aus dem finalisierten Angebot oder der finalisierten Auftragsbestätigung eine Rechnung. expectedUpdatedAt bezeichnet den gelesenen Quellentwurf. Das Original bleibt unverändert. Je Auftrag höchstens eine gültige Rechnung über den ganzen Auftrag oder eine Schlussrechnung; nach einem Storno ist wieder eine möglich. Davor beliebig viele Abschläge (`invoiceRole`). Sperren: `409 FinalInvoiceExists`, `409 DownPaymentsExist`, `422 DownPaymentTaxCaseUnsupported`. Kein Versand und keine Buchung beim Ableiten. Setzt ein Angebot automatisch auf angenommen, auch nach einer Ablehnung. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.