Doppelbeleg-Hinweis zurückholen
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Belegs mit dem Hinweis.
uuidotherId*stringID des anderen Belegs, meist possibleDuplicateOfId.
Idempotency-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 <= 128Erfolg.
application/json- response
Das Paar.
documentId?stringID des Belegs mit dem Hinweis.
uuidotherId?stringID des anderen Belegs, meist possibleDuplicateOfId.
uuidreplayed?booleantrue, wenn eine Wiederholung mit demselben Idempotency-Key nichts mehr geändert hat.
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"{ "documentId": "e1331e65-c539-4c84-9271-66cc20f52910", "otherId": "3432135f-5b01-4288-9764-e1ff7d061777"}Kein Doppelbeleg POST
Beendet den schwachen Hinweis „Möglicher Doppelbeleg“ (`possibleDuplicateKind` `same_amount`) zwischen den beiden Belegen, wie „Kein Doppelbeleg“ in der App: für alle in der Firma und in beide Richtungen. Ein Hinweis mit `same_content` bleibt. Es wird nichts gebucht oder gelöscht; das GoBD-Protokoll hält fest, wer es wann getan hat. `restorePossibleDuplicate` holt den Hinweis zurück. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.
Beleg erneut lesen POST
Startet die Erkennung eines Belegs neu, dessen Lesen fehlgeschlagen ist (`ocrStatus` `failed`), wie „Erneut lesen“ in der App. Der Beleg wartet danach sofort wieder (`ocrStatus` `pending`), die Antwort ist der Beleg in diesem Stand. Die Datei bleibt dieselbe, du lädst nichts neu hoch. Das erneute Lesen zählt im Tarif als weiterer Beleg ins Kontingent. Ist der Beleg schon gelesen, wartet er oder wird er gerade gelesen, antwortet die Route mit `409 DocumentReadingNotFailed`, auch beim zweiten Aufruf. Einen von Hand erfassten Beleg lehnt sie mit `409 DocumentReadingManual` ab, einen mit festgeschriebenen Buchungen mit `409 DocumentReadingFinalized` und eine in bimetrics ausgestellte Rechnung mit `409 DocumentReadingIssued`. Idempotency-Key bei Wiederholung unverändert senden. Benötigt einen Schlüssel mit der Berechtigung `upload`.