API


WebService SOAP raggiungibile all'indirizzo /api-legacy/service.php?WSDL per l'estrazione delle le gare dell'ente, con possibilità di applicare filtri tramite uno o più parametri. La risposta del WebService sarà in formato JSON

Struttura JSON risposta 
                  [
                    {
                      "gara": {
                        "data_pubblicazione": "2022-03-31 09:49:00",
                        "data_accesso": "2022-04-01 09:49:00",
                        "data_scadenza": "2022-04-02 09:49:00",
                        "data_apertura": "2022-04-03 09:49:00",
                        "codice": "166",
                        "codice_ente": "1",
                        "codice_gestore": "1",
                        "id": "53",
                        "stato": "3",
                        "numero_atto_indizione": " ",
                        "data_atto_indizione": " ",
                        "estremi_progetto": " ",
                        "data_validazione": " ",
                        "validatore": " ",
                        "rup": "Rossi Mario",
                        "struttura_proponente": " ",
                        "responsabile_struttura": " ",
                        "oggetto": "Gara test",
                        "descrizione": "",
                        "somme_disponibili": "0.00",
                        "prezzoBase": "14635778.00000000000",
                        "nuts": "IT",
                        "flag_gestione_autonoma": "",
                        "url": "/gare/dettaglio.php?codice=166",
                        "tipologia": 1,
                        "procedura": 1,
                        "modalita": 1,
                        "numero_atto_seggio": "",
                        "data_atto_seggio": "",
                        "numero_atto_commissione": "",
                        "data_atto_commissione": ""
                      },
                      "lotti": [
                        {
                          "codice": "164",
                          "cig": null,
                          "cup": null,
                          "importo_base": "14635778.00000000000",
                          "importo_oneri_ribasso": 0,
                          "importo_oneri_no_ribasso": "0.00000000000",
                          "importo_personale": "0.00000000000",
                          "importoAggiudicazione": null,
                          "numero_atto_esito": null,
                          "partecipanti": [
                              {
                                  "codice": "1",
                                  "codice_fiscale": "00000000000",
                                  "partita_iva": "00000000000",
                                  "codice_operatore": "1",
                                  "ragione_sociale": "AZIENDA DUMMY 0",
                                  "pec": "pec.0@pec.esempio.it",
                                  "email": "email.0@pec.esempio.it",
                                  "primo": "S",
                                  "anomalia": "N",
                                  "anomalia_facoltativa": "N",
                                  "verifica": "N",
                                  "escluso": "N",
                                  "ammesso": "S",
                                  "motivazione": null,
                                  "motivazione_anomalia": null,
                                  "tipo": "",
                                  "indirizzo_legale": "Via di test",
                                  "citta_legale": "Macerata",
                                  "provincia_legale": "MC",
                                  "regione_legale": "Marche",
                                  "stato_legale": "IT",
                                  "indirizzo_operativa": "Via di test",
                                  "citta_operativa": "Macerata",
                                  "provincia_operativa": "MC",
                                  "regione_operativa": "Marche",
                                  "stato_operativa": "IT"
                              }
                          ]
                        }
                      ],
                      "cpv": {
                        "0311": {
                          "id": "3",
                          "codice": "0311",
                          "codice_completo": "03110000-5",
                          "IT": "Prodotti agricoli, prodotti dell'ortofrutticoltura commerciale",
                          "BG": "Продукти на растениевъдството; живи животни и продукти от тях",
                          "CS": "Produkty rostlinné výroby v zelinářství a zahradnictví",
                          "DA": "Markafgrøder, gartneri- og havebrugsprodukter",
                          "DE": "Feldfrüchte und Erzeugnisse des Erwerbsgartenbaus",
                          "EL": "Φυτά και προϊόντα μεγάλης καλλιέργειας και κηπευτικά είδη",
                          "EN": "Crops, products of market gardening and horticulture",
                          "ES": "Cultivos, productos comerciales de jardinería y horticultura",
                          "ET": "Põllukultuurid, puu- ja köögiviljad ning aiandussaadused",
                          "FI": "Kauppapuutarhoista ja puutarhanhoidosta saadut tuotteet",
                          "FR": "Produits agricoles, produits de la culture maraîchère et de l'horticulture commerciale",
                          "GA": "Crops, products of market gardening and horticulture",
                          "HU": "Termény, bolgárkertészeti és kertészeti termék",
                          "LT": "Žemės ūkio augalai, prekinės daržininkystės ir sodininkystės produktai",
                          "LV": "Augkopības, dārzkopības un puķkopības produkcija",
                          "MT": "Uċuħ tar-raba, prodotti mill-ġonna u l-oltikoltura, tas-suq",
                          "NL": "Land- en tuinbouwgewassen en -producten",
                          "PL": "Rośliny uprawne, produkty warzywnictwa i ogrodnictwa",
                          "PT": "Cereais, produtos de culturas industriais e da horticultura",
                          "RO": "Produse agricole, produse horticole şi de grădină pentru comercializare",
                          "SK": "Plodiny, produkty zeleninárstva a záhradníctva",
                          "SL": "Poljščine, proizvodi tržnega sadjarstva in vrtnarstva",
                          "SV": "Grödor, trädgårdshandels- och trädgårdsprodukter"
                        }
                      }
                    }
                  ]


