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. Legt keine Kontakte, Rechnungen oder Buchungen an. Kein Anfrageinhalt erforderlich.

Benötigt einen Schlüssel mit der Berechtigung invoices:draft.

Authentifizierung

AuthentifizierungBearer <token>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

In: header

Pfadparameter

id*string

ID des Objekts in dieser Firma (UUID).

Formatuuid

Antworten

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

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"
{  "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,      "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"  }}

Ausgangsrechnung erstellen PUT

Schließt genau den gespeicherten und mit expectedUpdatedAt bezeichneten Entwurf ab, prüft die E-Rechnung und erzeugt Rechnungsnummer, PDF, XML und Buchungsdaten. Im Anfrageinhalt ausschließlich expectedUpdatedAt senden; es erfolgt kein Versand. Benötigt einen Schlüssel mit der Berechtigung `invoices:finalize`.

Belege und Umsätze zuordnen POST

Ordnet vorhandene Belege und Bankumsätze zu. Alle IDs müssen zur Firma gehören; parallele oder bereits vorhandene Zuordnungen werden geprüft. Die Änderung erzeugt vorbereitete Buchungen. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.