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:
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.
Selezione della Pendenza Sanzione Amministrativa
Il sistema mostra la seguente maschera
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:
Sezione Riepilogo Informazioni
| 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¶
Sezione form della Sanzione Amministrativa
| Campo | Significato | Note |
|---|---|---|
| Tipo layout | Indica il motore di interpretazione della descrizione formale della maschera di immissione del pagamento da parte del debitore |
|
| Definizione | Mostra il menu di caricamento e visualizzazione della descrizione formale dell’interfaccia di pagamento |
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:
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.
Funzionalità della sezione Elaborazione
| Campo | Significato | Note |
|---|---|---|
| Validazione | Selezione delle funzionalità sulla definizione della validazione in formato Json Schema |
|
| Trasformazione: tipo template | Motore di trasformazione delle informazioni immesse nel Form Dati | Freemarker |
| Trasformazione: Template | Template di defizione della trasformazione dati |
|
| 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
Informazioni 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 |
|
| Template Messaggio | Template di defizione del messaggio della mail di Avviso Pagamento |
|
| 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
Informazioni 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 |
|
| Template Messaggio | Template di defizione del messaggio della mail di Ricevuta Telematica |
|
| 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.
| # | 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.