Umsatz als Dublette kennzeichnen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/banktransaction/{id}/mark-duplicateKein 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. 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.
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.
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 <= 128Bestätigter Plan
application/json- body
Bestätigung der Vorschau.
keepId*stringID des bleibenden Umsatzes.
uuidplanHash*stringHash aus der bestätigten Vorschau.
Erfolg.
application/json- response
Die gespeicherte Kennzeichnung.
id?stringID des doppelt importierten Umsatzes.
keepId?stringID des bleibenden Umsatzes.
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/497f6eca-6276-4993-bfeb-53cbbbba6f08/mark-duplicate" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{"keepId":"2a7c99a2-2dd1-4c38-9619-e5a0aaff4745","planHash":"string"}'{ "id": "78c4ff15-f2a0-4eae-945d-73a969adab4b", "keepId": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033"}Doppelt importierten Umsatz prüfen GET
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`.
Merker für fehlenden Beleg entfernen DELETE
Entfernt den Merker des Umsatzes, auch wenn der Umsatz inzwischen zugeordnet ist oder nicht mehr in der Liste steht. Ohne Merker bleibt alles unverändert. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.