GovPay - Porta di accesso al sistema pagoPA - RT Batch

Sommario

Batch Spring Boot per il recupero automatico delle Ricevute Telematiche (RT) da pagoPA tramite API REST. Il sistema acquisisce le RT mancanti interrogando il Nodo dei Pagamenti e le riconcilia con i pagamenti esistenti nel database GovPay.

Funzionalita' principali

• Acquisizione RT: Recupero automatico delle ricevute telematiche dal Nodo pagoPA
• Riconciliazione: Matching automatico con i pagamenti presenti nel database GovPay
• Multi-database: Supporto per PostgreSQL, MySQL/MariaDB, Oracle, SQL Server, HSQLDB
• Schedulazione: Esecuzione periodica configurabile o trigger manuale
• Retry automatico: Gestione errori con retry e backoff esponenziale
• Containerizzazione: Immagine Docker pronta per il deploy

Requisiti

• Java 21+
• Maven 3.6.3+
• Database supportato (PostgreSQL, MySQL, Oracle, SQL Server, H2)

Compilazione

mvn clean install

Esecuzione

# Avvio applicazione
java -jar target/govpay-rt-batch.jar

# Con profilo specifico
java -jar target/govpay-rt-batch.jar --spring.profiles.active=prod

Configurazione Docker

docker run -d \
  -e GOVPAY_DB_TYPE=postgresql \
  -e GOVPAY_DB_SERVER=db-host:5432 \
  -e GOVPAY_DB_NAME=govpay \
  -e GOVPAY_DB_USER=govpay \
  -e GOVPAY_DB_PASSWORD=secret \
  -e GOVPAY_RT_API_ENV=uat \
  -e GOVPAY_RT_API_SUBSCRIPTIONKEY=your-key \
  linkitaly/govpay-rt-batch:latest

Database supportati

Database	Versione minima
PostgreSQL	9.6+
MySQL	5.7+
MariaDB	10.3+
Oracle	11g+
SQL Server	2016+
HSQLDB/H2	(sviluppo)

Documentazione

• ChangeLog - Storia delle modifiche e release
• Wiki - Documentazione completa

License

Questo progetto e' distribuito sotto licenza GPL v3. Vedere il file LICENSE per i dettagli.

Contatti

• Progetto: GovPay RT Batch
• Organizzazione: Link.it

---

Questo progetto e' parte dell'ecosistema GovPay per la gestione dei pagamenti della Pubblica Amministrazione italiana tramite pagoPA.