Configurazione connettore Plug And Pay
In questa documentazione verrà trattata la configurazione che è necessaria per attivare il connettore Plug And Pay di E-Fil 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
Nota: E-fil trametterà le schede di configurazione tramite FTP reperibile nel filetto Efil.txt
Prerequisiti
- backend ( VBG ) alla versione 2.85 o successiva
- applicativo nodo-pagamenti versione 2.85
Servizi usati dal connettore
Il connettore Plug And Pay implementa i servizi di:
- caricamento delle posizioni debitorie
- caricamento delle posizioni debitorie OTF
- annullamento delle posizioni
- verifica dello stato di pagamento
- attivazione della sessione di pagamento
- download dell'avviso di pagamento PDF
- download della ricevuta di pagamento PDF
Il sistema di pagamenti Plug And Pay espone tutti i servizi utilizzati dal connettore tramite 4 diversi endpoint. Perciò sarà necessario configurare 4 record nella tabella pay_connector_ws_endpoint e impostare i riferimenti a questi 4 endpoint nei campi di pay_connector_config così come illustrato nei due paragrafi seguenti.
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 |
PNP | 1 | https://services.integrazione.plugandpay.it/Feed/DigitBusFeed.svc | 10000 | 0 | 0 | |||||
PNP | 2 | https://services.integrazione.plugandpay.it/Deliver/DigitBusDeliver.svc | 10000 | 0 | 0 | |||||
PNP | 3 | https://pos.integrazione.plugandpay.it/WsPayment/DigitBusPayment.svc | 10000 | 0 5/5 * * * ? | 0 | 100 | 0 | |||
PNP | 4 | https://generatorpdf.integrazione.plugandpay.it/GeneratorPdf.svc | 10000 | 0 | 0 |
Configurazione del connettore
Il connettore Plug And Pay è 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 | Identificativo del connettore che deve essere poi associato al profilo dell'ente creditore in PAY_PROFILI_ENTI_CREDITORI.CODICE_CONNETTORE | |
DESCRIZIONE | PlugAndPay | Descrizione del connettore usata nei messaggi di errore |
PAY_CONNECTOR_JAVA_CLASS | it.gruppoinit.pal.gp.pay.connector.plugandpay.PlugAndPayConnector | Classe java che implementa il connettore |
URL_PORTALE_PAGAMENTI | URL del portale dei pagamenti online (non usato da Plug And Pay) | |
FK_WS_CARICAMENTO | 1 | FK all'enpoint SOAP configurato al paragrafo precedente |
FK_WS_ANNULLAMENTO | 1 | FK all'enpoint SOAP configurato al paragrafo precedente |
FK_WS_VERIFICA | 2 | FK all'enpoint SOAP configurato al paragrafo precedente |
FK_WS_ATTIVA_SESSIONE | 3 | FK all'enpoint SOAP configurato al paragrafo precedente |
FK_WS_AVVISO | 4 | FK all'enpoint SOAP configurato al paragrafo precedente |
FK_WS_NOTIFICA | 3 | FK all'enpoint SOAP configurato al paragrafo precedente |
FK_WS_RICEVUTA | 4 | FK all'enpoint SOAP configurato al paragrafo precedente |
gli altri campi devono essere lasciati vuoti
Configurazione dell'amministrazione
Deve essere inserito un record in AMMINISTRAZIONI per popolare gli attributi dell'anagrafica dell'ente per cui si effettua la configurazione.
Nel caso di Plug And Pay le informazioni che vengono utilizzate dal connettore sono indicate nella tabella seguente.
Nella tabella sottostante viene mostrato un esempio di configurazione per la Provincia di Pisa.
Colonna | Valore | Descrizione |
---|---|---|
IDCOMUNE | G702 | Identificativo dell'installazione |
CODICEAMMINISTRAZIONE | 3 | Numero progressivo |
AMMINISTRAZIONE | Provincia di Pisa | |
PARTITAIVA | 00184280360 | Partita IVA dell'ente |
Configurazione delle causali di registrazione
Tutti i debiti che vengono caricati nel nodo pagamenti devono essere associati ad una causale di registrazione.
pay_registrazioni_causali
Colonna | Valore | Note |
---|---|---|
ID | 1 | Numero progressivo |
IDCOMUNE | G702 | |
DESCRIZIONE | Oneri Provincia di Pisa | Descrizione della causale di registrazione che dipende dalla tipologia di onere (libero) |
CODICE_VERSAMENTO | 0000016 | Codice che identifica la tipologia di onere. Deve corrispondere nel backoffice a TIPICAUSALIONERI.CODICECAUSALEPEOPLE. il codice configurato qui è quello usato come valore di default nel caso in cui il client non lo passi nella richiesta di caricamento della posizione debitoria |
gli altri campi della tabella non sono utilizzati e devono essere lasciati vuoti
Configurazione del profilo dell'ente
Tutte le chiamate che il nodo pagamenti riceve devono contenere un parametro cfEnteCreditore che deve fare riferimento all'identificativo del profilo di un ente censito nel nodo pagamenti. Per attivate il connettore PlugAndPay per un ente è quindi necessario inserire il corrispondente profilo ente nella tabella PAY_PROFILI_ENTI_CREDITORI. Il record inserito associerà l'amministrazione che si è appena configurata nella tabella AMMINISTRAZIONI al connettore PlugAndPay precedentemente configurato in PAY_CONNECTOR_CONFIG. Il CF_CODICE_PROFILO usato per ??? è '???'. Tale valore deve essere configurato nella apposita verticalizzazione del BackOffice per assicurarsi che il nodo pagamenti sia invocato con il parametro corretto.
pay_profili_enti_creditori
Colonna | Valore | Note |
---|---|---|
IDCOMUNE | G702 | Identificativo dell'installazione |
ID | 1 | Numero progressivo |
CODICEAMMINISTRAZIONE | 1 | FK verso la riga di AMMINISTRAZIONI che identifica i dati dell'ente |
CF_CODICE_PROFILO | PI | E' il codice che il backoffice trasmette per identificare il connettore e la configurazion ente da utilizzare |
CODICE_CONNETTORE | PNP | Identificativo del connettore PlugAndPay già configurato |
FK_CUSALE_REG_DEFAULT | 1 | FK verso pay_registrazioni_causali che definisce la causale di registrazione del debito da usare nel caso in cui non venga specificata in fase di caricamento. |
ID_APP_PSP | 9637CBAE-207C-4B24-8076-84838DC225E1 | Identificativo dell'applicazione nel sistema PlugAndPay |
CF_CODICE_PROFILO_PSP | 0000110 | Ientificativo dell'ente nel sistema PlugAndPay |
URL_ESITO_PAGAMENTO | http://[host]:[port]/nodo-pagamenti/esitoSessionePagamento/pi?esito=1 | URL di ritorno delle sessioni di pagamento andate a buon fine |
URL_ANNULLAMENTO_PAGAMENTO | http://[host]:[port]/nodo-pagamenti/esitoSessionePagamento/pi?esito=1 | URL di ritorno delle sessioni di pagamento andate a buon fine |
CODICE_SEGREGAZIONE | 2 | codice segregazione per la generazione dello IUV |
APPLICATION_CODE | 16 | application code usato per la generazione dello IUV |
CF_ENTE_QRCODE_PAGOPA | 00184280360 | Il codice fiscale/partitaiva dell'ente che serve per generare la sezione Identificativo Ente/codice fiscale dell'Ente Creditore dell'algoritmo di generazione qrcode |
Le colonne della tabella PAY_PROFILI_ENTI_CREDITORI che non sono mostrate non devono essere valorizzate.
Configurazione del backend
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
attivare la verticalizzazione NODO_PAGAMENTI
e configurare i seguenti parametri personalizzandoli a seconda dell'ente
Parametro | Valore |
---|---|
AR_COD_FISC_ENTE_CREDITORE | F257 |
URL_WS | http://devel9:8085/nodo-pagamenti/services/pagamentiSOAP?wsdl |
TIPOMOVIMENTO_DOC_AVVISO | TTGENAVV |
TIPOMOVIMENTO_DOC_FATTURA | TTGENFATT |
Sono i movimenti da specificare nel caso si voglia riportare i documenti delle posizioni debitorie nella pratica di riferimento
conti
ID | CODICECONTO | CODICESOTTOCONTO | DESCRIZIONE | NOTE | FK_CODICEAMMINISTRAZIONE | SOFTWARE | IDCOMUNE | IVA | ANNO_ACCERTAMENTO | NUMERO_ACCERTAMENTO | DATASCADENZA | NUMERO_SOTTO_ACCERTAMENTO |
---|---|---|---|---|---|---|---|---|---|---|---|---|
2 | Servizi | ONERI AVVISI TOSAP | CO | F257 | 0 | 2021 | 31-DIC-99 | T525009 |
Sono importanti le colonne CODICESOTTOCONTO che DEVE corrispondere con una delle causali definite in
@XmlType(name = "CausaliImporti")
@XmlEnum
public enum CausaliImporti {
@XmlEnumValue("Servizi")
SERVIZI("Servizi"),
@XmlEnumValue("Sanzioni")
SANZIONI("Sanzioni"),
@XmlEnumValue("Spese")
SPESE("Spese"),
@XmlEnumValue("Bollo")
BOLLO("Bollo"),
@XmlEnumValue("Interessi")
INTERESSI("Interessi"),
@XmlEnumValue("Arrotondamento")
ARROTONDAMENTO("Arrotondamento"),
@XmlEnumValue("DepositiCauzionali")
DEPOSITI_CAUZIONALI("DepositiCauzionali"),
@XmlEnumValue("RimborsoDepositiCauzionali")
RIMBORSO_DEPOSITI_CAUZIONALI("RimborsoDepositiCauzionali"),
@XmlEnumValue("RimborsoServizi")
RIMBORSO_SERVIZI("RimborsoServizi"),
@XmlEnumValue("SpeseTenutaConto")
SPESE_TENUTA_CONTO("SpeseTenutaConto"),
@XmlEnumValue("ImpostaRegistro")
IMPOSTA_REGISTRO("ImpostaRegistro"),
@XmlEnumValue("Commissioni")
COMMISSIONI("Commissioni"),
@XmlEnumValue("InteressiPassiviCCP")
INTERESSI_PASSIVI_CCP("InteressiPassiviCCP"),
@XmlEnumValue("SpeseDomiciliazione")
SPESE_DOMICILIAZIONE("SpeseDomiciliazione"),
@XmlEnumValue("CommissioniBolloSpeseTenutaConto")
COMMISSIONI_BOLLO_SPESE_TENUTA_CONTO("CommissioniBolloSpeseTenutaConto"),
@XmlEnumValue("CommissioniSpeseTenutaConto")
COMMISSIONI_SPESE_TENUTA_CONTO("CommissioniSpeseTenutaConto"),
@XmlEnumValue("Urgenza")
URGENZA("Urgenza"),
@XmlEnumValue("SanzioniInfedele")
SANZIONI_INFEDELE("SanzioniInfedele"),
@XmlEnumValue("SanzioniOmessa")
SANZIONI_OMESSA("SanzioniOmessa"),
@XmlEnumValue("SanzioniLiquidazione")
SANZIONI_LIQUIDAZIONE("SanzioniLiquidazione"),
@XmlEnumValue("Addizionali")
ADDIZIONALI("Addizionali");
ed è importante la colonna numero_sotto_accertamento che è un valore che deve essere comunicato dall'ente e configurato per quel tipo di pendenza
causali oneri
CO_ID | CO_DESCRIZIONE | CO_SERICHIEDEENDO | IDCOMUNE | SOFTWARE | FK_RCO_ID | CO_DISABILITATO | CO_ORDINAMENTO | CODICECAUSALEPEOPLE | PAGAMENTIREGULUS | FKIDCAUSALEBOLLO | FLG_TIPICAUSALIINTERESSI | FK_TIPICAUSALIINTERESSI | FLAG_GENERA_FATTURA | FLAG_GENERA_AVVISO |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
54 | ONERI AVVISI TOSAP | 0 | F257 | CO | 0 | TOSAP | 0 | 0 | 0 | 1 |
È importante la colonna CODICECAUSALEPEOPLE che va a corrispondere nel nodo pagamento la colonna PAY_REGISTRAZIONI_CAUSALI.CODICE_VERSAMENTO e serve per capire se generare un avviso o una fattura.
job repository
Il job permette di agganciare il documento alla pratica
IDCOMUNEALIAS | JOB_NAME | DESCRIPTION | ACTIVE | TRIGGER_TYPE | START_DELAY | REPEAT_INTERVAL | CRON_EXPRESSION | JOB_CLASS_NAME | SOFTWARE |
---|---|---|---|---|---|---|---|---|---|
'F257' | 'VerificaDocumentiPosizioniDebitorieJob' | 'VerificaDocumentiPosizioniDebitorieJob' | '0' | 'CRON' | null | null | '0 0/10 * * ? ' | 'it.gruppoinit.pal.gp.core.features.oneri.jobs.VerificaDocumentiPosizioniDebitorieJob' | 'TT' |
job repository params
ETICHETTA | DESCRIZIONE | VALORE | FK_JOB_REPOSITORY |
---|---|---|---|
'LISTA_ALIAS_DA_ELABORARE' | 'La lista degli alias da elaborare separata da ; se non specificato prende la lista dalla security' | 'F257' | '2' |
'NUM_RECORD_DA_ELABORARE' | 'Indicare il numero di record da processare per ente. Ogni esecuzione del job cerca di elaborare questo numero di record. Il conteggio viene incrementato quando una riga della tabella ISTANZEONERI_POS_DEB_BATCH viene segnata come completata' | '150' | '2' |