> 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/archivio-centralizzato-avvisi.md).

# Archivio Centralizzato Avvisi

### A quale esigenza rispondiamo?

PagoPA ha realizzato un archivio centralizzato delle posizioni debitorie che contiene dati relativi agli avvisi di pagamento, emessi dagli Enti Creditori aderenti alla piattaforma, necessari per garantire la continuità operativa a fronte di disservizi e/o indisponibilità dei sistemi di questi ultimi. L’Archivio Centralizzato Avvisi, anche “ACA”, inoltre, permetterà a PagoPA di tarare la propria capacità in funzione delle necessità di traffico richieste dagli Enti aderenti, in termini di volumi di traffico e gestione dei picchi di esercizio.

### Quale soluzione adottiamo?

L'ACA contiene i dati necessari alla continuità del servizio della piattaforma.&#x20;

Il caricamento dei dati delle posizioni debitorie avverrà tramite l'utilizzo di specifiche primitive, da invocare da parte dall’EC in funzione della modalità prescelta di integrazione con la piattaforma pagoPA.&#x20;

La funzionalità non implica alcuna gestione della posizione debitoria da parte della Società PagoPA S.p.A., né modifiche al workflow di pagamento della piattaforma pagoPA. Gli Enti Creditori e/o i loro Intermediari Tecnologici e/o Partner Tecnologici, che si avvalgono dell’integrazione tramite API sincrone, sono tenuti al conferimento di tutti i dati delle loro posizioni debitorie all'ACA, necessari ad assicurare le misure di continuità operativa. Tali misure devono essere adottate dai gestori di sistemi di pagamento e dai fornitori critici di infrastrutture o servizi tecnici in conformità agli obblighi ex art. 146 T.U.B. di sorveglianza svolta dalla Banca d'Italia.

L’alimentazione dell’ACA è obbligatoria solo per le Pubbliche Amministrazioni. Per i soggetti diversi rimane facoltà dell’Aderente scegliere se alimentare l’ACA (sempre in caso di integrazione sincrona).&#x20;

Le tipologie di pagamento soggetti di possibile richiesta di esclusione sono definite nelle  SANP 3.12:&#x20;

{% embed url="<https://developer.pagopa.it/it/pago-pa/guides/sanp/3.12.0/ente-creditore/modalita-dintegrazione/integrazione-tramite-api-sincrone>" %}

Con la crescita esponenziale dei volumi transazionali su pagoPA, è diventato prioritario il mantenimento dei tempi di risposta (bassa latenza) delle API, in un contesto sempre più sfidante. Per rispondere adeguatamente a questa sfida infrastrutturale, con l’attuale versione delle SANP sono state introdotte nuove modalità di archiviazione (data archiving e cold storage). Questo meccanismo prevede lo spostamento asincrono e mirato delle posizioni debitorie "chiuse" (già pagate, annullate o scadute da molto tempo) dai database operativi principali (hot storage) verso archivi storici ad alta capacità.

Questa operazione continua alleggerisce significativamente le tabelle attive del database. Il risultato per gli Enti è un miglioramento netto delle performance in fase di creazione di nuovi debiti, di aggiornamento e di interrogazione (query) delle pendenze valide, garantendo la massima scalabilità del sistema anche nei periodi di picco, senza perdere la tracciabilità storica richiesta dalle normative

### Impatti

Ogni EC, al momento delle creazione di una nuova posizione debitoria, dovrà effettuare il caricamento della stessa sull’ACA tramite una delle seguenti modalità:&#x20;

* API di creazione e aggiornamento del servizio di Gestione Posizioni Debitorie (“GPD”)&#x20;
* API Create Position
* API di Gestione massiva

La relativa documentazione è disponibile al seguente link:&#x20;

{% embed url="<https://docs.pagopa.it/sanp/ente-creditore/modalita-dintegrazione/integrazione-tramite-api-sincrone#archivio-centralizzato-avvisi>" %}

### Perché è obbligatorio adeguarsi

PagoPA S.p.A. è inserita nell’elenco dei “fornitori critici di infrastrutture o servizi” e, in quanto tale, è assoggettata alla sorveglianza di Banca d’Italia ai sensi dell’art. 20 del Provvedimento del 9 novembre 2021 attuativo dell’art. 146 TUB. La messa a disposizione dell'ACA risponde alla necessità di assicurare un insieme di misure di continuità operativa.

### Serve supporto?

Per gli sviluppatori è possibile aprire una issue su GitHub.&#x20;

Per altri chiarimenti suggeriamo di rivolgersi all’Account PagoPA di riferimento.
