Tabella dei contenuti
Caricamento Massivo IBAN
Questa funzionalità consente l'inserimento multiplo di IBAN da parte degli EC.
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 {% mark style="color:red;" %}DEPRECATED{% /mark %} | 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 {% mark style="color:red;" %}DEPRECATED{% /mark %} | 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:
|
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:
- 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
1{
2 "creditor_institution_code": 01307110484 //
3 "description": "" //lasciare vuoto
4 "ibans": [
5 {
6 "iban": "IT12A1234512345123456789012",
7 "description": "iban 1 description", //es."Riscossione Tributi"
8 "validity_date": "2020-07-27T11🕛️00.897Z"
9 "due_date": "2024-10-28T11🕛️00.999Z"
10 },
11 {
12 "iban": "IT12A1234512345123456789013",
13 "description": "iban 2 description", //es."Riscossione Tributi"
14 "validity_date": "2020-07-27T11🕛️00.897Z"
15 "due_date": "2024-10-28T11🕛️00.999Z"
16 },
17 ]
18}
192. Inserimento file nell'archivio .zip
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
IBAN_UPSERT_02343920126_202311200100"IBAN_UPSERT"+"_"+"PT_Code"+"_"+"DateTime".JSON
Esempio: IBAN_UPSERT_01307110999_20231128160300.zip
IBAN_UPSERT_02343920999_202311200100 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.
Controlli e vincoli
[^1]:
Dicci cosa ne pensi
Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub