Duplikaterkennung

Pruefen Sie eine gespeicherte Rechnung gegen die aktuelle Rechnungshistorie mit deterministischem Scoring.

POST/v1/intelligence/duplicate-checkPro

Duplikaterkennung ist fuer Pro und Business verfuegbar. Der Endpunkt akzeptiert eine invoice_id aus einer vorherigen Extraktion und vergleicht diese Rechnung mit aktuellen Rechnungen desselben Workspaces.

Funktionsweise

Der Detektor bewertet Kandidatenpaare in dieser Reihenfolge:

Score	Signal
`1.0`	Normalisierte Rechnungsnummer stimmt exakt ueberein
`0.95`	Gleicher normalisierter Lieferant, exakter Betrag und gleiches Ausstellungsdatum
`0.85`	Gleicher normalisierter Lieferant, Betrag innerhalb von 2% und Datum innerhalb von 3 Tagen
`0.60`	Gleicher normalisierter Lieferant, Betrag innerhalb von 5% und Datum innerhalb von 14 Tagen
`0.0`	Kein Duplikatsignal

Ein Score ab 0.85 wird intern als wahrscheinliches Duplikat behandelt.

Anfrage

{
  "invoice_id": "2f7d7f8a-32fb-4a7c-a3b1-53b61b64252f"
}

curl -X POST https://api.parsurai.com/v1/intelligence/duplicate-check \
  -H "X-API-Key: $PARSURAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"invoice_id": "2f7d7f8a-32fb-4a7c-a3b1-53b61b64252f"}'

Antwort

{
  "score": 0.95,
  "reason": "likely_duplicate",
  "matching_invoice_ids": ["0b017f0d-e9d5-4bb3-a7d0-1f3df6ea9c10"]
}

Feld	Typ	Beschreibung
`score`	number	Hoechster Duplikat-Score von `0.0` bis `1.0`
`reason`	string	`no_match`, `possible_duplicate` oder `likely_duplicate`
`matching_invoice_ids`	UUID-String[]	Kandidatenrechnungen mit dem besten Score

Prüfung und DATEV-Export

Für sich genommen ist die Erkennung nur ein Hinweis, sie hat aber eine harte Folge. Eine Rechnung mit einem Duplikatrisiko von 0.85 oder höher blockiert den DATEV-CSV-Export für den gesamten Zeitraum, bis eine Person darüber entscheidet; der Export wird dann mit 409 datev_export_blocked abgelehnt und nennt die blockierenden Rechnungen.

Diese Entscheidung festzuhalten — diese Rechnung dupliziert eine andere, oder eben nicht, oder behalten, aber nie verbuchen — ist die Duplikatprüfung. Nur sie hebt die Blockade auf.

Fuehren Sie Duplikatpruefungen nach der Extraktion und vor der Uebergabe an Buchhaltung oder Freigabeprozesse aus.