bimetricsEntwickler
Belege

Kein Doppelbeleg

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.
post/api/document/{id}/not-duplicate

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

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

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

Der andere Beleg des Paars

application/json
  1. body

Der andere Beleg des Paars.

otherId?string

ID des anderen Belegs, meist possibleDuplicateOfId.

Formatuuid

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" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "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`.