Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è...

22
Ministero della Salute Dipartimento della programmazione e dell’ordinamento del Servizio sanitario nazionale Direzione Generale del Sistema Informativo e statistico sanitario Trasmissione dei dati campioni e analisi per vigilanza e controllo alimenti e bevande Specifiche Funzionali dei tracciati SISG_SSW MSW_ALIM_NSA_VIG Pag. 1 di 22 Versione 6.0 SPECIFICHE FUNZIONALI DEI TRACCIATI Flusso vigilanza e controllo alimenti e bevande Febbraio 2017 Versione 6.0

Transcript of Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è...

Page 1: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 1 di 22 Versione 6.0

SPECIFICHE FUNZIONALI

DEI TRACCIATI

Flusso vigilanza e controllo alimenti e bevande

Febbraio 2017 Versione 6.0

Page 2: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 2 di 22 Versione 6.0

Indice

1. Introduzione .............................................................................................................................................3

1.1 Storia del documento ...................................................................................................................3

1.2 Obiettivi del documento ..............................................................................................................4

1.3 Definizioni .........................................................................................................................................4

2. Informazioni Funzionali relative ai Tracciati ................................................................................5

2.1 I tracciati ...........................................................................................................................................5

2.2 Assunzioni di Base .........................................................................................................................5

2.3 Tempi e modalità di invio e di elaborazione ......................................................................6

3. Descrizione funzionale dei Tracciati Record ................................................................................7

3.1 Formato File .....................................................................................................................................7

3.2 Tipo di Dati .......................................................................................................................................7

3.3 Avvertenze Generali per la Valorizzazione dei campi ......................................................7

3.4 Descrizione funzionale dei campi .............................................................................................8

4. Tracciati XML .........................................................................................................................................18

4.1 Controlli, validazione e invio file ............................................................................................18

4.2 Esempi di inserimento/cancellazione dei dati. .................................................................19

4.2.1 Esempio di trasmissione 1: ............................................................................................19

4.2.2 Esempio di trasmissione 2: ............................................................................................20

4.2.3 Esempio di trasmissione 3: ............................................................................................21

4.3 Codici di errore .............................................................................................................................22

5. Allegati ........................................................................................ Errore. Il segnalibro non è definito.

Allegato 1 – Esempio file XML vigilanza ............................. Errore. Il segnalibro non è definito.

Allegato 2 – Schema XSD vigilanza ..................................... Errore. Il segnalibro non è definito.

Allegato 3 – Anagrafi di Riferimento ................................... Errore. Il segnalibro non è definito.

Page 3: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 3 di 22 Versione 6.0

1. Introduzione

1.1 Storia del documento

Versione: Data: Sintesi variazioni:

1.0 15 Novembre2011 Prima versione

2.0 30 Gennaio 2013 Aggiornate descrizioni in 3.4 Aggiornato par. Errore. L'origine

riferimento non è stata trovata.

3.0 28 Aprile 2014 Aggiornamento par. 3.4

3.1 30 Maggio 2014 Aggiornamento par. 4.1 per variazione alla chiave

4.0 13 Gennaio 2015 Aggiornamento par. 3.4 – Aggiornamenti per

inserimento campo numVerbale, rimozione campo regSampSd ed estensione campo

OSAid

5.0 28 Dicembre 2015 Aggiornamento par. 3.4 e par. 4.1 per

variazioni dovute ai nuovi controlli introdotti dall’EFSA per i campioni del 2016 e allo scarto

dell’intero file in presenza di almeno un scarto rispetto ai dati inviati

5.1 31 Marzo 2016 Aggiornato il controllo sul campo

resQualValue – pagina 15

5.2 05 Luglio 2016 Aggiornato il controllo sul campo resLOQ – pagina 13

6.0 15 Febbraio 2017 Aggiornato con le B.R. 2017 e con il nuovo

controllo che scarta i record trasmessi con tipo operazione “I” e con la chiave logica già

presente in banca dati.

Page 4: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 4 di 22 Versione 6.0

1.2 Obiettivi del documento

L’obiettivo del documento è fornire le specifiche tecniche per la trasmissione al Ministero della Salute dei dati dei controlli ufficiali di Vigilanza e controllo degli alimenti

e delle bevande in Italia. I dati dovranno essere trasmessi in formato XML.

1.3 Definizioni

Nella tabella riportata di seguito sono elencati tutti gli acronimi e le definizioni adottate

