Négativité Personne

Les négativités se réfèrent généralement à tous les événements ayant une valeur juridique/économique qui peuvent indiquer un risque ou un problème lié à une personne ou une entreprise.

Les événements négatifs sont généralement considérés comme étant :

Le service Négativité Personne fait partie de l'API RISK et permet, grâce au paramètre numéro fiscal, de vérifier la présence d'événements négatifs liés à une personne en quelques minutes.

Le service est identifié par l’endpoint https://risk.openapi.com/FR-negativite.

EXEMPLE DE DEMANDE

POST /negativite

La méthode à utiliser pour la demande est POST :

POST https://risk.openapi.com/FR-negativite

Les paramètres à transmettre dans le corps de la demande sont :

Voici un exemple des paramètres requis pour une demande avec le numéro fiscal RSSMRA90D15L117D :

{
  "cf_piva": "RSSMRA90D15L117D",  
  "callback": {
    "url": "https://votredomaine.com/votre_script",
    "field": "data",
    "method": "POST",
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }
}

La réponse est asynchrone. Il est possible de configurer un callback lors de la demande pour être notifié lorsque les données sont disponibles, sans avoir à appeler plusieurs fois l’endpoint GET /request/{id} pour vérifier son état. Si un callback est configuré, le champ 'headers' est obligatoire et peut être utilisé pour déclarer tous les headers que l’utilisateur souhaite voir mentionnés dans le callback (comme session_id).

EXEMPLE DE RÉPONSE

POST /negativite

La réponse comprendra l’ID de la demande à utiliser lors d'un appel ultérieur pour accéder aux données souhaitées :

{
    "data": {
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "negativite"
      ],
      "callback": true,
      "url": "https://votredomaine.com/votre_script",
      "field": "data",
      "method": "POST",
      "data": false,,
      "headers": {
        "session_id": "oiwejdf89453urf945jfg"
      },
      "esito": "null",
      "timestamp": "1717073284",,
      "owner": "test@openapi.com",,
      "id": "60e866b6b3178c6dc80adf8e",,
      "soggetto": "null",
      "status": "PENDING",,
      "date_request": "null",,
      "date_completion": "null",
    },
    "success": true,,
    "message": "",,
    "error": null
}

EXEMPLE DE DEMANDE

GET /FR-request/{id}

Pour obtenir les données, il sera nécessaire de faire une seconde demande à un autre endpoint avec l’ID précédemment obtenu.

POST https://risk.openapi.com/FR-request/60e866b6b3178c6dc80adf8e

EXEMPLE DE RÉPONSE

GET /FR-request/{id}

La réponse permettra de savoir si les événements négatifs suivants sont liés à une personne :

{
    "data": {
      "status": "COMPLETED",,
      "date_request": "2022-03-08T12:21:21Z",,
      "date_completion": "2022-03-08T12:21:51Z",,
      "cf_piva": "RSSMRA90D15L117D",,
      "soggetto": "Rossi Mario",
      "negativite": {
        "protestations": null,,
        "actes_pre": null,,
        "proc": null
      }
    }
}