Negatività Persona - Italia

Il servizio Negatività Persona consente, dal parametro codice fiscale, di verificare la presenza di negatività a carico di una persona in pochi minuti.

Le negatività si riferiscono generalmente a tutti quegli eventi con valore giuridico / economico che possono indicare un rischio o una criticità legata a una persona o a un'azienda.

Sono generalmente considerati come eventi negativi:

Il servizio appartiene all'API RISK e è identificato dall'endpoint https://risk.openapi.com/IT-negativita.

ESEMPIO RICHIESTA

POST /negativita

Il metodo da utilizzare nella richiesta è POST:

POST https://risk.openapi.com/IT-negativita

I parametri da passare nel body della chiamata sono:

Questo è un esempio dei parametri necessari per una richiesta con codice fiscale RSSMRA90D15L117D:

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

La risposta è asincrona. E' possibile impostare, in fase di richiesta, anche una callback per essere aggiornati su quando i dati saranno disponibili, senza dover chiamare più volte l'endpoint GET /richiesta/{id} per verificarne lo stato. In caso venga impostata la callback, 'headers' è un campo obbligatorio e può essere utilizzato per dichiarare tutti gli headers che l'utente vorrebbe venissero indicati nella callback (come ad esempio session_id).

ESEMPIO RISPOSTA

POST /negativita

Nella risposta sarà disponibile l'id della richiesta da utilizzare in una seconda chiamata per poter accedere ai dati desiderati:

{
    "data": {
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "negativita"
      ],
      "callback": true,
      "url" https://yourdomain.com/your_script,
      "field" data,
      "method" POST,
      "data": false,
      "headers": {
        "session_id": ""oiwejdf89453urf945jfg""
      }
      "status": "PENDING",      
      "esito": "null"
      "timestamp": "1717073284",
      "date_request": "null",
      "date_completion": "null",
      "owner": "[email protected]",
      "id": "60e866b6b3178c6dc80adf8e",
      "soggetto": "null",
      },
    "success": true,
    "message": "",
    "error": null
  }

ESEMPIO RICHIESTA

GET /IT-richiesta/{id}

Per ottenere i dati sarà necessario effettuare una seconda richiesta, come anticipato, ad un altro endpoint con l'ID precedentemente ottenuto.

POST https://risk.openapi.com/IT-richiesta/60e866b6b3178c6dc80adf8e 

ESEMPIO RISPOSTA

GET /IT-richiesta/{id}

Attrverso la risposta sarà possibile sapere se sono presenti a carico di una persona i seguenti eventi negativi:

{
    "data": {
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "negativita"
       ],
      "callback": true
      "status": "COMPLETED",
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      "timestamp": 1625232029,
      "date_request": "2024-04-09 17:09:42",
      "date_completion": "2024-04-09 17:40:57",
      "owner": "[email protected]",
      "id": "60e866b6b3178c6dc80adf8e",
      "soggetto": {
        "code": "RSSMRA90D15L117D",
        "negativita": {
          "protesti": true,
          "procedure": false,
          "pregiudizievoli":  false
          "coinvoltoInProcedura":  false
        },
      }  
    },
    "success": true,
    "message": "",
    "error": null
  }
  

Il servizio è ideale per le aziende che necessitano di ottenere in maniera rapida e affidabile informazioni sulle eventuali negatività di un soggetto privato in Italia. Alcune tipologie di aziende che hanno già integrato il servizio sono Banche, Istituti Finanziari, Agenzie di Recupero Crediti, Società di Assicurazioni.

Oltre alla verifica della presenza, è possibile ottenere i dettagli completi delle negatività tramite le visure protesti, pregiudizievoli e procedure concorsuali richiedibili con l'API Visengine. Questi documenti sono disponibili in formato pdf, JSON e XML