nel presente documento.

Acronimo /

Riferimento Definizione

EFSA European Food Safety Authority

NSIS Nuovo Sistema Informativo Sanitario

XML eXtensible Markup Language

XSD XML Schema Definition

Page 5: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 5 di 22 Versione 6.0

2. Informazioni Funzionali relative ai Tracciati

2.1 I tracciati

E’ previsto un solo tipo di tracciato per l’invio dei dati dei controlli ufficiali di Vigilanza e

controllo degli alimenti e delle bevande in Italia.

2.2 Assunzioni di Base

1. L’invio dei file deve essere effettuato tramite un tracciato XML. L’XML è un insieme di regole per formulare dei file in formato testo che permettono di strutturare i dati. L’XML rende facile la generazione di dati tramite

un computer, la lettura dei dati e il controllo sulla struttura in modo che non sia ambigua; è estensibile, indipendente dalla piattaforma e supporta i parametri

internazionali e locali. Inoltre è pienamente compatibile con gli standard Unicode.

2. Per ogni tracciato XML, sarà fornito il relativo documento XSD di

convalida a cui far riferimento; questo consentirà la lettura dei dati secondo uno specifico tracciato.

L’XSD è Il linguaggio che specifica le caratteristiche del tipo di documento attraverso una serie di "regole grammaticali". In particolare definisce l'insieme degli elementi del documento XML, le relazioni gerarchiche tra gli elementi,

l'ordine di apparizione nel documento XML e quali elementi e quali attributi sono opzionali o meno.

3. I file in formato XML, prima dell’invio al sistema, potranno essere compressi nei formati ZIP o GZIP.

L’invio di file compressi deve rispettare le seguenti regole: Il file compresso deve contenere un solo file XML dati al proprio interno

(NON è ammessa la presenza, all’interno del file compresso, di cartelle e/o

più file). I file compressi di tipo ZIP dovranno essere compressi secondo l’algoritmo

definito dallo standard “DEFLATE”. I file compressi di tipo ZIP, dovranno avere l’estensione “.zip”. E’

indifferente il maiuscolo o minuscolo.

I file compressi di tipo GZIP, dovranno avere l’estensione “.gz”. E’ indifferente il maiuscolo o minuscolo.

Qualora il file non rispettasse tali regole verrà restituito un messaggio di errore in fase di upload dello stesso.

Ulteriori assunzioni di base che riguardano verranno enunciate nella descrizione del tracciato stesso.

Page 6: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 6 di 22 Versione 6.0

2.3 Tempi e modalità di invio e di elaborazione

L’invio dei dati dei controlli ufficiali di Vigilanza e controllo degli alimenti e delle bevande in Italia relativi all’anno X è consentito dal 1 gennaio dell’anno X fino al 31

gennaio X+1 (Es: l’invio dei dati relativi all’anno 2012 è possibile dal 01/01/2012 fino al 31/01/2013) mentre la validazione dei dati sarà consentita fino al 28 febbraio dell’anno X+1.

L’invio dei file avviene attraverso la funzionalità “invio flussi” del sistema “Gestione

Accoglienza Flussi” (GAF). Gli esiti di elaborazione sono resi disponibili dopo circa 4 ore e sono consultabili

attraverso la funzionalità “Trasmissione dati > Visualizza Esiti Elaborazione” del NUOVO SISTEMA ALIMENTI- Flusso Vigilanza.

Il Sistema invia una mail di notifica

Page 7: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 7 di 22 Versione 6.0

3. Descrizione funzionale dei Tracciati Record

3.1 Formato File

I file da inviare al Ministero della Salute devono essere in formato XML versione 1.0.

Lo schema XSD del flusso è presente in par. Errore. L'origine riferimento non è stata trovata. - Allegati.

I file XML che non rispettano le caratteristiche dello schema XSD saranno scartati dal sistema (esito “XSD non rispettato”). Se i controlli formali e di dominio rilevano record scorretti, il file verrà scartato.

3.2 Tipo di Dati

Il tracciato XML sarà formato dai seguenti componenti: • “ELEMENT” che possono contenere a loro volta altri Element o valori espliciti (non

codificati) • “ELEMENT” con attributi, il cui valore, in genere, appartiene a un insieme già predefinito.

3.3 Avvertenze Generali per la Valorizzazione dei campi

