Informations Négatives pour Professionnels Indépendants

Les négativités font généralement référence à 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 :

Le service Négativité Libéraux est intégré à l'API RISK et permet de vérifier, en utilisant le paramètre code fiscal, la présence de négativités à l'encontre d'un Professionnel.

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

EXEMPLE DE DEMANDE

POST/negativita

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

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

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

Ceci est un exemple des paramètres requis pour une demande avec le code fiscal RSSMRA90D15L117D :

{
      "cf_piva": "DRSCLD70P15H501V",  
      "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 un callback lors de la demande pour être informé lorsque les données seront disponibles, sans avoir à appeler plusieurs fois l'endpoint GET/demande/{id} pour vérifier son état. Si un callback est configuré, les headers est un champ obligatoire et peut être utilisé pour déclarer tous les headers que l'utilisateur souhaite voir retournés dans le callback (par exemple, session_id).

EXEMPLE DE RÉPONSE

POST/negativite

La réponse fournira l'ID de la demande à utiliser dans un deuxième appel pour obtenir les données souhaitées.

{
        "data": {
          "cf_piva": "DRSCLD70P15H501V",
          "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 mentionné précédemment, à un autre endpoint en utilisant l'ID précédemment obtenu.

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

EXEMPLE DE RÉPONSE

GET/IT-demande/{id}

La réponse indiquera 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": "DRSCLD70P15H501V",
          "tipo": [
            "negativita"
          ],
          "callback": true
          "esito": {
            "codice": 200,
            "info": "OK"
          },
          
          "timestamp": 1625232029,
          "owner": "test@openapi.it",
          "soggetto": {
            "code": "DRSCLD70P15H501V",
            "negativita": {
              "protesti": true,
              "procedure": false,
              "pregiudizievoli":  false
            },
          }  
        },
        "success": true,
        "message": "",
        "error": null
      }
      

Le service Risk Negatività est également disponible pour des recherches sur les Particuliers et les Entreprises.

En plus de la vérification de la présence, il est possible d'obtenir les détails complets des négativités via les verrières de protestations, les préjudices et les procédures collectives qui peuvent être demandées avec l'API Visengine. Ces documents sont disponibles en formats PDF, JSON et XML.

CONDITIONS ET MODALITÉS D'UTILISATION DU SERVICE

Bien que le service soit disponible automatiquement via API, il est soumis à une surveillance continue des LOG pour des raisons réglementaires avec les limitations suivantes :

Les demandes effectuées en dehors de ces horaires ou jours sont mises en file d'attente et traitées en priorité le premier jour ouvrable suivant.

Le service, conformément aux conditions contractuelles, a des limites de taux quotidiennes fixées pour une gestion correcte du service.

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