> For the complete documentation index, see [llms.txt](https://docs.pagopa.it/circolare-trimestrale/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagopa.it/circolare-trimestrale/inizia-da-qui/roadmap/flussi-di-rendicontazione.md).

# Flussi di Rendicontazione

### A quale esigenza rispondiamo?

L'esigenza è quella di migliorare le modalità di gestione dei Flussi di Rendicontazione (FdR) introducendo nuovi strumenti per la trasmissione delle informazioni.

### Quale soluzione adottiamo?

PagoPA ha messo a disposizione degli EC/PSP delle primitive per la gestione dei download e upload dei FdR. Nelle SANP (già dalla versione 3.10.0) sono descritte le nuove primitive REST per la gestione di download/upload dei FdR. Le primitive SOAP sono state deprecate a partire dal 30 giugno 2026.

Per poter usufruire delle API sarà necessario generare una nuova coppia di chiavi che mettono a disposizione le primitive di seguito elencate. Per maggiori informazioni su come su come generare le chiavi si può far riferimento ai manuali del BO di pagoPA per [PsP](https://developer.pagopa.it/it/pago-pa/guides/manuale-bo-psp/v1.0/readme/funzionalita/generazione-api-key) ed [EC](https://developer.pagopa.it/it/pago-pa/guides/manuale-bo-ec/v1.0/readme/funzionalita/generazione-api-key) .

L'introduzione dei nuovi servizi ha l’obiettivo di ottimizzare l’attuale flusso logico, in modo da governare in maniera ottimale tutte le fasi legate alla gestione dei FdR di dimensioni elevate. Sono stati messi a disposizione due nuove funzionalità:

* **"FDR - Flussi di rendicontazione \[ORG]"** - API per gli Enti Creditori
* **"FDR - Flussi di rendicontazione \[PSP]"** - API per i PSP

Gli EC ed i PSP potranno adeguare le chiamate alle primitive messe a disposizione dalla piattaforma pagoPA per poter gestire in maniera efficiente i FdR.&#x20;

Per poter usufruire delle API sarà necessario effettuare una sottoscrizione al prodotto che mette a disposizione le primitive di seguito elencate. Per maggiori informazioni su come richiedere una sottoscrizione ad un nuovo prodotto si può far riferimento ai manuali per la creazione di nuove API Key per [EC](https://developer.pagopa.it/it/pago-pa/guides/manuale-bo-ec/v1.0/readme/funzionalita/generazione-api-key) e [PSP](https://developer.pagopa.it/it/pago-pa/guides/manuale-bo-psp/v1.0/readme/funzionalita/generazione-api-key).

{% embed url="<https://docs.pagopa.it/sanp/specifiche-attuative-del-nodo-dei-pagamenti-spc/funzionamento-generale/rendicontazione-e-cashflow#richiesta-flussi-di-rendicontazione-da-parte-dellente-creditore-1>" %}

Per assecondare la necessità di scaricare ed elaborare i flussi di rendicontazione (XML) con maggiore frequenza e velocità, pagoPA ha innalzato i rate limit (il numero massimo di chiamate API consentite in un dato lasso di tempo) per i servizi dedicati al recupero dei flussi di cashflow. Questo permette ai sistemi gestionali di operare sincronizzazioni più rapide e massive.

Inoltre è stata introdotta una preziosa sezione documentale dedicata al confronto tra il paradigma SOAP e il nuovo paradigma REST, con un focus specifico sulla gestione delle date.

{% embed url="<https://developer.pagopa.it/pago-pa/guides/sanp/specifiche-attuative-del-nodo-dei-pagamenti-spc/funzionamento-generale/rendicontazione-e-cashflow#richiesta-flussi-di-rendicontazione-da-parte-dellente-creditore-1>" %}

### Perché è importante adeguarsi

L’adeguamento alle nuove primitive, da parte di EC e PSP, è obbligatorio.&#x20;

L'utilizzo della nuova funzionalità consentirà ad EC e PSP di rendere notevolmente più robusto il processo di gestione dei FdR, in quanto le nuove primitive andranno ad implementare le logiche di controllo sulla sintassi del flusso e sulle operazioni di download/upload.&#x20;

Tali controlli sono ritenuti necessari per evitare dei blocchi nel processo limitando tempo stesso gli attuali interventi manuali di risoluzione da parte degli Enti Creditori.

### Serve supporto?

Per gli sviluppatori [è possibile aprire una issue su GitHub](https://github.com/pagopa/pagopa-api/issues).

Per altri chiarimenti suggeriamo di rivolgersi al team Service Management.
