Skip to content

Connettore J-City.Gov PagoPA

In questa documentazione verrà trattata la configurazione che è necessaria per attivare il connettore JPPA nel nodo pagamenti. Per quanto riguarda l'installazione del nodo pagamenti in generale e la configurazione delle verticalizzazioni sul backoffice fare riferimento al documento Configurazione del nodo dei pagamenti

NODO-PAGAMENTI

Attivazione ente

Per attivare l'ente contattare il fornitore dei servizi (MAGGIOLI). È importante preventivamente capire con l'ente quali servizi o tipi di dovuto (causali attivare).

Configurazione del connettore

Il connettore JPPA è deployato già col nodo pagamenti e per poter essere utilizzato deve essere configurato inserendo un record nella tabella PAY_CONNECTOR_CONFIG

PAY_CONNECTOR_CONFIG

Colonna Valore Note
CODICE JCITY Identificativo del connettore che deve essere poi associato al profilo dell'ente creditore in PAY_PROFILI_ENTI_CREDITORI.CODICE_CONNETTORE
DESCRIZIONE Connettore Maggioli JCity-GOV Descrizione del connettore
PAY_CONNECTOR_JAVA_CLASS it.gruppoinit.pal.gp.pay.connector.jcitygov.JCityGovConnector Classe java che identifica il connettore
URL_PORTALE_PAGAMENTI Url per accedere al portale dei pagamenti
FK_WS_CARICAMENTO 1 FK ai parametri di configurazione del servizio per il caricamento delle posizioni debitorie configurato al paragrafo precedente
FK_WS_ANNULLAMENTO 1 FK ai parametri di configurazione del servizio di annullamento delle posizioni debitorie configurato al paragrafo precedente
FK_WS_VERIFICA 2 FK ai parametri di configurazione del servizio di verifica dello stato di una posizione debitoria configurato al paragrafo precedente
FK_WS_ATTIVA_SESSIONE 1 FK ai parametri di configurazione del servizio di attivazione di una sessione di pagamento configurato al paragrafo precedente
FK_WS_AVVISO FK ai parametri di configurazione del servizio di generazione/invio dell'avviso di pagamento

PAY_CONNECTOR_WS_ENDPOINT

CODICE_CONNETTORE ID ENDPOINT_URL UTENTE PASSWORD TIMEOUT DESCRIZIONE QUARTZ_SCHEDULE FLAG_SOLO_SCHEDULATO MAX_CHIAMATE FLAG_SPEGNI_SCHEDULER
Codice del connettore nel nodo pagamenti come definito in PAY_CONNECTOR_CONFIG.CODICE, si può impostare qualunque codice. Il codice deve essere valorizzato in FK nel campo PAY_PROFILI_ENTI_CREDITORI.CODICE_CONNETTORE Numero progressivo URL dell'endpoint SOAP credenziali utente password utente numero di millisecondi da impostare come timeout per la connessione al servizio descrizione facoltativa del servizio Espressione chron che configura lo scheduling del servizio, se lasciato vuoto il servizio non è schedulato impostare a 1 per i servizi che devono essere invocati SOLO sulla base dello scheduler numero massimo di tentativi di invocazione del servizio eseguiti dallo scheduler in caso di errore flag per spegnere temporaneamente lo scheduling del servizio
JCITY 1 https://collaudopagopa.comune-online.it/jcitygov-pagopa/web/config/#/enti 180000
JCITY 2 https://collaudopagopa.comune-online.it/jcitygov-pagopa/web/config/#/enti 150000 VERIFICA STATO

In questa tabella sono rappresentati gli url dell'ambiente di collaudo.

Configurazione dell'amministrazione

Deve essere inserito un record in AMMINISTRAZIONI per popolare gli attributi dell'anagrafica dell'ente per cui si effettua la configurazione. I campi nell'elenco sottostante, se presenti, vengono riportati nei dati (facoltativi) descrittivi dell'ente creditore durante la trasmissione delle posizioni debitorie al sistema di pagamento JPPA.

Colonna Descrizione
IDCOMUNE Identificativo dell'installazione
CODICEAMMINISTRAZIONE Numero progressivo
AMMINISTRAZIONE Denominazione dell'ente
INDIRIZZO Indirizzo
CITTA Località
CAP CAP
PROVINCIA Provincia
TELEFONO1 Numero di telefono
EMAIL Email

pay_connector_config_values

Popolare la seguente tabella con le informazioni di configurazione con la security.

Colonna Descrizione
IDCOMUNE Identificativo dell'installazione
ID Numero progressivo
CONFIG_PARAM Nome del parametro
CODICE_CONNETTORE Identificativo del connettore
VALORE Valore che assume per la specifica configurazione dell'ente

pay_registrazioni_causali