Tutti i campi indicati come obbligatori sono vincolanti per il caricamento del record.

I campi data devono essere espressi nel formato YYYY-MM-DD (conforme alle specifiche W3C) dove:

YYYY rappresenta l’anno MM rappresenta il mese DD rappresenta il giorno

Esempio:

2005-02-01 corrisponde al 1 febbraio 2005. I campi decimali prevedono come separatore decimale il punto “.”. Gli eventuali campi opzionali possono non essere trasmessi o trasmessi vuoti

(apertura e chiusura ELEMENT)

Page 8: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 8 di 22 Versione 5.2

3.4 Descrizione funzionale dei campi

Nella seguente tabella sono descritti i campi contenuti nel tracciato con la seguente legenda:

- T: tipo di campo

- L: lunghezza

- O: obbligatorietà (in alcuni casi il campo è obbligatorio solo se un altro campo assume particolari valori, nel caso vi è una

nota a piè di pagina esplicativa)

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

regCode Codice Regione F.01

Codice che identifica la

Regione in cui si effettua il prelievo del campione.

Valori ammessi:

sheet REGIONI del file XLS “Anagrafi di riferimento”.

string(3) X

flType Tipo Flusso F.02 Codice che identifica il tipo di flusso.

Unico valore ammesso:

- “VIG” (flusso vigilanza e controllo alimenti e bevande).

string(3) X

opType Tipo Operazione F.03 Codice che identifica il tipo di operazione da effettuare.

Valori ammessi: - I inserimento

- C cancellazione

string(1) X

labCode Codice del laboratorio L.01 Codice del laboratorio che ha competenza territoriale nel

luogo di campionamento.

Valori ammessi: sheet LABORATORI del file

XLS “Anagrafi di riferimento”.

string(100) X

labAccred Accreditamento del Laboratorio

L.02 Accreditamento del laboratorio ad ISO/IEC 17025.

Valori ammessi: sheet LABACC del file XLS “Anagrafi di riferimento”.

string(5)

Page 9: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 9 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

labSampleCode Codice del campione di Laboratorio

S.01 Codice alfanumerico del campione analizzato assegnato dal laboratorio.

Concatenazione di

ANNO + CODICE LABORATORIO + PROGRESSIVO CAMPIONE (es: 2017_I0100000_00001)

string(30) X

labSubSampCode Numero di sub

campioni analizzati S.02

Numero di sub-campioni

analizzati. Il valore di Default è 1. decimal(4) X1

origCountry Nazione di origine del prodotto

S.06 Codice che identifica la nazione di origine del prodotto campionato.

Valori ammessi: sheet COUNTRY del file XLS “Anagrafi di riferimento”.

string(2) X

origReg

Regione di origine del prodotto

REG

Codice Regione di origine del prodotto campionato.

Valori ammessi: sheet REGIONI del file XLS “Anagrafi di riferimento”.

string(3)

prodCode Codice Prodotto S.13 Codice che identifica il

prodotto.

Valori ammessi: sheet FOODEX e FOODEX_MOCA del file XLS “Anagrafi di riferimento”.

Se il codice del prodotto non è presente nella lista, il campo deve essere valorizzato con

“XXXXXXA”.

string(20) X

1 Obbligatorio se il campo progCode (S31) è uguale a “VIG002AL” o “VIG005AL” (criteri microbiologici o micotossine).

Page 10: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 10 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

prodText Descrizione del prodotto

S.14 Descrizione di dettaglio del prodotto.

string(250) X2

prodProdMeth Metodo di produzione S.15 Codice identificativo del metodo di produzione.

Valori ammessi: sheet PRODMD del file XLS

“Anagrafi di riferimento”.

string(5)

prodPack Confezionamento del prodotto

S.16 Codice relativo al tipo di confezionamento del prodotto.

Valori ammessi:

sheet PRODPAC del file XLS “Anagrafi di riferimento”.

string(5)

prodTreat

Trattamento e

processi utilizzati per la produzione

S.17

Codice che fornisce informazioni sui trattamenti e processi utilizzati per la produzione.

Valori ammessi:

sheet PRODTR del file XLS “Anagrafi di riferimento”.

string(5) X

prodCom Informazioni aggiuntive sul

prodotto

S.21 Informazioni addizionali del prodotto, se disponibili.

Testo libero tranne per il flusso additivi - Valori ammessi: sheet UE1129 del file XLS “Anagrafi di riferimento”.

