Il servizio Anagrafica Libero Professionista appartiene all'API RISK e consente, a partire dal parametro codice fiscale, di ottenere una serie di informazioni utili alla verifica, all'individuazione e accedere ad informazioni sull'attività di un Libero Professionista.

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

ESEMPIO RICHIESTA POST /anagrafica

Il metodo da utilizzare nella richiesta è POST:

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

I parametri da passare nel body della chiamata sono:

• codice fiscale
• callback (opzionale)

Questo è un esempio dei parametri necessari per una richiesta con codice fiscale RSSMRA90D15L117D:

{
  "cf_piva": "RSSMRA90D15L117D",  
  "callback": {
    "url": "https://yourdomain.com/your_script",
    "field": "data",
    "method": "POST",
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }
}

La risposta è asincrona. È 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 vuole vengano ritornati nella callback (come ad esempio session_id)

ESEMPIO RISPOSTA POST /anagrafica

Nella risposta sarà disponibile l'id della richiesta da utilizzare in una seconda chiamata per ottenere i dati desiderati

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "DRSCLD70P15H501V",
      "tipo": [
        "anagrafica"
      ],
      "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:

• Nome e cognome
• Data di nascita
• Luogo di nascita
• Sesso
• Residenza
• Sede Legale
• Eventuale data di morte
• Denominazione
• Partita IVA
• Codice ATECO
• Descrizione ATECO

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2021-07-09 17:09:42",
      "date_completion": "2021-07-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "DRSCLD70P15H501V",
      "tipo": [
        "anagrafica"
      ],
      "callback": false,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1625232029,
      "owner": "[email protected]",
      "soggetto": {
        "code": "12485671007",
        "code_conferma": "DRSCLD70P15H501V",
        "risultato": "OK",
        "nome": "Claudio",
        "cognome": "De Rossi",
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo":  "ROMA (RM)",
        "nascita_data": "1970-10-15",
        "sesso": "M",
        "residenza": {
          "indirizzo": "VIALE XXI APRILE 221",
          "toponimo": "VIALE",
          "via": "XXI APRILE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00161",
          "provincia": "RM"
        },
        "domicilio fiscale": {
          "indirizzo": "VIALE XXI APRILE 221",
          "toponimo": "VIALE",
          "via": "XXI APRILE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00161",
          "provincia": "RM"
        },
        "denominazione": De Rossi Claudio,
        "partita_iva": 12485671007,
        "ateco_codice": 620100,
        "ateco_descrizione": "Attività degli studi legali",
        "sede_legale": {
          "indirizzo": "VIALE XXI APRILE 221",
          "toponimo": "VIALE",
          "via": "XXI APRILE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00161",
          "provincia": "RM"
        }
      }
    },
    "success": true,
    "message": "",
    "error": null
  }
  

Il servizio di Risk Anagrafica è disponibile anche per ricerche su Persone e su Aziende.

Allo stesso modo, l'abbonamento Risk Anagrafico può essere utilizzato per ricerche su persone, aziende, privati.

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 limite giornalieri impostati per una corretta gestione del servizio.
Questi limiti variano in funzione dell'abbonamento:

In caso di superamento del rate limit previsto dall'abbonamento, le chiamate passeranno ad addebito su credito del borsellino.

Se desideri avere un servizio personalizzato contattaci qui.