Colonna Descrizione
ID Numero progressivo
IDCOMUNE Identificativo dell'ente
SOFTWARE Identificativo del modulo dell'ente
DESCRIZIONE Descrizione della causale
ORDINE
CODICE_VERSAMENTO Codice che identifica l'onere nel sistema dei pagamenti dell'ente (codice tipo debito)
PARAMETRI
MAPPATURA_CLIENT Identifica la mappatura dello specifico nodo

ad esempio

ID IDCOMUNE SOFTWARE DESCRIZIONE ORDINE CODICE_VERSAMENTO PARAMETRI MAPPATURA_CLIENT
progressivo idcomune TT Votive JCITY-GOV 1 RETELIT 1

Ad esempio Votive JCITY-GOV è l'identificativo della pendenza configurata in JPPA per l'ente. Viene identificato come DOVUTO o CODICE TIPO DEBITO nel gestionale.

pay_profili_enti_creditori

Colonna Descrizione
IDCOMUNE Identificativo dell'ente
ID Numero progressivo
CODICECOMUNE Codice Belfiore che identifica il comune
CODICEAMMINISTRAZIONE Fk verso la tabella AMMINISTRAZIONI che identifica i dati dell'ente
SOFTWARE Identificativo del modulo dell'ente
CBILL
CC_POSTALE Conto Corrente Postale
CF_CODICE_PROFILO E' il codice che il backoffice trasmette per identificare il sistema dei pagamenti da utilizzare
CODICE_CONNETTORE Identificativo del connettore
FK_CUSALE_REG_DEFAULT FK verso pay_registrazioni_causali
ID_APP_PSP l'identificativo che viene passato come ida2a
CF_CODICE_PROFILO_PSP Il codice fiscale dell'ente/piva
URL_ESITO_PAGAMENTO Url da richiamare per sapere l'esito di un pagamento
URL_ANNULLAMENTO_PAGAMENTO Url assoluto che gestisce il ritorno all'app chiamante dopo l'annullamento del pagamento online
CODICE_SEGREGAZIONE Identificativo numerico del punto di emissione degli iuv di un ente creditore
APPLICATION_CODE Identificativo numerico dell'archivo di pagamenti associato a questo servizio dell'ente creditore in pagopa, utilizzato per la generazione del codice avviso con aux digit = 0
CF_ENTE_QRCODE_PAGOPA Il codice fiscale/partitaiva dell'ente che serve per generare la sezione Identificativo Ente/codice fiscale dell'Ente Creditore dell'algoritmo di generazione qrcode

Ad esempio:

IDCOMUNE ID CODICECOMUNE CODICEAMMINISTRAZIONE SOFTWARE CBILL CC_POSTALE CF_CODICE_PROFILO CODICE_CONNETTORE FK_CUSALE_REG_DEFAULT ID_APP_PSP CF_CODICE_PROFILO_PSP URL_ESITO_PAGAMENTO URL_ANNULLAMENTO_PAGAMENTO CODICE_SEGREGAZIONE APPLICATION_CODE CF_ENTE_QRCODE_PAGOPA
IDCOMUNE PROGRESSSIVO 0 TT JCITY-L424 JCITY 1 EntTest1 RETELIT http://devel3.init.gruppoinit.it/nodo-pagamenti/esitoSessionePagamento/jcity-l424` 01232713456

pay_regcausali_parametri

COLONNA DESCRIZIONE
IDCOMUNE Identificativo dell'ente
ID Progressivo
FK_PAYREGCAUSALE_ID FK verso pay_registrazioni_causali
CHIAVE
VALORE

Vanno configurati in questa tabella alcuni parametri utilizzati dal connettore.

Ad esempio per quanto rigurada Jesi va impostato il parametro CHIAVE_APPLICATION_CODE_IUV con il relativo valore fornito dall'ente per il calcolo dello IUV.

È obbligatorio impostare per ogni causale il parametro CODICE_SERVIZIO che indica il codice servizio (che può essere diverso da tipo debito).

Configurazione del backend/console

Ora che il nodo-pagamenti e il connettore sono configurati, bisogna indicare al backend che è attivo un sistema per poter pagare in maniera integrata. Per fare ciò bisogna recarsi nella voce di menù del backend Configurazione -> Tutti i backoffice -> Configurazione regole

Verticalizzazione

attivare la verticalizzazione NODO_PAGAMENTI

Verticalizzazione

e configurare i seguenti parametri personalizzandoli a seconda dell'ente

Verticalizzazione

Parametro Valore
AR_COD_FISC_ENTE_CREDITORE JCITY-L424
ID_MODALITA_PAGAMENTO 3*
URL_WS http://devel9:8085/nodo-pagamenti/services/pagamentiSOAP?wsdl

* corrisponde alla modalità online oppure PagoPa nei Tipi pagamento