Connettore per l’esportazione dei pagamenti verso Maggioli (JPPA)

Il connettore consente di interfacciarsi verso la piattaforma PagoPA Maggioli ed esportare i pagamenti gestiti da GovPay in un formato compatibile con il protocollo JPPA.

Il protocollo prevede due fasi:

• GovPay invia una notifica al servizio JPPA per ogni ricevuta positiva acquisita da pagoPA.

• Successivamente il servizio JPPA acquisisce le ricevute di pagamento dal servizio RecuperaRT esposto da GovPay.

Tramite il servizio RecuperaRT, vengono acquisiti i tracciati originali delle Ricevute secondo la specifica del servizio JPPA. Tali tracciati sono arricchiti con le informazioni contabili o di accertamento relativi all’importo riscosso per ogni singola voce pendenza, riportando le informazioni delle quote indicate nell’elemento contabilita come segue:

Tabella 30 Mapping dati contabili

Campo	Valore
Capitolo bilancio	vocePendenza.contabilita.quote[].capitolo
Anno	vocePendenza.contabilita.quote[].annoEsercizio
Importo	vocePendenza.contabilita.quote[].importo
Descrizione	vocePendenza.contabilita.quote[].descrizione

Il servizio RecuperaRT è disponibile alla URL: https://host-gp/govpay/backend/api/jppapdp/JppaPdpExternalFacetService. In maniera simile alle altre API messe a disposizione da GovPay, il servizio è fruibile previa autenticazione secondo la modalità individuata dalla configurazione Spring Security, per default con SSL Client Auth.

La spedizione delle notifiche verso la piattaforma Maggioli viene eseguita quotidianamente alle 3 di mattina ed al termine delle spedizioni viene inviato tramite email un report dell’attività in formato CSV.

Fig. 45 Configurazione del Connettore Maggioli (JPPA)

Tabella 31 Parametri di configurazione generale

Campo	Descrizione
Versione CSV	Versione del tracciato di esito
Modalità di consegna	Canale di trasmissione del CSV verso l’ente
Email	Specifica la lista degli indirizzi destinatari separati da virgola
Oggetto	Oggetto della email

Tabella 32 Parametri di configurazione servizio acquisizione ricevute

Campo	Descrizione
Principal	Principal autenticato della chiamata da Maggioli

Tabella 33 Parametri di configurazione servizio notifica pagamenti

Campo	Descrizione
Tipi pendenza	Elenco dei tipi pendenza oggetto di esportazione
URL	URL dei servizi esposti da Maggioli
Versione API	Versione dei servizi da utilizzare
Tipo Autenticazione	Tipo di autenticazione da utilizzare (Nessuna/HTTPBasic/SSL)

Tracciato esiti spedizioni versione 1.0

Per ciascuna notifica di pagamento inviata viene aggiunto un record con l’esito dell’operazione:

Tabella 34 Valori di esportazione

Campo	Descrizione
idDominio	Identificativo Ente Creditore
iuv	Identificativo Univoco Pagamento
cpp	Codice Contesto Pagamento/ReceiptID
esito	OK|ERROR
descrizioneEsito	Descrizione errore spedizione