Come creare un tracciato XML del tipo "MOVIMENTI" utilizzando un file Excel

Per creare un tracciato XML del tipo "MOVIMENTI", prelevando i dati dal vostro database aziendale di tipo relazionale basato su SQL, e inserirli in un file Excel bisogna eseguire le seguenti operazioni:

1. I dati devono essere estratti dal database aziendale e salvati in un file che deve essere chiamato dati.xlsx (vedi esempio seguente). Se il file ha una diversa denominazione non viene accettato dal server. Ogni riga del documento in formato Excel deve riportare i dati di un record. I tipi di dati riportati nelle righe precedenti sono i seguenti:
   id_dest ; tipo_d ; tipo_tr ; tipo_mov ; DDT ; t_doc ; giorno di trasmissione ; mese ; anno ; ora ; minuto ; secondo ; id_comm ; tipo_comm ; id_int_fatt ; tipo_i_f ; cod ; lot ; giorno di scadenza ; mese di scadenza ; anno di scadenza ; qta ; val
   Vimetra System esegue i controlli automatici incrociati per il rilevamento dei piú frequenti errori di compilazione, segnalando il numero della riga del file dati.xlsx in cui l'errore viene rilevato. In questo caso l'errore puó essere corretto direttamente sul file dati.xlsx, il quale, dopo la correzione, dovrá essere ricaricato sul server.
   Alcuni tipi di dati possono essere omessi. In questo caso, le relative celle del foglio Excel devono essere lasciate vuote.
2. Nel menú delle opzioni, presente nella pagina d'ingresso della propria area riservata, cliccare sulla dicitura: "Carica i dati in formato Excel sul server per la creazione di un tracciato XML del tipo "MOVIMENTI" (per utenti esperti)" o sull'icona che riporta la dicitura "Carica i dati in formato Excel dal file dati.xlsx".
   Cercare il file dati.xlsx sul proprio computer cliccando sul pulsante "Sfoglia.." e, una volta localizzato, cliccare sul pulsante "Carica il file dei dati"
3. Nel menú delle opzioni cliccare sulla dicitura: "Crea un nuovo tracciato XML del tipo "MOVIMENTI" con i dati contenuti nel file dati.xlsx (per utenti esperti)" e riempire i campi del modulo che viene presentato con i dati richiesti. Infine, cliccare sul pulsante "Crea il tracciato XML" Dopo aver cliccato sul pulsante 'Crea il tracciato XML' potrebbero occorrere anche diversi minuti, a seconda della quantitá dei dati caricati sul server, prima che il tracciato venga completato. Attendere fino a che il server non dá la comunicazione dell'avvenuta creazione del tracciato.
4. Nel menú delle opzioni cliccare sulla dicitura: "Ottieni l'elenco dei tracciati XML del tipo "MOVIMENTI" creati da te (dal file dati.txt o dati.xlsx) e conservati nel database" e poi sul pulsante color arancione con la dicitura "Ottieni l'elenco dei tracciati XML del tipo "MOVIMENTI". Ti verrá presentato l'elenco di tutti i tracciati ottenuti dai file di testo denominati dati.txt o dati.xlsx, tra cui quello appena creato.
5. Scaricare, come un qualsiasi altro file, sul tuo computer, il tracciato XML creato sul nostro server e trasmetterlo via Internet al N.S.I.S. dopo aver apposto la firma digitale
6. Eliminare dal nostro server il tracciato XML quando non ti serve piú.

1. Facciamo un esempio concreto. Nel vostro database aziendale avete una tabella con i seguenti campi, solo alcuni dei quali, quelli che servono per il vostro tracciato xml, sono valorizzati (N.B. Ogni riferimento a dati reali é del tutto casuale). Nel database reale i campi possono avere denominazioni diverse ed essere ordinati in modo diverso ma devono esserci tutti. Il formato dei dati deve essere quello che si vede nella tabella sottostante.
   
   

   id_dest	tipo_d	tipo_tr	tipo_mov	DDT	t_doc	giorno_tr	mese_tr	anno_tr	ora_tr	minuto_tr	secondo_tr	id_comm	tipo_comm	id_int_fatt	tipo_i_f	cod	lot	giorno_scad	mese_scad	anno_scad	qta	val
   0125342	Z	T	VI	4563	D	04	07	2008	08	05	32					874563425	152B4	12	12	2010	4
   7071202	Z	T	VI	4564	D	04	07	2008								874563425	152B4	12	12	2010	5	1025.00
   7071202	Z	T	VI	4564	D	04	07	2008								634529987	65CC87	25	07	2012	5
   3223220	Z	T	VI	4565	D	04	07	2008								095764554	XF56TY	30	08	2012	6
   3226720	Z	T	VI	4560	D	05	07	2008								837465344	89YU78HK	27	02	2009	3

   
   
   
