bimetricsEntwickler
Belege

Doppelbeleg-Hinweis zurückholen

Als Markdown ansehen

Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
delete/api/document/{id}/not-duplicate/{otherId}

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

Nimmt „Kein Doppelbeleg“ für das Paar zurück, wie das Rückgängig in der App: Der Hinweis erscheint wieder, wenn die Belege noch passen. Es wird nichts gebucht. Eine Wiederholung mit demselben Idempotency-Key ändert nichts; hat niemand für das Paar „Kein Doppelbeleg“ gewählt, antwortet die Route sonst mit 404.

Benötigt einen Schlüssel mit der Berechtigung documents: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 Belegs mit dem Hinweis.

Formatuuid
otherId*string

ID des anderen Belegs, meist possibleDuplicateOfId.

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

Antworten

Erfolg.

application/json
  1. response

Das Paar.

documentId?string

ID des Belegs mit dem Hinweis.

Formatuuid
otherId?string

ID des anderen Belegs, meist possibleDuplicateOfId.

Formatuuid
replayed?boolean

true, wenn eine Wiederholung mit demselben Idempotency-Key nichts mehr geändert hat.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/document/497f6eca-6276-4993-bfeb-53cbbbba6f08/not-duplicate/string" -X DELETE \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001"
Beispielantwort
{  "documentId": "e1331e65-c539-4c84-9271-66cc20f52910",  "otherId": "3432135f-5b01-4288-9764-e1ff7d061777"}