bimetricsEntwickler
Umsätze

Doppelt importierten Umsatz prüfen

Als Markdown ansehen

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

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
get/api/banktransaction/{id}/duplicate-preview

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

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

Query-Parameter

keepId*string

ID des bleibenden Umsatzes.

Antworten

Erfolg.

application/json
  1. response

Die Folgen der Kennzeichnung.

alreadyMarked?boolean

Der Umsatz ist bereits als Dublette dieses Originals gekennzeichnet.

duplicate?

Dieser Umsatz wird gekennzeichnet.

finalizedBookings?integer

Anzahl bestehender festgeschriebener Buchungen der Dublette.

keep?

Dieser Umsatz bleibt.

newReversals?integer

Anzahl neuer Stornos.

openBookings?integer

Anzahl entfallender offener Buchungen.

planHash?string

SHA-256 des Plans in der gezeigten Richtung.

Beispielanfrage
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"
Beispielantwort
{  "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"}