Detection de doublons
Comparez une facture enregistree avec l'historique recent via un scoring deterministe.
/v1/intelligence/duplicate-checkProLa 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:
| Score | Signal |
|---|---|
1.0 | Numero de facture normalise identique |
0.95 | Meme fournisseur normalise, montant exact et meme date d'emission |
0.85 | Meme fournisseur normalise, montant dans une tolerance de 2% et date dans les 3 jours |
0.60 | Meme fournisseur normalise, montant dans une tolerance de 5% et date dans les 14 jours |
0.0 | Aucun 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"]
}
| Champ | Type | Description |
|---|---|---|
score | number | Meilleur score de doublon de 0.0 a 1.0 |
reason | string | no_match, possible_duplicate ou likely_duplicate |
matching_invoice_ids | UUID 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.