2. Se il tracciato contiene anche farmaci per uso veterinario, alla tabella bisogna aggiungere una colonna, intitolata t_prod, come si vede nell'esempio seguente, che puó assumere i valori "9", se il farmaco ha un AIC di 9 cifre, o "8" se il farmaco ha un GTIN di 14 cifre.
   
   

   id_dest	tipo_d	tipo_tr	tipo_mov	DDT	t_doc	giorno_tr	mese_tr	anno_tr	ora_tr	minuto_tr	secondo_tr	id_comm	tipo_comm	id_int_fatt	tipo_i_f	cod	lot	giorno_scad	mese_scad	anno_scad	qta	val	t_prod
   0125342	Z	T	VI	4563	D	04	07	2008	08	05	32					874563425	152B4	12	12	2010	4		9
   7071202	Z	T	VI	4564	D	04	07	2008								874563425	152B4	12	12	2010	5	1025.00
   7071202	Z	T	VI	4564	D	04	07	2008								63452998794567	65CC87	25	07	2012	5		8
   3223220	Z	T	VI	4565	D	04	07	2008								095764554	XF56TY	30	08	2012	6
   3226720	Z	T	VI	4560	D	05	07	2008								837465344	89YU78HK	27	02	2009	3

   
   
   
3. I dati da inserire nei tracciati xml devono essere estratti dal database e inseriti in un foglio di calcolo Microsoft excel denominato dati.xlsx (non dati.xls !), come si vede nell'esempio seguente identico alla tabella del punto 1, che dovrà poi essere caricato sul server di Vimetra System. Utilizzando l'apposita funzione presente nell'Area Riservata "Crea un nuovo tracciato XML del tipo "MOVIMENTI" con i dati contenuti nel file dati.xlsx (per utenti esperti)" si ottiene il tracciato XML. Dall'Area Riservata si puó anche scaricare il modello del file:
   
   



4. Se il tracciato contiene anche farmaci per uso veterinario, il file Excell si presenta come si vede nell'esempio seguente, identico alla tabella del punto 2. Dall'Area Riservata si puó anche scaricare il seguente modello di file Excel per farmaci per uso veterinario:
   
   

