Doppelt importierten Umsatz prüfen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/banktransaction/{id}/duplicate-previewKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Der Umsatz im Pfad ist der doppelt importierte Umsatz. keepId bleibt als Original erhalten. Offene Buchungen der Dublette entfallen, festgeschriebene bleiben erhalten und bekommen bei Bedarf ein Storno zum ursprünglichen Buchungsdatum. Nur aktive Inhaber können eine Dublette prüfen oder kennzeichnen. Zeigt beide Umsätze mit Originalbetrag, Währung und Verwendungszweck, die betroffenen Buchungen als Zähler und den Plan-Hash. Bei einer Sperre antwortet der Server mit HTTP 409 und dem Sperrgrund.
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 doppelt importierten Umsatzes.
uuidkeepId*stringID des bleibenden Umsatzes.
Erfolg.
application/json- response
Die Folgen der Kennzeichnung.
alreadyMarked?booleanDer Umsatz ist bereits als Dublette dieses Originals gekennzeichnet.
duplicate?Dieser Umsatz wird gekennzeichnet.
finalizedBookings?integerAnzahl bestehender festgeschriebener Buchungen der Dublette.
keep?Dieser Umsatz bleibt.
newReversals?integerAnzahl neuer Stornos.
openBookings?integerAnzahl entfallender offener Buchungen.
planHash?stringSHA-256 des Plans in der gezeigten Richtung.
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/497f6eca-6276-4993-bfeb-53cbbbba6f08/duplicate-preview?keepId=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "alreadyMarked": false, "duplicate": { "amountMinor": -4200, "bookingDate": "2026-11-01", "currency": "EUR", "id": "78c4ff15-f2a0-4eae-945d-73a969adab4b", "otherPartyName": "Demowerkstatt", "remittanceInformation": "Rechnung 17" }, "finalizedBookings": 1, "keep": { "amountMinor": -4200, "bookingDate": "2026-11-01", "currency": "EUR", "id": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033", "otherPartyName": "Demowerkstatt", "remittanceInformation": "Rechnung 17" }, "newReversals": 1, "openBookings": 2, "planHash": "abababababababababababababababababababababababababababababababab"}Umsatz lesen GET
Liefert einen Bankumsatz mit Zuordnung (`match`) und Buchungen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Umsatz als Dublette kennzeichnen POST
Der Umsatz im Pfad ist der doppelt importierte Umsatz. keepId bleibt als Original erhalten. Offene Buchungen der Dublette entfallen, festgeschriebene bleiben erhalten und bekommen bei Bedarf ein Storno zum ursprünglichen Buchungsdatum. Nur aktive Inhaber können eine Dublette prüfen oder kennzeichnen. Sende keepId und planHash aus der bestätigten Vorschau. Die Dublette verschwindet aus der Umsatzliste. Du kannst das Kennzeichen nicht selbst zurücknehmen. Bei geändertem Plan erneut prüfen und bestätigen. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.