bimetricsEntwickler
Zuordnungen

Bereits erfolgte Zahlung erfassen

Als Markdown ansehen

Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/match/payment

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

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.

Authentifizierung

AuthentifizierungBearer <token>

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

In: header

Header-Parameter

Idempotency-Key*string

Stabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

application/json

Payment already received or paid

TypeScript-Typen

Typ request body für TypeScript.

Dokumentation einer bereits erfolgten Bar- oder Verrechnungszahlung.

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/payment" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
{  "amountOpenMinor": 5950,  "payment": {    "account": 1000,    "accountContra": 71007,    "amountMinor": 5950,    "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",    "createdAt": "2026-09-02T10:00:00Z",    "currency": "EUR",    "documentId": "a129ef0a-da5d-4204-804c-764d751bca95",    "id": "d5e264b8-4c4a-4155-a71a-c0bd9d9c757f",    "method": "cash",    "origin": "api",    "paidOn": {      "day": 2,      "month": 9,      "year": 2026    },    "updatedAt": "2026-09-02T10:00:00Z"  },  "replayed": false}

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

Erfasste Zahlung zurücknehmen POST

Nimmt eine erfasste Bar- oder Verrechnungszahlung durch Gegenbuchung zurück. Die ursprüngliche Zahlung und Buchung bleiben in der Historie. Erwartet aktuelle Belegversion und offenen Betrag; auch bei ausgeschalteter Neuerfassung verfügbar. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.