bimetricsEntwickler
Ausgangsrechnungen

Gespeicherten Rechnungsentwurf prüfen

Als Markdown ansehen

Benötigte Berechtigung:invoices:draft(Rechnungsentwürfe verwalten)

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
post/api/draft/{id}/tax-case

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

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 in dieser Firma (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. 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?boolean

Mindestens ein Problem verhindert den Abschluss.

buyer?

Erwarteter Kontaktbezug des Empfängers.

chartOfAccounts?string

Kontenrahmen SKR03 oder SKR04, leer falls nicht eingerichtet.

complete?boolean

Alle Positionen konnten einem Steuerfall zugeordnet werden.

enabled?boolean

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

Beispielanfrage
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"
Beispielantwort
{  "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"  }}