ANAC: le informazioni correlate a un CIG

Estrarle in due modalità, via file o via API

Tramite file

Questa modalità è dal punto di vista pratico la più semplice, ma non è la più efficiente.

Il portale dei dati aperti dell’ANAC infatti rende disponibili dei dataset, con l’elenco mensile dei CIG, raggruppati per anno.

Figura 1: Lista dei file sui CIG, sul sito di ANAC

I file per mese sono compressi in formato ZIP e disponibili in più formati (qui si fa riferimento al CSV). Sono file ricchi di informazioni, come l’oggetto della gara, la modalità di scelta del contraente, il luogo di riferimento secondo codifica Istat, i codici CPV¹ per categorizzare l’oggetto della gara, l’importo, il settore, ecc. (sotto un esempio, fare click per espandere).

Esempio di contenuto file sui CIG di ANAC

ℹ️ nota bene: non sono elencate tutte le colonne, ma soltanto quelle che per questo CIG erano valorizzate.


Colonna	Esempio contenuto
cig	95156957EC
numero_gara	8821609
oggetto_gara	MITIGAZIONE DEL RISCHIO IDROGEOLOGICO NEI PRESSI DI VIA DELLA RESISTENZA
importo_complessivo_gara	207364.64
n_lotti_componenti	1
oggetto_lotto	MITIGAZIONE DEL RISCHIO IDROGEOLOGICO NEI PRESSI DI VIA DELLA RESISTENZA
importo_lotto	207364.64
oggetto_principale_contratto	LAVORI
stato	ATTIVO
settore	SETTORI ORDINARI
luogo_istat	101018
provincia	CROTONE
data_pubblicazione	2022-12-02
data_scadenza_offerta	2022-12-17
cod_tipo_scelta_contraente	1
tipo_scelta_contraente	PROCEDURA APERTA
cod_modalita_realizzazione	1
modalita_realizzazione	CONTRATTO D’APPALTO
codice_ausa	0000247922
cf_amministrazione_appaltante	91006950793
denominazione_amministrazione_appaltante	PROVINCIA DI CROTONE
sezione_regionale	SEZIONE REGIONALE CALABRIA
id_centro_costo	212D6D14-1C28-49FD-AC30-A56185DC432B
denominazione_centro_costo	STAZIONE UNICA APPALTANTE - CENTRALE UNICA DI COMMITTENZA DELLA PROVINCIA DI CROTONE
anno_pubblicazione	2022
mese_pubblicazione	12
cod_cpv	45111230-9
descrizione_cpv	LAVORI DI STABILIZZAZIONE DEL TERRENO
flag_prevalente	1

Usare questi file per estrarre informazioni a partire da un elenco di CIG può essere un po’ farraginoso:

dato un codice CIG - ad esempio 918052266A - non c’è un modo semplice per capire a quale anno e e a quale mese fa riferimento. E quindi bisognerebbe scaricarli uno ad uno e verificare se i CIG di interesse sono presenti;
sono disponibili 16 anni di dataset, quindi circa 200 mesi e 200 file CSV, con milioni di CIG e di righe.

Tramite API

Questa modalità è più complessa, perché richiede alcune conoscenze di base sull’accesso ai dati in modalità adeguate all’estrazione e analisi automatica (la cosiddetta machine to machine), ma è più efficace e comoda.

L’Autorità Nazionale Anticorruzione mette a disposizione delle API per interrogare i suoi dati, a partire da un codice CIG. In particolare è nato per consultare gli smartCIG.

Le API - acronimo di Application Programming Interface (interfaccia di programmazione delle applicazioni) - sono in un certo senso degli indirizzi web speciali, che restituiscono non una pagina web, ma dei dati.

Questo indirizzo web speciale, questo URL ha questa struttura:

https://api.anticorruzione.it/apicig/1.0.0/getSmartCig/numero_cig

Se ad esempio si vogliono ottenere le informazioni relative al CIG 918052266A associato al CUP G34E21000260001, l’URL da utilizzare sarà:
https://api.anticorruzione.it/apicig/1.0.0/getSmartCig/918052266A

Si hanno ancora una volta diverse informazioni, e il formato file è stavolta il JSON (sotto un esempio, fare click per espandere).

Output delle API ANAC, per il CIG 918052266A

