MYISR
Translate in English

File XML, Portale Impresa e piattaforma del Ministero della Salute: una guida tecnica in linguaggio semplice per i professionisti della compliance

by | Aug 27, 2026 | Blog

Table of content

Author



Sabrina Morgan
Head of Global Compliance & Customer Delivery
Vector Health Compliance

 

Sabrina Morgan è la Responsabile Globale della Compliance e del Customer Delivery presso Vector Health. Supervisiona la rendicontazione globale sulla trasparenza e i requisiti di disclosure internazionali, oltre a guidare la strategia per il Sunshine Act italiano. Dirige inoltre il team globale di client delivery, dedicato a garantire l’integrità dei dati, offrire soluzioni di conformità e assicurare l’allineamento normativo per le organizzazioni farmaceutiche e MedTech.

 

Vector Health Compliance
Il principale partner in Italia per la conformità al Sunshine Act

Recent Blogs

Cerchi supporto per la compliance al Sunshine Act?

Scopri i nostri Partner consigliati — soluzioni legali, tecnologiche e operative selezionate per accompagnarti nella rendicontazione della trasparenza.

Hai domande pratiche?

Dai un’occhiata alla nostra sezione Domande Frequenti per risposte chiare su scadenze, obblighi e strategie.

Avete trascorso settimane a mappare i vostri flussi di trasferimenti di valore, coordinando sette diversi dipartimenti, sollecitando un’agenzia organizzatrice di eventi per ottenere i dati dei partecipanti e risolvendo centinaia e quarantatré errori di validazione nei dati del vostro HCP master. I dati sono puliti. Gli importi sono stati verificati dal management. Tutti hanno dato la propria approvazione.

E ora dovete inviare un file XML al Portale Impresa del Ministero della Salute.

Se lavorate nell’ambito della compliance anziché nell’IT, quest’ultimo passaggio può dare la sensazione di essere arrivati alla fine di una maratona e di sentirsi dire che, prima di tagliare il traguardo, dovete sostenere un esame tecnico. La terminologia non è familiare, il sistema non è intuitivo e sono disponibili pochissime indicazioni in linguaggio semplice per chi non è un software engineer.

Questo articolo è proprio quella guida in linguaggio semplice. Al termine della lettura, capirete che cos’è un file XML, come viene generato a partire dai vostri dati, quali sono gli attuali canali di accesso indicati dal Ministero della Salute e quali controlli le aziende dovrebbero predisporre prima dell’invio.

Che cos’è davvero un file XML?

XML sta per Extensible Markup Language. Questa definizione non è molto utile, quindi eccone una più comprensibile: un file XML è un documento di testo strutturato che organizza i dati utilizzando un sistema di etichette chiamate tag.

Probabilmente conoscete già una forma comune di XML senza rendervene conto: la fattura elettronica. Quando un’azienda italiana invia una fattura digitale, questa viene trasmessa come file XML. Lo stesso principio si applica alle comunicazioni previste dal Sunshine Act. Anziché contenere i dati di una fattura, il file XML contiene i trasferimenti di valore, gli accordi e le informazioni sui destinatari che devono essere comunicati ai sensi del Sunshine Act italiano.

La documentazione tecnica relativa a Sanità Trasparente definisce come deve essere strutturata la comunicazione elettronica, compresi i campi richiesti, i formati consentiti e le relazioni tra gli elementi dei dati. In un processo di comunicazione basato su XML, questi requisiti sono normalmente espressi attraverso uno schema XSD e le relative regole di business. La conformità all’XSD rappresenta solo il primo livello di validazione. Un file può essere strutturalmente valido ma non superare ulteriori controlli relativi alle regole di business o ai dati di riferimento. Le aziende devono pertanto validare sia la struttura tecnica sia il significato e la coerenza dei dati.

La buona notizia è che non è necessario creare un file XML manualmente. Nessun professionista della compliance dovrebbe mai digitare manualmente i tag XML. Il file viene generato tramite un processo automatizzato a partire da una tabella di dati, nello specifico dai vostri dati relativi ai trasferimenti di valore, precedentemente puliti e validati, utilizzando un software dedicato, un team IT o un provider di servizi gestiti che si occupa della conversione nell’ambito del vostro processo di reporting di trasparenza.

