Négativité Entreprise

Le service Négativité Entreprise appartient à l'API RISK et permet, à partir du paramètre numéro de TVA, de vérifier la présence de négativité à l'encontre d'une entreprise.

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

EXEMPLE DE DEMANDE

POST/negativita

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

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

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

Voici un exemple des paramètres nécessaires pour une demande avec le numéro de TVA 12485671007 :

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

La réponse est asynchrone. Il est possible de configurer, lors de la demande, 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. En cas de configuration du callback, les headers sont un champ obligatoire et peuvent être utilisés pour déclarer tous les headers que l'utilisateur souhaite voir retournés dans le callback (comme par exemple session_id)

EXEMPLE DE RÉPONSE

POST/negativita

Dans la réponse sera disponible l'id de la demande à utiliser dans un second appel pour obtenir les données souhaitées

{
    "data": {
      "cf_piva": "12485671007",
      "tipo": [
        "negativita"
      ],
      "callback": true,
      "url" https://yourdomain.com/your_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 /IT-richiesta/{id}

Pour obtenir les données, il sera nécessaire de faire une seconde demande, comme indiqué, à 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 de savoir si les événements négatifs suivants sont présents :

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2024-04-09 17:09:42",
      "date_completion": "2024-04-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "12485671007",
      "tipo": [
        "negativités"
      ],
      "callback": true,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
     
      "timestamp": 1625232029,
      "owner": "test@openapi.it",
      "soggetto": {
        "code": "12485671007",
        "negativita": {
          "protestations": true,
          "procédures": false,
          "privilèges":  false
        },
      }  
    },
    "success": true,
    "message": "",
    "error": null
  }
  

Le service Risk Negativités est également disponible pour les recherches sur Particuliers et sur Professionnels.

En plus de vérifier la présence, il est possible d'obtenir les détails complets des négativités via les visures de protestations, privilèges et procédures collectives disponibles via l'API Visengine. Ces documents sont disponibles en format PDF, JSON et XML.

CONDITIONS ET MODALITÉS D'UTILISATION DU SERVICE

Le service, bien qu'il soit disponible en mode automatique via API, est soumis à une surveillance continue des LOG pour des raisons réglementaires, avec les limitations suivantes :

Les demandes effectuées en dehors des heures ou jours indiqués sont mises en attente et traitées en priorité le premier jour ouvré.

Le service, comme prévu dans les conditions contractuelles, a des limites de taux journaliers définies pour une gestion correcte du service.

Si vous souhaitez un service personnalisé contactez-nous ici.