Téléphone Entreprise

Le service Téléphone Entreprise fait partie de l'API RISK et permet d'obtenir, à partir du paramètre numéro fiscal, le numéro de téléphone d'une entreprise.

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

EXEMPLE DE DEMANDE

POST/telefoni

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

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

Les paramètres à passer dans le corps de la requête sont :

Voici un exemple des paramètres nécessaires pour une demande avec le numéro fiscal 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 définir, 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.

EXEMPLE DE RÉPONSE

POST/telefoni

Voici un exemple de réponse en pending (c'est-à-dire en attente du résultat) où il sera possible d'obtenir l'ID de la demande à utiliser dans un deuxième appel pour accéder aux données souhaitées.

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "12485671007",
      "tipo": [
        "telefoni"
      ],
      "callback": false,
      "url" false,
      "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 de faire une deuxième demande, comme mentionné, à 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 au numéro de téléphone, fixe ou mobile selon la disponibilité.

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2023-07-09 17:09:42",
      "date_completion": "2023-07-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "12485671007",
      "tipo": [
        "061234567"
      ],
      "callback": null,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
     
      "timestamp": 1625232029,
      "owner": "imprese@openapi.it",
      "soggetto": {
        "code": "12485671007"
        "utenze": ["3331234567"]
          ]
        },        
    "success": true,
    "message": "",
    "error": null
  }
  

Le service Téléphone Entreprise est également disponible pour des recherches sur Particuliers et sur Travailleurs Indépendants.

MODALITÉS ET CONDITIONS D'UTILISATION DU SERVICE

Il est rappelé que ce service ne peut être demandé que sur la base d'un droit juridiquement pertinent (toute position subjective qui configure une relation d'utilité entre cet intérêt et la documentation demandée).

Par nature, le service peut également donner une réponse nulle (ex. aucun renseignement dans les bases de données publiques ou accessibles au public), et même dans ce cas, le service entraîne un coût. Le client, au moment de la demande, déclare avoir un droit pertinent (ex. recouvrement de créances). En cas de fausse déclaration, il est rappelé que la demande est communiquée trimestriellement aux bureaux de la Préfecture avec les conséquences correspondantes pour les fausses déclarations.

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

Les demandes effectuées à d'autres horaires ou jours sont mises en attente et sont traitées en mode prioritaire le premier jour ouvrable.

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

Si vous souhaitez bénéficier d'un service personnalisé contactez-nous ici.