Ausgestellte Auftragsbestätigung lesen
Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)
Liefert die eigene AB-Nummer, den eingefrorenen Inhalt und Bruttobetrag in Cent. Die Auftragsbestätigung ist kein Buchhaltungsbeleg und erzeugt keine Buchungen.
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).
uuidErfolg.
application/json- response
Finalisierte Auftragsbestätigung als unveränderlicher Inhalt, ohne Buchung oder E-Rechnungs-XML.
companyId?stringID der Firma.
uuidcreatedAt?stringAnlage in bimetrics.
date-timedraftBody?Bei Finalisierung eingefrorener Inhalt.
grossTotal?integerBruttobetrag in Cent.
id?stringID der ausgestellten Auftragsbestätigung.
uuidorderConfirmationNumber?stringEigene AB-Nummer.
salesProcessId?|Zugehöriger Verkaufsvorgang.
uuidsourceSalesProposalId?stringUrsprüngliches finales Angebot.
uuidupdatedAt?stringLetzte Änderung.
date-timeuploadDocument?|Gespeicherte PDF-Datei der ausgestellten Auftragsbestätigung.
uploadDocumentId?|ID der gespeicherten PDF-Datei.
uuidcurl --fail-with-body "https://app.bimetrics.de/api/orderconfirmation/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-10-07T08:00:00Z", "draftBody": { "buyer": { "address": { "city": "Hamburg", "countryId": "DE", "line1": "Am Hafen 12", "postcode": "20457" }, "contactId": "b17e8812-eae4-49b6-b5dc-30510635cb07", "customerNumber": 1004, "email": "", "name": "Brauhaus Elbwiese GmbH", "vatId": "" }, "dueDate": { "day": 15, "month": 9, "year": 2026 }, "issueDate": { "day": 1, "month": 9, "year": 2026 }, "items": [ { "description": "Gestaltung einer Geschäftsausstattung", "discount": "0", "name": "Gestaltung", "position": "1", "quantity": "1", "taxRate": "19", "unit": "C62", "unitPrice": "100" } ], "notes": "", "performancePeriodFrom": { "day": 1, "month": 9, "year": 2026 }, "priceType": "net", "remark": "", "showQRCode": false, "strict": false, "taxRateReason": "none", "validUntil": null }, "grossTotal": 11900, "id": "821c3664-640a-4e10-b120-a4ff713532f8", "orderConfirmationNumber": "AB-2026-0018", "salesProcessId": null, "sourceSalesProposalId": "821c3664-640a-4e10-b120-a4ff713532f8", "updatedAt": "2026-10-07T08:01:00Z", "uploadDocument": null, "uploadDocumentId": null}Offenen AB-Entwurf verwerfen DELETE
Löscht ausschließlich eine offene Auftragsbestätigung als Entwurf mit expectedUpdatedAt. Finale Auftragsbestätigungen, Angebote und Rechnungen bleiben geschützt. Idempotency-Key bei Wiederholung unverändert senden. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.
Befreiungsgründe auflisten GET
Liefert die Befreiungsgründe, die die App unter „Steuerfall anpassen“ für „Steuerfrei nach § 4 UStG“ anbietet, in derselben Reihenfolge. `shortcut` ist der Wert für `taxException.reason` bei `kind` `exempt_4`. Der Grund steht im Pflichthinweis der Rechnung und entscheidet das Erlöskonto, das `account` nennt. Der letzte Eintrag, `§ 4 UStG` ohne genauen Grund, geht auch, die Prüfung meldet dann den Hinweis `exempt_reason_unspecific`. Die Liste ist für alle Firmen gleich. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.