Scheda di collaudo Integrazione NoTIER Ente Data Collaudo Versione Data Autore Cambiamenti apportati 1.0 18/03/2015 Intercent-ER Prima stesura 1.1 26/05/2015 Intercent-ER Integrate revisioni del Parer 1
Sommario Scheda di collaudo Integrazione NoTIER - Ente XXX... 1 1 COMPONENTI OGGETTO DI COLLAUDO... 3 2 PRECONDIZIONI... 4 3 CASI DI TEST... 4 3.1 Processo di Ciclo Attivo... 4 3.2 Processo di Ciclo Passivo... 6 3.3 Processo di Integrazione e Conservazione... Errore. Il segnalibro non è definito. 2
1 COMPONENTI OGGETTO DI COLLAUDO Di seguito si riportano le Macro-Funzioni oggetto di verifica (selezionare il box di interesse): CICLO ATTIVO (invio fattura e nota di credito) 1) Servizi REST per l invio di fatture e note di credito a NoTIER 2) Servizi REST per il recupero di notifiche SDI relative ai documenti inviati, notifiche di esito versamento in conservazione e relativi metadati 1. CICLO PASSIVO (ricezione fattura e nota di credito) 1) Servizi REST per il recupero da NoTIER di fatture e note di credito e relativi metadati 2 e notifiche di esito versamento. 2) Servizi REST per l invio di notifiche di esito committente; 3) Servizi REST per l integrazione dati fiscali relativi ai documenti di ciclo passivo finalizzato al versamento in conservazione. 1 Come descritto nel Documento di Specifiche Tecniche dei Servizi (ver 1.14) 2 Come descritto nel Documento di Specifiche Tecniche dei Servizi (ver 1.14) 3
2 PRECONDIZIONI L'ambiente che sarà usato per i test da remoto dovrà essere identico all'ambiente di produzione e dovrà puntare all'ambiente di test di Notier. I test dovranno riguardare prove che l'ente ritiene utile (quanto più possibili casi reali). Sarà possibile scegliere tra i file di esempio messi a disposizione sull area dematerializzazione del sito di IntercentER oppure altri decisi dall'ente stesso. Per effettuare i test di ricezione di fatture elettroniche dovrà essere utilizzato esclusivamente il codice UFE IPA di test attribuito dalla Segreteria Tecnica NoTIER. Per effettuare i test di versamento in conservazione è necessario comunicare a Helpdeskparer HelpdeskParer@Regione.Emilia-Romagna.it e a Support.notier@regione.emilia-romagna.it il codice del registro di conservazione di TEST dei documenti oggetti di collaudo secondo il template allegato 1. E necessario che il registro di test utilizzato per le prove, di cui al punto precedente, sia uno fra quelli indicati nel modulo di Iscrizione ai servizi NoTIER in modo da rispettare le regole ivi previste (codice, tipo numerazione nel registro e ciclo di spesa). E necessario che il client abbia precedentemente verificato in modo autonomo i casi di test riportati nell allegato 2. 3 CASI DI TEST 3.1 Processo di Ciclo Attivo Il caso di uso che descrive tale processo si compone in generale della seguente sequenza: Il Client Committente si autentica sul Servizio REST Invio Documento 3 ed invia un Documento Fiscalmente rilevante esempio Fattura o Nota di credito (d ora in poi F/NC). NoTIER controlla la validità sintattica e semantica del Documento utilizzando la versione attuale del Validatore UBL XSD e semantico SCH. NoTIER salva il Documento e restituisce al Committente il file di metadati con l urn del Documento salvato. NoTIER effettua la transcodifica da UBL a SDI e verifica che il formato risultante sia valido secondo XSD di SDI. L utente con ruolo firmatario (admin NoTIER) firma il documento in formato SDI. L utente WEB approva il documento precedentemente firmato 4 utilizzando l apposita funzione sull interfaccia Web di NoTIER. Il Documento viene inviato da NoTIER a SDI come previsto dalle specifiche tecniche del relativo servizio 5. SDI valida il Documento e lo consegna al destinatario, inviando a NoTIER una Notifica di Consegna destinata al 3 Come descritto dal Documento di Specifiche tecniche di Servizi (ver 1.14). 4 Questa fase viene esclusa se il client ha specificato l approvazione automatica in fase di invio. 5 In particolare le specifiche su come comporre il nome del file da inviare e il progressivo numerico da generare. 4
Committente 6. Solo nel caso di Ciclo Attivo, NoTIER estrae i dati necessari per l Integrazione dei dati Fiscali del Documento fiscalmente rilevante all atto dell invio dello stesso. NoTIER versa sul sistema di conservazione Parer la fattura/nota di credito e le notifiche SDI sul registro indicato dal chiamante una volta ricevuta una ricevuta di consegna o di una ricevuta di mancata consegna da SDI. In modalità asincrona SDI invia a NoTIER una Notifica di Esito destinata al Cedente. Il client cedente recupera da NOTIER attraverso i servizi REST la ricevuta di consegna, la notifica esito\notifica di decorrenza termini e la notifica di esito versamento Parer. NoTIER rende disponibile al Cedente l esito relativo al positivo versamento in Conservazione che viene salvato come Documento e associato ad un urn. Parer verifica la correttezza dei metadati e dei documenti nel sistema di conservazione. Segue check list di test: DESCRIZIONE TEST NOTE DATA ESITO 1 Verifica autenticazione e profilazione Organizzazione Client Cedente su servizio REST Invio Documento 2 Controllo validità sintattica (XSD) e Semantica (SCH) di una Fattura e di una nota di credito UBL inviata tramite servizio REST Invio Documento 3 Salvataggio in NoTIER di un Documento (Fattura\NC) Inviato tramite servizio REST Invio Documento. Transcodifica del documento dal formato UBL 2.1 a SDI 1.1 e validazione sintattica. Il Documento in formato SDI 1.1 viene firmato ed inviato a SDI. 4 Client recupera la Notifica di Ricevuta di Consegna (ricevuta da SDI) messa a disposizione da NoTIER relativa al Documento precedentemente inviato. 6 Il caso di test si applica anche alla Notifica di Scarto, Mancata Consegna o decorrenza Termini. 5
5 Client recupera la Notifica di Esito \ Decorrenza termini (ricevuta da SDI) messa a disposizione da NoTIER relativa al Documento precedentemente inviato 6 NoTIER versa il Documento inviato a SDI e tutti i Documenti ad esso collegati (Notifiche) su Parer 7 Client recupera la Notifica di Esito Versamento positivo (ricevuta da Parer) messa a disposizione da NoTIER relativa al Documento inviato in conservazione. 8 Parer verifica la correttezza dei metadati e del documento versato rispetto ai dati attesi nel sistema di conservazione e ne da conferma all Ente e a Intercent-ER. 3.2 Processo di Ciclo Passivo Il caso di uso che descrive tale processo si compone in generale della seguente sequenza: SDI invia a NoTIER un Fattura/Nota di credito destinata ad un Client Committente. NoTIER converte la F/NC da formato FatturaPA a formato UBL2.1 ed effettua la validazione sintattica e semantica del documento, salva il documento associandolo all ufficio ID NoTIER corrispondente. Il Client Committente si autentica sul Servizio REST Recupero 7 e recupera la lista di Documenti di cui è destinatario. Il Client Committente si autentica sul Servizio REST Recupero ed effettua il recupero puntuale del Documento inviato da SDI, specificando il relativo urn NoTIER. Il Client Committente si autentica sul Servizio REST Invio Documento ed invia una Notifica di Esito Committente a NoTIER. NoTIER invia a SDI la Notifica di Esito Committente e gestisce la risposta da SDI in modalità sincrona 8. Solo nel caso di Ciclo Passivo, Il client Committente si autentica sul Servizio REST di Integrazione e effettua l invio dei dati fiscalmente rilevanti relativi al Documento precedentemente recuperato che sono necessari per l invio in Conservazione. NoTIER versa sul sistema di conservazione Parer la fattura/nota di credito e le notifiche SDI sul registro indicato dal chiamante. NoTIER rende disponibile al Committente l esito relativo al positivo versamento in 7 Come descritto dal Documento di Specifiche tecniche di Servizi (ver 1.14) 8 La risposta consiste in un codice di conferma o una Notifica di Scarto di Esito Committente 6
Conservazione che viene salvato come Documento e associato ad un urn. Parer verifica la correttezza dei metadati e dei documenti nel sistema di conservazione. Segue check list di test: 1 DESCRIZIONE TEST NOTE DATA ESITO Il Client Committente Recupera la lista di Documenti di cui è destinatario specificando l ID NoTIER 2 Il Client Committente Recupera puntualmente un documento specificando il relativo urn NoTIER 3 Il Client Committente invia una Notifica di Esito Committente relativa alla Fattura\nota credito precedentemente recuperata 4 NoTIER invia a SDI la Notifica di Esito Committente tramite il servizio WS SDiRiceviNotifica e ne gestisce la risposta 5 Il Client Committente recepisce la risposta ricevuta da SDI relativa all invio della Notifica di Esito Committente (scarto esito committente). 6 Il Client Committente effettua l Integrazione dei Dati Fiscalmente rilevanti tramite il servizio REST di Integrazione di NoTIER su un documento F/NC. NoTIER versa il Documento inviato da SDI e tutti i Documenti ad esso collegati (Notifiche) sul Parer. 7
7 Client recupera la Notifica di Esito Versamento positivo (ricevuta da Parer) messa a disposizione da NoTIER relativa al Documento inviato in conservazione su Parer. 8 Parer verifica la correttezza dei metadati e del documento versato rispetto ai dati attesi nel sistema di conservazione e ne da conferma all Ente e a Intercent-ER 8
Allegato 1 Comunicazione del registro per l esecuzione dei test di versamento dei documenti fiscali Attenzione: come richiesto nelle premesse è necessario che il registro di test utilizzato per le prove sia uno fra quelli indicati nel modulo di Iscrizione ai servizi NoTIER in modo da rispettare le regole ivi previste (codice, tipo numerazione nel registro e ciclo di spesa). Registro di conservazione di test Codice registro Descrizione registro Ciclo della spesa Formato numerazione della fattura nel registro 9 Inserire il codice identificativo del registro/sezionale/bollato in cui sono registrate presso l ente le fatture in formato elettronico che si inviano in conservazione. Si precisa che il codice del registro deve essere univoco (cioè non possono esserci più registri con lo stesso codice). Inserire la descrizione o intestazione completa del registro Inserire il ciclo di spesa a cui si riferisce il registro: Fatturazione attiva Fatturazione passiva Inserire un esempio di numerazione e specificare il significato di ciascun elemento che compone il formato numero. Ad esempio: ACQ20140001 ACQ: codice registro 2014: anno di emissione 0001: numero progressivo annuale Se nello stesso registro sono presenti più sequenze di numerazione indicarle tutte. 9 Si precisa che il numero della fattura attiva deve essere univoco nell ambito di tutte le fatture attive emesse dall ente in un determinato anno in quanto questo è uno dei controlli a cui SDI sottopone la fattura all atto del suo ricevimento. Si consiglia, pertanto, a maggior ragione nel caso i registri delle fatture attive siano più di uno, di riportare nel numero, oltre al numero progressivo, anche il codice del registro ed eventualmente l anno (quest ultimo obbligatoriamente nel caso in cui il numero progressivo venga azzerato all inizio di ogni anno). Il numero della fattura passiva deve essere univoco nell ambito del registro e dell anno. 9
Allegato 1 ESEMPI VED Registro per le fatture attive relativo alle vendite differite Fatturazione attiva VED-20150001 VED: codice registro 2015:anno 0001: numerazione progressiva annuale 03 Registro delle fatture attive Fatturazione attiva PI20150156 PI: protocollo contabile di registrazione 2015:anno 0156: numerazione progressiva annuale FT Registro unico delle fatture Fatturazione passiva 6 numerazione annuale ACQUISTI Registro degli acquisti relativi ad attività istituzionale Fatturazione passiva 001 numerazione annuale 10