Come viene generato il file XML

Il processo funziona in questo modo. Il vostro team Compliance ha raccolto un dataset completo e validato dei trasferimenti di valore relativi al periodo di riferimento, contenente in forma strutturata le informazioni identificative del beneficiario o della controparte, il codice fiscale o la partita IVA, i dati dell’HCP o dell’HCO, ove applicabili, la data o il periodo di riferimento, la natura e la finalità del trasferimento o dell’accordo, il relativo importo o valore di mercato, le informazioni sull’intermediario e gli altri campi richiesti dal modello tecnico applicabile.

Questa tabella viene inserita in uno strumento che legge ogni riga e la traduce nella struttura XML richiesta dal Ministero. Lo strumento conosce lo schema. Sa quale colonna della tabella corrisponde a ciascun campo dell’XML. Applica la formattazione corretta, valida i tipi di dati e produce un file che, per un lettore umano, appare come una fitta parete di testo con parentesi angolari ed etichette, ma che la piattaforma del Ministero è in grado di leggere, validare ed elaborare automaticamente.

Se lavorate con un provider di servizi per il reporting di trasparenza, questo passaggio viene gestito dal provider. Voi fornite i dati puliti; loro producono il file XML. Se la vostra organizzazione gestisce il processo internamente, il vostro team IT può utilizzare un’applicazione sviluppata internamente, uno script di trasformazione dei dati o uno strumento di reporting specificamente progettato per associare i dati di origine alla struttura XML richiesta. In ogni caso, la generazione del file XML non dovrebbe richiedere un intervento manuale da parte del professionista della compliance: il vostro ruolo è validare i dati alla base della comunicazione, non produrre il file tecnico.

Registrazione al Portale Impresa del Ministero della Salute

L’attuale pagina del Ministero dedicata al Sunshine Act identifica diversi canali di accesso in funzione della tipologia e della sede dell’ente che effettua la comunicazione. Le aziende registrate tramite Portale Impresa accedono al servizio del Ministero attraverso tale portale. Gli enti che non sono registrati su Portale Impresa, comprese le aziende extra-UE e alcune organizzazioni del Terzo Settore, sono indirizzati ad accedere tramite NSIS.

Il Ministero attualmente indica agli utenti di inviare le richieste di registrazione al proprio servizio di assistenza tecnica. Le aziende dovrebbero pertanto verificare il canale di accesso applicabile e la documentazione richiesta per la propria specifica organizzazione direttamente attraverso la procedura ufficiale di registrazione, anziché presumere che la stessa procedura si applichi a tutti i soggetti tenuti alla comunicazione.

Le informazioni esatte richieste per la registrazione e la documentazione attestante i poteri di rappresentanza possono dipendere dall’ente e dal canale di accesso. L’utente designato dovrebbe verificare i requisiti aggiornati con il servizio di assistenza del Ministero e assicurarsi che i poteri societari o le deleghe appropriate siano documentati internamente.

La procedura di registrazione non è particolarmente complessa, ma prevede alcuni passaggi che devono essere completati in un ordine specifico e l’interfaccia della piattaforma non è sempre intuitiva per chi vi accede per la prima volta. Se non vi siete ancora registrati, prevedete il tempo necessario per completare la procedura; non cercate di completare la registrazione il giorno della scadenza per l’invio. Avviate la procedura di registrazione e di accesso con largo anticipo rispetto alla prima finestra di comunicazione. Potrebbe essere necessario del tempo per risolvere eventuali problemi relativi alla registrazione dell’ente, alle deleghe o all’accesso degli utenti.

Una volta ottenuto l’accesso, l’utente designato per la comunicazione dovrà seguire il flusso di invio reso disponibile per Sanità Trasparente. Un flusso basato su XML comprenderà normalmente la trasmissione del file, l’elaborazione tecnica, la verifica dell’esito dell’elaborazione e la correzione o il nuovo invio qualora vengano rilevati errori. Le aziende dovrebbero seguire il manuale utente definitivo del Ministero e le istruzioni tecniche per conoscere l’esatta sequenza e le funzioni di correzione disponibili.

