{
    "openapi": "3.0.2",
    "tags": [
        {
            "name": "Gare",
            "description": "Operazioni sulle gare della piattaforma"
        }
    ],
    "components": {
        "schemas": {
            "gara": {
                "title": "Schema gara",
                "type": "object",
                "required": [
                    "modalita",
                    "tipologia",
                    "oggetto",
                    "codice_ente"
                ],
                "properties": {
                    "codice": {
                        "type": "integer",
                        "description": "Codice della gara, impostare 0 o null per nuovo gara (o utilizzare il riferimentoEsterno)"
                    },
                    "riferimentoEsterno": {
                        "type": "string",
                        "description": "Codice della gara su gestionale esterno  (o utilizzare il codice)"
                    },
                    "modalita": {
                        "type": "string",
                        "description": "Modalità di gestione della gara ",
                        "enum": []
                    },
                    "tipologia": {
                        "type": "string",
                        "description": "Marco-Tipologia merceologica del gara: ",
                        "enum": []
                    },
                    "procedura": {
                        "type": "string",
                        "description": "Procedura di scelta del contraente: ",
                        "enum": []
                    },
                    "importi": {
                        "type": "object",
                        "description": "Data inizio gara",
                        "format": "date",
                        "required": [
                            "tipologia",
                            "importoBase",
                            "importoOneri"
                        ],
                        "properties": {
                            "tipologia": {
                                "type": "string",
                                "enum": []
                            },
                            "importoBase": {
                                "type": "number",
                                "description": "Importo base d'asta"
                            },
                            "importoOneri": {
                                "type": "number",
                                "description": "Oneri non ribassabili"
                            }
                        }
                    },
                    "sommeDisposizione": {
                        "type": "number",
                        "description": "Somme a disposizione nell'appalto"
                    },
                    "rinnoviOpzioni": {
                        "type": "number",
                        "description": "Rinnovi ed ulteriori opzioni"
                    },
                    "oggetto": {
                        "type": "string",
                        "description": "Oggetto del gara"
                    },
                    "codice_pec": {
                        "type": "integer",
                        "description": "Identificativo dell'indirizzo PEC da utilizzare per le comunicazioni"
                    },
                    "codice_ente": {
                        "type": "integer",
                        "description": "Identificativo del beneficiario del gara"
                    },
                    "cpvs": {
                        "type": "array",
                        "items": {
                            "allOf": [
                                {
                                    "type": "string",
                                    "description": "codice CPV completo"
                                }
                            ]
                        }
                    },
                    "extra": {
                        "type": "object",
                        "description": "Informazioni aggiuntive sull'appalto",
                        "required": [
                            "normaRiferimento",
                            "concessione",
                            "settore"
                        ],
                        "properties": {
                            "normaRiferimento": {
                                "type": "string",
                                "description": "",
                                "enum": []
                            },
                            "concessione": {
                                "type": "string",
                                "description": "Concessione",
                                "enum": [
                                    "Si",
                                    "No"
                                ]
                            },
                            "settore": {
                                "type": "string",
                                "description": "Settore di riferimento dell'appalto",
                                "enum": [
                                    "ordinario",
                                    "speciale",
                                    "difesa"
                                ]
                            },
                            "provvedimentoIndizione": {
                                "type": "string",
                                "description": "Estremi del provvedimento di indizione"
                            },
                            "dataProvvedimentoIndizione": {
                                "type": "string",
                                "format": "YYYY-MM-DD",
                                "description": "Data del provvedimento di indizione"
                            },
                            "nuts": {
                                "type": "string",
                                "description": "Codice NUTS dell'appalto"
                            },
                            "strutturaProponente": {
                                "type": "string",
                                "description": "Struttura proponente"
                            },
                            "responsabileStruttura": {
                                "type": "string",
                                "description": "Responsabile della struttura"
                            },
                            "estremiProgetto": {
                                "type": "string",
                                "description": "Estremi del progetto"
                            },
                            "soggettoApprovatore": {
                                "type": "string",
                                "description": "Soggetto approvatore del progetto"
                            },
                            "dataApprovazioneProgetto": {
                                "type": "string",
                                "format": "YYYY-MM-DD",
                                "description": "Data di approvazione del progetto"
                            }
                        }
                    }
                }
            },
            "lotto": {
                "title": "Schema Lotto",
                "type": "object",
                "required": [
                    "oggetto",
                    "descrizione",
                    "criterio",
                    "modalitaOfferta",
                    "importoBase",
                    "importoManodopera",
                    "oneriNoRibasso",
                    "importoOpzioni",
                    "cpv"
                ],
                "properties": {
                    "codice": {
                        "type": "integer",
                        "description": "Codice del lotto, impostare 0 o null per nuovo lotto (o utilizzare il riferimentoEsterno)"
                    },
                    "riferimentoEsterno": {
                        "type": "string",
                        "description": "Codice del lotto su gestionale esterno (o utilizzare il codice)"
                    },
                    "codice_gara": {
                        "type": "integer",
                        "description": "Codice della gara a cui è collegato il lotto (o utilizzare il riferimentoEsternoGara)"
                    },
                    "riferimentoEsternoGara": {
                        "type": "string",
                        "description": "Riferimento sul gestionale esterno della gara a cui è collegato il lotto (o utilizzare il codice_gara)"
                    },
                    "cup": {
                        "type": "string",
                        "description": "Codice CUP legato al lotto",
                        "minLength": 15,
                        "maxLength": 15
                    },
                    "cig": {
                        "type": "string",
                        "description": "Codice CIG del lotto",
                        "minLength": 10,
                        "maxLength": 10
                    },
                    "criterio": {
                        "type": "string",
                        "description": "Criterio con cui sarà aggiudicato il lotto - prezzo: Solo Prezzo | vantaggiosa: Qualità Prezzo",
                        "enum": [
                            "prezzo",
                            "vantaggiosa"
                        ]
                    },
                    "formato": {
                        "type": "string",
                        "description": "Formato dell'offerta - ribasso: Ribasso percentuale | rialzo: Rialzo percentuale | assoluto: Ribasso assoluto | r-assoluto: Rialzo Assoluti | nulla: Non prevista ",
                        "enum": [
                            "ribasso",
                            "rialzo",
                            "assoluto",
                            "r-assoluto",
                            "nulla"
                        ]
                    },
                    "oggetto": {
                        "type": "string",
                        "description": "Oggetto sintetico del lotto"
                    },
                    "descrizione": {
                        "type": "string",
                        "description": "Descrizione approfondita del lotto"
                    },
                    "importoBase": {
                        "type": "number",
                        "description": "Importo Base"
                    },
                    "importoManodopera": {
                        "type": "number",
                        "description": "Importo Manodopera"
                    },
                    "oneriNoRibasso": {
                        "type": "number",
                        "description": "Oneri non soggetti a ribasso"
                    },
                    "importoOpzioni": {
                        "type": "number",
                        "description": "importo Opzioni e/o Rinnovi"
                    },
                    "cpv": {
                        "type": "string",
                        "description": "Codice CPV del lotto"
                    }
                }
            },
            "incaricato": {
                "title": "Schema Lotto",
                "type": "object",
                "required": [
                    "ruolo",
                    "codiceFiscale",
                    "extra"
                ],
                "properties": {
                    "codiceFiscale": {
                        "type": "string",
                        "description": "Codice fiscale dell'incaricato",
                        "minLength": 16,
                        "maxLength": 16
                    },
                    "ruolo": {
                        "type": "string",
                        "description": "Ruolo dell'incaricato",
                        "enum": []
                    },
                    "codice_gara": {
                        "type": "integer",
                        "description": "Codice della gara a cui è collegato il lotto (o utilizzare il riferimentoEsternoGara)"
                    },
                    "riferimentoEsternoGara": {
                        "type": "string",
                        "description": "Riferimento sul gestionale esterno della gara a cui è collegato il lotto (o utilizzare il codice_gara)"
                    },
                    "extra": {
                        "type":"object",
                        "required": [
                            "nome",
                            "cognome"
                        ],
                        "properties": {
                            
                            "nome": {
                                "type": "string",
                                "description": "Nome dell'incaricato",
                                "maxLength": 50
                            },
                            "cognome": {
                                "type": "string",
                                "description": "Cognome dell'incaricato",
                                "maxLength": 50
                            },
                            "attoNomina": {
                                "type": "string",
                                "description": "Estremi dell'atto di nomina"
                            },
                            "dataAttoNomina": {
                                "type": "string",
                                "description": "Data dell'atto di nomina",
                                "format": "YYYY-MM-DD"
                            },
                            "telefono": {
                                "type": "string",
                                "description": "Recapito telefonico dell'incaricato"
                            },
                            "email": {
                                "type": "string",
                                "description": "Indirizzo e-mail dell'incaricato"
                            },
                            "fax": {
                                "type": "string",
                                "description": "Recapito fax dell'incaricato"
                            },
                            "indirizzo": {
                                "type": "string",
                                "description": "Indirizzo di residenza dell'incaricato"
                            },
                            "comune": {
                                "type": "string",
                                "description": "Comune di residenza dell'incaricato"
                            },
                            "cap": {
                                "type": "string",
                                "description": "CAP del comune di residenza dell'incaricato"
                            }
                        }
                    }
                }
            },
            "documentoOfferta": {
                "type": "object",
                "properties": {
                    "codice": {
                        "type": "integer",
                        "description": "Identificativo unico del documento d'offerta",
                        "example": 1
                    },
                    "titolo": {
                        "type": "string",
                        "description": "Titolo oggetto della richiesta del documento presentato dal partecipante",
                        "example": "Titolo richiesta"
                    },
                    "nomeFile": {
                        "type": "string",
                        "description": "Nome fisico del file",
                        "example": "busta-a.zip.p7m"
                    },
                    "mime": {
                        "type": "string",
                        "description": "MIME type del file",
                        "example": "octet/stream"
                    },
                    "type": {
                        "type": "string",
                        "description": "Tipologia di documento presentato (originale o emendamento)",
                        "enum": [
                            "originale",
                            "emendamento"
                        ],
                        "example": "originale"
                    }
                }
            },
            "buste": {
                "type": "object",
                "properties": {
                    "amministrativa": {
                        "type": "array",
                        "description": "Lista di documenti amministrativi",
                        "items": {
                            "$ref": "#/components/schemas/documentoOfferta"
                        }
                    },
                    "tecnica": {
                        "type": "array",
                        "description": "Lista di documenti tecnica",
                        "items": {
                            "$ref": "#/components/schemas/documentoOfferta"
                        }
                    },
                    "economica": {
                        "type": "array",
                        "description": "Lista di documenti economici",
                        "items": {
                            "$ref": "#/components/schemas/documentoOfferta"
                        }
                    }
                }
            }
        }
    },
    "paths": {
        "/gare/store": {
            "post": {
                "description": "Crea o aggiorna un gara",
                "tags": [
                    "Gare"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/gara"
                            }
                        },
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "$ref": "#/components/schemas/gara"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Richiesta effettuata con successo",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/standardResponse"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gare/lotti/store": {
            "post": {
                "description": "Crea o aggiorna un lotto di gara",
                "tags": [
                    "Gare"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/lotto"
                            }
                        },
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "$ref": "#/components/schemas/lotto"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Richiesta effettuata con successo",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/standardResponse"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gare/incaricati/store": {
            "post": {
                "description": "Crea o aggiorna un incaricato di gara",
                "tags": [
                    "Gare"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/incaricato"
                            }
                        },
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "$ref": "#/components/schemas/incaricato"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Richiesta effettuata con successo",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/standardResponse"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gare/attach": {
            "post": {
                "description": "Allega un documento alla gara",
                "tags": [
                    "Gare"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "required": [
                                    "data",
                                    "file"
                                ],
                                "type": "object",
                                "properties": {
                                    "data": {
                                        "type": "object",
                                        "required": [
                                            "riferimentoEsterno",
                                            "sha256",
                                            "titolo",
                                            "nomefile",
                                            "mime"
                                        ],
                                        "properties": {
                                            "riferimentoEsterno": {
                                                "type": "string",
                                                "description": "Codice del'allegato su gestionale esterno"
                                            },
                                            "codice_gara": {
                                                "type": "integer",
                                                "description": "Codice della gara a cui è collegato il lotto (o utilizzare il riferimentoEsternoGara)"
                                            },
                                            "riferimentoEsternoGara": {
                                                "type": "string",
                                                "description": "Riferimento sul gestionale esterno della gara a cui è collegato il lotto (o utilizzare il codice_gara)"
                                            },
                                            "sha256": {
                                                "type": "string",
                                                "description": "Hash del file con SHA-256"
                                            },
                                            "titolo": {
                                                "type": "string",
                                                "description": "Titolo del file"
                                            },
                                            "nomeFile": {
                                                "type": "string",
                                                "description": "Nome fisico del file"
                                            },
                                            "mime": {
                                                "type": "string",
                                                "description": "MIME Type del file"
                                            }
                                        }
                                    },
                                    "file": {
                                        "type": "string",
                                        "format": "binary"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Richiesta effettuata con successo",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/standardResponse"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gare/complete-create": {
            "post": {
                "description": "Chiude la fase di creazione della gara",
                "tags": [
                    "Gare"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "codice_gara": {
                                        "type": "integer",
                                        "description": "Codice di riferimento del gara (da usare in alternativa al riferimentoEsterno)"
                                    },
                                    "riferimentoEsterno": {
                                        "type": "string",
                                        "description": "Riferimento esterno al gara"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Richiesta effettuata con successo",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "$ref": "#\/components\/schemas\/standardResponse"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/gare/bustePartecipanti": {
            "get": {
                "description": "Ottiene l'elenco delle buste presentate dai partecipanti",
                "tags": [
                    "Gare"
                ],
                "parameters": [
                    {
                        "in": "query",
                        "name": "codice_lotto",
                        "description": "Codice del lotto o del riferimento del lotto sul gestionale esterno",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "in": "query",
                        "name": "codice_fase",
                        "description": "Codice della fase o riferimento alla fase sul gestionale esterno",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "in": "query",
                        "name": "codice_partecipante",
                        "description": "Codice del partecipante",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Ottiene l'elenco delle buste",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/buste"
                                }
                            }
                        }
                    }
                }       
            }
        },
        "/gare/downloadBusta": {
            "get": {
                "description": "Ottiene un documento presentato dal partecipante",
                "tags": [
                    "Gare"
                ],
                "parameters": [
                    {
                        "in": "query",
                        "name": "codice_lotto",
                        "description": "Codice del lotto o del riferimento del lotto sul gestionale esterno",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "in": "query",
                        "name": "codice_fase",
                        "description": "Codice della fase o riferimento alla fase sul gestionale esterno",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "in": "query",
                        "name": "codice_partecipante",
                        "description": "Codice del partecipante",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "in": "query",
                        "name": "codice_documento",
                        "description": "Codice del documento",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    },
                    {
                        "in": "query",
                        "name": "type",
                        "description": "Tipologia di documento",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Ottiene l'elenco delle buste",
                        "content": {
                            "multipart/form-data": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "riferimentoEsterno": {
                                                    "type": "string",
                                                    "description": "Codice del'allegato su gestionale esterno"
                                                },
                                                "codice_gara": {
                                                    "type": "integer",
                                                    "description": "Codice della gara a cui è collegato il lotto (o utilizzare il riferimentoEsternoGara)"
                                                },
                                                "riferimentoEsternoGara": {
                                                    "type": "string",
                                                    "description": "Riferimento sul gestionale esterno della gara a cui è collegato il lotto (o utilizzare il codice_gara)"
                                                },
                                                "sha256": {
                                                    "type": "string",
                                                    "description": "Hash del file con SHA-256"
                                                },
                                                "titolo": {
                                                    "type": "string",
                                                    "description": "Titolo del file"
                                                },
                                                "nomeFile": {
                                                    "type": "string",
                                                    "description": "Nome fisico del file"
                                                },
                                                "mime": {
                                                    "type": "string",
                                                    "description": "MIME Type del file"
                                                }
                                            }
                                        },
                                        "file": {
                                            "type": "string",
                                            "format": "binary"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }       
            }
        }
    }
}