Struttura dei dati

Organizzazione dati

Struttura logica

In questa sezione viene illustrata la struttura logica dei dati disponibili via API, a prescindere da come sono fisicamente memorizzati e di come possono essere interrogati programmaticamente, al solo fine di facilitare la comprensione della struttura generale. I dettagli sono quindi discussi nelle sezioni seguenti.

La struttura dei dati è relazionale e non può quindi essere semplicemente rappresentata in una tabella bidimensionale (si pensi ad esempio ad una azienda che possiede numerosi immobili, ciascuno dei quali avente un proprio indirizzo e una propria dimensione in vani). Per semplicità e per meglio comprendere l’assetto dei dati, possiamo pensare ad essi come alla struttura matematica del grafo: i nodi rappresentano le entità principali (aziende, persone, immobili, luoghi, etc.) e gli archi tra i nodi rappresentano le relazioni esistenti tra le entità (es: possesso, localizzazione, ruolo, etc.).

Si noti che sia alle entità, sia alle relazioni, possono essere associate una serie di “proprietà”, che ne descrivono ulteriormente alcuni aspetti (es: nome, partita iva, natura giuridica per una azienda; codice fiscale, genere e data di nascita per una persona fisica, etc). Nella figura qui sotto, visualizziamo a titolo di esempio solo alcune delle proprietà e delle relazioni esistenti.

Struttura fisica: scegliere la strategia di interrogazione

Data la struttura altamente relazionale dei dati, per gestire la complessità e l’ampia dimensione dei nostri archivi, i dati vengono resi accessibili in forma “denormalizzata” in differenti API Endpoints. I diversi endpoint corrispondono ai diversi tipi di entità presenti nel grafo (esiste ad esempio un endpoint per le aziende, uno per le persone, un altro per i luoghi, etc.). Sebbene accedendo a uno degli endpoint sia comunque possibile seguire certe relazioni e accedere alle proprietà connesse alle diverse entità presenti, non sempre possibile è possibile per questioni di performance. Interrogando l’endpoint companies per Poste Italiane SPA è quindi possibile accedere solo ad alcune delle decine di migliaia di sedi locali dell’azienda perché per ottenere una lista completa con tutti i dettagli e gli indirizzi è necessario usare l’endpoint specifico Locations.

La scelta della modalità con cui interrogare i dati, degli endpoints e dei parametri da usare in una query dipendono quindi dal vostro specifico caso d’uso, non esiste una strategia universalmente valida.

Le entità principali della struttura dati

Alle entità principali rappresentate nella struttura dati, corrisponde nella maggior parte dei casi uno specifico endpoint. Le entità principali sono univocamente identificate da almeno un identificatore, detto “atoka id”, ciò non toglie che ad una entità possa corrispondere più d’un identificatore¹ (ad esempio la partita iva e il numero REA per le aziende, il codice fiscale per le persone, etc).

Soggetti Economici

Aziende

Sono l’entità principale e raccolgono oltre 15 milioni di aziende operative e non operative, tra quelle iscritte e non iscritte al REA (Repertorio delle notizie Economiche e Amministrative). Tra le iscritte vi sono Società di Capitali (sottoposte, tra l’altro, all’obbligo di deposito dei bilanci), Società di Persone, Società Cooperative, Ditte Individuali e numerose altre tipologie di aziende. Tra le aziende non iscritte al REA, sono presenti circa 2 milioni di organizzazioni, tra cui professionisti, associazioni, condomini e molte altre tipologie di organizzazioni non soggette all’obbligo di registrazione all’Archivio Dati.

Pubbliche Amministrazioni

Oltre 22.000 enti pubblici suddivisi in più di 90.000 unità organizzative, provenienti dall’indice nazionale delle Pubbliche Amministrazioni.

Persone Fisiche (Soci ed Esponenti)

Comprendono i soci e gli esponenti (persone fisiche che detengono cariche e poteri all’interno di una organizzazione), per circa 13 milioni di persone. Ove disponibili, oltre alle quote di partecipazione e le cariche aziendali, alle persone fisiche sono associati gli immobili di loro proprietà.

Sedi

Rappresentano le unità territoriali delle aziende (compresa la sede legale) e possono essere di diversa natura (sede operativa, magazzino, punto vendita, etc.).

Luoghi (entità geografiche)

Rappresentano le unità amministrative territoriali, organizzate secondo una struttura logica che va dalla regione fino alla cella censuaria.

Immobili

Sono gli immobili da fonte catastale associati alle aziende o alle persone fisiche. Tra le proprietà degli immobili sono disponibili l’indirizzo, la tripla catastale, la categoria catastale, la rendita e, per determinate tipologie di immobile, anche le dimensioni e una stima del valore di mercato (secondo il modello proprietario di Cerved Group).

Contratti

Sono i contratti pubblici banditi da Pubbliche Amministrazioni e appaltati a una o più aziende. Comprendono tutti i contratti sottoposti a vigilanza dell’Autorità Nazionale Anti Corruzione.

News

Si tratta di oltre 15.000 news analizzate ogni giorno da algoritmi automatici, i quali le associano alle aziende e agli esponenti aziendali che vi sono menzionati. Le news provengono da oltre 700 quotidiani e periodici cartacei e digitali, nazionali e locali.

Liste

