0,70 € + TVA
Obtenez le numéro de téléphone, fixe ou mobile, d'une entreprise italienne à partir du paramètre code fiscal, le tout via l'API.
Le service Numéro 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.
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.
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
}
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
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 :
- le service est actif de 9h à 19h
- le service est actif uniquement les jours ouvrables
- la limite de taux est configurée automatiquement pour chaque client en fonction des volumes annuels achetés
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.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
Le Numéro Téléphone Entreprise est une API qui offre un accès immédiat aux numéros de téléphone des entreprises, qu'ils soient fixes ou mobiles. Il permet de récupérer des informations à jour et fiables, facilitant ainsi les communications commerciales. Ce service est particulièrement utile pour les professionnels et les opérateurs de marketing qui ont besoin de contacter rapidement des entreprises à des fins promotionnelles ou administratives. Grâce à sa simple intégration, il soutient une gestion efficace des communications d'entreprise.
Le service de numérotation est fourni par un opérateur autorisé TULPS, qui obtient les coordonnées via des centres d'appels et la consultation de répertoires publics, ainsi que des contacts fournis par les clients avec l'autorisation d'usage externe.
Veuillez noter que ce service ne peut être demandé qu’en présence d’un droit juridiquement pertinent, c’est-à-dire qu’il doit exister une base légale justifiant l’accès aux informations demandées et établissant un lien entre l'intérêt du demandeur et la documentation recherchée.
Le service peut, par nature, ne donner aucun résultat (par exemple, si aucune donnée n'est disponible dans les bases de données publiques ou d’accès public). Même en l'absence de résultats, des frais de service sont appliqués.
Lors de la soumission de la demande, le client déclare avoir un droit juridiquement pertinent (par exemple, à des fins de recouvrement de créances). En cas de fausse déclaration, il est à noter que la demande sera signalée trimestriellement à la Préfecture, avec les conséquences légales prévues pour les fausses déclarations.
Entreprises italiennes, travailleurs indépendants et particuliers.
Le service "Telefono Impresa" est conçu pour diverses catégories de professionnels, notamment :
Ce service est particulièrement utile pour ceux qui ont besoin de numéros de téléphone à jour à des fins commerciales, promotionnelles ou administratives, facilitant ainsi les communications avec les clients et les partenaires commerciaux.
Le service est traité dans un délai de 2 heures ouvrables à partir de la demande.
Les demandes sont traitées exclusivement les jours ouvrables, de 9h00 à 19h00. Celles envoyées en dehors de ces horaires ou pendant les jours fériés seront mises en file d'attente et traitées en priorité le premier jour ouvrable suivant.
Le coût du Numéro Téléphone Entreprise pour chaque demande individuelle via recharge est de 0,70 € + TVA.