Documentation

Detection d'anomalies

Signale les changements de fournisseur et de paiement via des controles deterministes sur l'historique workspace.


POST/v1/intelligence/anomaliesPro

La detection d'anomalies est disponible sur Pro et Business. Elle compare une facture deja extraite a l'historique fournisseur et renvoie des flags auditables.

Controles effectues

Type de flagSeveriteRegle
first_time_vendorinfoAucun profil fournisseur existant pour le nom normalise
iban_changedcriticalL'IBAN fournisseur differe du profil stocke
currency_changedwarningLa devise de facture differe de la devise historique du fournisseur
amount_unusualwarning ou criticalLe montant depasse 1.5x ou 3x la moyenne fournisseur
terms_changedwarningLes jours de paiement different de la mediane historique
tax_rate_changedwarningLa facture utilise un taux fiscal jamais vu pour ce fournisseur
missing_tax_idwarningUne facture dans une locale exigeant un identifiant fiscal n'a pas de tax_id fournisseur

Requete

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

Reponse

{
  "flags": [
    {
      "type": "iban_changed",
      "severity": "critical",
      "message": "Vendor IBAN changed from DE893704... to DE125001..."
    },
    {
      "type": "amount_unusual",
      "severity": "warning",
      "message": "Amount 2500.00 exceeds 1.5x vendor average 1200.00"
    }
  ]
}
ChampTypeDescription
flagsarrayFlags detectes; tableau vide si rien n'est trouve
flags[].typestringType de flag lisible par machine
flags[].severitystringinfo, warning ou critical
flags[].messagestringExplication lisible

Traitez les flags critical comme bloquants pour le paiement jusqu'a revue humaine.