(Ruby) Cerved API Entity Search

Perform searches on a Subject, known indifferently, the Fiscal Code, VAT number or Name, and to obtain basic information of the Subject.

For more information, see https://apps-developer.cerved.com/

Chilkat Ruby Downloads install from rubygems.org gem install chilkat or download... Ruby Library for Windows, MacOS, Linux, Alpine Linux

require 'chilkat'

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

http = Chilkat::CkHttp.new()

# Implements the following CURL command:

# curl -X GET \
#   https://api.cerved.com/cervedApi/v1/entitySearch/live?testoricerca=test \
#   -H 'accept: application/json' \
#   -H 'apikey: ********************************'

# Use the following online tool to generate HTTP code from a CURL command
# Convert a cURL Command to HTTP Source Code

http.SetRequestHeader("accept","application/json")
# Note: Your apikey is your Consumer Key
http.SetRequestHeader("apikey","********************************")

sbResponseBody = Chilkat::CkStringBuilder.new()
success = http.QuickGetSb("https://api.cerved.com/cervedApi/v1/entitySearch/live?testoricerca=test",sbResponseBody)
if (success == false)
    print http.lastErrorText() + "\n";
    exit
end

jResp = Chilkat::CkJsonObject.new()
jResp.LoadSb(sbResponseBody)
jResp.put_EmitCompact(false)

print "Response Body:" + "\n";
print jResp.emit() + "\n";

respStatusCode = http.get_LastStatus()
print "Response Status Code = " + respStatusCode.to_s() + "\n";
if (respStatusCode >= 400)
    print "Response Header:" + "\n";
    print http.lastHeader() + "\n";
    print "Failed." + "\n";
    exit
end

# Sample JSON response:
# (Sample code for parsing the JSON response is shown below)

# {
#   "peopleTotalNumber": 1,
#   "companiesTotalNumber": 49,
#   "companies": [
#     {
#       "dati_anagrafici": {
#         "id_soggetto": 12207335,
#         "denominazione": "ANGELANTONI TEST TECHNOLOGIES S.R.L. IN FORMA ABBREVIATA ATT S.R.L.",
#         "codice_fiscale": "01234567890",
#         "partita_iva": "01234567890",
#         "indirizzo": {
#           "descrizione": "LOCALITA' CIMACOLLE, 464",
#           "cap": "06056",
#           "codice_comune": "PG028",
#           "descrizione_comune": "MASSA MARTANA",
#           "codice_comune_istat": "054028",
#           "provincia": "PG",
#           "descrizione_provincia": "PERUGIA"
#         }
#       },
#       "dati_attivita": {
#         "codice_ateco": "265129",
#         "ateco": "Fabbricazione di altri apparecchi di misura e regolazione, strumenti da disegno, di contatori di elettricita', gas, acqua ed altri liquidi, di bilance analitiche di precisione (incluse parti staccate ed accessori)",
#         "codice_stato_attivita": "A",
#         "flag_operativa": true,
#         "codice_rea": "PG 272575",
#         "company_form": {
#           "code": "SR",
#           "description": "SOCIETA' A RESPONSABILITA' LIMITATA",
#           "company_form_class": "SC"
#         }
#       },
#       "dati_pa": {
#         "ente": false,
#         "fornitore": true,
#         "partecipata": false
#       }
#     },
#     {
#       "dati_anagrafici": {
#         "id_soggetto": 1046896,
#         "denominazione": "TEST INDUSTRY S.R.L.",
#         "codice_fiscale": "01234567890",
#         "partita_iva": "01234567890",
#         "indirizzo": {
#           "descrizione": "CORSO VENEZIA, 36",
#           "cap": "20121",
#           "codice_comune": "MI146",
#           "descrizione_comune": "MILANO",
#           "codice_comune_istat": "015146",
#           "provincia": "MI",
#           "descrizione_provincia": "MILANO"
#         }
#       },
#       "dati_attivita": {
#         "codice_ateco": "265129",
#         "ateco": "Fabbricazione di altri apparecchi di misura e regolazione, strumenti da disegno, di contatori di elettricita', gas, acqua ed altri liquidi, di bilance analitiche di precisione (incluse parti staccate ed accessori)",
#         "codice_stato_attivita": "A",
#         "flag_operativa": true,
#         "codice_rea": "MI 2579272",
#         "company_form": {
#           "code": "SR",
#           "description": "SOCIETA' A RESPONSABILITA' LIMITATA",
#           "company_form_class": "SC"
#         }
#       },
#       "dati_pa": {
#         "ente": false,
#         "fornitore": true,
#         "partecipata": false
#       }
#     },
#     {
#       "dati_anagrafici": {
#         "id_soggetto": 300632,
#         "denominazione": "ITW TEST AND MEASUREMENT ITALIA S.R.L.",
#         "codice_fiscale": "01234567890",
#         "partita_iva": "01234567890",
#         "indirizzo": {
#           "descrizione": "VIA AIRAUDA, 12",
#           "cap": "10044",
#           "codice_comune": "TO189",
#           "descrizione_comune": "PIANEZZA",
#           "codice_comune_istat": "001189",
#           "provincia": "TO",
#           "descrizione_provincia": "TORINO"
#         }
#       },
#       "dati_attivita": {
#         "codice_ateco": "265129",
#         "ateco": "Fabbricazione di altri apparecchi di misura e regolazione, strumenti da disegno, di contatori di elettricita', gas, acqua ed altri liquidi, di bilance analitiche di precisione (incluse parti staccate ed accessori)",
#         "codice_stato_attivita": "A",
#         "flag_operativa": true,
#         "codice_rea": "TO 379571",
#         "company_form": {
#           "code": "SU",
#           "description": "SOCIETA' A RESPONSABILITA' LIMITATA CON UNICO SOCIO",
#           "company_form_class": "SC"
#         }
#       },
#       "dati_pa": {
#         "ente": false,
#         "fornitore": true,
#         "partecipata": false
#       }
#     }
#   ],
#   "people": [
#     {
#       "dati_anagrafici": {
#         "id_soggetto": 333333333,
#         "denominazione": "ROBUSTELLI TEST ALESSANDRO",
#         "dt_nascita": "08-22-1978",
#         "codice_fiscale": "RBSSMMMMMMMMMMMM",
#         "indirizzo": {
#           "descrizione": "VIA ALESSANDRINI, 22",
#           "cap": "26027",
#           "codice_comune": "CR084",
#           "descrizione_comune": "RIVOLTA D'ADDA",
#           "codice_comune_istat": "019084",
#           "provincia": "CR",
#           "descrizione_provincia": "CREMONA"
#         }
#       }
#     }
#   ]
# }

