FSE Document Validator - CDA L3 & Gateway INI
Valida documenti CDA Level 3 per il Fascicolo Sanitario Elettronico 2.0 italiano: check tag obbligatori HL7, namespace, templateId AGID, OID nazionali. Simula scenari Gateway INI (publishDocument, searchDocument, getDocument) con risposte mock JSON. Tutto client-side - nessun dato clinico trasmesso a server esterni.
Lavori su sistemi sanitari o integrazioni FSE?
Iscriviti alla newsletter mensile di Federico per approfondimenti su interoperabilità sanitaria, standard HL7/FHIR, sviluppo backend in ambito healthcare.
Come utilizzare FSE Document Validator
Incolla il documento CDA L3 nella scheda "Validate CDA XML"
Incolla il tuo XML CDA Level 3, oppure carica il documento di esempio pronto per vedere subito come funziona il validatore su un referto di laboratorio conforme.
Avvia la validazione e leggi il report
Il validatore controlla namespace HL7 v3, elemento radice ClinicalDocument, tag obbligatori (typeId, templateId, id, code, effectiveTime, recordTarget, author, custodian, component), struttura structuredBody e OID nazionali, restituendo errori, avvisi e informazioni.
Passa alla scheda "Gateway INI" per simulare l'integrazione
Seleziona uno degli 8 scenari mock (publishDocument, searchDocument, getDocument con esiti successo/errore) inserendo patientId, documentId o query di ricerca, per testare come la tua integrazione dovrebbe gestire ogni risposta del Gateway INI.
Analizza la risposta JSON simulata
Osserva status HTTP, payload JSON e codici di errore XDS/IHE restituiti da ciascuno scenario per verificare la gestione degli errori nel tuo client prima di integrarti con l'ambiente reale.
Suggerimenti
- Parti sempre dal documento di esempio incluso nel tool: è un referto di laboratorio CDA L3 minimo e conforme, utile come base di partenza da modificare per i tuoi test.
- Presta attenzione agli avvisi (warning), non solo agli errori: un OID non standard o un effectiveTime mal formattato non blocca il documento, ma può causare problemi di interoperabilità con altri sistemi FSE regionali.
- Usa il simulatore Gateway INI per verificare che il tuo client gestisca correttamente tutti gli scenari di errore (409 duplicato, 403 non autorizzato, 404 non trovato), non solo il percorso di successo.
Domande frequenti
Che cosa verifica esattamente il validatore CDA L3?
Controlla il namespace HL7 v3, l'elemento radice ClinicalDocument, la presenza dei tag obbligatori dello standard CDA R2 (typeId, templateId, id, code, effectiveTime, recordTarget, author, custodian, component), il formato dell'OID del documento e del paziente, il formato di effectiveTime e la presenza di structuredBody, indicativo del livello 3 CDA.
I documenti clinici che incollo vengono inviati a un server?
No, la validazione avviene interamente lato client tramite DOMParser del browser. Nessun dato clinico o XML incollato viene trasmesso a server esterni: puoi verificarlo anche testando il tool offline dopo il primo caricamento della pagina.
Cosa sono i "template ID" e come vengono riconosciuti?
I templateId sono OID (es. 2.16.840.1.113883.2.9.10.1.1) che identificano il tipo specifico di documento FSE, come referto di laboratorio, lettera di dimissione, profilo sanitario sintetico o prescrizione farmaceutica. Il validatore riconosce automaticamente 10 tipi di documento comuni confrontando i templateId trovati con il catalogo OID nazionale AGID.
Il simulatore Gateway INI restituisce dati reali dal sistema sanitario nazionale?
No, sono risposte mock generate interamente nel browser, pensate per riprodurre la struttura JSON e i codici di errore XDS/IHE (es. XDSDocumentUniqueIdError, XDSUnknownDocumentEntry) tipici del profilo di interoperabilità INI, utili per testare la gestione degli errori del tuo client prima dell'integrazione reale.
Un documento senza errori è garantito conforme e accettato dal Gateway INI reale?
No. Il validatore copre i controlli strutturali principali dello standard CDA R2 e delle specifiche FSE 2.0, ma non sostituisce la validazione ufficiale contro gli schema XSD e i profili di conformità AGID/Ministero della Salute richiesti per l'accreditamento reale al sistema FSE.