Sono raggruppamenti arbitrari di aziende stilati dagli utenti della piattaforma Atoka. Una lista appartiene a uno specifico utente e può essere condivisa in lettura o in scrittura con altri utenti della piattaforma.

Settori

È l’insieme dei settori nazionali definiti dalla Classificazione delle Attività Economiche (Ateco), allineati alla nomenclatura internazionale NACE

Entità (concetti/keywords)

Si tratta di un vocabolario di oltre 4 milioni di differenti concetti, ciascuno corrispondente a una pagina Wikipedia, associati automaticamente ai soggetti economici mediante l’analisi semantica dei loro siti web, dell’oggetto sociale, dei social media e di altre fonti documentali.

Tecnologie

Si tratta di un insieme di tecnologie web, tra le quali piattaforme di e-commerce, sistemi di pagamento, sistemi di content management e molte altre, associate ai soggetti economici mediante l’analisi automatica dei loro siti web.

Fonti

Di seguito un elenco generale delle fonti che vengono utilizzate per reperire i dati disponibili sulla piattaforma Atoka:

Registro Imprese della Camera di Commercio — visure camerali, bilanci, XBRL
Cerved Group S.P.A. — calcolo e rielaborazioni di vari dati: bilanci d’esercizio, gruppi finanziari ed altri
Siti web delle aziende — meta-informazioni e testo delle pagine web
Account social delle aziende (facebook, twitter)
IndicePA — indice delle pubbliche amministrazioni
Registro Informatico dei Protesti ed altri registri — l’estrazione di negatività e calcolo di relativi score
Consit — pregiudizievoli e altri atti di conservatoria
ANAC (Autorità Nazionale AntiCorruzione) — contratti pubblici
SISTER di Agenzia delle Entrate — dati immobiliari e catastali
OpenPolis — dati sulle persone politicamente esposte
INPS — dati trimestrali su numero dipendenti
Accredia — certificazioni ISO
Numerosi siti web per l’estrazione di notizie collegate ad esponenti ed aziende

A seconda della natura delle fonti e delle logiche di ottimizzazione, gli aggiornamenti seguono profili diversi, come giornalieri (es. notizie), settimanali (es. dati da Registro Imprese, IndicePA), mensili (es. dati web), fino a quelli quasi annuali (es. dati da bilanci).

Dati

Alcuni numeri

aziende operative: 6 mln
aziende non operative: 10 mln
aziende con stato di operatività ignoto: 5.9 mln
persone: 38 mln
contratti pubblici: 67 mln
sedi aziende operative: 23 mln

Nota: le metriche di copertura vengono fornite generalmente per aziende operative. In particolare, le aziende il cui stato di operatività non è noto non sono incluse nei conteggi in quanto generalmente molto variabili per quantità e qualità di dati ad esse collegati.

Dati anagrafici

Frequenza di aggiornamento: giornaliera

Dato presente per: 95% - 100% aziende operative, 62 - 100% non operative²

I dati anagrafici di aziende e persone fisiche sono ricavati dalle visure camerali, le quali vengono raccolte e processate da Cerved. Questo vale sia per le aziende persone giuridiche che per le persone fisiche collegate alle aziende tramite legami di partecipazioni o cariche ufficiali.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: base

endpoint: companies

Esempio

{
    "id": "6da785b3adf2",
    "vat": "02241890223",
    "taxID": "02241890223",
    "legalName": "SPAZIODATI S.R.L.",
    "legalClass": "Società di Capitale",
    "legalForms": [
        {
            "level": 1,
            "name": "Società Di Capitale"
        },
        {
            "level": 2,
            "name": "Società A Responsabilità Limitata"
        }
    ],
    "startup": false,
    ...,
    "rea": "210089",
    "founded": "2012-02-13"
}

*la numerosità delle colonne in esempio è stato limitata per questioni di visualizzazione.

Sedi

Frequenza di aggiornamento: giornaliera

Dato presente per (sedi legali): 98% aziende operative, 86% non operative

Gli indirizzi di sedi legali e unità locali sono geolocalizzati e arricchiti con coordinate per permetterne la visualizzazione su una mappa. Questo non avviene per gli indirizzi legati alle persone.

L’indirizzo è esposto sia in formato completo, sia diviso per componenti: toponimo, nome della via, numero civico, codice avviamento postale etc.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: locations

endpoint: companies

Nota: l’endpoint /company ha un limite riguardo le sedi pari a 10. Il numero totale delle sedi disponibili per l’azienda viene mostrato nel campo count.

Per ottenere informazioni circa tutte le sedi di un’azienda è necessario utilizzare l’endpoint /locations.

Esempio

Oggetto `registeredAddress` (sede legale):

pacchetto: base

{
    "registeredAddress": {
        "fullAddress": "Via Dell'Unione Europea, 6/A-6, 20097, San Donato Milanese (MI)",
        "lat": 45.41691,
        "latlonPrecision": 90,
        "lon": 9.25743,
        "macroregion": "Nord-ovest",
        "municipality": "San Donato Milanese",
        "postcode": "20097",
        "province": "Milano",
        "provinceCode": "MI",
        "region": "Lombardia",
        "state": "Italia",
        "streetName": "Dell'Unione Europea",
        "streetNumber": "6/A-6",
        "toponym": "Via"
    }
}

Oggetto `location`:

pacchetto: locations

