Risk Impresa
0,70 € + IVA
Tutte le informazioni per l'individuazione di un'Impresa come denominazione, sede legale, dati ATECO, telefono ed eventi negativi di un'azienda.
Il servizio Risk Impresa appartiene all'API RISK e consente di ottenere, dal parametro codice fiscale, una serie di informazioni utili ai fini dell'individuazione della residenza, del domicilio fiscale e dell'utenza telefonica e alla verifica di eventuali eventi negativi di un professionista.
Il servizio è identificato dall'endpoint https://risk.openapi.com/IT-richiesta.
Risk Impresa consente con un'unica richiesta di ottenere la denominazione, la sede legale, codice e descrizione ATECO, le negatività e il numero telefono.
ESEMPIO RICHIESTA
POST/richiesta
Il metodo da utilizzare nella richiesta è POST:
POST https://risk.openapi.com/IT-richiesta
I parametri da passare nel body della chiamata sono:
- codice fiscale
- callback (opzionale)
Questo è un esempio dei parametri da utilizzare per una richiesta con codice fiscale RSSMRA90D15L117D:
{
"cf_piva": "RSSCLD79R07H501O",
"tipo": [
"anagrafica", "negativita","telefoni"
]
"callback": {
"url": "https://yourdomain.com/your_script",
"method": "POST",
"field": "data",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}
}
È possibile richiedere anche solo una parte delle informazioni. In questo caso sarà possibile indicare nel campo tipo il dataset di informazioni desiderato (anagrafica, negatività o telefoni) oppure utilizzare in fase di richiesta direttamente gli endpoint specifici per ogni dataset.
La risposta è asincrona ed è possibile impostare, in fase di richiesta, anche una callback per essere aggiornati su quando i dati saranno disponibili, senza dover chiamare più volte l'endpoint GET/richiesta/{id} per verificarne lo stato. In caso venga impostata la callback, 'headers' è un campo obbligatorio e può essere utilizzato per dichiarare tutti gli headers che l'utente vorrebbe venissero indicati nella callback (come ad esempio session_id).
ESEMPIO RISPOSTA
POST/richiesta
Nella risposta sarà disponibile l'id della richiesta, da utilizzare in una seconda chiamata per avere accesso ai dati desiderati:
{
"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
}ESEMPIO RICHIESTA
GET/IT-richiesta/{id}
Per ottenere i dati sarà necessario effettuare una seconda richiesta, come anticipato, ad un altro endpoint con l'ID precedentemente ottenuto:
POST https://risk.openapi.com/IT-richiesta/60e866b6b3178c6dc80adf8e
ESEMPIO RISPOSTA
GET/IT-richiesta/{id}
Nella risposta sarà possibile accedere alle seguenti informazioni:
- Nome e Cognome
- Denominazione
- Partita IVA
- Codice fiscale
- Data e luogo di nascita
- Indirizzo residenza
- Indirizzo domicilio fiscale
- Indirizzo sede legale
- Codice e Descrizione ATECO
- Data e Luogo di nascita
- Sesso
- Numero telefono (fisso o mobile)
- Presenza di eventi negativi (protesti, pregiudizievoli, procedure concorsuali)
{
"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
}
CONDIZIONI E MODALITA' DI UTILIZZO DEL SERVIZIO
Il servizio, nonostante sia disponibile in modalità automatica tramite API, per motivi di normativa è sottoposto a monitoraggio continuo dei LOG con le seguenti limitazioni:
- il servizio è attivo dalle 9 alle 19
- il servizio è attivo solo nei giorni feriali
- il rate limit è configurato in automatico per singolo cliente in funzione dei volumi annui acquistati
Le richieste effettuate in altri orari o giorni vanno in coda e sono lavorate in modalità prioritaria il primo giorno lavorativo.
Il servizio come da condizioni contrattuali ha vincoli di rate limit giornalieri impostati per una corretta gestione del servizio.
Se desideri avere un servizio personalizzato contattaci qui.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
Il servizio Risk Impresa fornisce informazioni in tempo reale sul livello di rischio di un'azienda, analizzando vari fattori come la solvibilità, eventuali protesti, pregiudizievoli e altre segnalazioni negative. Questo report consente di valutare l'affidabilità e la stabilità finanziaria di un'impresa, supportando decisioni strategiche per investitori, partner commerciali e istituti di credito. Il servizio Risk Impresa è disponibile anche per ricerche su Persone e sui Liberi Professionisti.
Il servizio Risk Impresa fornisce una serie di dati fondamentali per valutare il rischio di un'azienda, tra cui:
- Denominazione
- Partita IVA
- Indirizzo sede legale
- Indirizzo domicilio fiscale
- Codice e descrizione ateco
- Numero telefono (fisso o mobile)
- Presenza di eventi negativi (protesti, pregiudizievoli, procedure concorsuali)
Le informazioni sono disponibili in diversi formati, a seconda delle esigenze dell'utente. È possibile ottenere i dati in formato PDF, ideale per una visualizzazione immediata e semplice, oppure in formati strutturati come JSON o XML, che sono particolarmente utili per l'integrazione automatica nei sistemi informatici o per l'elaborazione di dati tramite software specifici.
Il servizio Risk Impresa è pensato per diverse figure professionali e aziende che necessitano di valutare il rischio associato a partner o clienti, tra cui:
- Aziende che vogliono valutare i rischi associati a partner o clienti.
- Istituti finanziari per verificare l'affidabilità creditizia di imprese.
- Investitori che necessitano di informazioni dettagliate sui rischi finanziari prima di prendere decisioni.
- Consulenti legali e fiscali per valutare il rischio di insolvenza o di problematiche finanziarie.
- Fornitori che desiderano verificare la stabilità finanziaria di potenziali clienti o partner.
Le informazioni sono fornite tramite API in tempo reale, garantendo un accesso immediato ai dati richiesti.
Le richieste vengono elaborate esclusivamente nei giorni feriali, dalle 9:00 alle 19:00. Quelle inviate al di fuori di questo orario o durante i giorni festivi saranno messe in coda e trattate con priorità il primo giorno lavorativo successivo.
Il costo del servizio Risk Impresa per ogni singola richiesta tramite ricarica è di 0,70 € +iva.