{
  "codice_risposta": "NOKSN",
  "stazione_appaltante": {
    "CF_AMMINISTRAZIONE_APPALTANTE": "05678721001",
    "CITTA": "ROMA",
    "CODICE_AUSA": "0000225258",
    "DENOMINAZIONE_AMMINISTRAZIONE_APPALTANTE": "AGENZIA NAZIONALE PER L ATTRAZIONE DEGLI INVESTIMENTI E LO SVILUPPO D IMPRESA S.P.A.",
    "DENOMINAZIONE_CENTRO_COSTO": "CENTRALE DI COMMITTENZA",
    "ID_CENTRO_COSTO": "33986B12-6680-4F38-AE62-C734375E3060",
    "INDIRIZZO": "VIA CALABRIA 46",
    "ISTAT_COMUNE": "012058091",
    "REGIONE": "LAZIO",
    "SEZIONE_REGIONALE": "SEZIONE REGIONALE CENTRALE"
  },
  "pubblicazioni": {
    "DATA_CREAZIONE": "2022-04-08",
    "DATA_PUBBLICAZIONE": "2022-04-11"
  },
  "bando": {
    "CIG": "918052266A",
    "COD_MODALITA_REALIZZAZIONE": "17",
    "COD_MOTIVO_URGENZA": 0,
    "COD_STRUMENTO_SVOLGIMENTO": 5,
    "COD_TIPO_SCELTA_CONTRAENTE": "1",
    "CPV": [
      {
        "COD_CPV": "71315400-3",
        "DESCRIZIONE_CPV": "SERVIZI DI COLLAUDO E VERIFICA DI EDIFICI",
        "FLAG_PREVALENTE": 1
      }
    ],
    "CUP": [
      {
        "CUP": "C81B21003510001"
      },
      {
        "CUP": "C84E21000290001"
      },
      {
        "CUP": "C87H21000520001"
      },
      {
        "CUP": "C87H21000530001"
      },
      {
        "CUP": "C87H21000540001"
      },
      {
        "CUP": "G31B21000770001"
      },
      {
        "CUP": "G34E21000150001"
      },
      {
        "CUP": "G34E21000230001"
      },
      {
        "CUP": "G34E21000240001"
      },
      {
        "CUP": "G34E21000250001"
      },
      {
        "CUP": "G34E21000260001"
      },
      {
        "CUP": "H38I19000070001"
      },
      {
        "CUP": "H39J18000210001"
      },
      {
        "CUP": "H39J19000990001"
      },
      {
        "CUP": "I98I21000110001"
      },
      {
        "CUP": "I99J21000460001"
      }
    ],
    "DATA_SCADENZA_OFFERTA": "2022-05-26",
    "DENOMINAZIONE_SA_DELEGANTE": "LICIS - A.B.C. - STRADE SOCIETÀ CONSORTILE A RESPONSABILITÀ LIMITATA",
    "DENOMINAZIONE_SA_DELEGATA": "LICIS - A.B.C. - STRADE SOCIETÀ CONSORTILE A RESPONSABILITÀ LIMITATA",
    "DETTAGLIO_STATO": {
      "DATA_ULTIMO_PERFEZIONAMENTO": "2022-05-24"
    },
    "DURATA_PREVISTA": 1220,
    "FLAG_ESCLUSO": 0,
    "FLAG_PREV_RIPETIZIONI": 0,
    "FLAG_URGENZA": 0,
    "IMPORTO_COMPLESSIVO_GARA": 23569628.59,
    "IMPORTO_LOTTO": 3987864.4,
    "IMPORTO_SICUREZZA": 0,
    "IPOTESI_COLLEGAMENTO": {
      "COD_IPOTESI_COLLEGAMENTO": 10
    },
    "LUOGO_NUTS": "ITF6",
    "MODALITA_REALIZZAZIONE": "Accordo quadro",
    "N_LOTTI_COMPONENTI": "7",
    "NUMERO_GARA": "8519126",
    "OGGETTO_GARA": "PROCEDURA DI GARA APERTA AI SENSI DEGLI ARTT. 54 E 60 DEL D.LGS. N. 50/2016, DA REALIZZARSI MEDIANTE PIATTAFORMA TELEMATICA, PER LA CONCLUSIONE DI ACCORDI QUADRO CON PIU’ OPERATORI ECONOMICI PER L’AFFIDAMENTO DI LAVORI (OG1 – OG11) E SERVIZI DI INGEGNERIA E ARCHITETTURA (E.21 – E.06 – S.03 – IA.02 – IA.04) PER LA NUOVA EDIFICAZIONE, RISTRUTTURAZIONE E RIQUALIFICAZIONE DI EDIFICI PUBBLICI RESIDENZIALI E NON.",
    "OGGETTO_LOTTO": "ACCORDO QUADRO OG1 - OG11 - SUB - LOTTO PRESTAZIONALE 1 – SERVIZI DI DI COLLAUDO  - LOTTO GEOGRAFICO: CALABRIA - SICILIA",
    "OGGETTO_PRINCIPALE_CONTRATTO": "SERVIZI",
    "SETTORE": "Settori Ordinari",
    "STATO": "ATTIVO",
    "STRUMENTO_SVOLGIMENTO": "Procedure svolte attraverso piattaforme telematiche di negoziazione Art.58",
    "TIPO_CIG": "Ordinario",
    "TIPO_SCELTA_CONTRAENTE": "Procedura aperta"
  },
  "incaricati": [
    {
      "COD_RUOLO": "14",
      "CODICE_FISCALE": "MSTGCR74D19B354U",
      "COGNOME": "MASTINU",
      "DESCRIZIONE_RUOLO": "Responsabile Unico del procedimento",
      "NOME": "GIANCARLO"
    }
  ]
}

A partire da un elenco di CIG di proprio interesse, si dovrà per ciascuno utilizzare queste API di ANAC. Sono richieste quindi delle conoscenze per sapere leggere il formato JSON, analizzarlo e trasformarlo, così come delle conoscenze per costruire procedure automatiche per interrogare delle API (se i CIG sono 1000, è impensabile fare 1000 click su 1000 URL e salvare il risultato).

Le API forniscono un codice di risposta:

OK, smartCIG trovato;
NOKSN, il CIG è stato trovato ma è un CIG ordinario;
NOKCN, il CIG non è stato trovato;
KO, il CIG non è nè uno smartCIG, nè un CIG. Non è stato trovato.

Torna in cima