Skip to content

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'