Gespeicherten Rechnungsentwurf prüfen
Benötigte Berechtigung:invoices:draft(Rechnungsentwürfe verwalten)
Echte Wirkung
/api/draft/{id}/tax-caseKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Prüft den gespeicherten Entwurf und liefert Steuerfall, Problemcodes und vorgesehene Konten. Meldet auch einen Entwurf ohne Position (ItemsRequired), einen fehlenden Firmennamen (company_name_required), unvollständige Anschriften von Firma oder Kunde (InvoiceAddressRequired) sowie eine unbestätigte Versteuerung (SellerTaxStatusUnconfirmed) oder fehlende Steuernummer der Firma (SellerTaxIdRequired) als blockierend, weil das Abschließen sie ablehnt. Liegt das Rechnungsdatum vor deiner letzten Rechnung, weist IssueDateBeforeLastInvoice darauf hin, ohne zu blockieren. Hat ein Steuerfall ohne Umsatzsteuer auf der Rechnung eine Position mit Bruttopreis auf 0 % gesetzt, weist gross_price_without_vat darauf hin, ebenfalls ohne zu blockieren. Der Hinweis nennt den Einzelpreis, den der Kunde zahlt, und den Einzelpreis, aus dem die frühere Umsatzsteuer herausgerechnet ist. Je Position nennt lines[].allowedRates die Steuersätze, die ihr Steuerfall erlaubt. Bei einer Schlussrechnung nennt settlement Abzüge, Stornos, Korrekturen und den Revisionswert, bei Abschlag und Schlussrechnung billing den Stand des Auftrags. Legt keine Kontakte, Rechnungen oder Buchungen an. Kein Anfrageinhalt erforderlich.
Benötigt einen Schlüssel mit der Berechtigung invoices:draft.
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
Fachliche Prüfung des gespeicherten Entwurfs ohne Speicherung oder Versand.
allowedRates?array<>|Steuersätze in Prozent für eine neue Position der Verkaufsart der Firma; jede Position nennt ihre eigenen in lines.
billing?Nur Abschlag und Schlussrechnung: Stand des Auftrags mit seinen Abschlägen, der abschließenden Rechnung und den Summen.
blocking?booleanMindestens ein Problem verhindert den Abschluss.
buyer?Erwarteter Kontaktbezug des Empfängers.
chartOfAccounts?stringKontenrahmen SKR03 oder SKR04, leer falls nicht eingerichtet.
complete?booleanAlle Positionen konnten einem Steuerfall zugeordnet werden.
enabled?booleanDie Steuerfallableitung ist für diese Firma aktiviert.
lines?array<>|Vorgesehene Kategorien und Konten pro Position.
problems?array<>|Blockierende Probleme und Warnungen.
settlement?Nur Entwurf einer Schlussrechnung: was das Ausstellen mit den Abschlägen des Auftrags macht.
taxCase?Abgeleiteter Steuerfall und verwendete Fakten.
curl --fail-with-body "https://app.bimetrics.de/api/draft/497f6eca-6276-4993-bfeb-53cbbbba6f08/tax-case" -X POST \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "allowedRates": [ "19", "7", "0" ], "blocking": false, "buyer": { "contactId": "b17e8812-eae4-49b6-b5dc-30510635cb07", "customerNumber": 1004, "kindSource": "contact", "link": "selected", "name": "Brauhaus Elbwiese GmbH" }, "chartOfAccounts": "SKR03", "complete": true, "enabled": true, "lines": [ { "account": 8400, "allowedRates": [ "19", "7", "0" ], "bookingCategory": "income", "case": "standard", "index": 0, "vatCategory": "S" } ], "problems": [], "taxCase": { "cases": [ "standard" ], "facts": { "buyerAddressCountry": "DE", "buyerKindSource": "contact", "buyerRegion": "DE", "contactLink": "selected", "noVatLiability": false, "salesKind": "services", "sellerCountry": "DE", "sellerHasTaxNumber": false, "sellerHasVatId": false, "smallBusiness": false }, "hints": [], "lines": [ { "bookingCategory": "income", "case": "standard", "freeOfVat": false, "index": 0, "kind": "services", "kindSource": "company", "reverseCharge": false, "taxRate": "19", "vatCategory": "S" } ], "ruleVersion": 1, "source": "derived" }}Neue Version eines Angebots anlegen POST
Legt wie „Neue Version erstellen“ in der App einen Angebotsentwurf mit allen Inhalten des Angebots an, mit heutigem Datum und so vielen Tagen Gültigkeit wie bisher. Das geht, solange das Angebot offen, abgelaufen oder abgelehnt ist und keine neuere ausgestellte Version hat. Gibt es schon einen offenen Entwurf dieser Version, kommt er zurück. Beim Ausstellen bekommt die neue Version die Nummer des ersten Angebots mit ihrer Version, etwa `AN-2026-1040-2`, und ihr PDF nennt unter dem Titel das Datum des ersetzten Angebots. Das ersetzte Angebot bleibt unverändert. Ein angenommenes Angebot ergibt `409 ProposalVersionAccepted`, eine neuere Version `409 ProposalVersionExists` (`context.version` und `context.draftId` nennen die neueste). Eine ersetzte Version lässt sich weder annehmen, ablehnen noch umwandeln (`409 ProposalReplaced`). Beim Ausstellen gelten dieselben Regeln noch einmal. Idempotency-Key bei Wiederholung unverändert senden. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.
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`.