Anomalieerkennung

Markiert Aenderungen bei Lieferanten- und Zahlungsmustern anhand deterministischer Workspace-Historie.

POST/v1/intelligence/anomaliesPro

Anomalieerkennung ist fuer Pro und Business verfuegbar. Sie prueft eine zuvor extrahierte Rechnung gegen die Lieferantenhistorie und gibt nachvollziehbare Flags zurueck.

Durchgefuehrte Pruefungen

Flag-Typ	Schwere	Regel
`first_time_vendor`	`info`	Kein bestehendes Lieferantenprofil fuer den normalisierten Namen
`iban_changed`	`critical`	Lieferanten-IBAN unterscheidet sich vom gespeicherten Profil
`currency_changed`	`warning`	Rechnungswaehrung unterscheidet sich von der historischen Waehrung
`amount_unusual`	`warning` oder `critical`	Betrag liegt ueber 1.5x oder 3x des Lieferantendurchschnitts
`terms_changed`	`warning`	Zahlungsziel in Tagen weicht vom historischen Median ab
`tax_rate_changed`	`warning`	Rechnung nutzt einen bisher nicht gesehenen Steuersatz
`missing_tax_id`	`warning`	Rechnung in einer steuer-ID-pflichtigen Locale hat keine Lieferanten-`tax_id`

Anfrage

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

Antwort

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

Feld	Typ	Beschreibung
`flags`	array	Gefundene Anomalie-Flags; leer, wenn keine Flags gefunden wurden
`flags[].type`	string	Maschinenlesbarer Flag-Typ
`flags[].severity`	string	`info`, `warning` oder `critical`
`flags[].message`	string	Lesbare Erklaerung

Behandeln Sie critical-Flags als zahlungsblockierend, bis sie manuell geprueft wurden.