Tipi Pendenze

Ogni importo che costituisce un versamento deve essere associato ad una pendenza censita sul sistema. La configurazione di questo oggetto determina quindi le coordinate di pagamento e quelle di rendicontazione. Si noti come le pendenze siano associate a un dominio, determinando quindi il tipo di pagamenti che ad esso fanno riferimento. La gestione dei tipi di pendenza permette la generazione di maschere automatiche per l’immissione dei dati, semplificando in modo notevole lo sviluppo di interfacce e ottimizzando i tempi generali di progetto. Le modalità per la creazione di una nuova pendenza sono sempre le medesime (tasto più in basso a destra) e la maschera presentata è la seguente:

Fig. 37 Maschera di creazione di una Nuova Pendenza

Vediamo come modificare una pendenza esistente; ciò ci permetterà di illustrare il dettaglio dei campi presenti. Selezioniamo, ad esempio, la Pendenza Sanzione Amministrativa.

Fig. 38 Selezione della Pendenza Sanzione Amministrativa

Il sistema mostra la seguente maschera

Fig. 39 Modifica del tipo pendenza Sanzione Amministrativa

Possiamo identificare i seguenti raggruppamenti di informazioni:

• Riepilogo Informazioni

• Layout form dati

• Elaborazione

• Promemoria avviso pagamento

• Promemoria ricevuta telematica

A ciascuno di essi è dedicata una sezione di dettaglio, come segue.

Riepilogo Informazioni

La sottosezione si presenta nel seguente modo:

Fig. 40 Sezione Riepilogo Informazioni

Tabella 32 Campi modificabili della prima sezione

Campo	Significato	Note
Descrizione	Descrizione sintetica del tipo di pendenza
Id Tipo Pendenza	Codice tecnico che indica in modo univoco la pendenza	Non modificabile
Tipologia	Tipo di pendenza: dovuta o spontanea
Codifica IUV	Identificatore della struttura del codice IUV
Abilitato	Indica se la Sanzione Amministrativa sia abilitata o meno, quindi sia o meno associabile a domini esistenti
Pagabile da terzi	Indica se la sanzione possa o meno essere pagata non dal debitore

Layout form dati

Fig. 41 Sezione form della Sanzione Amministrativa

Tabella 33 Campi modificabili della sezione Layout Form dati

Campo	Significato	Note
Tipo layout	Indica il motore di interpretazione della descrizione formale della maschera di immissione del pagamento da parte del debitore	Al momento solo Angular Json schema form
Definizione	Mostra il menu di caricamento e visualizzazione della descrizione formale dell’interfaccia di pagamento

Fig. 42 Funzionalità selezionabili per la definizione form

Sono presenti le voci:

• Carica: carica un nuovo file di definizione del form

• Visualizza: visualizza la definizione del form

• Ripristina: ripristina la definizione originaria del form

Vediamo un esempio di un file di definizione dell’interfaccia:

Fig. 43 Funzionalità selezionabili per la definizione form

Elaborazione

La sezione Elaborazione consente a GovPay di descrivere in modo formale come elaborare quanto immesso nella sezione Layout Form Dati al fine di trasformare e inoltrare le informazioni del pagamento alle applicazioni (anche esterne) che ne abbisognino. Si pensi a uno scenario in cui, ad esempio, sia necessario informare un sistema di recupero crediti del fatto che una pendenza abbia superato la data di scadenza.

Fig. 44 Funzionalità della sezione Elaborazione

Tabella 34 Dettagli della sezione Elaborazione

Campo	Significato	Note
Validazione	Selezione delle funzionalità sulla definizione della validazione in formato Json Schema	Carica Visualizza Ripristina
Trasformazione: tipo template	Motore di trasformazione delle informazioni immesse nel Form Dati	Freemarker
Trasformazione: Template	Template di defizione della trasformazione dati	Carica Visualizza Ripristina
Inoltro	Consente di selezionare l’applicazione cui verranno inoltrati i dati	L’applicazione deve essere censita nella sezione Applicazioni

Promemoria Avviso Pagamento

La sezione Avviso di pagamento permette l’inoltro automatico verso la mail del debitore dell’avviso di pagamento. La tipologia di definizione del subject e del corpo della mail è, al momento, basata su Freemarker

Fig. 45 Informazioni della sezione Promemoria Avviso Pagamento

Tabella 35 Dettagli della sezione Promemoria Avviso Pagamento

Campo	Significato	Note
Tipo template	Motore di trasformazione delle informazioni immesse nel template oggetto e messaggio della mail di Avviso Pagamento	Freemarker
Template Oggetto	Template di defizione dell’oggetto della mail di Avviso Pagamento	Carica Visualizza Ripristina
Template Messaggio	Template di defizione del messaggio della mail di Avviso Pagamento	Carica Visualizza Ripristina
Allega pdf avviso	Permette di allegare o meno il pdf dell’avviso di pagamento alla mail di promemoria

Promemoria Ricevuta Telematica

La sezione Promemoria Ricevuta Telematica è del tutto analoga a quella relativa all” Avviso di pagamento: essa permette l’inoltro automatico verso la mail del debitore della ricevuta telematica dell’avvenuto pagamento. Anche in questo caso la tipologia di definizione formale del oggetto e del corpo della mail è, al momento, basata su Freemarker

Fig. 46 Informazioni della sezione Promemoria Ricevuta Telematica

Tabella 36 Dettagli della sezione Promemoria Ricevuta Telematica

Campo	Significato	Note
Tipo template	Motore di trasformazione delle informazioni immesse nel template oggetto e messaggio della mail di Ricevuta Telematica	Freemarker
Template Oggetto	Template di defizione dell’oggetto della mail di Ricevuta Telematica	Carica Visualizza Ripristina
Template Messaggio	Template di defizione del messaggio della mail di Ricevuta Telematica	Carica Visualizza Ripristina
Allega pdf avviso	Permette di allegare o meno il pdf della Ricevuta Telematica

Esempio di scenario di utilizzo

Come esempio di scenario di utilizzo possiamo cercare di mappare, sui componenti presentati, un semplice processo reale: si supponga di gestire, infatti, il pagamento spontaneo di dieci buoni pasto elettronici con relativo inoltro della codifica elettronica univoca, previo pagamento andato a buon fine, al richiedente.

Tabella 37 Gestione buoni pasto elettronici

#	Oggetto della pendenza	Passo di processo
1	Layout form dati	Definizione form in cui si chiede il numero di buoni pasto richiesti
2	Elaborazione.Validazione	Gestione delle soglie (es. massimo 20 buoni pasti a richiesta)
3	Elaborazione.Trasformazione	Creazione della pendenza correlata al numero di buoni mensa effettivamente richiesti (es. determinazione del costo finale, con le varie franchigie, aggravi amministrativi e via dicendo)
4	Elaborazione.Applicazione	Interfacciamento con l’applicazione verticale che crea i codici relativi ai buoni mensa richiesti

E” di tutta evidenza come questo non sia che uno dei molteplici processi che sono formalmente definibili, quindi implementabili direttamente, con i meccanismi appena visti, da GovPay.