Caricamento Massivo IBAN
Questa funzionalità consente l'inserimento multiplo di IBAN da parte degli EC.
Last updated
Questa funzionalità consente l'inserimento multiplo di IBAN da parte degli EC.
Last updated
La funzionalità illustrata in questa sezione, descrive le azioni da compiere per poter inserire/cancellare/modificare massivamente i codici IBAN.
L'operatività rimane la stessa odierna, ovvero tramite invio di un file csv al gruppo di Assistenza PagoPA.
In alternativa al file csv è garantita la possibilità di innescare il caricamento massivo mediante un tracciato json, questa opzione prevede l'invio di una cartella in formato .zip con all'interno uno o più file json.
Nelle prossime settimane, al fine di snellire l'attuale processo, verrà rilasciata sul portale BackOffice pagoPA una feature che consentirà agli EC di caricare in autonomia il filecsvo lo zip con la cartella contenente i file json senza dover più passare dall'Assistenza PagoPA.
La funzionalità Caricamento Massivo IBAN è riservata esclusivamente al Referente dei Pagamenti.
La funzionalità in oggetto si rende necessaria per gli EC o loro intermediari nel caso in cui si debba procedere ad un inserimento di molteplici codici IBAN.
Come indicato nel box informativo in alto è possibile continuare a caricare massivamente gli IBAN seguendo la procedura in essere.
Per comodità si riporta di seguito la struttura del file csv che dovrà essere adottata.
| Field Name | Mandatory | Type | Description |
|---|---|---|---|
La logica con cui il sistema eseguirà l'inserimento è la cosiddetta "UPSERT": se un record è già presente a sistema verrà eseguito l'aggiornamento del record, nel caso invece non esistesse verrà inserito il nuovo record.
Gli step necessari sono i seguenti:
Creare un file JSON con i seguenti attributi:
creditor_institution_code -> Codice Identificativo dell'EC
description -> Lasciare vuoto
Ibans (sezione contenente tutti gli IBAN da inserire)
iban -> Codice IBAN
description -> descrizione finalità IBAN (es. "Riscossione tributi")
validity_date -> da a partire dalla quale l'IBAN è da considerarsi valido
due_date -> data a partire dalla quale l’IBAN non sarà più valido
Esempio di file JSON
Pattern del file: "EC_Code"+"_"+"DateTime".JSON
Esempio: 01307110484_20231128160300.JSON
Inserire il file (o nel caso di Intermediario EC i files) all'interno di un archivio zip così nominato:
"IBAN_UPSERT"+"_"+"EC_Code"+"_"+"DateTime".JSON
Esempio: IBAN_UPSERT_01307110484_20231128160300.zip
Aprire un ticket ad Assistenza PagoPA allegando il file di cui sopra specificando la necessità di voler caricare massivamente gli IBAN.
A valle dell'approvazione dei colleghi del servizio di assistenza il file verrà caricato e nella sezione IBAN potranno essere visualizzati tutti gli IBAN inseriti.
Se vi fossero dei problemi durante il caricamento del file il servizio di assistenza risponderà nel ticket con le evidenze del caso.
se si sta eseguendo un caricamento massivo per più di un EC (caso di Intermediari di EC) è necessario creare n file json quanti sono gli EC.
Vincoli per la creazione dei file, archivio zip
Max numero file per archivio: 10
Dimensione massima archivio zip: 10 MB
Si ricorda che in caso di IBAN Postale non è ammessa l'associazione a più di un EC.
idDominio
Y
11 digit
Codice Fiscale dell’Ente Creditore costituito da 11 cifre con eventuali zeri (0) a sinistra
codiceIpa
N
Alphanumeric
Codice IPA dell’Ente Creditore registrato nell’Indice delle PA
ragioneSociale
Y
Alphanumeric
Ragione Sociale dell’EC
descrizione
N
Alphanumeric
Eventuale descrizione associata all’IBAN (ad esempio il servizio per cui verrà utilizzato)
iban
Y
Alphanumeric (16)
Codice IBAN
idSellerBank DEPRECATED
N
Alphanumeric
Codice Seller Bank ovvero la banca dell’Ente Creditore nell’ambito del servizio MyBank
dataAttivazioneIban
Y
yyyy-mm-gg
Data alla quale l’IBAN dovrà essere attivato sul Nodo dei Pagamenti-SPC
operazione
Y
String (1)
Indica l’operazione da eseguire sull’IBAN:
I = Inserimento
M = Modifica
C = Cancella
