Il servizio Risk Real Time Azienda appartiene all'API RISK e consente di ottenere, dal parametro codice fiscale, una serie di informazioni utili alla verifica dell'esistenza e  all'individuazione di un'azienda.

Il servizio è identificato dall'endpoint https://risk.openapi.com/IT-richiesta.

Risk Azienda consente con un'unica richiesta di ottenere la denominazione, codice e descrizione ATECO, la sede legale, negatività e 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 per una richiesta con codice fiscale 12485671007:

{
  "cf_piva": "12485671007",  
  "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à necessario 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 e può essere impostata, 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": "12485671007",
      "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": "[email protected]"
      "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:

• 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)

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2024-03-09 17:09:42",
      "date_completion": "2024-03-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "12485671007",
      "tipo": [
        "anagrafica",
        "negativita",
        "telefoni"
      ],
      "callback": null,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1717141431,
      "owner": "[email protected]",
      "soggetto": {
        "code": "12485671007",
        "risultato": "OK",
        "nome": null,
        "cognome": null,
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo": null,
        "nascita_data": null,
        "sesso": null,
        "residenza": null,
        "domicilio_fiscale":{
          "indirizzo": "VIALE F TOMMASO MARINETTI 221",
          "toponimo": "VIALE",
          "via": "F TOMMASO MARINETTI",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00143",
          "provincia": "RM"
        },
        "denominazione": OPENAPI SPA,
        "partita_iva": 12485671007,
        "ateco_codice": 620100,
        "ateco_descrizione": "Produzione di software non connesso all'edizione",
        "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",
          "061234568",
          "333123456"
        ],
        "negativita": {
          false,
          false,
          false
        }
      }
    },
    "success": true,
    "message": "",
    "error": null
  }
  

Il servizio Risk Real Time Azienda è disponibile anche per ricerche su Persone e su Liberi Professionisti.

CONDIZIONI E MODALITA' DI UTILIZZO DEL SERVIZIO

Il servizio, nonostante sua 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.