# Sample code for parsing the JSON response...
# Use the following online tool to generate parsing code from sample JSON:
# Generate Parsing Code from JSON

peopleTotalNumber = jResp.IntOf("peopleTotalNumber")
companiesTotalNumber = jResp.IntOf("companiesTotalNumber")
i = 0
count_i = jResp.SizeOfArray("companies")
while i < count_i
    jResp.put_I(i)
    dati_anagraficiId_soggetto = jResp.IntOf("companies[i].dati_anagrafici.id_soggetto")
    dati_anagraficiDenominazione = jResp.stringOf("companies[i].dati_anagrafici.denominazione")
    dati_anagraficiCodice_fiscale = jResp.stringOf("companies[i].dati_anagrafici.codice_fiscale")
    dati_anagraficiPartita_iva = jResp.stringOf("companies[i].dati_anagrafici.partita_iva")
    dati_anagraficiIndirizzoDescrizione = jResp.stringOf("companies[i].dati_anagrafici.indirizzo.descrizione")
    dati_anagraficiIndirizzoCap = jResp.stringOf("companies[i].dati_anagrafici.indirizzo.cap")
    dati_anagraficiIndirizzoCodice_comune = jResp.stringOf("companies[i].dati_anagrafici.indirizzo.codice_comune")
    dati_anagraficiIndirizzoDescrizione_comune = jResp.stringOf("companies[i].dati_anagrafici.indirizzo.descrizione_comune")
    dati_anagraficiIndirizzoCodice_comune_istat = jResp.stringOf("companies[i].dati_anagrafici.indirizzo.codice_comune_istat")
    dati_anagraficiIndirizzoProvincia = jResp.stringOf("companies[i].dati_anagrafici.indirizzo.provincia")
    dati_anagraficiIndirizzoDescrizione_provincia = jResp.stringOf("companies[i].dati_anagrafici.indirizzo.descrizione_provincia")
    dati_attivitaCodice_ateco = jResp.stringOf("companies[i].dati_attivita.codice_ateco")
    dati_attivitaAteco = jResp.stringOf("companies[i].dati_attivita.ateco")
    dati_attivitaCodice_stato_attivita = jResp.stringOf("companies[i].dati_attivita.codice_stato_attivita")
    dati_attivitaFlag_operativa = jResp.BoolOf("companies[i].dati_attivita.flag_operativa")
    dati_attivitaCodice_rea = jResp.stringOf("companies[i].dati_attivita.codice_rea")
    dati_attivitaCompany_formCode = jResp.stringOf("companies[i].dati_attivita.company_form.code")
    dati_attivitaCompany_formDescription = jResp.stringOf("companies[i].dati_attivita.company_form.description")
    dati_attivitaCompany_formCompany_form_class = jResp.stringOf("companies[i].dati_attivita.company_form.company_form_class")
    dati_paEnte = jResp.BoolOf("companies[i].dati_pa.ente")
    dati_paFornitore = jResp.BoolOf("companies[i].dati_pa.fornitore")
    dati_paPartecipata = jResp.BoolOf("companies[i].dati_pa.partecipata")
    i = i + 1
end
i = 0
count_i = jResp.SizeOfArray("people")
while i < count_i
    jResp.put_I(i)
    dati_anagraficiId_soggetto = jResp.IntOf("people[i].dati_anagrafici.id_soggetto")
    dati_anagraficiDenominazione = jResp.stringOf("people[i].dati_anagrafici.denominazione")
    dati_anagraficiDt_nascita = jResp.stringOf("people[i].dati_anagrafici.dt_nascita")
    dati_anagraficiCodice_fiscale = jResp.stringOf("people[i].dati_anagrafici.codice_fiscale")
    dati_anagraficiIndirizzoDescrizione = jResp.stringOf("people[i].dati_anagrafici.indirizzo.descrizione")
    dati_anagraficiIndirizzoCap = jResp.stringOf("people[i].dati_anagrafici.indirizzo.cap")
    dati_anagraficiIndirizzoCodice_comune = jResp.stringOf("people[i].dati_anagrafici.indirizzo.codice_comune")
    dati_anagraficiIndirizzoDescrizione_comune = jResp.stringOf("people[i].dati_anagrafici.indirizzo.descrizione_comune")
    dati_anagraficiIndirizzoCodice_comune_istat = jResp.stringOf("people[i].dati_anagrafici.indirizzo.codice_comune_istat")
    dati_anagraficiIndirizzoProvincia = jResp.stringOf("people[i].dati_anagrafici.indirizzo.provincia")
    dati_anagraficiIndirizzoDescrizione_provincia = jResp.stringOf("people[i].dati_anagrafici.indirizzo.descrizione_provincia")
    i = i + 1
end