Nome Campo	Descrizione Funzionale	Informazioni di Dominio
id_dest	Indica l'ID del Sito Logistico del Destinatario	Obbligatorio solo per alcune tipologie di destinatario. Puó essere omesso se il tipo destinatario é 'U' (uscita dal canale distributivo) o 'Z' (altra destinazione non codificata). Se valorizzato, le regole di attribuzione dell'identificativo sono riportate nelle specifiche del N.S.I.S.
tipo_d	Indica il tipo di anagrafica del destinatario cui l'id_dest afferisce	Obbligatorio Valori di riferimento nella tabella di codifica.
tipo_tr	Indica il Tipo di Trasmissione effettuata. In caso di trasmissione (inserimento) viene inserito un nuovo record nella banca dati; in caso di rettifica (modifica) vengono aggiornati i dati precedentemente trasmessi, univocamente individuati tramite i campi chiave.	Obbligatorio T = Trasmissione R = Rettifica E = Errore
tipo_mov	Indica il Tipo di Movimento effettuato, ovvero se il movimento é una vendita, una distruzione di bollini, una riclassificazione dei bollini etc	Obbligatorio Valori di riferimento nella tabella di codifica.
DDT	Indica il codice Documento di Trasporto emesso dal Mittente, o documento equivalente.	Non previsto per alcune tipologie di causale di movimento. Ove previsto si prevede una lunghezza massima di 10 caratteri.
t_doc	Indica il tipo di documento di trasporto	Obbligatorio. Puó assumere i valori riportati nell'allegato G dell'apposita tabella.
giorno_tr mese_tr anno_tr	Questi campi formano la Data di trasmissione (d_tr) (in pratica la data del DDT). Il sistema la compone utilizzando i dati di: giorno_tr = giorno della trasmissione mese_tr = mese della trasmissione anno_tr = anno della trasmissione	Obbligatorio. In caso sia previsto il DDT o documento equivalente per il tipo movimento oggetto della trasmissione, tale data puó essere la data di emissione del documento. Il sistema crea questo dato combinando, nella forma convenzionale richiesta, il giorno ,il mese e l'anno di trasmissione.
ora_tr minuto_tr secondo_tr	Questi campi formano l'Ora di trasmissione (h_tr). Il sistema la compone utilizzando i dati di: ora_tr = ora della trasmissione minuto_tr = minuto della trasmissione secondo_tr = secondo della trasmissione	Obbligatorio solamente nel caso in cui il campo DDT non venga valorizzato. In questi casi, puó essere utilizzata l'ora di sistema al momento della creazione del tracciato. In caso sia previsto il DDT o documento equivalente per il tipo movimento oggetto della trasmissione, l'ora non é obbligatoria, ma ,se valorizzata, puó essere l'ora di emissione del documento. Il sistema crea questo dato combinando, nella forma convenzionale richiesta, l'ora, il minuto e il secondo di trasmissione.
id_comm	Indica l'ID del sito Logistico del Committente dell'Ordine	ID del sito logistico fornito dal Ministero della Salute. Questo ID é omesso qualora si faccia riferimento ad una vendita non a SSN. Da utilizzare solo per i medicinali ad uso UMANO.
tipo_comm	Indica il tipo di anagrafica del committente dell'ordine cui l'id_comm afferisce	Valori di riferimento nella tabella di codifica "Alleg. E Tipo Comm/Int Fatt" Questo valore é omesso qualora si faccia riferimento ad una vendita non a SSN. Da utilizzare solo per i medicinali ad uso UMANO.
id_int_fatt	Indica l'ID del sito Logistico dell'Intestatario della Fattura	ID del sito logistico fornito dal Ministero della Salute. Questo ID é omesso qualora si faccia riferimento ad una vendita non a SSN. Da utilizzare solo per i medicinali ad uso UMANO.
tipo_i_f	Indica il tipo di anagrafica dell'intestatario della fattura dell'ordine cui l'id_int_fatt afferisce	Questo valore é omesso qualora si faccia riferimento ad una vendita non a SSN. Da utilizzare solo per i medicinali ad uso UMANO.
cod	Indica il codice dell'Autorizzazione Immissione in Commercio del medicinale.	Obbligatorio. Medicinali ad uso UMANO: Codice costituito da 9 cifre. Medicinali ad uso VETERINARIO: Codice costituito da 9 cifre per AIC/ codice costituito da 14 cifre per GTIN
lot	Indica il numero del Lotto di produzione del medicinale	Non obbligatorio solo per i grossisti
giorno_scad mese_scad anno_scad	Questi campi formano la data di scadenza del medicinale (d_scad). Il sistema la compone utilizzando i dati di: giorno_scad = giorno di scadenza mese_scad = mese di scadenza anno_scad = anno di scadenza	Non obbligatorio solo per i grossisti. Il sistema crea questo dato combinando, nella forma convenzionale richiesta, giorno, mese e anno di scadenza.
qta	Indica la Quantitá delle confezioni che vengono spedite in quella data trasmissione	Obbligatorio
val	Indica il valore della fornitura a SSN comprensivo d'IVA, riferito all'AIC in oggetto. Rappresenta quindi il valore totale per AIC (non del singolo pezzo) Questo campo si riferisce solo alle forniture a SSN.	Opzionale. Da utilizzare solo per i medicinali ad uso UMANO.
t_prod	Indica il Tipo di Prodotto e, se si riferisce ai farmaci per uso veterinario, puó assumere i valori "9", se il farmaco ha un AIC di 9 cifre, o "8" se il farmaco ha un GTIN di 14 cifre.	Obbligatorio solo per i farmaci per uso veterinario. Per i faramaci per uso umano puó essere omesso, lasciato vuoto, o valorizzato con "1".