bimetricsEntwickler
Umsätze

Umsatz als Dublette kennzeichnen

Als Markdown ansehen

Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/banktransaction/{id}/mark-duplicate

Kein 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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des doppelt importierten Umsatzes.

Formatuuid

Header-Parameter

Idempotency-Key*string

Stabiler 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.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

Bestätigter Plan

application/json
  1. body

Bestätigung der Vorschau.

keepId*string

ID des bleibenden Umsatzes.

Formatuuid
planHash*string

Hash aus der bestätigten Vorschau.

Antworten

Erfolg.

application/json
  1. response

Die gespeicherte Kennzeichnung.

id?string

ID des doppelt importierten Umsatzes.

keepId?string

ID des bleibenden Umsatzes.

Beispielanfrage
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"}'
Beispielantwort
{  "id": "78c4ff15-f2a0-4eae-945d-73a969adab4b",  "keepId": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033"}