Tabella dei contenuti
Avviso Massivo
La stampa dell'avviso secondo la modalità massiva, prevede che l'API che va a generare i PDF, fornisca in output una url con la quale andare ad eseguire il download di tutti i pdf prodotti.
I template da utilizzare seguono le linee guida e le specifiche tecniche fornite da PagoPA e sono riportati nella sezione "Specifiche Tecniche" della "Guida tecnica agli avvisi di pagamento".
A differenza del processo di stampa singola (si veda Avviso Singolo per maggiori info) il processo massivo prevede alcuni step differenti che sono descritti nel diagramma e nelle sezioni di seguito.
- dopo aver avviato il processo con POST /notices/generate-massive (che prevede in input l'array di avvisi e i relativi template id) l'API restituisce in output una folderID
- ottenuta la FolderID di cui sopra per conoscere lo stato di avanzamento del processo è necessario invocare (GET) l'API /notices/folder/{folder_id}/status passando come path parameter la FolderID. Essa restituisce nel formato seguente le informazioni sullo stato di elaborazione dei vari avvisi:
1{
2 "noticesInError": [
3 "string"
4 ],
5 "processedNotices": [
6 "string"
7 ],
8 "status": "PROCESSED"
9}
10Lo stato può essere "INSERTED", "IN PROCESS", "PROCESSED", "FAILED".
- Nella sezione "noticesInError" vi sarà l'elenco degli avvisi non processati mentre nella sezione "processedNotices" sarà possibile visualizzare l'elenco di tutti gli avvisi correttamente elaborati e i loro ID.
- Se si vuole infatti recuperare il singolo file di un avviso è possibile utilizzare l'API /notices/folder/{folderId}/file/{fileId}/url passando come path parameter sia la FolderID che il fileID ottenuto sopra.
- Se invece si vuole recuperare l'intero archivio è necessario usare /notices/folder/{folderId}/url passando come path parameter la FolderID. L'api restituisce una signedUrl della durata di 5 minuti con la quale effettuare il download del file zip contenente i file generati.
I file rimangono in archivio per un totale di 200 giorni trascorsi i quali vengono eliminati.
Dicci cosa ne pensi
Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub