Come cambia il servizio nel 2024

Questa pagina descrive le modalità di utilizzo del servizio Canone Unico Patrimoniale offerto da pagoPA alle Società Corporate aderenti.

Per l'anno 2024 il servizio di pagamento del Canone Unico Patrimoniale CUP subirà delle piccole variazioni volte ad automatizzare quanto più possible gli step manuali presenti nell'attuale processo. Tali variazioni riguardano sostanzialmente le modalità di invio e ricezione del file csv, il cui formato è descritto nel dettaglio all'interno del modulo di esempio che è possibile scaricare a questo link.

Il formato dei file di input/output/error rimane invariato rispetto a quello degli anni passati.

Processo di scambio file

Per il pagamento del CUP 2024 lo scambio dei file csv per il caricamento delle posizioni debitorie avverrà tramite SFTP, ogni Società Corporate SC avrà a disposizione due cartelle, una di input per il caricamento del file, e una di output da dove sarà possibile scaricare la ricevuta contenente gli identificativi IUV delle posizioni debitorie create.

alla SC è messa a disposizione anche una cartella errorche contiene un report in caso di errori in fase di caricamento

Ogni SC entro l'ultima settima di marzo riceverà all'indirizzo PEC indicato in fase di adesione al servizio una URL per l'accesso al server SFTP ed una password da utilizzare per l'autenticazione.

la mail contenente URL e username/password saranno inviate da un account ufficiale pagoPA sfruttando la modalità riservata di Gmail ovvero :

• utilizzo di un passcode per la cifratura ( inviato sempre sulla PEC della SC )

• scadenza di 1 settimana dalla ricezione della mail

• I destinatari non disporranno dell'opzione di inoltro, copia, stampa o download per questa email

Ogni SC avrà a disposizione una cartella identificata in parte o in tutto dalla sua ragione sociale, contenente tre sotto-cartelle /input, /output e /error, di seguito una rappresentazione della struttura:

/<RAGIONE_SOCIALE_SC_01>
    | /input
    | /output
    | /error
/<RAGIONE_SOCIALE_SC_02>
    | /input
    | /output
    | /error
/...

Una volta caricato il file all'interno della cartella /input, verrà attivato il processo di creazione delle posizioni debitorie. Al termine del processo ( che può richiedere anche qualche minuto ) , il sistema depositerà nella cartella /output il file csv contenente una colonna aggiuntiva payment_notice_number con i codici identificativi IUV delle posizioni create, in caso di errore il file verrà inserito all'interno della cartella /error e conterrà una colonna aggiuntiva errors_note con il dettaglio dell'errore. Potranno verificarsi due tipologie di errore:

1. Errori di validazione che potranno essere corretti in autonomia dalle SC

2. Errori tecnici che dovranno essere segnalati all'assistenza PagoPA

Modalità di caricamento file

Per effettuare il caricamento del file via SFTP esistono due modalità:

• Da linea di comando (shell ssh/prompt DOS)

• Tramite client grafico FTP (es. Filezilla)

Le credenziali inviate alla casella di posta del referente tecnico della SC, hanno la seguente forma:

• URL - [e-mail]

  • pagopapcanoneunicosa.sc01 -> username

  • pagopapcanoneunicosa.blob.core.windows.net -> host

• Password - <PASSWORD>

Caricamento da linea di comando

Per accedere al server SFTP mediante linea di comando è necessario aprire una shell ssh oppure il prompt dei comandi DOS ed utilizzare i seguenti comandi:

> sftp [e-mail]
> [e-mail]'s password:
> sftp> 

dopo aver inserito la password la shell visualizza il prompt sftp> che indica che la connessione al server SFTP è stata stabilita e che il sistema è pronto a ricevere comandi ftp.

A questo punto è necessario posizionarsi sul folder /input e caricare il file:

 > sftp> cd input
 > sftp> put my_input_file.csv

Il file deve essere presente all'interno del folder da cui si è partiti per stabilire la connessione SFTP, in alternativa deve essere indicato il path locale relativo al file da caricare:

> sftp> put ../my-folder/my_input_file.csv

Caricamento tramite client SFTP

In questa sezione viene mostrato come stabilire una connessione SFTP mediante il client Filezilla, tuttavia le modalità adottate dagli altri prodotti sono similari.

Una volta lanciato Filezilla, è necessario valorizzare i campi posti in alto subito sotto la toolbar:

I campi in questione devono essere valorizzati nel seguente modo:

• Host - pagopapcanoneunicosa.blob.core.windows.net

• Username - pagopapcanoneunicosa.sc01

• Password - <PASSWORD>

• Port - 22

Una volta connessi ci si troverà di fronte ad una situazione del seguente tipo:

Il file può essere caricato all'interno del folder remoto /input mediante drag&drop da locale (finder/esplora risorse), oppure selezionandolo dalla finestra di sinistra Local site dalla quale è possibile fare doppio click sul file oppure trascinarlo nella finestra di destra Remote site.