Parametri richiesta
Nome Descrizione Tipo
token* (Obbligatorio) Token di riconoscimento stringa
tipologia Tipologia di gara intero
procedura Procedura intero
codice Codice di gara intero
stato Stato di gara intero
cup CUP intero
cig CIG intero
data Data di interesse Array dateType
typeDate Tipo di data richiesta stringa
startDate Data d'inizio stringa
endDate Data di fine stringa

Vocabolari filtri
$tipologia) { echo << HTML; } ?>
Tipologia
Valore Descrizione
{$codice} {$tipologia}


codice); $procedure = array_column($procedure, "titolo", "codice_api"); ksort($procedure); foreach ($procedure as $codice => $procedura) { echo << HTML; } ?>
Procedura
Valore Descrizione
{$codice} {$procedura}

In merito al codice di gara, il sistema prevede di selezionare una singola gara utilizzando il solo campo codice .
Codice
Valore Descrizione
codice Dettaglio sulla singola gara

Anche per lo stato di gara sarà possibile richiedere un singolo stato. Gli stati di gara consentiti saranno:
Stato
Valore Descrizione
3 Pubblicazione
4 Proposta di Aggiudicazione
5 Verifica anomalie
7 Aggiudicazione Definitiva
8 Inviato Esito di gara
98 Deserta
99 Annullata
100 Non Aggiudicata
101 Conclusa

È prevista la possibilità di selezionare una gara inserendo il numero di CIG o CUP corrispondente.
CIG - CUP
Valore Descrizione
cig Dettaglio sulla gara con il CIG richiesto
cup Dettaglio sulla gara con il CUP richiesto

Riguardo alla data di gara, per selezionare una specifica data sarà necessario definire innanzitutto a quale debba fare riferimento sulla base dei valori proposti nella tabella seguente, poi occorrerà inserire una data di inizio ed una di fine nel formato YYYY-MM-DD . L'inserimento del solo valore typeDate senza le rispettive date verrà ignorato dal sistema.
Data
Valore Descrizione
typeDate
data_pubblicazione Data di pubblicazione
data_accesso Termine accesso agli atti
data_scadenza Scadenza presentazione offerte
data_apertura Apertura delle offerte
startDate Data di inizio (formato YYYY-MM-DD )
endDate Data di fine (formato YYYY-MM-DD )

