Caricamento Massivo IBAN

Questa funzionalità consente l'inserimento multiplo di IBAN da parte degli EC.

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.

Gestione mediante file CSV [gestione attuale]

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
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

Gestione mediante file .zip + JSON

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:

1. Creazione File JSON

Creare un file JSON con i seguenti attributi:

1. creditor_institution_code -> Codice Identificativo dell'EC

2. description -> Lasciare vuoto

3. Ibans (sezione contenente tutti gli IBAN da inserire)

   1. iban -> Codice IBAN

   2. description -> descrizione finalità IBAN (es. "Riscossione tributi")

   3. validity_date -> da a partire dalla quale l'IBAN è da considerarsi valido

   4. 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

{
  "creditor_institution_code": 01307110484 // 
  "description": "" //lasciare vuoto
  "ibans": [
    {
      "iban": "IT12A1234512345123456789012",
      "description": "iban 1 description", //es."Riscossione Tributi"
      "validity_date": "2020-07-27T11:00:00.897Z"
      "due_date": "2024-10-28T11:00:00.999Z"
    }, 
    {
      "iban": "IT12A1234512345123456789013",
      "description": "iban 2 description", //es."Riscossione Tributi"
      "validity_date": "2020-07-27T11:00:00.897Z"
      "due_date": "2024-10-28T11:00:00.999Z"
    },
  ]
} 

964B

02343920126_202311200100.json

Esempio di JSON

2. Inserimento file nell'archivio .zip

Inserire il file (o nel caso di Intermediario EC i files) all'interno di un archivio zip così nominato:

EC Diretto

"IBAN_UPSERT"+"_"+"EC_Code"+"_"+"DateTime".JSON

Esempio: IBAN_UPSERT_01307110484_20231128160300.zip

3KB

IBAN_UPSERT_02343920126_202311200100.zip

archive

Intermediario EC

"IBAN_UPSERT"+"_"+"PT_Code"+"_"+"DateTime".JSON

Esempio: IBAN_UPSERT_01307110999_20231128160300.zip

6KB

IBAN_UPSERT_02343920999_202311200100 .zip

archive

3. Apertura ticket

Aprire un ticket ad Assistenza PagoPA allegando il file di cui sopra specificando la necessità di voler caricare massivamente gli IBAN.

4. Approvazione file

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.

Controlli e vincoli

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.