bimetricsEntwickler
Zuordnungen

Geeignete Rechnungen für eine Verrechnung suchen

Als Markdown ansehen

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

GET
/api/match/correction-settlement/{correctionDocumentId}/targets

Liefert bis zu 20 geeignete offene Ausgangsrechnungen derselben Firma und desselben Kunden. Maßgeblich sind Kontakt-ID und Kundennummer aus den ausgestellten Originalen sowie das gebuchte Personenkonto. Die ursprüngliche Rechnung, Stornos, unklare Zahlungsstände und festgeschriebene Belege sind ausgeschlossen. Bei hasMore=true die Rechnungsnummer mit search weiter eingrenzen.

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

correctionDocumentId*string

ID des ausgestellten Korrekturbelegs (UUID).

Query-Parameter

search?string

Teil der Rechnungsnummer; Groß- und Kleinschreibung wird nicht unterschieden.

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/match/correction-settlement/string/targets" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
{  "hasMore": false,  "items": [    {      "customerName": "Brauhaus Elbwiese GmbH",      "documentId": "94c38d05-f204-493e-bcd8-d7f1e75cd1c6",      "invoiceNumber": "RE-2026-0145",      "openMinor": 35700,      "revision": "0e8ca8e3db88d8d5b74c965d0e17598a5909240c88376e0b0a4a23e53ee9356f"    }  ]}

Erstattungsfähiges Guthaben einer Rechnungskorrektur lesen GET

Liefert die aktuelle Kapazität und bisher erfasste Rückzahlungen oder Verrechnungen einer ausgestellten Rechnungskorrektur. Die Kapazität ist sowohl durch deren eigenen Restbetrag als auch durch das Guthaben der Originalrechnung einschließlich aller Korrekturen und Zahlungen begrenzt. Unklarer Zahlungsstand sperrt neue Erfassungen. Eine Minderung einer unbezahlten Rechnung ist noch kein auszahlbares Guthaben. Benötigt einen Schlüssel mit der Berechtigung `sales:read` oder `read`.

Bereits erfolgte Zahlung erfassen POST

Dokumentiert eine bereits erfolgte Bar- oder Verrechnungszahlung zu einem Beleg. Standardmäßig ausgeschaltet (manualPaymentsEnabled); erwartet expectedAmountOpenMinor zusätzlich zur Belegversion. Betrag in Cent, Währung EUR. Das Gegenkonto bestimmt der Server. Erzeugt weder eine Banktransaktion noch einen Zahlungsauftrag. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.