Skip to content

Configurazione connettore EntraNext

In questa documentazione verrà trattata la configurazione che è necessaria per attivare il connettore EntraNext 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

Prerequisiti

  • backend ( VBG ) alla versione 2.77 o successiva
  • applicativo nodo-pagamenti versione 2.8.2
  • comunicazione tra l'applicativo nodo-pagamenti e vbg ( solitamtente tramite http sulla porta 8080 )
  • comunicazione tra l'applicativo nodo-pagamenti e ibcsecurity ( solitamente tramite http sulla porta 8080 )

Servizi usati dal connettore

Il connettore di EntraNext implementa i servizi di: - caricamento del debito - annullamento del debito - verifica dello stato di pagamento delle rate di un debito - autenticazione Il sistema di pagamenti di EntraNext espone tutti i servizi necessari al connettore come metodi diversi di uno stesso endpoint SOAP. Perciò sarà sufficiente configurare un sono record nella tabella pay_connector_ws_endpoint e impostare il riferimento a questo record nei campi corrispondenti nella riga di pay_connector_config che configura il connettore. La configurazione da impostare per il connettore e il suo endpoint è illustrata nei due paragrafi seguenti.

PAY_CONNECTOR_WS_ENDPOINT

Colonna Valore Note
CODICE_CONNETTORE EntraNext 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
ID Numero progressivo
ENDPOINT_URL https://linknext-t.comune.modena.it/LinkNext.asmx URL dell'endpoint SOAP
UTENTE VBG_Portale lasciare vuoto
PASSWORD ** impostare la vera password
TIMEOUT 15000 Serve a configurare il timeout di attesa nell'invocazione del servizio configurato nel campo ENDPOINT_URL
DESCRIZIONE URL base dei servizi SOAP Descrizione aggiuntiva che spiega a cosa si riferisce questo endpoint
QUARTZ_SCHEDULE Configurare un espressione chron se si vuole che il nodo pagamenti ritenti periodicamente le chiamate che hanno avuto esito negativo a causa di errori dovuti alla temporanea indisponibilità del servizio
FLAG_SOLO_SCHEDULATO 0 Indica che le chiamate all'endpoint avvengono in maniera sincrona
MAX_CHIAMATE può essesere impostato per impostare un limite ai tentativi di invocare i servizi che hanno fallito
FLAG_SPEGNI_SCHEDULER 0 utile per disattivare gli scheduler mantenendo memorizzata l'espressione che lo configura in quartz_schedule

Configurazione del connettore

Il connettore ExtraNet per Modena è 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 Connettore EntraNext Descrizione del connettore usata nei messaggi di errore
PAY_CONNECTOR_JAVA_CLASS it.gruppoinit.pal.gp.pay.connector.entranext.EntraNextConnector Classe java che implementa il connettore
FK_WS_CARICAMENTO FK all'enpoint SOAP configurato al paragrafo precedente
FK_WS_ANNULLAMENTO FK all'enpoint SOAP configurato al paragrafo precedente
FK_WS_VERIFICA 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 del comune di Genova. I campi nell'elenco sottostante se presenti vengono riportati nei dati (facoltativi) descritttivi dell'ente creditore durante la trasmissione delle posizioni debitorie al sistema di pagamento NEXI | Colonna | Descrizione | | ------ | ------ | | IDCOMUNE | Identificativo dell'installazione | | CODICEAMMINISTRAZIONE | Numero progressivo | | AMMINISTRAZIONE | Denominazione dell'ente |

Configurazione delle causali di registrazione

Tutti i debiti che vengono caricati nel nodo pagamenti devono essere associati ad una causale di registrazione per cui devono essere valorizzati i campi CODICE_VERSAMENTO e PARAMETRI. Nel caso di Modena la causale di versamento è utilizzata per determinare la tipologia di documento (Avviso o Fattura) che il sistema EntraNext deve restituire al noso pagamenti insieme all'esito del caricamento di un debito. Quindi dovranno essere configurati due record nella tabella pay_registrazioni_causali per poter specificare le due diverse tipologie di documento richiesto a seconda delle esigenze del client.

