Zuordnung lesen
Benötigte Berechtigung:read(Daten lesen)
Liefert die Zuordnung mit ihren Beleg- und Umsatzreferenzen und dem offenen Betrag.
Benötigt einen Schlüssel mit der Berechtigung read.
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).
uuidErfolg.
application/json- response
Zuordnung von Belegen und Umsätzen, z. B. eine bezahlte Rechnung.
amountOpen?integerOffener Betrag in Cent; 0, wenn Belege und Umsätze aufgehen.
autoMatch?booleanDie Zuordnung entstand automatisch.
bankTransactions?array<>|Zugeordnete Umsätze.
cashBookEntryId?stringBei cash_transit: der Eintrag im Kassenbuch, dessen Bankseite die Zuordnung ist.
uuidcashDiscount?Bei der Zuordnung angewendeter Skonto; fehlt ohne Skonto.
category?stringArt der Zuordnung: payment Zahlung, invoice_cancellation Storno, money_transfer Umbuchung zwischen eigenen Konten, cash_transit Bankumsatz einer Buchung Bank ↔ Kasse im Kassenbuch.
companyId?stringID der Firma.
uuidcreatedAt?stringAnlage in bimetrics.
date-timedocuments?array<>|Zugeordnete Belege.
exchangeDifference?Als Kursdifferenz gebuchter offener Betrag von Belegen in Fremdwährung; fehlt sonst.
id?stringID der Zuordnung.
uuidmatchingRule?|Die Zuordnungsregel; null ohne Regel.
matchingRuleId?|ID der Zuordnungsregel: bei autoMatch die Regel, nach der die Zuordnung entstand, sonst die aus ihr abgeleitete Regel. null ohne Regel.
uuidorigin?stringAuslösender Zugang bzw. automatische Zuordnung.
reminderCharges?Als Mahnkosten und Zinsen gebuchter Mehrbetrag der Zahlung; fehlt sonst.
updatedAt?stringLetzte Änderung.
date-timecurl --fail-with-body "https://app.bimetrics.de/api/match/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "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": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "matchingRule": null, "matchingRuleId": null, "updatedAt": "2026-09-12T07:30:15Z"}Offenen Zuordnungsbetrag berechnen POST
Berechnet den offenen Betrag für ausgewählte Belege und Umsätze ohne Speicherung. Betrag als Dezimalzahl in Euro. Benötigt einen Schlüssel mit der Berechtigung `read`.
Zuordnung aufheben DELETE
Hebt eine veränderbare Zuordnung auf und berechnet betroffene Buchungen neu. expectedVersions aus delete-preview unverändert mitsenden; die Vorschau nennt dabei gelöschte Serienbelege. Sind Buchungen schon an DATEV exportiert (`exportedMonths` der Vorschau), hebt bimetrics die Zuordnung nur mit `confirmExported: true` auf, sonst kommt `409 FinalizedBookingsLocked`. Es bucht dann dasselbe wie „Zuordnung lösen“ in der App. Festgeschriebene Buchungen bleiben stehen, ob exportiert oder nicht. Storno und Neubuchung bucht bimetrics nur dort, wo sich für DATEV etwas ändert: bei einer festgeschriebenen Zahlung immer, weil ihr Konto wechselt, und bei einer Sammelzahlung mit Rest auch bei den Belegen. Was davon schon exportiert war, geht mit dem nächsten Export der noch nicht exportierten Buchungen als Nachtrag an DATEV. Ist die Umsatzsteuer-Voranmeldung eines Monats aus `reversedFinalizedMonths` schon abgegeben, kann eine Berichtigung nötig sein. Neu zuordnen lassen sich Beleg und Umsatz danach mit `POST /api/match/` und `confirmExported: true`. Eine Wiederholung mit gleichem Schlüssel hebt nichts erneut auf. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.