Esplorando pagoPA: Caricamento Massivo delle posizioni debitorie
Come gestire massivamente le posizioni debitorie con le API di GPD
Questo webinar è dedicato all'introduzione delle nuove primitive messe a disposizione dalla piattaforma pagoPA per la gestione massiva delle posizioni debitorie con GPD. Queste nuove API sono state sviluppate per gestire i casi d’uso dove è richiesta l’elaborazione di input aventi dimensione elevata.
Parleremo di:
- Introduzione API massive
- Dettaglio e confronto delle API massive
- Best practice e pattern di integrazione
- API walkthrough
Ospiti
Andrea Ferracci
Technical Project Manager - pagoPA Core
Angelo Caporaso
Junior Software Engineer - pagoPA Core
Le risposte alle vostre domande
I numeri avviso gestiti tramite GDP avranno un codice di segregazione identificato, quindi significa che gli avvisi già emessi non possono essere migrati sul GPD?
Il numero avviso viene inserito dall’EC/PT senza alcun vincolo, pertanto anche avvisi già emessi possono essere migrati su GPD.
Esiste un concetto di idempotenza per le API massive?
Si, eventuali posizioni debitorie già presenti verranno gestite e segnalate nel report di caricamento.
Esiste già un recupero massivo delle posizioni debitorie?
No, la gestione massiva delle posizioni debitorie prevede le operazioni di INSERT, UPDATE e DELETE.
Che succede nell’update massivo, la posizione debitoria rimane nello stato published?
Rimangono nello stato PUBLISHED soltanto le posizioni debitorie la cui data di validità non è ancora giunta, in tutti gli altri casi vanno nello stato VALID.
Ci sarà un’integrazione in modalità push?
No, perché il pattern di riferimento, Request-Reply asincrono, non necessita di una modalità push.
Quanto dura un caricamento massivo?
Mediamente il caricamento massivo di 10K posizioni debitorie dura circa 2 minuti (può subire variazioni in base al carico del sistema).
E' disponibile la modalità SFTP per la gestione delle posizioni debitorie?
La gestione massiva delle prevede il caricamento tramite SFTP come specificato nelle SANP → 📥 Gestione massiva tramite SFTP | SANP | Piattaforma pagoPA | DevPortal; tuttavia il canale SFTP non è disponibile per il caricamento massivo delle posizioni debitorie ACA.
Queste api possono essere chiamate da chiunque o solo da intermediari pagopa certificati?
Tutti gli intermediari e partner possono utilizzare le API massive.
Ipotizzando di eseguire il caricamento massivo tramite sftp, in quanto tempo è garantito il caricamento o update delle posizioni massive? parliamo di 100.000 posizioni.
Il caricamento massivo di 100K posizioni debitorie mediamente avviene in un tempo pari a 20/25 minuti (può subire variazioni in base al carico del sistema).
L'API status si può fare polling?
Si può andare in polling utilizzando opportuni intervalli (>= 1 minuto)
Come si ottiene il broker-code?
Il broker code coincide con il codice fiscale del partner/intermediario tecnologico, nel caso di ente non intermediato il broker code coincide con il codice fiscale dell’ente stesso.
Per usare queste API è necessaria ovviamente la nuova connettività, le API devono essere in v2?
Il caricamento delle posizioni debitorie su GPD, ma più in generale la configurazione sulla piattaforma pagoPA in modalità asincrona, non ha dipendenze con la versione delle API, eccezion fatta per l’eventuale configurazione di una stazione di broadcast (consigliata) che deve rispondere alla primitiva paSendRTV2.
Lavorando tramite protocollo SFTP , come si richiede lo stato e il report delle posizioni debitorie?
Come specificato nelle SANP, il report relativo al caricamento sarà disponibile sempre via SFTP all’interno del path /CF_BROKER_ID/CF_EC_ID/output, mentre lo stato può essere richiesto utilizzando le API Rest valorizzando il path parameter fileID con il nome del file.
E' possibile richiedere un'operazione massiva se non è ancora stata completata quella precedente? O la seconda asincrona viene accodata alla prima?
Il parallelismo delle richieste di operazioni massive è possibile ed è consigliato in caso di una grande mole di dati.