Problemi tecnici comuni e come evitarli

I problemi tecnici più frequenti nelle comunicazioni previste dal Sunshine Act rientrano in un numero limitato di categorie e, nella maggior parte dei casi, possono essere prevenuti con una buona preparazione dei dati.

Le incongruenze nei codici fiscali rappresentano la singola fonte di errori più comune. Codici fiscali errati, incompleti o non coerenti possono impedire l’accettazione di un record relativo a un destinatario o il suo corretto abbinamento. Le aziende dovrebbero validare gli identificativi prima di generare l’XML e riconciliarli con gli altri dati presenti nel master dei destinatari.

La mancanza di elementi obbligatori o la presenza di valori formattati in modo errato può causare errori di validazione strutturale o il rifiuto di singoli record, a seconda della regola tecnica applicabile. Ogni campo definito come obbligatorio nello schema del Ministero deve essere presente e formattato correttamente. Eseguire un controllo preliminare dei dati rispetto allo schema pubblicato consente di individuare tempestivamente questi problemi.

I problemi di codifica possono verificarsi quando i dati provenienti da diversi sistemi vengono consolidati, in particolare quando nomi o indirizzi contengono lettere accentate, apostrofi o caratteri appartenenti ad alfabeti differenti. Il generatore XML dovrebbe utilizzare la codifica richiesta dalle specifiche tecniche e preservare tali caratteri in modo coerente durante le fasi di estrazione, trasformazione e invio.

Non è necessario essere esperti di tecnologia

Il messaggio più importante per i professionisti della compliance che si apprestano a effettuare la loro prima comunicazione prevista dal Sunshine Act è questo: non è necessario comprendere i dettagli tecnici della generazione dell’XML per gestire con successo il processo di comunicazione. È necessario comprendere abbastanza il processo da poter porre le domande giuste al proprio team IT o al proprio provider di servizi, sapere quale dovrebbe essere un output corretto e comprendere il significato dei messaggi di errore quando qualcosa non funziona.

La competenza in materia di compliance che portate a questo processo — comprendere la normativa, validare i dati, prendere decisioni sui casi borderline, gestire i rapporti con gli HCP e gli stakeholder interni — è quella su cui dovrebbero concentrarsi il vostro tempo e le vostre energie. La parte tecnica relativa alla conversione XML e al caricamento sul portale dovrebbe essere gestita da sistemi e specialisti che se ne occupano abitualmente.

Ciò che conta è che i dati inseriti nel file XML siano accurati, completi e validati. Se questo aspetto viene gestito correttamente, il processo tecnico di comunicazione diventa considerevolmente più gestibile. Dati puliti non risolveranno ogni problema tecnico, ma ridurranno significativamente il rischio di rifiuti evitabili e di invii ripetuti.

FAQ

I professionisti della compliance devono creare manualmente i file XML?

No. I file XML dovrebbero essere generati automaticamente a partire dai dati di reporting validati, utilizzando software dedicati, strumenti IT interni o un provider di servizi gestiti.

Un file XML può superare la validazione tecnica e venire comunque rifiutato?

Sì. Un file può essere conforme allo schema XML pur non rispettando le regole di business o i controlli sui dati di riferimento; per questo è importante effettuare sia la validazione tecnica sia quella dei dati.

Qual è la differenza tra Portale Impresa e NSIS?

Il Ministero attualmente identifica diversi canali di accesso in funzione del soggetto tenuto alla comunicazione. Le aziende dovrebbero verificare il canale corretto per la propria organizzazione durante la procedura di registrazione.

Quali sono le cause più frequenti degli errori nell’invio dei file XML?

Tra i problemi più comuni rientrano identificativi dei destinatari non validi, campi obbligatori mancanti, problemi di formattazione e incoerenze nella codifica dei caratteri.

Avete domande sul livello di preparazione della vostra organizzazione rispetto al Sunshine Act italiano? Scoprite le nostre risposte e risorse specialistiche qui.