{
    "id": "0ef76064b441",
    "type": "Studio",
    "address": {
        "fullAddress": "Via Mario Giuntini, 25, 56023, Navacchio, Cascina (PI)",
        "hamlet": "Navacchio",
        "lat": 43.68490295,
        "latlonPrecision": 90,
        "lon": 10.48699555,
        "macroregion": "Centro",
        "municipality": "Cascina",
        "postcode": "56023",
        "province": "Pisa",
        "provinceCode": "PI",
        "region": "Toscana",
        "state": "Italia",
        "streetName": "Mario Giuntini",
        "streetNumber": "25",
        "toponym": "Via"
    }
}

Bilanci e dipendenti

Frequenza di aggiornamento: annuale, ~6 mesi dopo la data di chiusura

Dato presente per:

Bilanci — 16% aziende operative³

58% Società di Capitale2 (le uniche soggette in Italia all’obbligo di deposito del bilancio)

Dipendenti — 74% aziende operative

Il dato grezzo è rappresentato da bilanci e documenti ad esso collegati come XBRL, bilanci ottici, note integrative, etc di fonte Deposito Bilanci di Registro Imprese (Camera di Commercio). Sulla base di questi dati, Cerved elabora i cosiddetti “bilanci riclassificati” in seguito a normalizzazioni, verifiche e modifiche per correggere eventuali errori; questi dati comprendono anche ulteriori indicatori e quantità calcolate dal gruppo Cerved utili per analisi di bilancio. Si noti che per effetto di suddette modifiche alcune voci generalmente disponibili nei bilanci “originali” sono mancanti o modificate, in quanto, ad esempio, possono riguardare valori e dimensioni spesso effetto di operazioni contabili e di conseguenza non robuste per la creazione di indici e analisi di bilancio.

Il dato esposto è denominato riclassificato per via della riclassificazione che viene operata basandosi su diverse tipologie di aziende (industriale, immobiliare, finanziaria, leasing, holding).

È compresa la differenziazione tra bilanci d’esercizio e consolidati.

Nel pacchetto economics è anche presente l’info sulla serie storica trimestrale dei dipendenti di fonte Infocamere.

I campi capitalStock e public infine mostrano rispettivamente il capitale sociale estratto da Visura camerale e se l’azienda è quotata in borsa.

Sono inoltre disponibili a richiesta tramite sales@atoka.io:

fino alle ultime tre annualità della totalità delle voci presenti nei bilanci riclassificati Cerved Group (CeBi)
fino alle ultime dieci annualità dei bilanci in formato IV direttiva CEE

Atoka Enterprise API

documentazione: leggi qui

pacchetto: economics

endpoint: companies

Esempio

{
    "balanceSheets": [
        {
            "assets": 1457817000,
            "capitalStock": 50521000,
            "currency": "EUR",
            "date": "2019-12-31",
            "ebitda": 140287000,
            "latest": true,
            "mol": 133942000,
            "netFinancialPosition": 551086000,
            "production": 298796000,
            "profit": 41530000,
            "purchases": 807000,
            "rawMaterialsVariation": 0,
            "revenue": 298796000,
            "revenueTrend": 0.016,
            "revenueTrendLabel": "stable",
            "servicesAndTPGoodsCharges": 89372000,
            "staffCosts": 74675000,
            "year": 2019
        },
        ...
    ],
    "employees": [
        {
            "date": "2020-06-01",
            "latest": true,
            "value": 1082,
            "year": 2020
        },
        ...
    ],
    "capitalStock": { "value": 50521142 },
    "public": true
}

Partecipazioni

Frequenza di aggiornamento: giornaliera

Dato presente per: 24% aziende operative

Le partecipazioni derivano anch’esse dai dati disponibili tramite visura camerale. Sotto una soglia minima non vengono mostrate su Atoka (percentuali irrisorie).

Per ogni azienda sono disponibili sia le informazioni sugli azionisti dell’azienda che le partecipazioni in possesso della stessa. È incluso in questo pacchetto di informazioni anche il dato sul chi possiede più del 25%, talvolta identificabile come “titolare effettivo”; tuttavia, vi sono alcune eccezioni (tra cui finanziarie, holding ed altre) per le quali questo non è individuato con una persona fisica.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: shares

endpoint: companies

Esempio

{
    "beneficialOwnerOf": [
        {
            "active": true,
            "cervedId": 364943955,
            "id": "1335c3c19a47",
            "legalName": "CERVED RATING AGENCY S.P.A.",
            "name": "CERVED RATING AGENCY S.P.A."
        },
        ...
    ],
    "shareholders": [
        {
            "active": true,
            "company": true,
            "id": "d8a23b3def67",
            "lastUpdate": "2020-06-29",
            "legalName": "'GRUPPO MUTUIONLINE S.P.A.' IN BREVE 'GRUPPO MOL S.P.A.' O ANCHE MOL HOLDING S.P.A.'",
            "name": "'GRUPPO MUTUIONLINE S.P.A.' IN BREVE 'GRUPPO MOL S.P.A.' O ANCHE MOL HOLDING S.P.A.'",
            "ratio": 0.0231,
            "typeOfRight": "proprietà"
        },
        ...
    ],
    "sharesOwned": [
        {
            "active": false,
            "amount": 50000000,
            "id": "936f12733738",
            "lastUpdate": "2014-05-06",
            "legalName": "CERVED GROUP SPA",
            "name": "CERVED GROUP SPA",
            "ratio": 1,
            "typeOfRight": "proprietà"
        },
        {
            "active": true,
            "amount": 10776,
            "id": "fabf60f9ca03",
            "lastUpdate": "2018-05-16",
            "legalName": "MAJOR 1 S.R.L.",
            "name": "MAJOR 1 S.R.L.",
            "ratio": 1,
            "typeOfRight": "proprietà"
        },
        ...,
    ]
}