Questo è un esempio scritto in codice PHP di una richiesta effettuata per questo ente riguardo le gare Lavori in procedura Aperta, modalità tradizionale, pubblicate dal 01/01/2015 al 10/02/2015:
$parameters = array('token' => '{token}', 'tipologia' => '7', 'procedura' => '1', 'modalita' => '1', 'data' => array('typeDate' => 'data_pubblicazione', 'startDate' => '2015-01-01', 'endDate' => '2015-02-10'));
$client = new SoapClient('/api-legacy/service.php?WSDL',array('cache_wsdl' => WSDL_CACHE_NONE));
$response = $client->getGare($parameters);
Struttura JSON risposta 
                [
                  {
                    "bando": {
                      "codice": "23",
                      "codice_ente": "1",
                      "codice_gestore": "1",
                      "id": "22",
                      "stato": 3,
                      "tipologia": "F",
                      "rup": "Rossi Mario",
                      "oggetto": "Albo fornitori test 2021-12-28 12:37:43",
                      "data_pubblicazione": "2021-12-28 12:37:00",
                      "data_scadenza": "2021-12-30 12:37:00",
                      "data_chiarimenti": "2021-12-29 12:37:00"
                    },
                    "cpv": {
                      "0311": {
                        "id": "3",
                        "codice": "0311",
                        "codice_completo": "03110000-5",
                        "IT": "Prodotti agricoli, prodotti dell'ortofrutticoltura commerciale",
                        "BG": "Продукти на растениевъдството; живи животни и продукти от тях",
                        "CS": "Produkty rostlinné výroby v zelinářství a zahradnictví",
                        "DA": "Markafgrøder, gartneri- og havebrugsprodukter",
                        "DE": "Feldfrüchte und Erzeugnisse des Erwerbsgartenbaus",
                        "EL": "Φυτά και προϊόντα μεγάλης καλλιέργειας και κηπευτικά είδη",
                        "EN": "Crops, products of market gardening and horticulture",
                        "ES": "Cultivos, productos comerciales de jardinería y horticultura",
                        "ET": "Põllukultuurid, puu- ja köögiviljad ning aiandussaadused",
                        "FI": "Kauppapuutarhoista ja puutarhanhoidosta saadut tuotteet",
                        "FR": "Produits agricoles, produits de la culture maraîchère et de l'horticulture commerciale",
                        "GA": "Crops, products of market gardening and horticulture",
                        "HU": "Termény, bolgárkertészeti és kertészeti termék",
                        "LT": "Žemės ūkio augalai, prekinės daržininkystės ir sodininkystės produktai",
                        "LV": "Augkopības, dārzkopības un puķkopības produkcija",
                        "MT": "Uċuħ tar-raba, prodotti mill-ġonna u l-oltikoltura, tas-suq",
                        "NL": "Land- en tuinbouwgewassen en -producten",
                        "PL": "Rośliny uprawne, produkty warzywnictwa i ogrodnictwa",
                        "PT": "Cereais, produtos de culturas industriais e da horticultura",
                        "RO": "Produse agricole, produse horticole şi de grădină pentru comercializare",
                        "SK": "Plodiny, produkty zeleninárstva a záhradníctva",
                        "SL": "Poljščine, proizvodi tržnega sadjarstva in vrtnarstva",
                        "SV": "Grödor, trädgårdshandels- och trädgårdsprodukter"
                      }
                    },
                    "allegati": [
                      {
                        "codice": "867",
                        "sezione": "albo_fornitori-public",
                        "nome_file": "report-19.pdf",
                        "titolo": "report-19.pdf",
                        "url": "/allegati/open.php?codice=867&filename=cmVwb3J0LTE5LnBkZg==&sourceID=23&sourceType=YWxib19mb3JuaXRvcmktcHVibGlj&general_connection=0",
                        "timestamp": "2022-03-12 17:18:46"
                      },
                      {
                        "codice": "868",
                        "sezione": "albo_fornitori-public",
                        "nome_file": "immagine2-3.png",
                        "titolo": "immagine2-3.png",
                        "url": "/allegati/open.php?codice=868&filename=aW1tYWdpbmUyLTMucG5n&sourceID=23&sourceType=YWxib19mb3JuaXRvcmktcHVibGlj&general_connection=0",
                        "timestamp": "2022-03-12 17:18:41"
                      }
                    ]
                  }
                ]


Parametri richiesta
Nome Descrizione Tipo
token* (Obbligatorio) Token di riconoscimento stringa
tipologia Tipologia di albo stringa
codice Codice intero

Vocabolari filtri
Tipologia
Valore Descrizione
F Albo di fornitori
P Albo di professionisti
M Manifestazione d'interesse / Indagine di mercato

$parameters = array('token' => '{token}', 'tipologia' => 'M');
$client = new SoapClient('/api-legacy/service.php?WSDL',array('cache_wsdl' => WSDL_CACHE_NONE));
$response = $client->getAlbi($parameters);

Forbidden