Rimanete aggiornati sulle scadenze e sugli aggiornamenti relativi al Sunshine Act italiano, scoprite i nostri prossimi webinar ed eventi.

Table of content

Avete trascorso settimane a mappare i vostri flussi di trasferimenti di valore, coordinando sette diversi dipartimenti, sollecitando un’agenzia organizzatrice di eventi per ottenere i dati dei partecipanti e risolvendo centinaia e quarantatré errori di validazione nei dati del vostro HCP master. I dati sono puliti. Gli importi sono stati verificati dal management. Tutti hanno dato la propria approvazione.

E ora dovete inviare un file XML al Portale Impresa del Ministero della Salute.

Se lavorate nell’ambito della compliance anziché nell’IT, quest’ultimo passaggio può dare la sensazione di essere arrivati alla fine di una maratona e di sentirsi dire che, prima di tagliare il traguardo, dovete sostenere un esame tecnico. La terminologia non è familiare, il sistema non è intuitivo e sono disponibili pochissime indicazioni in linguaggio semplice per chi non è un software engineer.

Questo articolo è proprio quella guida in linguaggio semplice. Al termine della lettura, capirete che cos’è un file XML, come viene generato a partire dai vostri dati, quali sono gli attuali canali di accesso indicati dal Ministero della Salute e quali controlli le aziende dovrebbero predisporre prima dell’invio.

Che cos’è davvero un file XML?

XML sta per Extensible Markup Language. Questa definizione non è molto utile, quindi eccone una più comprensibile: un file XML è un documento di testo strutturato che organizza i dati utilizzando un sistema di etichette chiamate tag.

Probabilmente conoscete già una forma comune di XML senza rendervene conto: la fattura elettronica. Quando un’azienda italiana invia una fattura digitale, questa viene trasmessa come file XML. Lo stesso principio si applica alle comunicazioni previste dal Sunshine Act. Anziché contenere i dati di una fattura, il file XML contiene i trasferimenti di valore, gli accordi e le informazioni sui destinatari che devono essere comunicati ai sensi del Sunshine Act italiano.

La documentazione tecnica relativa a Sanità Trasparente definisce come deve essere strutturata la comunicazione elettronica, compresi i campi richiesti, i formati consentiti e le relazioni tra gli elementi dei dati. In un processo di comunicazione basato su XML, questi requisiti sono normalmente espressi attraverso uno schema XSD e le relative regole di business. La conformità all’XSD rappresenta solo il primo livello di validazione. Un file può essere strutturalmente valido ma non superare ulteriori controlli relativi alle regole di business o ai dati di riferimento. Le aziende devono pertanto validare sia la struttura tecnica sia il significato e la coerenza dei dati.

La buona notizia è che non è necessario creare un file XML manualmente. Nessun professionista della compliance dovrebbe mai digitare manualmente i tag XML. Il file viene generato tramite un processo automatizzato a partire da una tabella di dati, nello specifico dai vostri dati relativi ai trasferimenti di valore, precedentemente puliti e validati, utilizzando un software dedicato, un team IT o un provider di servizi gestiti che si occupa della conversione nell’ambito del vostro processo di reporting di trasparenza.

Come viene generato il file XML

Il processo funziona in questo modo. Il vostro team Compliance ha raccolto un dataset completo e validato dei trasferimenti di valore relativi al periodo di riferimento, contenente in forma strutturata le informazioni identificative del beneficiario o della controparte, il codice fiscale o la partita IVA, i dati dell’HCP o dell’HCO, ove applicabili, la data o il periodo di riferimento, la natura e la finalità del trasferimento o dell’accordo, il relativo importo o valore di mercato, le informazioni sull’intermediario e gli altri campi richiesti dal modello tecnico applicabile.

Questa tabella viene inserita in uno strumento che legge ogni riga e la traduce nella struttura XML richiesta dal Ministero. Lo strumento conosce lo schema. Sa quale colonna della tabella corrisponde a ciascun campo dell’XML. Applica la formattazione corretta, valida i tipi di dati e produce un file che, per un lettore umano, appare come una fitta parete di testo con parentesi angolari ed etichette, ma che la piattaforma del Ministero è in grado di leggere, validare ed elaborare automaticamente.