pay_registrazioni_causali causale per gli avvisi

Colonna Valore Note
ID Numero progressivo
IDCOMUNE
SOFTWARE Identificativo del modulo dell'ente (non utilizzato)
DESCRIZIONE Descrizione della causale (libero)
ORDINE (non utilizzato)
FLAG_RIDUZIONE (non utilizzato)
FLAG_NOINCASSI (non utilizzato)
CODICE_VERSAMENTO TOSAP Codice che identifica la tipologia di onere nel backoffice (TIPICAUSALIONERI.CODICECAUSALEPEOPLE)
PARAMETRI Avviso Valore passato a EntraNext per specificare il tipo documento Avviso

pay_registrazioni_causali causale per le fatture

Colonna Valore Note
ID Numero progressivo
IDCOMUNE
SOFTWARE Identificativo del modulo dell'ente (non utilizzato)
DESCRIZIONE Descrizione della causale (libero)
ORDINE (non utilizzato)
FLAG_RIDUZIONE (non utilizzato)
FLAG_NOINCASSI (non utilizzato)
CODICE_VERSAMENTO FIERE Codice che identifica la tipologia di onere nel backoffice (TIPICAUSALIONERI.CODICECAUSALEPEOPLE)
PARAMETRI Fattura Valore passato a EntraNext per specificare il tipo documento fattura

I valori specificati nel campo CODICE_VERSAMENTO delle due causali di registrazione devono corrispondere con i valori configurati nel backoffice nella tabella TIPICAUSALIONERI come descritto nella tabella sottostante:

TIPICAUSALIONERI causale per gli avvisi

Colonna Valore Note
ID Numero progressivo
IDCOMUNE
SOFTWARE SS Identificativo del modulo di VBG
CODICECAUSALEPEOPLE TOSAP deve corrispondere a pay_registrazioni_causali.CODICE_VERSAMENTO
FLAG_GENERA_FATTURA 0 generazione fattur anon richiesta
FLAG_GENERA_AVVISO 1 generazione avviso richiesta

TIPICAUSALIONERI causale per le fatture

Colonna Valore Note
ID Numero progressivo
IDCOMUNE
SOFTWARE SS Identificativo del modulo di VBG
CODICECAUSALEPEOPLE FIERE deve corrispondere a pay_registrazioni_causali.CODICE_VERSAMENTO
FLAG_GENERA_FATTURA 1 generazione fattur anon richiesta
FLAG_GENERA_AVVISO 0 generazione avviso richiesta

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 EntraNext per il comune di Modena è quindi necessario inserire il corrispindente profilo ente nella tabella PAY_PROFILI_ENTI_CREDITORI. Il record inserito associerà l'amministrazione inserita nella tabella AMMINISTRAZIONI al connettore EntraNext precedentemente configurato in PAY_CONNECTOR_CONFIG. Il CF_CODICE_PROFILO usato per Modena è 'F257'. 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 Identificativo dell'ente
ID Numero progressivo
CODICEAMMINISTRAZIONE Fk verso la tabella AMMINISTRAZIONI che identifica i dati dell'ente
CF_CODICE_PROFILO F257 E' il codice che il backoffice trasmette per identificare il sistema dei pagamenti da utilizzare
CODICE_CONNETTORE EntraNext Identificativo del connettore EntraNext già configurato
FK_CUSALE_REG_DEFAULT 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. Di default si usa la causale TOSAP associata alla generazione dell'avviso di pagamento
ID_APP_PSP EntraNext_CSV Identificativo dell'applicazione nel sistema EntraNext
CF_CODICE_PROFILO_PSP 00221940364 Ientificativo dell'ente nel sistema EntraNext
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
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'