Esplorando pagoPA: Come generare il pdf di un avviso di pagamento
Esploriamo come è possibile per un ente creditore e per un partner tecnologico generare gli avvisi di pagamento secondo le specifiche tecniche pagoPA e mediante l’uso di API di pagoPA.
La nuova funzionalità di “Genera Avvisi Pagamento” mette a disposizione degli Enti e dei Partner Tecnologici delle nuove API per generare l’avviso di pagamento pagoPA in formato pdf.
L'utilizzo della funzionalità consente all'Ente di semplificare notevolmente il processo di gestione della posizione debitoria delegando a PagoPA il ciclo di vita della generazione dell'avviso tramite una semplice integrazione.
Sono previste diverse possibilità di generare l’avviso pdf, sia in modalità sincrona, ad esempio per poche generazioni, che in modalità massiva asincrona, nel caso di generazione di molti avvisi.
Ospiti
Cristiano Sticca
Technical Project Manager
Jacopo Carlini
Software Engineer
Le risposte alle vostre domande
Quanto grande l’array in caso di Generazione Multipla? Qual è il throughput di generazione dei pdf nel caso massivo?
1000 file.
Il tempo di generazione varia a seconda della richiesta. Per una richiesta di 1000 pdf circa 10 minuti
Quanto dura il signed URL?
5 min
Dopo quanto tempo vengono eliminati i file?
200 giorni
Come si gestisce il PT che opera per più enti?
Nel caso di PT che vuole generare gli avvisi di pagamento degli enti che intermedia devono essere validate le seguenti condizioni:
- gli enti abbiano configurato il modello per l’avviso (maggiori info DevPortal | Avvisi di pagamento )
- gli enti siano associati alle stazioni del partner
- il partner abbia staccato l’api key per utilizzare il servizio
Per ottenere l’API Key per l’utilizzo del servizio bisogna completare un processo di abilitazione o basta solo richiederla?
Nessuna abilitazione
Qual è il numero massimo di rate stampabili?
12
Generando massivamente N avvisi di pagamento, lo zip viene cancellato dopo 5 minuti ma posso continuare ad accedere direttamente ad uno degli avvisi generati in futuro?
La signedUrl ha durata di 5 min ma i file vengono archiviati per 200 giorni scaduti i quali vengono cancellati. Pertanto per ri-ottenere un file già elaborato è necessario soltanto chiamare l’API per avere la signedUrl.
Le chiavi per le chiamate API vengono rilasciate all'Ente che può condividerle con i suoi fornitori o sono ad uso solo dei partner tecnologici?
I partner tecnologici possono staccare le proprie chiavi dal portale di BackOffice pagoPa con le quali possono operare per conto degli enti deleganti.
Un ente diretto può ottenere sul BackOffice la propria chiave per operare in autonomia.
Le chiavi non devono essere condivise.
In caso di produzione massiva, se ho interpretato bene sono prodotti n singoli file PDF. Come identificare le singole avvisature con il debitore se sono più d'uno?
I fileID hanno la seguente struttura:
pagopa-avviso-<CF-Ente>-<codice-avviso>-<templateID>
Tramite il <codice-avviso> è possibile identificare il PDF
Il pdf engine che produce i pdf, con che tecnologia è realizzato?
NodeJS con puppeteer per la realizzazione dei file PDF e Java per convertire il file in PDF/A