Documentation

Detection de doublons

Comparez une facture enregistree avec l'historique recent via un scoring deterministe.


POST/v1/intelligence/duplicate-checkPro

La detection de doublons est disponible sur Pro et Business. L'endpoint accepte un invoice_id issu d'une extraction precedente et compare cette facture aux factures recentes du meme workspace.

Fonctionnement

Le detecteur evalue les paires candidates dans cet ordre:

ScoreSignal
1.0Numero de facture normalise identique
0.95Meme fournisseur normalise, montant exact et meme date d'emission
0.85Meme fournisseur normalise, montant dans une tolerance de 2% et date dans les 3 jours
0.60Meme fournisseur normalise, montant dans une tolerance de 5% et date dans les 14 jours
0.0Aucun signal de doublon

Un score de 0.85 ou plus est traite en interne comme doublon probable.

Requete

{
  "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"}'

Reponse

{
  "score": 0.95,
  "reason": "likely_duplicate",
  "matching_invoice_ids": ["0b017f0d-e9d5-4bb3-a7d0-1f3df6ea9c10"]
}
ChampTypeDescription
scorenumberMeilleur score de doublon de 0.0 a 1.0
reasonstringno_match, possible_duplicate ou likely_duplicate
matching_invoice_idsUUID string[]Factures candidates avec le meilleur score

Révision et export DATEV

La détection est purement indicative, mais elle a une conséquence ferme. Une facture dont le risque de doublon atteint 0.85 bloque l'export CSV DATEV pour toute la période tant qu'une personne n'a pas tranché, et l'export est refusé avec 409 datev_export_blocked en nommant les factures qui font obstacle.

Enregistrer cette décision — cette facture en double une autre, ou non, ou la conserver sans jamais la comptabiliser — relève de la révision des doublons. C'est la seule chose qui lève le blocage.

Lancez la verification de doublon apres extraction et avant d'ecrire les donnees dans votre comptabilite ou workflow d'approbation.