NoTI-ER: specifiche funzionali

Il Sistema di Interscambio prevede un flusso di messaggi articolato, come descritto in figura sottostante.

È importante notare come NoTI-ER si ponga intermediario completo nei confronti di SdI, implementando sia le funzioni di trasmissione che di ricezione.

La logica di integrazione con SdI è stata realizzata secondo le specifiche di servizio in modalità Web Service, che prevedono l’implementazione di due Web Services SOAP deputate all’ invio (Trasmissione) e alla ricezione (Ricezione). Si noti, inoltre, che le specifiche di servizio SdI impongono che le fatture trasmesse (e ricevute) nel formato FatturaPA siano firmate tramite un Certificato di Firma Elettronica Qualificata secondo i formati CAdES-BES o XAdES-BES previsti dalle direttive AgID ^[13].

Per raccordare i vari documenti del flusso, in particolare fatture e relative notifiche, SdI associa ad ogni documento in ingresso un identificativo numerico univoco, detto identificativo SdI che viene utilizzato come riferimento per le successive notifiche. Tale identificativo viene comunicato da SdI a NoTI-ER in fase di invio (o ricezione) di una fattura e opportunamente salvato.

Come già accennato ai capitoli precedenti, NoTI-ER integra al suo interno un Access Point accreditato Peppol ^[14] e si serve del SMP Unico della PA ^[15], messo a disposizione dalla Peppol Authority italiana AGID ^[16], per utilizzare l’infrastruttura BusDox ed inviare e ricevere documenti di e-Procurement in formato UBL.
Così come previsto dal progetto europeo EeISI ^[17], tale Access Point implementa in trasmissione e in ricezione il protocollo AS4, che va in sostituzione del precedente AS2.

Con l’entrata in vigore dell’obbligatorietà per le Aziende Sanitarie italiane di raccordarsi con il Nodo di Smistamento Ordini, per la gestione dell'ordine elettronico, NoTI-ER - nel suo ruolo di intermediazione per le Pubbliche Amministrazioni della regione Emilia-Romagna - si interfaccia con NSO in uno scenario di validazione dei documenti, detto "scenario di validazione con terza parte in ingresso".

La trasmissione degli ordini elettronici fra PA e suo fornitore avviene per tramite della rete Peppol. In corrispondenza dell’invio di un documento verso l'Access Point del destinatario, NoTI-ER provvede ad inoltrare lo stesso anche ad NSO, che effettua i controlli necessari e, a sua volta, comunica l’esito di validazione a NoTI-ER stesso.
Anche in questo caso, NSO associa ad ogni documento in ingresso un identificativo numerico univoco, detto identificativo NSO che viene utilizzato come riferimento per le successive notifiche.

SATER (piattaforma di eProcurement) è lo strumento adottato da Intercent-ER a supporto del processo di innovazione delle piccole e medie imprese e, da ottobre 2021, anche delle Pubbliche Amministrazioni che decidono di avvalersi dei servizi semplificati offerti dalla piattaforma.
Intercent-ER mette a disposizione delle imprese fornitrici, nell’ambito del Nodo Telematico di Interscambio dell’Emilia-Romagna, uno strumento accessibile via web, attraverso il quale le stesse possono ricevere ordini ed inviare documenti di trasporto (tramite Peppol) e fatture ai soggetti che hanno obbligo o facoltà di utilizzo del Sistema SiCiPa-ER.
Considerato che l’interfaccia di accesso alle imprese è la piattaforma di eProcurement, si è scelto di operare un’integrazione tra questo sistema e NoTI-ER, con i seguenti obiettivi:

Le modalità di versamento in Conservazione previste dalle specifiche tecniche di ParER prevedono la creazione di una Unità Documentaria in cui vengono inseriti tutti i componenti di un singolo flusso documentale.
In particolare, se si considera come riferimento il flusso specificato da SdI, si effettua in un’unica fase il versamento del documento principale (fattura nel formato FatturaPA firmata) e di tutte le notifiche SdI (consegna, scarto, esito, etc.) ad esso correlate, anche se in qualità di annessi del documento principale. Il versamento del documento principale e dei suoi annessi avviene in determinate fasi dei processi di e-Procurement gestiti da NoTI-ER.
ParER, inoltre, richiede che all’atto del versamento siano indicati alcuni dati specifici di Integrazione Fiscale. Tali dati sono estratti direttamente dal documento, oppure vengono inviati dall’utente a seconda del Processo di e-Procurement ^[20].