Persone

Frequenza di aggiornamento: settimanale

Copertura: 14 mln di persone

I dati sulle persone mostrate su Atoka si riferiscono prettamente a individui collegati ad aziende tramite legami di partecipazione o cariche ufficiali. Il numero complessivo ad oggi è di circa 14 milioni. La fonte primaria è sempre il Registro Imprese, dal quale vengono reperite informazioni quali:

generalità
codice fiscale (e di conseguenza luogo e data di nascita)
ultimo indirizzo noto (ove disponibile)
ruoli ufficiali e partecipazioni in imprese

Ulteriori informazioni possono essere legate ad un individuo:

contatti: email lavorative ricavate dal sito web aziendale
sottoscore di negatività, ricavato sulla base delle negatività direttamente collegate alla persona e/o delle aziende a cui essa è legata
sottoscore immobiliare, calcolato sui dati immobiliari (quantità, tipo, dimensione etc.)
sottoscore centralità: indicatore dell’influenza della persona nella rete aziendale italiana
immobili: dato puntuale sugli immobili legati alla persona riportato in SISTER
cariche politiche nelle amministrazioni locali e centrali, presenti o passate
notizie: news che gli algoritmi di SpazioDati associano a quella persona

Atoka Enterprise API

Nota: l’endpoint company ha un limite riguardo gli esponenti pari a 10. Il numero totale viene comunque mostrato nel campo count. L’ordine rispecchia l’importanza della persona secondo le cariche ad essa attribuite.

Nel caso sia necessario ottenere informazioni sulle eventuali altre persone associate all’azienda, oltre le 10 fornite tramite il pacchetto people nell’endpoint `/companies` si prega di contattare sales@atoka.io.

documentazione: leggi qui

pacchetto: people

endpoint: companies

Esempio

Livello 0:

{
    "count": 43
}

Per persona:

{
    "birthDate": "1969-06-12",
    "cLevels": ["CEO"],
    "familyName": "Mignanelli",
    "gender": "M",
    "givenName": "Andrea",
    "id": "pLiEGf6-JM3SGZbBMu",
    "name": "Andrea Mignanelli",
    "roles": [
        {
            "name": "amministratore delegato",
            "since": "2019-04-19"
        },
        {
            "name": "consigliere",
            "since": "2016-04-29"
        },
        {
            "name": "chief executive officer"
        }
    ]
}

Graph4You (relazioni dirette e indirette)

Utilizzando i dati relativi alle partecipazioni, cariche ufficiali, titolari effettivi ed eventuali gruppi vengono sviluppati i grafici disponibili alla voce Graph4You su Atoka.

Atoka Enterprise API

L’informazione è accessibile tramite API Cerved: https://developer.cerved.com/.

Entities

Frequenza di aggiornamento: settimanale

Dato presente per: 42% aziende operative (aziende con almeno un entity associata)

Tecnologia proprietaria di SpazioDati, le entities - anche chiamate parole chiave - sono un ricco dato collegato a concetti individuati da pagine Wikipedia; possono essere legate ad aziende o persone.

Le fonti per la rilevazione di queste parole chiave sono: dati testuali provenienti da Registro Imprese (es. descrizione attività), testo del sito web e account social.

Le entities sono anche collegate a persone fisiche qualora queste posseggano partecipazioni di, o abbiano ruoli ufficiali in aziende alle quali sono state a loro volte assegnate delle entities.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: entities

endpoint: companies

Esempio

{
    "de": [{
        "name": "Ausbildung",
        "score": 0.3333333333333333,
        "uri": "http://de.wikipedia.org/wiki/Ausbildung"
    }],
    "en": [{
        "name": "Education",
        "score": 0.3333333333333333,
        "uri": "http://en.wikipedia.org/wiki/Education"
    }],
    "fr": [{
        "name": "Éducation",
        "score": 0.3333333333333333,
        "uri": "http://fr.wikipedia.org/wiki/%C3%89ducation"
    }],
    "it": [{
        "name": "Educazione",
        "score": 0.3333333333333333,
        "uri": "http://it.wikipedia.org/wiki/Educazione"
    }],
    "pt": [{
        "name": "Educação",
        "score": 0.3333333333333333,
        "uri": "http://pt.wikipedia.org/wiki/Educa%C3%A7%C3%A3o"
    }]
}

Contatti

Frequenza di aggiornamento: giornaliera

Dato presente per:

numeri di telefono: 37.8% aziende operative

email: 11.3% aziende operative

I contatti (e-mail, fax, numeri di telefono) legati ad aziende derivano sia da fonti ufficiali quali visure camerali, pubblica amministrazione, che non ufficiali come siti web e social network.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: contacts

endpoint: companies

Esempio