Se lavorate con un provider di servizi per il reporting di trasparenza, questo passaggio viene gestito dal provider. Voi fornite i dati puliti; loro producono il file XML. Se la vostra organizzazione gestisce il processo internamente, il vostro team IT può utilizzare un’applicazione sviluppata internamente, uno script di trasformazione dei dati o uno strumento di reporting specificamente progettato per associare i dati di origine alla struttura XML richiesta. In ogni caso, la generazione del file XML non dovrebbe richiedere un intervento manuale da parte del professionista della compliance: il vostro ruolo è validare i dati alla base della comunicazione, non produrre il file tecnico.

Registrazione al Portale Impresa del Ministero della Salute

L’attuale pagina del Ministero dedicata al Sunshine Act identifica diversi canali di accesso in funzione della tipologia e della sede dell’ente che effettua la comunicazione. Le aziende registrate tramite Portale Impresa accedono al servizio del Ministero attraverso tale portale. Gli enti che non sono registrati su Portale Impresa, comprese le aziende extra-UE e alcune organizzazioni del Terzo Settore, sono indirizzati ad accedere tramite NSIS.

Il Ministero attualmente indica agli utenti di inviare le richieste di registrazione al proprio servizio di assistenza tecnica. Le aziende dovrebbero pertanto verificare il canale di accesso applicabile e la documentazione richiesta per la propria specifica organizzazione direttamente attraverso la procedura ufficiale di registrazione, anziché presumere che la stessa procedura si applichi a tutti i soggetti tenuti alla comunicazione.

Le informazioni esatte richieste per la registrazione e la documentazione attestante i poteri di rappresentanza possono dipendere dall’ente e dal canale di accesso. L’utente designato dovrebbe verificare i requisiti aggiornati con il servizio di assistenza del Ministero e assicurarsi che i poteri societari o le deleghe appropriate siano documentati internamente.

La procedura di registrazione non è particolarmente complessa, ma prevede alcuni passaggi che devono essere completati in un ordine specifico e l’interfaccia della piattaforma non è sempre intuitiva per chi vi accede per la prima volta. Se non vi siete ancora registrati, prevedete il tempo necessario per completare la procedura; non cercate di completare la registrazione il giorno della scadenza per l’invio. Avviate la procedura di registrazione e di accesso con largo anticipo rispetto alla prima finestra di comunicazione. Potrebbe essere necessario del tempo per risolvere eventuali problemi relativi alla registrazione dell’ente, alle deleghe o all’accesso degli utenti.

Una volta ottenuto l’accesso, l’utente designato per la comunicazione dovrà seguire il flusso di invio reso disponibile per Sanità Trasparente. Un flusso basato su XML comprenderà normalmente la trasmissione del file, l’elaborazione tecnica, la verifica dell’esito dell’elaborazione e la correzione o il nuovo invio qualora vengano rilevati errori. Le aziende dovrebbero seguire il manuale utente definitivo del Ministero e le istruzioni tecniche per conoscere l’esatta sequenza e le funzioni di correzione disponibili.

Problemi tecnici comuni e come evitarli

I problemi tecnici più frequenti nelle comunicazioni previste dal Sunshine Act rientrano in un numero limitato di categorie e, nella maggior parte dei casi, possono essere prevenuti con una buona preparazione dei dati.

Le incongruenze nei codici fiscali rappresentano la singola fonte di errori più comune. Codici fiscali errati, incompleti o non coerenti possono impedire l’accettazione di un record relativo a un destinatario o il suo corretto abbinamento. Le aziende dovrebbero validare gli identificativi prima di generare l’XML e riconciliarli con gli altri dati presenti nel master dei destinatari.

La mancanza di elementi obbligatori o la presenza di valori formattati in modo errato può causare errori di validazione strutturale o il rifiuto di singoli record, a seconda della regola tecnica applicabile. Ogni campo definito come obbligatorio nello schema del Ministero deve essere presente e formattato correttamente. Eseguire un controllo preliminare dei dati rispetto allo schema pubblicato consente di individuare tempestivamente questi problemi.

