Proposta di Uniformità e Richiesta Funzionalità per API PagoPA - Receipts e Flussi di Rendicontazione (FdR)

[sapollonio-maggioli]

Scrivo in merito alle attuali metodologie di interfacciamento con la piattaforma PagoPA per il recupero delle Ricevute Telematiche (Receipts) e dei Flussi di Rendicontazione (FdR).

Al fine di semplificare l'integrazione per gli Enti Creditori (EC) e i Partner Tecnologici, in linea con i principi di standardizzazione, sottopongo le seguenti considerazioni e proposte di uniformità:

Uniformità Metodi API per il Recupero delle Ricevute

Si propone di valutare la possibilità di uniformare i metodi API attualmente distinti per il recupero delle Receipts, in una singola interfaccia agnostica rispetto all'infrastruttura di gestione delle posizioni debitorie.

• biz_events.json: Recupero generico tramite Eventi di Business.
• gpd_payments.json Recupero specifico di Receipts per EC che utilizzano GPD.

Questa unificazione permetterebbe agli utilizzatori di adottare un unico pattern di integrazione.

Uniformità Metodi API per i Flussi di Rendicontazione (FdR)

Si ritiene che le API per il recupero degli FdR non debbano essere vincolate alla piattaforma GPD, poiché la generazione e la gestione dei flussi sono centrali al Nodo dei Pagamenti.

• gpd_fdr.json - API legata al contesto GPD. L

• fdr_organization.yaml - API per FdR a livello di organizzazione.

Relativamente al recupero dei Flussi di Rendicontazione tramite le API REST/JSON più recenti, ho notato che il file XML originale non viene più restituito.

L'XML dell'FdR è un file di interscambio dati di cruciale importanza, necessario per la rigorosità strutturale garantita dallo standard XML e relativo XSD. Molte logiche e sistemi di back-office consolidati degli Enti Creditori sono tuttora basati sull'elaborazione di tale file.

Si chiede cortesemente di valutare la possibilità di allegare il file XML originale del Flusso di Rendicontazione, codificato in Base64, all'interno della risposta JSON delle API.

Riteniamo che questa funzionalità sia fondamentale per garantire la continuità operativa e semplificare la riconciliazione contabile per molti Enti.

ACA Caricamento Massivi
Per uniformità sarebbe possibile avere tutti i metodi di caricamento ACA nel gpd-4-aca.json in modo da non generare confuzione tra l'utilizzo ACA e GPD