string(250) X3

sampDate Data prelievo S.28-S.29-

S.30 Data in cui è stato prelevato il campione.

Formato YYYY-MM-DD date(10) X

2 Obbligatorio se prodCode è valorizzato con “XXXXXXA” oppure se il campo progCode (S31) è uguale a “VIG005AL” 3 Campo obbligatorio solo nel flusso additivi, utile all’inserimento del codice indicato sul regolamento UE1129 (vedi Piano Nazionale Additivi)

Page 11: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 11 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

progCode Identificativo del sottogruppo di dati.

S.31 Codice identificativo del sottogruppo di dati nell’ambito

del flusso VIG.

Valori ammessi: sheet PROGCODE del file XLS

“Anagrafi di riferimento”.

string(20) X

progLegalRef Normativa di riferimento

S.32 Normativa di riferimenti per l’analisi effettuata.

Testo libero. string(100)

progSampStrategy Strategia di campionamento

S.33 Strategia utilizzata per il campionamento del prodotto.

Valori ammessi:

sheet SAMPSTR del file XLS “Anagrafi di riferimento”.

string(5) X

progType Tipo di programma S.34 Tipo di programma in cui il campione è stato prelevato.

Unici valori ammessi: “K005A” - Official National Programme “K022A” - Monitoring

string(5) X

sampMethod Metodo di campionamento

S.35 Codice che descrive il metodo di campionamento.

Valori ammessi:

sheet SAMPMD del file XLS “Anagrafi di riferimento”.

string(5) X

sampPoint Punto di campionamento

S.39

Punto della filiera di

produzione in cui il campione è stato prelevato.

Valori ammessi:

sheet SAMPNT_VIG del file XLS “Anagrafi di riferimento”.

string(10) X

analysisDate Data analisi R.02-R.03-

R.04 Data di inizio delle analisi Formato YYYY-MM-DD Date(10) X

Page 12: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 12 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

paramCode Analiti R.06 Codice identificativo degli

analiti.

Valori ammessi:

sheet PARAM del file XLS “Anagrafi di riferimento”. Se il codice del parametro non è presente nella lista, il campo deve essere valorizzato con “RF-XXXX-XXX-XXX”.

string(20) X

paramText Descrizione degli

analiti R.07 Descrizione degli analiti. Testo libero string(250) X4

paramType Tipo di analita R.08

Specifica se l’analita riportato si riferisce a un singolo residuo, alla somma di residui o a parte della somma.

Valori ammessi:

sheet PARTYP del file XLS “Anagrafi di riferimento”.

string(5) X

anMethRefCode Codice del metodo analitico

R.09 Identificativo del metodo analitico utilizzato.

Valori ammessi:

sheet ANLYMD del file XLS “Anagrafi di riferimento”.

string(5) X

anMethText Testo del metodo

analitico R.11

Descrizione libera del metodo

analitico Testo libero string(500) X5

4 Obbligatorio se il campo paramCode (R.06) = “RF-XXXX-XXX-XXX” o “RF-XXXX-XXX-X01” o “RF-XXXX-XXXX02”. 5 Obbligatorio se il campo anMethRefCode è valorizzato con “F001A” o “F500A”.

Page 13: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 13 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

accredProc Procedura di certificazione

R.12 Procedura di certificazione per il metodo di analisi utilizzato.

Valori ammessi: sheet MDSTAT del file XLS

“Anagrafi di riferimento”.

string(5)

resUnit Unità di misura R.13 Unità di misura utilizzata. Valori ammessi: sheet UNIT del file XLS

“Anagrafi di riferimento”.

string(5) X6

resLOD LOD R.14 LOD riferito all’unità di misura riportata nel campo resUnit.

Deve essere valorizzato con il

LOD riferito all’unità di misura inserita in resUnit

double X7

resLOQ LOQ R.15 LOQ riferito all’unità di misura riportata nel campo resUnit.

Deve essere Valorizzato con il

LOQ riferito all’unità di misura inserita in resUnit .

double X8

6 Obbligatorio nei seguenti casi:

a) se almeno un campo tra i seguenti è valorizzato: resLOD, resLOQ, resVal, resValUncertSD, resValUncert, resLegalLimit b) resType (R.27) = “BIN” e resQualValue (R.26) = “GTT” o “GET” o “LST” o “LET”.