Come specificato nei capitoli precedenti, NoTI-ER adotta UBL, nelle sue versioni di UBL BIS2.1 e UBL BIS_3, come formato XML di riferimento per rappresentare i documenti di e-Procurement.
Esistono precisi standard che descrivono come deve essere composto un documento UBL^[21], con riferimento sia a regole sintattiche (quali campi valorizzare in base al relativo schema XSD) sia a regole semantiche (come tali campi devono essere valorizzati).
NoTI-ER integra una logica che esegue entrambe le validazioni sui documenti UBL in transito sul sistema.

Il requisito di integrazione con SdI ha invece reso necessario integrare una logica che, in fasi specifiche del processo, effettui la traduzione dal formato UBL a quello fatturaPA (e viceversa).
Questo avviene perchè il formato fatturaPA è attualmente l’unico supportato dal Sistema di Interscambio, mentre gli iscritti a NoTI-ER supportano, lato loro, il formato UBL.

A questo punto, esistono in NoTI-ER due tipologie di transcodifica:

Per entrambi i tipi, il documento viene sottoposto ad una trasformazione XSLT che lo converte da un formato ad un altro.

Infine, al termine del processo di transcodifica, NoTI-ER esegue sempre la validazione del documento risultante.

SdI richiede che il file in formato fatturaPA sia dotato di firma elettronica qualificata, pertanto in NoTI-ER è stata integrata una logica che prevede che il file in fatturaPA, risultante dal processo di transcodifica da UBL, sia firmato ^[22].
La firma di tutte le fatture in formato FatturaPA viene effettuata da Intercent-ER ed il successivo invio a SdI è condizionato all’approvazione dell’ufficio emittente della fattura UBL originale, che può essere:

I documenti in formato UBL e fatturaPA sono file XML.
Per consentire la visualizzazione degli stessi in una modalità che garantisca immediata comprensione, NoTI-ER integra una funzione di visualizzazione dei documenti, producendo un formato HTML formattato a partire dal file originale.
Per ottenere questo risultato, NoTI-ER mantiene aggiornati i fogli di stile XSLT di ciascun documento, sia per il formato UBL che per il formato fatturaPA.

La visualizzazione può avvenire in due modalità:

Tutti i documenti gestiti da NoTI-ER, a parte il tipo documento "catalogo", vengono identificati con una chiave logica composta secondo i parametri:

A partire dalla chiave, NoTI-ER prevede la creazione di un URN ^[26] che identifica univocamente la risorsa documento.
Tale URN viene composto a partire dalla chiave logica, come segue:

Un esempio: urn:notier:AAOSPCN_01_Uff_eFatturaPA:2020:L1E_20202000000222:CA:FATTURA

In conformità con i requisiti di tracciabilità, NoTI-ER salva tutti i formati associati ai documenti in transito sul sistema.
Per esempio, prendendo una fattura inviata da un Ufficio, NoTI-ER:

Tutti questi file vengono associati al medesimo documento e sono resi disponibili per la visualizzazione e il download, tramite apposita funzione dell’interfaccia Web.
Analogamente, NoTi-ER salva tutti i metadati associati al documento, corrispondenti alle diverse fasi in cui viene elaborato dal sistema (ad esempio, i metadati d’invio).
Queste funzioni, unitamente al salvataggio sui log applicativi delle azioni eseguite dagli attori che operano sul sistema, consentono la completa tracciabilità di tutte le fasi e di tutti gli attori coinvolti nella gestione di ogni singolo documento transitante sul sistema.

NoTI-ER supporta la possibilità di sovrascrivere un documento preesistente previo il suo versionamento.
In particolare, nel momento in cui un documento che deve andare a sovrascriverne un altro entra in NoTI-ER, vengono effettuate le seguenti azioni:

Si noti che la sovrascrittura non è sempre ammessa da NoTI-ER, ma è vincolata a precisi requisiti che deve avere il documento a seconda della fase in cui si trova.

Per convenzione, si considera il processo di Outbound come l’insieme di tutte le fasi che seguono l’invio su NoTI-ER di un documento principale.

In fase di Invio, l’ufficio emittente deve specificare l’instradamento da assegnare al documento.
La scelta dei canali verso i quali si sceglie di far transitare il documento viene effettuata al momento della compilazione dei metadati di invio.
In particolare, questo avviene mediante la valorizzazione a true o false di alcuni campi che devono essere presenti nel file XML:

I flussi che sono compresi in questo processo, dove i documenti che ne prendono parte vengono classificati come documenti inviati, sono:

