Skip to main content

6.3 WS2 per Invio Esito GDL

Per ogni transazione, si avrà una comunicazione sul WS 2 in risposta ala richiesta dell'operatore, evento che definisce l'esito della  Transazione e riporta l'eventuale errore per cui la tratta è andata in 'KO'.
Il WS esposto sarà di tipo RESTful, metodo HTTP POST, raggiungibile tramite il seguente URL:

 

La struttura dell’oggetto json inserito nel body dell'invio del WS 2 dovrà essere analoga alla seguente:

{
    "id_transaction":1234,
    "tratta_g4w": [ 
        {
            "nome_tratta": "ABI2ARIELLI00000" ,
            "esito_tratta": "KO",
            "giornate":[
                {
                        "data_gl": "2023-02-06",
                        "esito": "OK",
                        "motivazione": ""
                }
                {
                        "data_gl": "2023-02-07",
                        "esito": "OK",
                        "motivazione": "Inserimento mezzi"
                }
                {
                        "data_gl": "2023-02-08",
                        "esito": "KO",
                        "motivazione": "Superamento ore Lavoratore,Ore Archeologo non compatibili,ecc"
                }
                {
                        "data_gl": "2023-02-09",
                        "esito": "Non Inserito",
                        "motivazione": "Giornata presente e approvata DL"
                }
            ]
        }
    ]
}

 

  Tipologia Campo Lunghezza max Obbligatorio Valori
id_transaction Testo 50 SI
nome_tratta Testo 100 SI
esito_tratta Bool 2 SI 'ok/ko'
data_gl Date 10 SI
esito Bool 2 SI 'ok/ko'
motivazione Testo 200 SI

Il WS esposto restituirà un HTTP CODE “200”. Dopo aver effettuato dei controlli sui dati ricevuti, GISFO ne dettaglierà l’esito all’interno del body JSON della risposta, che sarà strutturata come riportato di seguito. 

{
    “id_transaction”: “1234”,
    “result”: “KO”,
    “error_code”: “ERR_400_Bad Request”,
    “message”: ” La richiesta non può essere soddisfatta a causa di errori di sintassi.”

}

  Tipologia Campo Lunghezza max Obbligatorio Valori
id_transaction Testo 50 SI
result Bool 2 SI 'ok/ko'
error_code Testo  50 SI
message Testo 100 SI

Di seguito è riportato l’elenco dei controlli previsti per cui verrà restituito l'errore 'ERR_400_Bad Request':

 
  1. La tipologia di campo non è quella ammessa dalla tabella della caratteristiche json Riquest;
  2. La lunghezza del campo non è quella ammessa dalla tabella della caratteristiche json Riquest;
  3. Un campo obbligatorio non è stato popolato
  4.  Un campo non è conforme con le pick list condivise