Ausgestellte E-Rechnung laden
Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)
Liefert das bereits ausgestellte CII-XML einer abgeschlossenen Rechnung, Stornorechnung, Rechnungskorrektur oder deren Gegenbeleg als Datei. Die Bytes stammen aus dem unveränderten ausgestellten PDF.
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 in dieser Firma (UUID).
uuidDie bereits ausgestellte E-Rechnung als XML-Datei.
response?unknownapplication/xmlcurl --fail-with-body "https://app.bimetrics.de/api/draft/497f6eca-6276-4993-bfeb-53cbbbba6f08/einvoice-xml" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"nullFolgedokument 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`, aus einem Nachtrag `409 ProposalAddendumNotConvertible`, eine Auftragsbestätigung nach einem ausgestellten Nachtrag `409 OrderConfirmationAfterAddendum`. 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`.
Rechnung, Korrektur, Angebot oder Auftragsbestätigung ausstellen PUT
Eine Auftragsbestätigung erhält eine eigene Nummer und ein PDF ohne XML oder Buchungen; das Ergebnis steht in orderConfirmation. Ein Angebot ebenso, mit Nummer aus dem Nummernkreis der Angebote; das Ergebnis steht in salesProposal. Rechnungen stehen weiterhin in document. Schließt genau den gespeicherten und mit expectedUpdatedAt bezeichneten Entwurf ab. Korrekturen und deren Gegenbelege erzeugen eigene unveränderliche Belege und entsprechende Buchungen; daraus entsteht keine Auszahlung. Bei Rechnungen wird die E-Rechnung geprüft und Rechnungsnummer, PDF, XML und Buchungsdaten erzeugt. Im Anfrageinhalt expectedUpdatedAt senden; für Korrekturen und deren Gegenbelege kann expectedCapacityRevision aus getCorrectionCapacity zusätzlich den geprüften Kapazitätsstand binden. Geänderte Kapazität erfordert dann eine erneute Prüfung. Eine Schlussrechnung storniert beim Ausstellen unbezahlte Abschläge des Auftrags und korrigiert teilbezahlte auf den bezahlten Betrag, in einem Schritt mit fortlaufenden Nummern; sind unbezahlte dabei, nur mit `acceptCancelOpenDownPayments`. `expectedSettlementRevision` bindet sie an die geprüften Abzüge (`409 FinalInvoicePaymentsChanged`). Gesperrt mit `409 DownPaymentDraftsOpen`, `409 DownPaymentPaymentUnknown`, `409 DownPaymentOverpaid`, `422 FinalInvoiceNegative`, `422 FinalInvoiceCashDiscount`. Hat sich der Auftrag geändert, seit eine Schlussrechnung oder Rechnung über den ganzen Auftrag angelegt wurde (ein Nachtrag beauftragt oder zurückgenommen, eine neue Auftragsbestätigung; `orderChanges`), lehnt es sie mit `409 ClosingInvoiceAddendaChanged` ab; dann legst du sie mit `replaceDraftId` und `replaceExpectedUpdatedAt` neu an. Einen Abschlag, dessen Betrag seitdem nicht neu berechnet wurde, lehnt es mit `409 DownPaymentOrderValueChanged` ab; speichern mit `downPayment` rechnet ihn neu. Keine bearbeitbaren Rechnungsfelder und kein Versand. Benötigt einen Schlüssel mit der Berechtigung `invoices:finalize`.