Vérification Entreprise - Italie

Le service Vérification Entreprise fait partie de l'API RISK et permet d'obtenir, à partir du paramètre numéro fiscal, une série d'informations utiles pour l'identification de la résidence, du domicile fiscal et de l'utilisateur téléphonique, ainsi que pour la vérification des éventuels événements négatifs d'un professionnel.

Le service est identifié par l'endpoint https://risk.openapi.com/IT-richiesta.

Vérification Entreprise permet avec une seule requête d'obtenir la dénomination, le siège social, le code et la description ATECO, les négativités et le numéro de téléphone.

EXEMPLE DE DEMANDE

POST/richiesta

La méthode à utiliser dans la requête est POST :

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

Les paramètres à passer dans le corps de l'appel sont :

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

{
  "cf_piva": "RSSCLD79R07H501O",  
  "tipo": [
    "anagrafica",  "negativita","telefoni"
    ]
  "callback": {
    "url": "https://yourdomain.com/your_script",
    "method": "POST",
    "field": "data",    
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }
}

Il est possible de demander également seulement une partie des informations. Dans ce cas, il sera possible d'indiquer dans le champ type le jeu de données d'informations souhaité (anagrafica, negatività ou téléphones) ou d'utiliser directement lors de la demande les endpoints spécifiques pour chaque jeu de données.

La réponse est asynchrone et il est possible de configurer, lors de la demande, également un callback pour être informé lorsque les données seront disponibles, sans avoir à appeler plusieurs fois l'endpoint GET/richiesta/{id} pour vérifier son état. Si le callback est configuré, 'headers' est un champ obligatoire et peut être utilisé pour déclarer tous les headers que l'utilisateur souhaiterait voir indiqués dans le callback (comme par exemple session_id).

EXEMPLE DE RÉPONSE

POST/richiesta

Dans la réponse, l'id de la demande sera disponible, à utiliser dans un second appel pour accéder aux données souhaitées :

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

EXEMPLE DE DEMANDE

GET/IT-richiesta/{id}

Pour obtenir les données, il sera nécessaire d'effectuer une seconde demande, comme indiqué précédemment, à un autre endpoint avec l'ID précédemment obtenu :

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

EXEMPLE DE RÉPONSE

GET/IT-richiesta/{id}

Dans la réponse, il sera possible d'accéder aux informations suivantes :

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2021-04-09 17:09:42",
      "date_completion": "2021-04-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D ",
      "tipo": [
        "anagrafica"
      ],
      "callback":"false",
      "esito":{
        "codice":200,
        "info":"OK"
      }
      "timestamp": 1625232029,
      "owner": "impresa@openapi.it"
      "soggetto": "null"
      "status": "PENDING",
      "date_request": "null",
      "date_completion": "null",
      },
    "success": true,
    "message": "",
    "error": null
  }

Le service Risk Professionnel Indépendant est également disponible pour des recherches sur Personnes et sur Entreprises.