Erfasste Zahlung zurücknehmen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/match/payment/reverseKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Nimmt eine erfasste Bar-, Verrechnungs- oder Privatzahlung oder eine Rundungsdifferenz oder Ausbuchung durch Gegenbuchung zurück; solange eine davon aktiv ist, geht sie vor jeder anderen Zahlung des Belegs zurück (409 RoundingStillActive, 409 WriteOffStillActive). 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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Idempotency-Key*stringStabiler 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.
^[!-~]+$1 <= length <= 128Rücknahme einer Zahlung
application/json- body
Rücknahme einer erfassten Zahlung durch Gegenbuchung.
expectedAmountOpenMinor?|Aktueller offener Betrag des Belegs in Cent.
expectedVersion?stringAktueller fachlicher Versionsdigest des Belegs.
paymentId?stringID der zurückzunehmenden Zahlung.
uuidreversedOn?Datum der Gegenbuchung, frühestens der Zahltag, höchstens heute. Ohne Angabe der Zahltag, solange dessen Buchung offen ist, sonst heute. Bei einer Ausbuchung (write_off) Pflicht: der Tag der Zahlung, wenn der Kunde doch zahlt, nach einem Irrtum der Tag der Ausbuchung.
Erfolg.
application/json- response
Erfasste Zahlung und neuer offener Betrag.
amountOpenMinor?integerVerbleibender offener Betrag in Cent; solange beim Beleg der Euro-Betrag fehlt, in Hundertsteln der Belegwährung.
amountOpenOriginalMinor?integerNur bei einer Zahlung in Belegwährung: was vom Beleg in seiner Währung noch offen ist, in Hundertsteln.
payment?|Dokumentierte Zahlung.
replayed?booleanTrue bei sicherer Wiederholung eines bereits erfolgreichen Aufrufs.
curl --fail-with-body "https://app.bimetrics.de/api/match/payment/reverse" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "amountOpenMinor": 11900, "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 }, "reversedAt": "2026-09-03T10:00:00Z", "reversedOn": { "day": 3, "month": 9, "year": 2026 }, "updatedAt": "2026-09-02T10:00:00Z" }, "replayed": false}Privat bezahlt: Stand der Firma lesen GET
Sagt, wie bimetrics eine private Zahlung (`recordPayment` mit `method` `private`) für diese Firma bucht, und bei GmbH und UG, was die Firma dem Gesellschafter noch schuldet. Den Zahlungsstand eines einzelnen Belegs liefert `getDocument` (`remainingPaymentMinor`, `recordedPayments`). Nur mit eingeschalteter Zahlungserfassung (`manualPaymentsEnabled`), sonst `403 ManualPaymentUnavailable`. Benötigt einen Schlüssel mit der Berechtigung `read`.
Zuordnungsvorschläge lesen POST
Liefert die Vorschläge, die die App zu offenen Belegen und Umsätzen zeigt, für bis zu 20 auf einmal: Gegenstück, Begründung, offener Betrag danach und ob die App noch nachfragen würde. Es wird nichts zugeordnet. `anchors` hat einen Eintrag je Beleg und Umsatz, erst die Belege, je in der Reihenfolge der Anfrage, mit denselben Vorschlägen in derselben Reihenfolge wie einzeln, höchstens `limit` (1 bis 5, ohne Angabe 3). Ist ein Eintrag schon zugeordnet, steht die Zuordnung in `anchorMatchId`; lässt er sich nicht lesen oder trägt er manuelle Zahlungen, nennt `unavailable` den Grund. Beides stört die übrigen Einträge nicht. Vorschläge aus Buchungsvorlagen fehlen. Die Route vergleicht mit allen offenen Belegen und Umsätzen der Firma und hat deshalb ein eigenes Budget, siehe Limits. Benötigt einen Schlüssel mit der Berechtigung `read`.