2,20 € + TVA
Obtenez le nom, la résidence, le siège social, le code et la description ATECO, le numéro de téléphone et les événements négatifs d'un travailleur indépendant en utilisant uniquement le numéro de TVA.
Le service Vérification Freelances fait partie de l'API RISK et permet d'obtenir, à partir du paramètre code fiscal, une série d'informations utiles pour l'identification de la résidence, du domicile fiscal et du numéro de téléphone, 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 Freelances (Tous) permet, avec une seule demande, d'obtenir la dénomination, le siège légal, le code et la description ATECO, les négativités et le numéro de téléphone.
POST/richiesta
La méthode à utiliser pour la demande est POST :
POST https://risk.openapi.com/IT-richiesta
Les paramètres à passer dans le corps de l'appel sont :
Ceci est un exemple des paramètres à utiliser pour une demande avec le code 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 également possible de demander seulement une partie des informations. Dans ce cas, il sera possible d'indiquer dans le champ type le dataset d'informations souhaité (anagrafica, negativita ou telefoni) ou d'utiliser directement les endpoints spécifiques pour chaque dataset lors de la demande.
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. En cas de configuration du callback, 'headers' est un champ obligatoire et peut être utilisé pour déclarer tous les headers que l'utilisateur souhaite voir dans le callback (comme par exemple session_id).
POST/richiesta
Dans la réponse, l'id de la demande sera disponible, à utiliser dans une seconde demande 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
}
GET/IT-richiesta/{id}
Pour obtenir les données, il sera nécessaire d'effectuer une seconde demande, comme mentionné précédemment, à 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 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": "RSSCLD79R07H501O ",
"tipo": [
"anagrafica"
],
"callback":"false",
"esito":{
"codice":200,
"info":"OK"
}
"timestamp": 1625232029,
"owner": "impresa@openapi.it",
"soggetto": {
"code": "RSSCLD79R07H501O ",
"risultato": "OK",
"nome": Claudio,
"cognome": Rossi,
"deceduto": false,
"decesso_data": null,
"nascita_luogo": ROMA,
"data_luogo": 1970-10-01,
"sesso": M,
"residenza": {
"indirizzo": "VIA OSTIENSE 11",
"toponimo": "VIA,
"via": "OSTIENSE",
"numero_civico": "11",
"comune": "ROMA",
"cap": "00127",
"provincia": "RM"
},
"domicilio_fiscale": {
"indirizzo": "VIA OSTIENSE 11",
"toponimo": "VIA,
"via": "OSTIENSE",
"numero_civico": "11",
"comune": "ROMA",
"cap": "00127",
"provincia": "RM"
},
"denominazione": "ROSSI CALUDIO",
"partita_iva": "12485671007",
"ateco_codice": "461901",
"ateco_descrizione": "Agenti e rappresentanti di vari prodotti senza prevalenza di alcuno"
"sede_legale": {
"indirizzo": "VIALE F TOMMASO MARINETTI 221",
"toponimo": "VIALE",
"via": "F TOMMASO MARINETTI",
"numero_civico": "221",
"comune": "ROMA",
"cap": "00143",
"provincia": "RM"
}
"utenze":[
"061234567"
],
"negativita": {
"protesti": false,
"pregiudizievoli": false,
"procedure": false
}
}
},
"success": true,
"message": "",
"error": null
}
CONDITIONS ET MODALITÉS D'UTILISATION DU SERVICE
Le service, bien qu'il soit disponible en mode automatique via l'API, pour des raisons de réglementation, est soumis à une surveillance continue des LOGS avec les limitations suivantes :
- le service est actif de 9h à 19h
- le service est actif uniquement les jours ouvrables
- le taux limite est configuré automatiquement pour chaque client en fonction des volumes annuels achetés
Les demandes effectuées en dehors des heures ou jours ouvrables sont mises en attente et traitées en mode prioritaire le premier jour ouvrable.
Le service, conformément aux conditions contractuelles, a des limitations de taux journalier fixées pour une gestion correcte du service.
Si vous souhaitez 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!
Grâce à un contrôle rapide, il permet d’évaluer la fiabilité financière du professionnel. Cet outil est utile pour les entreprises, les institutions financières et les partenaires commerciaux qui doivent vérifier rapidement la stabilité économique des travailleurs indépendants avant de commencer des collaborations.
Avec le service Vérification Freelances, vous pouvez obtenir les informations suivantes :
Il est possible d'obtenir des données dans des formats structurés comme JSON ou XML, qui sont particulièrement utiles pour l'intégration automatique dans les systèmes informatiques ou pour le traitement des données par des logiciels spécifiques.
Le Vérification Freelances est conçu pour diverses catégories d'utilisateurs qui doivent évaluer le risque et la stabilité financière des professionnels indépendants, notamment :
Les informations sont fournies via API en 2 heures. Ce délai garantit une disponibilité rapide des données demandées, permettant aux utilisateurs d'intégrer efficacement les informations dans leurs systèmes.
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 Vérification Freelances pour chaque demande individuelle via recharge est de 2,20 € + TVA.