7 Obbligatorio se progCode (S.31) = “VIG003AL” (3MCPD) e se resType = “LOD”. Se valorizzato deve essere maggiore di 0. Deve essere minore o uguale a resLOQ se entrambi valorizzati. 8 Obbligatorio se progCode (S.31) = “VIG003AL” o “VIG004AL” o “VIG001AD” o VIG005AL (Diossine o 3MCPD o Additivi, Micotossine) o per gli analiti di tipo “CHEMICAL” (paramCode = RF-********-CHE).Obbligatorio sempre se resType = “LOQ”. Se valorizzato deve essere maggiore di 0.

Page 14: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 14 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

resVal Valore del risultato R.18 Valore analitico del risultato.

Deve contenere un dato numerico nei seguenti casi:

a) resType (R.27) = “VAL” b) resType (R.27) = “BIN”

e resQualValue (R.26) = “GTT” o “GET” o “LST” o “LET”

altrimenti “null”.

double X9

resValRec Accuratezza R.19 Approssimazione percentuale per l’accuratezza.

Deve contenere un dato numerico. Es. riporta 100 per 100%.

double X10

resValRecCorr Correzione valore in base al recupero

R.20 Indica se il valore del risultato è stato corretto in base al calcolo per l’approssimazione.

Valori ammessi: sheet YESNO del file XLS “Anagrafi di riferimento”.

string(1) X11

9 Obbligatorio nei seguenti casi:

a) resType (R.27) = “VAL” b) resType (R.27) = “BIN” e resQualValue (R.26) = “GTT” o “GET” o “LST” o “LET”

Se valorizzato deve essere maggiore di 0 tranne nel caso resType=LOQ. Se resType (R.27) = “LOD” non deve essere valorizzato. Se è maggiore di ResLegalLimit il campo resEvaluation deve essere differente da J002A, J01CP, J034A, J035A, J037A, J040A, J041A Se resType=”VAL” resVal :

- deve essere maggiore od uguale a resLOQ, se resLOQ è valorizzato - deve essere maggiore o uguale di resLOD, se resLOD è valorizzato

10 Obbligatorio se paramCode (R.06) diverso da ”RF-*******-MCG” (microbiologico). Se valorizzato deve essere >0 e <200 11 Obbligatorio se il campo resValRec è valorizzato.

Page 15: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 15 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

resValUncertSD Deviazione Standard R.21 Deviazione Standard Deve contenere un dato numerico.

double12

resValUncert Incertezza del risultato

R.22

Indica il valore totale dell’incertezza (solitamente in un intervallo del 95%) associata con la misura espressa nell’unità riportata nel campo “Result unit”.

Deve contenere un dato numerico.

double13 X14

fatPerc Percentuale di grasso R.24 Percentuale di grasso nel campione originale.

Deve contenere un dato numerico.

double X15

exprRes Espressione del risultato

R.25 Codice che descrive come il risultato è stato espresso: peso intero, peso grasso, ecc.

Valori ammessi: sheet EXRES del file XLS “Anagrafi di riferimento”.

string(5) X16

resQualValue Risultato qualitativo R.26 Questo campo deve essere alimentato solo se resType (R.27) = “BIN”.

Valori ammessi: sheet POSNEG del file XLS “Anagrafi di riferimento”.

string(3) X17

12 Se valorizzato deve essere maggiore di 0

13 Se valorizzato deve essere maggiore di 0 14 Obbligatorio se progCode (S.31) = “VIG005AL”. 15 Obbligatorio se progCode (S.31) = “VIG003AL” o “VIG004AL” (diossine o 3MCPD) e se =B003A (Fat weight).Se valorizzato deve essere >=0 e <=100. 16 Obbligatorio se resType (R.27) = “VAL” e per gli analiti di tipo “CHEMICAL” (param = RF-********-CHE) oppure se il campo progCode (S31) è uguale a “VIG005AL”. 17 Obbligatorio se resType (R.27) = “BIN”. Se valorizzato, deve essere diverso da NEG se il campo ResEvaluation = J003A o J02CP o J031A o J038A o J041A.

Page 16: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 16 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

resType Tipo di risultato R.27 Tipo di risultato. Valori ammessi: sheet VALTYP del file XLS

“Anagrafi di riferimento”.

string(3) X

resLegalLimit Limite legale R.28 Indica il limite legale per il campione.

Deve contenere un dato numerico.

double X18

