Configurazione
Dalla versione 4.2.5 di Titulus è stata introdotta la gestione degli Ordinativi Informatici verso un ente cassiere.
Voci di indice
Il salvataggio degli ordinativi trasmessi da U-GOV avviene tramite l'associazione di una voce di indice, attraverso cui definire:
- La classificazione per i mandati;
- Il Responsabile del procedimento (UOR/RPA) dei mandati, che *deve appartenere alla stessa AOO indicata in configurazione;
- Le altre assegnazioni di responsabilità: copia conoscenza, conferenza di servizi, etc.;
- Il workflow da avviare automaticamente alla registrazione dei mandati.
- La modalità di composizione dell'oggetto della PEC da inviare alla banca - TITULUS-3783Getting issue details... STATUS
- Il tipo di ricevute pervenute dalla banca e associate ai relativi ordinativi su Titulus, da inviare a U-GOV tramite ftp - TITULUS-3783Getting issue details... STATUS
Sono previste 4 diverse voci di indice, per 4 tipi di salvataggio: Inserimento MANDATO, inserimento REVERSALE, annullamento MANDATO, annullamento REVERSALE.
Pagina impostazioni avanzate
Accedendo alla pagina delle impostazioni avanzate di Titulus è possibile configurare ed attivare la gestione:
Configurare le varie impostazioni presenti, in particolare:
- Indicare i dati di accesso al server FTP di U-GOV
- Indicare i vari percorsi all'interno del sito ftp
- Indicare il codice amministrazione + codice AOO dai documenti da registrare. Ad esempio: /UNKICLE/
- Indicare le voci di indice da utilizzare
Gestione flussi di ritorno
- Solo messaggi di elaborazione: inoltrerà nella directory FTP(S) di scambio flussi/ricevute con UGOV i messaggi di elaborazione (acquisizione e rifiuto flusso).
[POPSO]: I messaggi di elaborazione sono file denominati RICEVUTA-XML-1.0-SIGNED.xml. **
Attenzione: I messaggi di esito con valore ACQUISITO o NON ACQUISITO sono considerati messaggi di elaborazione, quindi con tale impostazione verranno inoltrati via FTP anche i messaggi di esito (denominati GESTES-RESULT-SIGNED.xml) ma solo quelli con valore ACQUISITO/NON ACQUISITO. - Solo messaggi di esito: inoltrerà nella directory FTP(S) di scambio flussi/ricevute con UGOV i messaggi di esito, che contengono quindi la rendicontazione giornaliera dell'esiti degli ordinativi (PAGATO/STORNATO/RISCOSSO/...) .
[POPSO]: I messaggi di esito sono file denominati GESTES-RENDI-SIGNED.xml. - Tutti: inoltra via FTP tutte le notifiche ricevute dall'ente cassiere.
- Nessuno: non inoltra nessuna notifica,
- Il giornale di cassa viene sempre inoltrato via FTP indipendentemente dalla configurazione scelta.
**: Per evitare la scrittura su FTP dei file di elaborazione (RICEVUTA-XML-1.0-SIGNED), a partire dalla versione di Titulus 04.04.01 si può richiedere al supporto tecnico di modificare la seguente configurarazione avanzata impostando nelle ultime due property dell'immagine seguente rispettivamente i valore:
([/doc/tipologia/@cod]=ordinativo) AND (([/doc/rif_esterni/rif/interoperabilita/@notifyUGOV]=false) OR (([/doc/rif_esterni/rif/interoperabilita/interoperabilita/@notifyUGOV]=false) AND (([/doc/rif_esterni/rif/interoperabilita/interoperabilita/#interop_notify_by_type]="messaggio_rifiuto_flusso|false") OR ([/doc/rif_esterni/rif/interoperabilita/interoperabilita/#interop_notify_by_type]="messaggi_esito_applicativo|false")))) /doc/rif_esterni/rif//interoperabilita[@notifyUGOV='false' and not(@title='RICEVUTA-XML-1.0-SIGNED')]
Impostazioni avanzate (tramite assistenza)
Tramite assistenza help-desk Titulus si può accedere ad altre impostazioni avanzate e:
- Eventualmente modificare il modello del documento xml da registrare in Titulus per i mandati/reversali
- Cambiare l'operatore per le operazioni di registrazione in Titulus di mandati/reversali
- Configurare le query interne per n4u
Trasformazione xsl dell'allegato
- Inserire un file xsl per la trasformazione html degli ordinativi: ordinativi.xsl
- Inserire una regola di trasformazione per gli ordinativi, che punti a quel file xsl, come segue:
ordinativi.xsl , .[ends-with(@name,'.xml')]/ancestor::doc/tipologia[@cod='Ordinativo']
Disattivazione della firma XADES
- Modificare la Regola XPATH di attivazione della firma di tipo XML, come segue:
.[ends-with(@name,'.xml')][not(./ancestor::doc/tipologia[@cod='Ordinativo'])]
Funzionamento
Flusso operazioni
Previa configurazione e attivazione del servizio, Titulus dialogherà con U-GOV tramite un sito ftp secondo il flusso seguente
1. U-GOV deposita sul sito ftp, in una cartella dedicata ai file in uscita, i flussi degli ordinativi da inviare alla banca.
2. Titulus per ogni file trovato sull'ftp:
2.1 Scompone il flusso in modo da ottenere un flusso per ogni ordinativo/reversale
2.1.1 Se si tratta di un INSERIMENTO/VARIAZIONE
2.1.2 Se NON è già inserito in Titulus
2.1.2.1 Registra una bozza in arrivo, di tipologia 'Ordinativo', a cui allega il flusso da inviare alla banca
2.1.2.2 Applica la voce di indice configurata alla bozza, provvedendo a classificare la bozza, assegnarla ed avviare il workflow configurato per l'iter autorizzativo e di firma personalizzato del cliente.
2.1.2.3 Se si trattava di una variazione
3.1.2.3.1 Aggiunge una nota al documento in bozza appena creato, in cui si segnala l’assenza del precedente
2.1.3 Se è già stato inserito in Titulus
2.1.3.1 Se protocollato:
2.1.3.1.1 Crea una nuova bozza in Titulus
2.1.3.1.2 Annulla il protocollo precedente riportando la motivazione configurata
2.1.3.1.3 Collega i due documenti
2.1.3.2 Se ancora in bozza:
2.1.3.2.1 Sostituisce la bozza trovata con quella nuova, riportando eventuali collegamenti della vecchia bozza su quella nuova.
Esempio di un mandato registrato:
2.2. Archivia il flusso spostando l'xml in una sottocartella del percorso ftp configurato.
3. Quando viene invocata la funzione 'Invia ordinativo informatico' tramite workflow su una data bozza:
3.2 Viene inviato l'ordinativo firmato alla banca
3.3 Vengono gestite le notifiche PEC relative all'invio
3.4 Quando viene ricevuto nella casella PEC un messaggio dalla banca, relativo all'ordinativo inviato, Titulus associa l'allegato xml firmato di risposta, all'ordinativo cui si riferisce. Da visualizzazione del documento si può aprire il contenuto della risposta, che viene identificato da un'apposita icona.
3.4.1 - TITULUS-3783Getting issue details... STATUS In base all'impostazione Notifiche ricevute dalla banca da mandare a UGOV via ftp, marca la ricevuta per il successivo invio a UGOV. Le possibili scelte sono:
- Solo messaggi di elaborazione Notifiche xml con elemento radice corrispondente a messaggio_rifiuto_flusso, messaggio_ricezione_flusso. Più notifiche xml con elemento radice messaggi_esito_applicativo in cui esista il campo /messaggi_esito_applicativo/esito_mandati/esito_operazione valorizzato con ACQUISITO o NON ACQUISITO
- Solo messaggi di esito Notifiche xml con elemento radice corrispondente a messaggi_esito_applicativo non incluse nel caso precedente
- Tutti
- Nessuno
4. Quando viene ricevuto nella casella PEC un messaggio dalla banca, il cui oggetto contiene messaggio_esito_esecuzione, questo viene riconosciuto come esito giornaliero/giornale di cassa. Questo viene associato a una nuova documento in Titulus come bozza di documento in arrivo, ricevuta via PEC. La bozza è assegnata al responsabile dell'AOO a cui è associato l'indirizzo PEC ricevente. Il file è marcato per linvio a U-GOV
5. Titulus identifica i messaggi marcati per l'invio a U-GOV e copia gli allegati xml firmati sul sito ftp configurato, in una cartella dedicata ai file in entrata.
Pagina di gestione
Quando è attiva la gestione degli Ordinativi Informatici, è presente un diritto aggiuntivo da assegnare alle persone interne di ACL: Abilita gestione ordinativi informatici. Gli utenti che hanno tale diritto vedono nella schermata principale di Titulus il pulsante Ordinativi che permette loro di accedere alla pagina di ricerca e gestione degli ordinativi.
- Attraverso il pulsante Avvia ricerca si possono ricercare i documenti relativi ai mandati e alle reversali, in base ai filtri impostati. Accedendo ai vari documenti si può procedere nell'iter autorizzativo tramite le eventuali azioni di workflow disponibili per ogni singolo documento;
- Attraverso il pulsante Azioni workflow vengono mostrate le azioni di workflow disponibili all'utente, relativi ai mandati e alle reversali, in base ai filtri impostati. In questo modo si può procedere nell'iter autorizzativo di più documenti contemporaneamente (ad esempio, la firma elettronica di più ordinativi).
Esecuzione script per la Gestione degli Ordinativi Informatici
Modulo gestione ordinativi
Il modulo Ordinativi, la cui esecuzione si intende da schedulare a intervalli periodici, svolge ad ogni esecuzione queste operazioni principali:
1. Registra su Titulus gli ordinativi esportati da U-GOV su ftp (nel percorso indicato in configurazione)
2. Gestisce i casi di annullamento e variazione degli ordinativi
3. Registra sul sito ftp di U-GOV (nel percorso indicato in configurazione) gli xml di risposta ricevuti dalla banca, marcati come da inviare (dipende anche dalle impostazioni): messaggio rifiuto flusso o messaggio accettazione flusso e esito giornaliero.
Modulo MSA
Il componente MSA di Titulus, quando è attiva la gestione degli Ordinativi, verifica periodicamente i messaggi presenti nella casella PEC ricevuti dalla banca e:
- associa agli ordinativi inviati alla banca le relative ricevute PEC;
- individua i messaggi di esito giornaliero, e li registra in Titulus come bozze di documento in arrivo, ricevute via PEC. La bozza è assegnata al responsabile dell'AOO a cui è associato l'indirizzo PEC ricevente.