I problemi di codifica possono verificarsi quando i dati provenienti da diversi sistemi vengono consolidati, in particolare quando nomi o indirizzi contengono lettere accentate, apostrofi o caratteri appartenenti ad alfabeti differenti. Il generatore XML dovrebbe utilizzare la codifica richiesta dalle specifiche tecniche e preservare tali caratteri in modo coerente durante le fasi di estrazione, trasformazione e invio.

Non è necessario essere esperti di tecnologia

Il messaggio più importante per i professionisti della compliance che si apprestano a effettuare la loro prima comunicazione prevista dal Sunshine Act è questo: non è necessario comprendere i dettagli tecnici della generazione dell’XML per gestire con successo il processo di comunicazione. È necessario comprendere abbastanza il processo da poter porre le domande giuste al proprio team IT o al proprio provider di servizi, sapere quale dovrebbe essere un output corretto e comprendere il significato dei messaggi di errore quando qualcosa non funziona.

La competenza in materia di compliance che portate a questo processo — comprendere la normativa, validare i dati, prendere decisioni sui casi borderline, gestire i rapporti con gli HCP e gli stakeholder interni — è quella su cui dovrebbero concentrarsi il vostro tempo e le vostre energie. La parte tecnica relativa alla conversione XML e al caricamento sul portale dovrebbe essere gestita da sistemi e specialisti che se ne occupano abitualmente.

Ciò che conta è che i dati inseriti nel file XML siano accurati, completi e validati. Se questo aspetto viene gestito correttamente, il processo tecnico di comunicazione diventa considerevolmente più gestibile. Dati puliti non risolveranno ogni problema tecnico, ma ridurranno significativamente il rischio di rifiuti evitabili e di invii ripetuti.

FAQ

I professionisti della compliance devono creare manualmente i file XML?

No. I file XML dovrebbero essere generati automaticamente a partire dai dati di reporting validati, utilizzando software dedicati, strumenti IT interni o un provider di servizi gestiti.

Un file XML può superare la validazione tecnica e venire comunque rifiutato?

Sì. Un file può essere conforme allo schema XML pur non rispettando le regole di business o i controlli sui dati di riferimento; per questo è importante effettuare sia la validazione tecnica sia quella dei dati.

Qual è la differenza tra Portale Impresa e NSIS?

Il Ministero attualmente identifica diversi canali di accesso in funzione del soggetto tenuto alla comunicazione. Le aziende dovrebbero verificare il canale corretto per la propria organizzazione durante la procedura di registrazione.

Quali sono le cause più frequenti degli errori nell’invio dei file XML?

Tra i problemi più comuni rientrano identificativi dei destinatari non validi, campi obbligatori mancanti, problemi di formattazione e incoerenze nella codifica dei caratteri.

Avete domande sul livello di preparazione della vostra organizzazione rispetto al Sunshine Act italiano? Scoprite le nostre risposte e risorse specialistiche qui.

Rimanete aggiornati sulle scadenze e sugli aggiornamenti relativi al Sunshine Act italiano, scoprite i nostri prossimi webinar ed eventi.

Author



Sabrina Morgan
Head of Global Compliance & Customer Delivery
Vector Health Compliance

 

Sabrina Morgan è la Responsabile Globale della Compliance e del Customer Delivery presso Vector Health. Supervisiona la rendicontazione globale sulla trasparenza e i requisiti di disclosure internazionali, oltre a guidare la strategia per il Sunshine Act italiano. Dirige inoltre il team globale di client delivery, dedicato a garantire l’integrità dei dati, offrire soluzioni di conformità e assicurare l’allineamento normativo per le organizzazioni farmaceutiche e MedTech.

 

Vector Health Compliance
Il principale partner in Italia per la conformità al Sunshine Act

Recent Blogs

Cerchi supporto per la compliance al Sunshine Act?

Scopri i nostri Partner consigliati — soluzioni legali, tecnologiche e operative selezionate per accompagnarti nella rendicontazione della trasparenza.

Hai domande pratiche?

Dai un’occhiata alla nostra sezione Domande Frequenti per risposte chiare su scadenze, obblighi e strategie.