bimetricsEntwickler
Forderungen und Mahnungen

Aktuellen Forderungsstand einer Rechnung lesen

Als Markdown ansehen

Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)

GET
/api/receivable/{id}

Die ID bezeichnet den ursprünglichen Rechnungsentwurf. receivableVersion bindet Rechnung, Zahlungen und ausgestellte Korrekturen. Eine bezahlte Rechnung kann weiterhin korrigiert werden; refundDueMinor bezeichnet ein Guthaben des Kunden, keine ausgeführte Auszahlung.

Benötigt einen Schlüssel mit der Berechtigung sales:read oder read.

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 dieser Firma (UUID); bei Forderungsständen und neuen Korrekturen die Quellentwurfs-ID.

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/receivable/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
{  "canCorrect": true,  "canRemind": true,  "correctableMinor": 178500,  "correctedMinor": 0,  "currency": "EUR",  "customerName": "Brauhaus Elbwiese GmbH",  "dueDate": {    "day": 15,    "month": 9,    "year": 2026  },  "invoiceDate": {    "day": 1,    "month": 9,    "year": 2026  },  "number": "RE-2026-0142",  "openMinor": 107100,  "originalGrossMinor": 178500,  "paidMinor": 71400,  "paymentKnown": true,  "receivableVersion": "0e8ca8e3db88d8d5b74c965d0e17598a5909240c88376e0b0a4a23e53ee9356f",  "refundDueMinor": 0,  "sourceDocumentId": "3026096b-614f-40d3-8749-8acf9b529480",  "sourceDraftId": "821c3664-640a-4e10-b120-a4ff713532f8",  "sourceLayoutId": "classic",  "sourceVersion": "2026-09-01T08:01:02.123456Z"}

Forderungsstände lesen GET

Liefert ausgestellte Rechnungen mit aktuellem Zahlungsstand, Korrekturkapazität und Aktionsfreigaben. Alle Geldwerte in EUR-Cent. Bei paymentKnown=false sind zahlungsabhängige Nullwerte keine bestätigten Nullbeträge; Mahnungen bleiben gesperrt. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.

Mahnungen und Entwürfe suchen GET

Liefert Mahnungsentwürfe, ausgestellte und zurückgezogene Mahnungen. status=all schließt den unveränderlichen Verlauf ein. Ein dokumentierter externer Versand ist kein Versandauftrag oder Zustellnachweis. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.