resLegalLimitType Tipologia limite legale R.29

Tipologia di limite legale

considerato nella valutazione del risultato.

Valori ammessi:

sheet LMTTYP del file XLS “Anagrafi di riferimento”.

string(5) X19

resEvaluation Valutazione risultato R.30 Nel caso di n. sub campioni viene riportata la valutazione complessiva.

Valori ammessi: sheet RESEVAL del file XLS “Anagrafi di riferimento”.

string(5) X

actTakenCode Azioni intprese R.31ra

Codice che identifica le azioni

di follow-up intraprese se il risultato dovesse superare il limite legale.

Valori ammessi: sheet ACTION del file XLS “Anagrafi di riferimento”.

string(5)

resComm Note sui risultati R.32 Informazioni addizionali sui risultati analitici ottenuti.

Testo libero. string(250)

18 Obbligatorio se progCode (S31) è uguale a “VIG005AL” e resLegalLimitType è diverso da IT0QS e ITXXX. 19 Obbligatorio se resLegalLimit è valorizzato oppure se il campo progCode (S31) è uguale a “VIG005AL” (micotossine) o “VIG001AD” (additivi)

Page 17: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione e

dell’ordinamento del Servizio sanitario

nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati campioni e

analisi per vigilanza e controllo

alimenti e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 17 di 22 Versione 5.2

Campo Descrizione breve Codice Campo

Descrizione Informazioni di Dominio T(L) O

sampAccDate Data accettazione campione

U.01 Data di accettazione del campione esaminato.

Formato: YYYY-MM-DD

Date(10) X

numVerbale Numero del verbale di campionamento

U.02 Numero del verbale di campionamento

Testo libero String(250) X

OSAid Identificativo OSA U.03

Identificativo dell’Operatore del

Settore Alimentare: Partita Iva o Codice Fiscale.

Testo libero String(250) X

sampOrg Organo prelevatore U.04 Codice identificativo della ASL che ha effettuato il prelievo

Valori ammessi:

sheet ASL del file XLS “Anagrafi di riferimento”.

String (50) X

Page 18: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 18 di 22 Versione 6.0

4. Tracciati XML I tracciati che seguono sono stati formattati con indentazioni per renderne più chiara la

lettura. Insieme allo schema XML è fornito il relativo schema XSD.

4.1 Controlli, validazione e invio file

I file in fase di acquisizione dal Ministero della Salute verranno scartati nel caso non risultino conformi allo schema XSD (par. Errore. L'origine riferimento non è stata

trovata. - Allegati); è consigliabile, quindi, effettuare una validazione preliminare prima di procedere con l’invio. Tale verifica può essere effettuata tramite un validatore

che permette di controllare che un documento xml, generato in base a uno schema, sia ben formato o valido. Inoltre, anche se i file sono ben formattati e validi, potranno essere generati scarti, con

specifiche causali di errore, nei successivi controlli di coerenza. Se sarà generato almeno uno scarto rispetto ai dati inviati verrà scartato

l’intero file. I controlli

verificano la corrispondenza dei dati trasmessi con le anagrafiche di riferimento;

verificano l’eventuale esistenza di chiavi duplicate. La trasmissione è univocamente individuata dai seguenti campi, che costituiscono la chiave

logica:

o regCode

o flType (per il flusso relativo a vigilanza e controllo alimenti e bevande sempre uguale a VIG)

o labCode o labSampleCode o paramCode

o paramText (solo se paramCode=RF-XXXX-XXX-XXX o RF-XXXX-XXX-X01 o RF-XXXX-XXX-X02)20

Tutte le analisi relative a un campione devono essere inviate nello stesso file in

un’unica soluzione senza suddividerle in invii successivi. Invii consecutivi di dati (file) con la stessa chiave logica o di dati con stessa chiave all’interno dello stesso file con tipo operazione inserimento (opType = “I”) saranno

scartati se la chiave logica è già presente.

Per cancellare un record, è sufficiente inviare la stessa chiave del record (e i campi obbligatori previsti dallo schema XSD) valorizzando il campo opType = “C”.

20 Il campo paramCode è case insensitive: non viene fatta distinzione tra lettere maiuscole e minuscole.

Page 19: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 19 di 22 Versione 6.0

Per modificare un record, è necessario:

inviare la stessa chiave del record (e i campi obbligatori previsti dallo schema XSD) valorizzando il campo opType = “C”

