Zuordnung erweitern
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/match/{id}/extendKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Fügt einer Zuordnung Belege oder Umsätze hinzu, etwa eine zweite Teilzahlung, wie „Zuordnung erweitern“ in der App. documentIds und transactionIds nennen die vollständige neue Auswahl: alle bisherigen Einträge und mindestens einen neuen. bimetrics ersetzt die Zuordnung in einem Schritt durch eine neue mit derselben Kategorie und bucht neu; replacedMatchId nennt die alte. expectedVersions kommt unverändert aus previewDeleteMatch. Nicht möglich mit bestätigtem Skonto (400 CashDiscountNotEligible), mit gebuchten Mahnkosten (422 ReminderChargesNotEligible), mit einem Beleg aus einer Buchungsvorlage (409 MatchNotExtendable) und, wie beim Aufheben, wenn Buchungen schon an DATEV exportiert sind (409 FinalizedBookingsLocked). Andere festgeschriebene Buchungen bleiben stehen; storniert und neu gebucht werden sie nur, wenn sich für DATEV etwas ändert, etwa bei einer Sammelzahlung.
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.
id*stringID des Objekts in dieser Firma (UUID).
uuidIdempotency-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 <= 128Die vollständige neue Auswahl und die Versionen der Aufhebungsvorschau
application/json- body
Die vollständige neue Auswahl einer Zuordnung.
documentIds?array<>|Alle Belege der neuen Zuordnung, die bisherigen und die neuen.
expectedVersions?Vollständige Versionsmap aus previewDeleteMatch, unverändert.
transactionIds?array<>|Alle Umsätze der neuen Zuordnung, die bisherigen und die neuen.
Erfolg.
application/json- response
Die neue Zuordnung und die ersetzte.
match?|Die neue Zuordnung.
replacedMatchId?stringID der ersetzten Zuordnung; sie gibt es danach nicht mehr.
uuidreplayed?booleanTrue bei sicherer Wiederholung eines bereits erfolgreichen Aufrufs.
reversedFinalizedMonths?array<string>Monate (YYYY-MM), in denen bimetrics festgeschriebene Buchungen storniert und mit geändertem Datum, Leistungszeitraum, Konto, Steuerkennzeichen oder Betrag neu gebucht hat. Ändert sich nur der Buchungstext oder die Zuordnung, fehlt der Monat. Hast du die Umsatzsteuer-Voranmeldung für einen dieser Monate oder, bei geändertem Datum, für den neuen Monat schon abgegeben, musst du sie womöglich berichtigen. Fehlt, wenn nichts storniert wurde, und bei einer Wiederholung mit demselben Idempotency-Key.
curl --fail-with-body "https://app.bimetrics.de/api/match/497f6eca-6276-4993-bfeb-53cbbbba6f08/extend" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "match": { "amountOpen": 0, "autoMatch": true, "bankTransactions": [ { "bankTransactionId": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:15Z", "id": "840529df-2d2a-42ea-afa3-3704d855634f", "matchId": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "updatedAt": "2026-09-12T07:30:15Z" } ], "category": "payment", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:15Z", "documents": [ { "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:15Z", "documentId": "3026096b-614f-40d3-8749-8acf9b529480", "id": "3432135f-5b01-4288-9764-e1ff7d061777", "matchId": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "updatedAt": "2026-09-12T07:30:15Z" } ], "id": "f63d8099-4d4e-44b4-8938-ec3b35cb0bf8", "matchingRule": null, "matchingRuleId": null, "updatedAt": "2026-09-12T07:30:15Z" }, "replacedMatchId": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "replayed": false}Euro-Betrag aus der Zahlung prüfen GET
Sagt, ob sich für den Beleg einer Zuordnung, der in einer Fremdwährung ist und dessen Euro-Betrag fehlt (`documentCurrency` ohne `euroAmountSource`), der Euro-Betrag aus der Zahlung übernehmen lässt, und liefert, was der Nutzer vorher bestätigt: Belegwährung, Betrag vom Beleg, Euro-Betrag der Zahlungen und jede Position vorher und nachher. Nötig sind genau ein Beleg und mindestens ein gebuchter Euro-Umsatz, kein Skonto an der Zuordnung und keine erfassten Zahlungen am Beleg. Passt die Zuordnung nicht, antwortet die API mit `eligible: false`, `refusal` nennt den Code und `refusalReason` den Grund. Verändert nichts. Benötigt einen Schlüssel mit der Berechtigung `read`.
Mehrbetrag einer Zuordnung als Mahnkosten und Zinsen buchen POST
Bucht die Zahlung über dem Rechnungsbetrag als Mahnkosten und Verzugszinsen der Mahnung, wie „als Mahnkosten und Zinsen buchen“ in der App, ohne die Zuordnung vorher aufzuheben. Rufe das erst auf, wenn der Nutzer die Werte aus `previewMatchReminderCharges` bestätigt hat. bimetrics ersetzt die Zuordnung in einem Schritt durch eine neue über dieselbe Rechnung und Zahlung und bucht den Debitor an die Ertragskonten, ohne Umsatzsteuer; `replacedMatchId` nennt die alte. Der offene Betrag ist danach null, die Rechnung bleibt und lässt sich nicht mehr korrigieren. `expectedVersions` kommt unverändert aus `previewMatchReminderCharges`, auch die Version der Mahnung. Eine Wiederholung mit gleichem Schlüssel bucht nichts erneut. Nicht möglich, wenn die Zuordnung nicht passt oder schon Mahnkosten oder Skonto gebucht hat (`422 ReminderChargesNotEligible`) und wenn Buchungen schon an DATEV exportiert sind (`409 FinalizedBookingsLocked`). Andere festgeschriebene Buchungen bleiben stehen; storniert und neu gebucht werden sie nur, wenn sich für DATEV etwas ändert. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.