Oltre ai quattro documenti principali, vengono classificati documenti di CA anche i documenti correlati, di ritorno da questi flussi:

Per convenzione, si considera il processo di Inbound come l’insieme di tutte le fasi che seguono la ricezione in NoTI-ER di un documento principale.

Il processo di Inbound assume due forme:

A seguito della ricezione di documenti principali provenienti da SdI, l'ufficio potrà in seguito recuperare tutte le notifiche correlate ed inviare, eventualmente, una notifica di esito committente.

I flussi compresi in questo processo di cui i documenti che ne prendono parte vengono classificati come documenti ricevuti, sono:

Quanto descritto in precedenza è valido in generale per i processi di NoTI-ER, al netto di qualche particolarità introdotta a seguito della necessità di recepire il nuovo formato UBL BIS_3 di fattura e nota di credito.

Per rappresentare le varie fasi del processo di e-Procurement in cui un documento si trova, è stato definito un insieme numerabile di stati.
La sequenza di tutte le transizioni tra stati che un documento ha trascorso costituisce il ciclo di vita dello stesso in NoTI-ER.
A partire dall’insieme complessivo di stati, sono state individuate alcune collezioni che vengono chiamate sessioni. In particolare, le sessioni di un documento sono collezioni di stati che descrivono il transito di un documento in NoTI-ER declinato in una specifica direzione.

Pertanto, un documento è associato in maniera mutualmente esclusiva ad una:

Entrambe le sessioni si scindono in riferimento al sistema di integrazione. Avremo, dunque, delle sessioni di invio e di ricezione da e verso SdI, oppure da e verso Peppol.

A queste si possono aggiungere:

Ulteriormente, considerato che il ciclo di vita di un documento non termina con il singolo transito su NoTI-ER, ma prosegue a seguito dell’integrazione con gli altri sistemi, sono state definite delle collezioni di stati specifici del documento stesso, sempre in riferimento alla direzione di instradamento.

Nei paragrafi che seguono, viene mostrata una panoramica di quelli che sono gli stati associati ad ogni sessione, a livello di stato della sessione e di stato del documento corrispondente.

In relazione all’innesco di transizioni da parte di eventi interni, NoTI-ER utilizza una logica basata sullo scheduling, in un’ottica di esecuzione massiva della stessa azione su collezioni di documenti che si trovano nel medesimo stato.
Per effettuare le operazioni appena descritte, NoTI-ER si serve dei seguenti Job ^[45].

Per garantire la statefulness delle singole invocazioni, i servizi di NoTI-ER basati sulle chiamate di tipo POST richiedono che oltre al documento venga inviato anche un apposito file dei metadati ^[51].
Il file dei metadati è un file XML accessorio che consente a NoTI-ER di:

Nel rispetto dei requisiti di tracciabilità, NoTI-ER salva i metadati relativi a tutte le invocazioni ricevute per i suoi servizi.

NoTI-ER gestisce l’accesso ai servizi REST in un contesto di elevata sicurezza, esponendo questi ultimi esclusivamente su protocollo HTTPS con un livello di crittografia/autenticazione basato su TLS ^[52].
Inoltre, ad ogni invocazione dei servizi, vengono effettuate le opportune verifiche di:

La fase di autenticazione viene implementata con la client authentication per mezzo del certificato digitale.
In fase di accreditamento di una nuova organizzazione viene generato un certificato digitale a partire da un certificato CA (Certification Authority), specifico dell’organizzazione stessa.
Al momento dell’invocazione del servizio, il client stabilisce una connessione HTTPS attivando la client authentication, con il proprio certificato, inviando una request all’endpoint di riferimento. La request viene intercettata da NoTI-ER a monte dell’endpoint, che effettua il trusting del certificato client su quello CA.
Se la fase di trusting non viene superata, il client non riesce ad accedere all’endpoint del servizio e la request viene rifiutata.
Se invece il trusting viene superato, NoTI-ER estrae dal certificato client le informazioni specifiche che servono per identificare univocamente l’organizzazione. Tali informazioni vengono aggiunte alla request e vengono utilizzate per effettuare la fase successiva di autorizzazione.
La fase di autorizzazione dipende dal servizio che viene invocato ed esegue tutta una serie di controlli sulla congruenza dei dati da elaborare e sulle abilitazioni del soggetto.

L’interfaccia Web di NoTI-ER è stata progettata per essere:

Analogamente ai servizi esposti, anche l’interfaccia Web di NoTI-ER è accessibile esclusivamente su protocollo HTTPS ^[54], pur non richiedendo la client authentication con certificato digitale.