inviare la stessa chiave del record (e i campi obbligatori previsti dallo schema XSD) valorizzando il campo opType = “I”

4.2 Esempi di inserimento/cancellazione dei dati.

Negli esempi che seguono, si assuma che la chiave sia sempre la stessa. A variare è sempre l’ELEMENT “resComm”, che non fa parte della chiave.

4.2.1 Esempio di trasmissione 1:

<?xml version="1.0"?>

<dataroot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:noNamespaceSchemaLocation="VIG.xsd">

<sample>

<opType>I</opType>

<flType>VIG</flType>

<labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento1</resComm>

</sample>

<sample>

<opType>C</opType>

<flType>VIG</flType>

<labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento2</resComm>

</sample>

</dataroot>

Risultato: In banca dati non viene memorizzato nessun record, in quanto l’ultima operazione sulla chiave è “C”, cancellazione. Il primo record inserisce, il secondo record cancella.

Page 20: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 20 di 22 Versione 6.0

4.2.2 Esempio di trasmissione 2:

<?xml version="1.0"?>

<dataroot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:noNamespaceSchemaLocation="VIG.xsd">

<sample>

<opType>I</opType>

<flType>VIG</flType>

<labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento1</resComm>

</sample>

<sample>

<opType>I</opType>

<flType>VIG</flType>

<labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento2</resComm>

</sample>

<sample>

<opType>I</opType>

<flType> VIG</flType> <labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento3</resComm>

</sample>

</dataroot>

Risultato: In banca dati non viene memorizzato nessun record. La fornitura sarà

scartata perchè nello stesso file sono presenti più record con la stessa chiave logica ed il tipo operazione uguale a “I”.

Page 21: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 21 di 22 Versione 6.0

4.2.3 Esempio di trasmissione 3:

<?xml version="1.0"?>

<dataroot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:noNamespaceSchemaLocation="VIG.xsd">

<sample>

<opType>I</opType>

<flType> VIG</flType> <labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento1</resComm>

</sample>

<sample>

<opType>C</opType>

<flType> VIG</flType> <labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento2</resComm>

</sample>

<sample>

<opType>I</opType>

<flType>VIG</flType>

<labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento3</resComm>

</sample>

</dataroot>

Risultato: In banca dati non viene memorizzato nessun record. La fornitura sarà

scartata perchè nello stesso file sono presenti più record con la stessa chiave logica ed il tipo operazione uguale a “I”.

Page 22: Flusso vigilanza e controllo alimenti e bevande · campioni e analisi per ... riferimento non è stata trovata. ... Nella seguente tabella sono descritti i campi contenuti nel tracciato

Ministero della Salute

Dipartimento della programmazione

e dell’ordinamento del Servizio

sanitario nazionale

Direzione Generale del Sistema

Informativo e statistico sanitario

Trasmissione dei dati

campioni e analisi per

vigilanza e controllo alimenti

e bevande

Specifiche Funzionali dei

tracciati

SISG_SSW MSW_ALIM_NSA_VIG Pag. 22 di 22 Versione 6.0

4.2.4 Esempio di trasmissione 4:

<?xml version="1.0"?>

<dataroot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:noNamespaceSchemaLocation="VIG.xsd">

<sample>

<opType>C</opType>

<flType> VIG</flType> <labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento1</resComm>

</sample>

<sample>

<opType>I</opType>

<flType> VIG</flType> <labSampleCode>2009_00000287</labSampleCode>

.

.

.

<resEvaluation>J002A</resEvaluation>

<actTakenCode>W</actTakenCode>

<resComm>Commento2</resComm>

</sample>

</dataroot>

Risultato: Se la chiave logica è già presente in banca dati il valore memorizzato di “resComm” nella banca dati, per questa chiave, sarà “Commento2”. Il primo record

cancella la chiave già presente in banca dati ed il secondo inserisce un nuovo record per la stessa chiave logica.

Se la chiave logica non è già presente in banca dati la fornitura viene scartata perchè si sta cercando di cancellare una chiave non presente in banca dati.

4.3 Codici di errore

L’elenco completo dei possibili codici di errore è disponibile nella sezione dedicata del portale del Ministero della Salute. (Disponibile sul portale del Ministero della Salute –

Sezione “Sicurezza Alimentare –Flusso vigilanza e controllo alimenti e bevande”)