bimetricsEntwickler
Forderungen und Mahnungen

Forderungsstände lesen

Als Markdown ansehen

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

GET
/api/receivable/

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.

Authentifizierung

AuthentifizierungBearer <token>

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

In: header

Query-Parameter

limit?integer

Seitengröße; Standard 25, höchstens 100.

offset?integer

Anzahl zu überspringender Treffer; Standard 0.

search?string

Suche in Rechnungsnummer und Kundenname.

sort?string

Sortierfeld createdAt (Standard), number, customerName, issueDate oder dueDate. Berechnete offene Beträge sind nicht sortierbar.

direction?string

Sortierrichtung asc oder desc; Standard desc. Sortierung gilt vor der Seitenauswahl.

dueState?string

Fälligkeitsfilter overdue, not_due oder all (Standard). Prüft ausschließlich das Fälligkeitsdatum, nicht den Zahlungsstand.

review?string

Optional reminders: nur mahnfähige Rechnungen oder Klärfälle mit unbekanntem Zahlungsstand beziehungsweise offenem Betrag ohne Fälligkeitsdatum. Ausgestellte Stornos und bekannte ausgeglichene oder überzahlte Forderungen bleiben ausgeschlossen. Ebenso Rechnungen mit einer ausgestellten, nicht zurückgezogenen Mahnung, deren Zahlungsfrist heute oder später endet (Europe/Berlin). Entwürfe und abgelaufene Fristen verschieben die Prüfung nicht. Filtert vor Gesamtzahl und Seitenauswahl; ohne Parameter bleibt die vollständige Quellenauswahl erhalten.

Antworten

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl --fail-with-body "https://app.bimetrics.de/api/receivable/" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
{  "items": [    {      "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"    }  ],  "total": 1}

Tarif und Kontingent lesen GET

Liefert Tarif, Grenzen und die aktuelle Nutzung der Firma. Ein einfacher erster Aufruf, um Schlüssel und Verbindung zu prüfen. Benötigt einen Schlüssel mit der Berechtigung `read`.

Aktuellen Forderungsstand einer Rechnung lesen GET

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