{
    "emails": {
        "address": "consit@cerved.com",
        "type": "other",
        "verified": true
    },
    "fax": [
      "+39 02 2940 1153"
    ],
    "phones": [
        {
            "fullAddress": "Via Dell'Unione Europea, 6/A-6, 20097, San Donato Milanese (MI)",
            "locationId": "3063a2fa9127",
            "number": "+39 02 8909 6061",
            "source": "phone books",
            "verified": true
        },
        {
            "number": "+39 800 029 029",
            "source": "web",
            "verified": false
        },
        ...
    ]
}

Siti web

Aggiornamento: mensile

Dato presente per: 11.3% aziende operative

SpazioDati utilizza tecniche di crawling del web per poter ottenere un database esaustivo dei possibili siti web corporate; in seguito a specifiche logiche di matching questi siti web, ove possibile, vengono accoppiati ad un’azienda.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: web

endpoint: companies

Esempio

{
    "description": "Cerved fornisce servizi di valutazione, gestione e recupero crediti, report e studi di settore a aziende e istituti finanziari.",
    "languages": [ "en", "it" ],
    "logo": "https://s3-eu-west-1.amazonaws.com/static-mastergraph-spaziodati-eu/resources/logos/47cf3b46031d9bd9491ea76ec64f1b20f49ed7ba.png",
    "websites": [
        {
            "active": true,
            "url": "http://www.cerved.com"
        },
        {
            "active": true,
            "confidence": 0.9547110921,
            "url": "http://company.cerved.com"
        },
        ...
    ]
}

Frequenza di aggiornamento: mensile

Dato presente per: almeno un social: 5.1% aziende operative

Tramite le suddette procedure di crawling del web, SpazioDati estrae anche gli account social relativi alle aziende. I social ad oggi supportati sono:

facebook
twitter
linkedin
instagram
youtube
vimeo
flickr
googleplus

Sono disponibili anche degli indici di attività dei suddetti account social, in riferimento a due differenti finestre temporali: globale è calcolato sui 12 mesi mentre locale su 3; questi indici sono espressi in termini di quantili. Per dettagli si faccia riferimento al link alla documentazione qui di seguito.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: socials

endpoint: companies

Esempio

{
    "facebook": {
        "id": "158085997557040",
        "likes": [
            {
                "count": 763,
                "date": "2015-12-31T12:00:00.000000"
            },
            {
                "count": 1002,
                "date": "2016-06-02T12:00:00.000000"
            },
            {
                "count": 1023,
                "date": "2016-06-09T12:00:00.000000"
            },
            ...
        ],
        "url": "https://www.facebook.com/cervedgroup"
    },
    "linkedin": [
        {
          "url": "http://www.linkedin.com/company/cerved-group-spa"
        }
    ],
    "score": {
        "blog": 0,
        "facebookGlobal": 0.704,
        "facebookLocal": 0.7653,
        "global": 1.0,
        "globalLabel": "top",
        "local": 1.0,
        "localLabel": "top",
        "presence": 1.0,
        "twitterGlobal": 0.8391,
        "twitterLocal": 0.6675,
        "updateTime": "2020-10-26"
    },
    "twitter": {
        "followers": [
            {
                "count": 269,
                "date": "2016-06-16T12:00:00.000000"
            },
            {
                "count": 357,
                "date": "2017-01-19T12:00:00.000000"
            },
            ...
        ],
        "friends": [
            {
              "count": 247,
              "date": "2016-06-16T12:00:00.000000"
            },
            {
              "count": 263,
              "date": "2017-01-19T12:00:00.000000"
            },
            ...
        ],
        "url": "https://twitter.com/cervedcom"
    }
}

*non incluse perché non presenti per quest’azienda esempio: instagram, vimeo, flickr, youtube.

Immobili

Frequenza di aggiornamento: settimanale sulla base delle movimentazioni dei giornalieri di conservatoria

Dato presente per: 9.5% aziende operative

Copertura: 98.2% di Società di Capitale e Società di Persone operative