Le pratiche di accesso all’interfaccia sono del tutto indipendenti rispetto a quelle già viste per l’autenticazione ai servizi. Pur essendo raggiungibile allo stesso URL, l’interfaccia permette l’accesso in base al classico meccanismo di autenticazione e autorizzazione con username e password, oltre a mettere a disposizione il login con SPID.
Username e password vengono generati e comunicati all’utente web in fase di creazione dell’utenza. Gli username vengono costruiti secondo una logica che ne permette di garantire l’univocità e la password è modificabile secondo le preferenze dell’utente ^[55].

Un utente web è l’unico attore client deputato ad operare sull’interfaccia Web NoTI-ER.
Un’utenza viene creata in fase di accreditamento di un’organizzazione o su richiesta specifica di un secondo momento.

L’utente accede ai documenti in transito e ai vari servizi offerti in base ad una relazione associativa con i soggetti (intesi come uffici) al quale lo stesso utente è assegnato. In altre parole, un’utenza ha visibilità sui documenti degli uffici ai quali è stato associato in fase di accreditamento.
In tal senso, NoTI-ER non pone vincoli di associazione, pertanto:

L’interfaccia web si suddivide in varie funzioni (esplicitate dal menu della pagina) e, affinché si possa operare su ognuna di esse, all’utente vengono assegnati dei ruoli ai quali corrispondono dei permessi specifici. Dunque, un utente web è associato ad almeno un ruolo.
I ruoli disponibili e i relativi permessi associati sono, in ordine di privilegi decrescenti:

La profilazione utente avviene in fase di accreditamento dello stesso e può essere modificata facendo richiesta tramite i canali predisposti da Intercenter. ^[56].
L’inserimento di un nuovo utente a sistema può avvenire direttamente da interfaccia ed è un’azione che può essere effettuata da chi possiede almeno il ruolo di Gestione Anagrafica.
A seguito dell’inserimento dei dati e, quindi, dell’accreditamento dell’utente, NoTI-ER esegue quanto descritto:

Raggiunta la pagina di login ^[58] è possibile accedere a NoTI-ER.
Il login a NoTI-ER può essere effettuato in due modalità alternative:

Se il login viene effettuato correttamente, si viene reindirizzati alla Home di NoTI-ER dove comparirà in alto il menu per accedere alle varie funzionalità rese disponibili.
Come già accennato, la possibilità di accedere a determinate funzioni dipende strettamente dai ruoli posseduti dall’utente autenticato.
L’unica funzionalità di NoTI-ER che viene resa disponibile a tutti gli utenti, indistintamente, è quella del "profilo utente", che può essere utilizzata per visualizzare le informazioni anagrafiche e di configurazione del proprio profilo, per effettuare un cambio password e per modificare parametri anagrafici come mail e numero di telefono.
Tenendo presente questo, di seguito è riportato l’elenco che descrive la totalità delle funzioni disponibili in interfaccia.

La creazione di una nuova Organizzazione interna si esegue compilando i campi del tab 'Dati principali' della pagina Crea Organizzazione.

I campi obbligatori sono:

Una volta eseguito il salvataggio dei dati inseriti, si procede alla generazione del Certificato.

Nell’applicazione è possibile censire un nuovo Ufficio, a partire da un’organizzazione esistente. Nel tab 'Dati principali' della pagina Crea Ufficio sono presenti i seguenti campi obbligatori:

Il campo Participant Id Peppol non è editabile e non viene compilato immediatamente da sistema. Solo dopo aver salvato i Dati principali del nuovo ufficio, si procede a definire i tipi di documenti gestiti dall’ufficio e il tipo di trasmissione:

Se l’ufficio viene registrato per la ricezione di ordini e/o documenti di trasporto, il sistema automaticamente crea l’Id Peppol e nel tab 'Configurazione documenti' è possibile verificare la capacità di ricezione Peppol. Tale funzionalità si integra con il servizio esposto dalla Peppol Directorty.

Entrambi organizzazioni interne e uffici interni censiti in NoTI-ER possono essere eliminati attraverso il processo di de-registrazione, che comporta, appunto, l’eliminazione logica dell’organizzazione o ufficio.

Quando perviene una richiesta di de-registrazione di un ufficio interno di Noti-ER, per prima cosa si procede a rimuovere l’ufficio dalla rete Peppol e scollegarlo dal canale di ricezione NoTI-ER presso IndiceIPA (a carico dell’ufficio richiedente). Seguono poi le tre fasi di de-registrazione: