Kein Doppelbeleg
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/api/document/{id}/not-duplicateKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
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.
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.
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 <= 128Der andere Beleg des Paars
application/json- body
Der andere Beleg des Paars.
otherId?stringID des anderen Belegs, meist possibleDuplicateOfId.
uuidErfolg.
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" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "documentId": "e1331e65-c539-4c84-9271-66cc20f52910", "otherId": "3432135f-5b01-4288-9764-e1ff7d061777"}Umrechnung zum Monatskurs prüfen GET
Sagt für einen Beleg in Fremdwährung mit „Euro-Betrag fehlt“, ob `euroAtMonthlyRate` in `PATCH /api/document/{id}` ihn jetzt zum Monatskurs des BMF umrechnen kann, und ändert nichts. `ready` nennt die Kurse je Monat und die Euro-Summe danach. `waiting` heißt, der Kurs gilt ab `availableFrom`: Das BMF gibt ihn am ersten Arbeitstag des Folgemonats bekannt. `late`: Der Kurs ist überfällig. `noRate`: Für die Währung gibt es keinen Monatskurs, dann den Euro-Betrag mit `euroTotalAmount` eintragen. `notEligible` mit `reason`, etwa `settledPayment` (die Zuordnung hat schon Skonto, Mahnkosten oder eine Kursdifferenz gebucht). Ist eine Bankzahlung ohne solchen Ausgleich zugeordnet, rechnet `euroAtMonthlyRate` trotzdem um; den Rest zur Zahlung bucht danach `POST /api/match/{id}/exchange-difference` als Kursdifferenz. `askEuroTax`: Bei deutscher Umsatzsteuer auf einem Eingangsbeleg erst fragen, ob er die Steuer in Euro ausweist; wenn ja, `euroTaxAmounts` statt `euroAtMonthlyRate`. `exported` heißt, die Buchungen sind schon an DATEV gegangen; beim Umrechnen storniert bimetrics dann wie in der App und bucht neu, als Nachtrag (`addendaMonths`; ein API-Schlüssel braucht dafür `documents:correct`). Benötigt einen Schlüssel mit der Berechtigung `read`.
Doppelbeleg-Hinweis zurückholen DELETE
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`.