Dati resi disponibili da SISTER (gestito dall'Agenzia delle Entrate), compresi di:

indirizzo dell’immobile
metadati (lotto, sezione, …)
tipo (residenza ad uso abitativo, terreno, …)
dimensione
proprietà (titolari⁴, quote, etc)

A queste informazioni Cerved aggiunge una stima relativa al valore dell’immobile.

Nelle API Atoka informazioni base circa le categorie aggregate degli immobili possono essere ricavate tramite l’endpoint /companies — descritte qui sotto —, mentre i dati completi sono reperibili mediante l’utilizzo dell’endpoint /realestate dedicato.

Atoka Enterprise API

Per l’endpoint companies:

documentazione: leggi qui

pacchetti: realestate

endpoint: companies

Esempio

{
    "categories": [
        {
            "code": "A/10",
            "label": "Uffici e studi privati"
        },
        {
            "code": "C/6",
            "label": "Stalle, scuderie, rimesse, autorimesse (senza fine di lucro)"
        }
    ]
}

Per l’endpoint realestate:

documentazione: non ancora disponibile

pacchetti: base,owners

endpoint: realestate

Esempio

Lista di oggetti così definiti:

pacchetto base

{
    address: {
        "fullAddress": "Via Londra, Rende (CS)",
        "macroregion": "Sud",
        "municipality": "Rende",
        "province": "Cosenza",
        "provinceCode": "CS",
        "region": "Calabria",
        "state": "Italia",
        "streetName": "Via Londra"
    },
    "cadastralInfo": {
        "category": "Stalle, scuderie, rimesse, autorimesse (senza fine di lucro)",
        "categoryCode": "C/6",
        "floor": "S2",
        "income": 163.82,
        "layout": "31",
        "lot": "517",
        "subLot": 9,
        "updateTime": "2019-02-25"
    },
    "estimation": {
        "averageMax": 48880,
        "averageMin": 37440
    },
    "size": {
        "unit": "mq",
        "value": 52
    },
    "type": "building"
}

pacchetto owners

{
    "id": "8b2d6ff2b408",
    "company": true,
    "entitlement": "Proprieta’",
    "label": "CERVED GROUP S.P.A.",
    "ratio": 1
}

Contratti Pubblici

Frequenza di aggiornamento: giornaliero

Dato presente per: 9.4% operative

67 mln di contratti dal 2014 ad oggi (che rappresentano il 99.3% dei contratti presenti nel registro dell’Autorità Nazionale Anticorruzione)

Dati esposti dall’Autorità Nazionale Anticorruzione e processati da SpazioDati. Comprendono:

committente
tipo e descrizione del bando
aziende partecipanti al bando
aziende vincitrici
valore economico, con eventuali importi parziali già erogati
datazione e scadenze

Atoka Enterprise API

I dati sono disponibili sia azienda per azienda (se ha partecipato e eventualmente vinto almeno un bando), che nel dettaglio tramite le API di Contrattipubblici.org.

documentazione: leggi qui

pacchetto: govcontracts

endpoint: companies

Esempio

{
    "applied": true,
    "won": true
}

Per dettagli sui contratti pubblici azienda per azienda invece la risposta sarà come segue. Si tenga presente che la fonte non offre nessun dato ufficiale per operare un matching affidabile, come ad esempio partita iva o codice fiscale.

documentazione: leggi qui

pacchetto: base

endpoint: contracts

Esempio

{
    "id": "61635e0dfd26",
    "subject": "Servizio 2017"
}

pacchetto base

{
    "amount": 7000,
    "amountPaid": 0,
    "cig": "Z461D7E0DA",
    "commissioningBody": {
        "atokaMatched": true,
        "id": "cb7b48472d51",
        "legalName": "UNIVERSITA' DEGLI STUDI DI TRENTO",
        "registeredAddress": {
            "macroregion": "Nord-est",
            "municipality": "Trento",
            "postcode": "38122",
            "province": "Trento",
            "provinceCode": "TN",
            "region": "Trentino-Alto Adige/Südtirol",
            "state": "Italia"
        },
        "taxId": "00340520220",
        "vat": "00340520220"
    },
    "contractorSelection": {
        "code": "4",
        "label": "Procedura negoziata senza previa pubblicazione del bando"
    },
    "participantGroups": [
        {
            "awarded": true,
            "id": "cad77176b112",
            "participants": [
                {
                    "ateco": [
                        {
                            "code": "82.91.10",
                            "description": "Attività di agenzie di recupero crediti",
                            "rootCode": "N"
                        }
                    ],
                    "atokaMatched": true,
                    "id": "cad77176b112",
                    "legalForms": [
                        {
                            "level": 1,
                            "name": "Società Di Capitale"
                        },
                        {
                            "level": 2,
                            "name": "Società Per Azioni"
                        }
                    ],
                    "legalName": "INNOLVA S.P.A.",
                    "registeredAddress": {
                        "macroregion": "Nord-est",
                        "municipality": "Buja",
                        "postcode": "33030",
                        "province": "Udine",
                        "provinceCode": "UD",
                        "region": "Friuli-Venezia Giulia",
                        "state": "Italia"
                    },
                    "taxId": "01836920304",
                    "vat": "01836920304"
                }
            ]
        },
        ...
    ],
    "participantGroupsCount": 3,
    "startDate": "2017-09-11"
}

Score di affidabilità / rischio (CGR & CGS)

Frequenza di aggiornamento: settimanale

Dato presente per: CGS — 93.6% operative

Score proprietario di Cerved che utilizza svariate fonti di dati (dati sui pagamenti, negatività, indici di stabilità finanziaria, etc) per produrre una stima della probabilità di default, e in generale dell’affidabilità dell’azienda. Può risultare non calcolabile o soggetto a riesaminazione nei casi in cui non vi siano dati sufficienti o i dati presenti non siano stati adeguatamente verificati.

Questo viene calcolato sia per le aziende che per le persone fisiche, ma con scale diverse: 0-100 per le aziende, dove 100 rappresenta affidabilità massima e rischio pressoché nullo e 0 rischio molto alto di default / affidabilità molto bassa.

Per le persone fisiche lo score è inteso come rating, con scala 1-10; 1 rappresenta affidabilità massima e 10 affidabilità minima.

Inoltre per l’endpoint /people è anche disponibile una variabile booleana indicante la presenza di negatività relative alla persona fisica stessa.

Sottoscore

Su richiesta sono anche disponibili alcuni sottoscore specifici, sia per l’oggetto azienda che per l’oggetto persona; la lista di questi è disponibile nelle pagine di documentazione linkate qui sotto.

L’utilizzo di questi sottoscore richiede autorizzazioni speciali da parte del nostro partner, per cui si prega di contattare sales@atoka.io qualora ci fosse interesse per questi dati.

Atoka Enterprise API

Oggetto azienda:

documentazione: leggi qui

pacchetto: cervedindicators

endpoint: companies

Esempio

{
    "subscores": {
        "C13_MBD": {
            "classValue": "4.0",
            "description": "Affidabile",
            "realTime": false,
            "updateTime": "2019-03-23"
        },
        "C4_EVNT": {
            "classValue": "0.0",
            "description": "ASSENZA DI EVENTI",
            "realTime": false,
            "updateTime": "2019-03-02",
            "value": 50
        }
    },
    "cgs": {
        "label": "Buona",
        "updated": "2019-03-04",
        "value": 69
    }
}

Oggetto persona:

documentazione: leggi qui

pacchetto: cervedindicators

endpoint: people

Esempio

{
    "cgrP15": {
        "linked": false,
        "updated": "2019-03-05",
        "value": "1.0"
    },
    "cgrP4": {
        "linked": false,
        "updated": "2019-03-05",
        "value": "0.0"
    },
    "cgs": {
        "realTime": true,
        "updated": "2019-03-27",
        "value": "2.0"
    },
    "negativities": false
}

Score propensione al mercato estero

Frequenza di aggiornamento: semestrale

Dato presente per: 11.2% aziende operative

Score calcolato da SpazioDati sulla base di dati ufficiali e non ufficiali riguardo alla propensione di un’azienda a commerciare con l’estero. Le fonti utilizzate sono sia registri ufficiali che indicano una presenza certa di rapporti nei mercati esteri utilizzati come ground truth, sia dati vari provenienti da visura camerale, siti web, bilanci e altri ancora. Non viene calcolato per pubbliche amministrazioni, imprese molto piccole o aventi alcuni codici Ateco specifici che suggeriscono attività per cui la propensione al mercato estero non è indicativa, quali, ad esempio le attività ristorative.

Atoka Enterprise API

documentazione: non ancora disponibile

pacchetto: foreignmarket

endpoint: companies

Esempio

{
    "areas": [
        {
            "continent": "019",
            "continentLabel": "America",
            "lastUpdate": "2019-02-27",
            "official": false,
            "provenance": [
                "webLang"
            ],
            "type": "continent"
        },
        {
            "continent": "142",
            "continentLabel": "Asia",
            "lastUpdate": "2018-10-07",
            "official": true,
            "provenance": [
              "infocamere"
            ],
            "state": "CN",
            "stateLabel": "Cina",
            "subRegion": "030",
            "subRegionLabel": "Asia orientale",
            "type": "state"
        },
        ...
    ],
    "exportPropensity": {
        "score": 1,
        "scoreLabel": "certain",
        "updateTime": "2018-09-27"
    }
}

Score innovazione, centralità web, Indice di Disagio Sociale e Edilizio

Frequenza di aggiornamento: mensile / mensile / ogni censimento

Dato per presente per::

innovazione: 10.9% aziende operative

centralità web: 12.7% aziende operative

IDE & IDS: 92.3% aziende operative

L’innovation score di SpazioDati è indice dell’affinità di un’azienda con il mondo delle startup e aziende innovative. È sviluppato a partire dalle entities (o concetti chiave), le quali a loro volta sono ricavate da SpazioDati a partire da informazioni disponibili su siti web e in visura camerale. È disponibile sia per categoria (cioè confrontato con aziende con Ateco simili) e globale. Espresso sempre in forma di quantile.

Lo score centralità web indica l’importanza dei siti dell’azienda (se presenti) all’interno del grafo dei siti corporate. Similmente allo score innovazione comprende uno score per categoria e uno globale, sempre espressi in forma di quantile.

Gli indici di disagio sociale (IDS) e di disagio edilizio (IDE) sono due score calcolati a partire dagli ultimi dati di censimento, calcolato per ogni azienda sulla base della cella censuaria della sede legale della stessa. Uno score alto rappresenta un livello alto di disagio.

Per web centrality score e indici territoriali si prega di contattare sales@atoka.io.

Atoka Enterprise API

documentazione: leggi qui

pacchetto: atokaindicators

endpoint: companies

Esempio

{
    "innovation": {
        "categoryScore": 0.59,
        "categoryScoreLabel": "medium",
        "score": 0.57,
        "scoreLabel": "medium",
        "updateTime": "2019-02-24"
    },
    "territorialScores": {
        "IDE": {
            "label": "minimum",
            "value": 0,
            "valueNational": 0
        },
        "IDS": {
            "label": "medium",
            "value": 0.67,
            "valueNational": 0.7092
        }
    },
    "webCentrality": {
        "categoryScore": 0.97,
        "categoryScoreLabel": "top",
        "score": 0.95,
        "scoreLabel": "top",
        "updateTime": "2019-02-24"
    }
}

Tecnologie

Frequenza di aggiornamento: mensile

Dato presente per: 5.3% aziende operative

Questo pacchetto offre i dati ricavati sulle tecnologie utilizzate a partire dal sito (o da più siti, se presenti) associato all’azienda.

Queste sono raggruppate per categoria per poter individuare in maniera più efficace quali tipi di tecnologie vengono utilizzate, tra:

analytics
apps
blog
cms (content management system)
e-commerce
marketing
payments

Atoka Enterprise API

documentazione: leggi qui

pacchetto: technologies

endpoint: companies

Esempio

{
    "blog": [{
        "name": "wordpress",
        "sources": [
          "http://glammilano.it"
        ],
        "version": "4.9.9"
    }],
    "cms": [{
        "name": "wordpress",
        "sources": [
        "http://glammilano.it"
        ],
        "version": "4.9.9"
    }],
    "marketing": [{
        "name": "yoastseo",
        "sources": [
            "http://www.glammilano.it"
        ]
    }]
}

*non incluse perché non presenti per quest’azienda esempio: analytics, apps, ecommerce, payments.

Certificazioni

Frequenza di aggiornamento: bimestrale

Dato presente per: 1.2% aziende operative

Questi dati rappresentano le certificazioni ISO di fonte Accredia. È possibile ricavare info sul tipo di certificazione, l’istituzione che l’ha fornita, la data di riferimento e l’attività per cui è stata certificata l’azienda.

Ogni azienda può presentare una o più certificazioni.

Atoka Enterprise API

documentazione: non ancora disponibile

pacchetto: certifications

endpoint: companies

Esempio

singolo oggetto:

{
    "activity": "Gestione energetica della progettazione e fabbricazione di macchine per movimento terra e sollevatori telescopici mediante le fasi di costruzione di componenti (taglio, lavorazioni meccaniche, assemblaggio), verniciatura e montaggio",
    "institution": "DNV GL BUSINESS ASSURANCE ITALIA S.R.L.",
    "startDate": "2016-12-30",
    "type": "UNI CEI EN ISO 50001:2011"
}

Note & sales funnel

FEATURE IN VERSIONE SPERIMENTALE

per informazioni riguardo l’utilizzo di questo endpoint, si prega di contattare sales@atoka.io

Utilizzando le API di Atoka è altresì possibile gestire un sales funnel per i propri clienti presenti su Atoka.

I cosiddetti lead status - Nuovo, Primo Contatto, Appuntamento, Proposta, Negoziazione, Vinto - rappresentano lo stato di avanzamento delle trattative con i propri clienti. Questa informazione è corredata da una data di aggiornamento ed eventuali note, in forma di testo, che accompagnano un cambiamento di status nel sales funnel.

Per poter utilizzare questa funzione è necessario l’Atoka ID dell’azienda stessa, disponibile tramite l’endpoint company.

Atoka Enterprise API

documentazione: non ancora disponibile

pacchetto: —

endpoint: leadevents

Liste

FEATURE IN VERSIONE SPERIMENTALE

per informazioni riguardo l’utilizzo di questo endpoint, si prega di contattare sales@atoka.io

Il servizio permette di gestire (creare, leggere, aggiornare, cancellare) liste di aziende.

È possibile anche gestire la condivisione e visibilità di liste ad altri utenti appartenenti allo stesso gruppo (applicazione).

Si noti che alcuni identificatori non sono necessariamente univoci. Esistono ad esempio dei casi limite per cui la partita IVA e il Codice Fiscale, non identificano univocamente un singolo soggetto (es: Omocodie). ↩︎
la copertura può variare per ogni tipo di dato: ad esempio la partita IVA è presente per il 95% delle aziende operative, mentre scende al 61% per le non operative. Nome legale e natura giuridica hanno invece copertura del 100% sia per operative che per non operative. ↩︎
dati riferiti ai bilanci chiusi nell’anno 2017. ↩︎
la proprietà può essere legata a persone o ad aziende. ↩︎

Organizzazione dati

Struttura logica

Struttura fisica: scegliere la strategia di interrogazione

Le entità principali della struttura dati

Soggetti Economici

Aziende

Pubbliche Amministrazioni

Persone Fisiche (Soci ed Esponenti)

Sedi

Luoghi (entità geografiche)

Immobili

Contratti

News

Liste

Settori

Entità (concetti/keywords)

Tecnologie

Fonti

Dati

Alcuni numeri

Dati anagrafici

Atoka Enterprise API

Esempio

Sedi

Atoka Enterprise API

Esempio

Oggetto registeredAddress (sede legale):

Oggetto location:

Bilanci e dipendenti

Atoka Enterprise API

Esempio

Partecipazioni

Atoka Enterprise API

Esempio

Persone

Atoka Enterprise API

Esempio

Graph4You (relazioni dirette e indirette)

Atoka Enterprise API

Entities

Atoka Enterprise API

Esempio

Contatti

Atoka Enterprise API

Esempio

Siti web

Atoka Enterprise API

Esempio

Account social

Atoka Enterprise API

Esempio

Immobili

Atoka Enterprise API

Per l’endpoint companies:

Esempio

Per l’endpoint realestate:

Esempio

Contratti Pubblici

Atoka Enterprise API

Esempio

Esempio

Score di affidabilità / rischio (CGR & CGS)

Sottoscore

Atoka Enterprise API

Oggetto azienda:

Esempio

Oggetto persona:

Esempio

Score propensione al mercato estero

Atoka Enterprise API

Esempio

Score innovazione, centralità web, Indice di Disagio Sociale e Edilizio

Atoka Enterprise API

Esempio

Tecnologie

Atoka Enterprise API

Esempio

Certificazioni

Atoka Enterprise API

Esempio

Oggetto `registeredAddress` (sede legale):

Oggetto `location`: