# Caricamento Massivo IBAN

{% hint style="success" %}
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 file`csv`o 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.**
{% endhint %}

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.

<table data-full-width="true"><thead><tr><th>Field Name</th><th>Mandatory</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>idDominio</code></td><td>Y</td><td>11 digit</td><td>Codice Fiscale dell’Ente Creditore costituito da 11 cifre con eventuali zeri (0) a sinistra</td></tr><tr><td><code>codiceIpa</code> <mark style="color:red;">DEPRECATED</mark></td><td>N</td><td>Alphanumeric</td><td>Codice IPA dell’Ente Creditore registrato nell’Indice delle PA</td></tr><tr><td><code>ragioneSociale</code></td><td>Y</td><td>Alphanumeric</td><td>Ragione Sociale dell’EC</td></tr><tr><td><code>descrizione</code></td><td>N</td><td>Alphanumeric</td><td>Eventuale descrizione associata all’IBAN (ad esempio il servizio per cui verrà utilizzato)</td></tr><tr><td><code>iban</code></td><td>Y</td><td>Alphanumeric (16)</td><td>Codice IBAN</td></tr><tr><td><code>idSellerBank</code> <mark style="color:red;">DEPRECATED</mark></td><td>N</td><td>Alphanumeric</td><td>Codice Seller Bank ovvero la banca dell’Ente Creditore nell’ambito del servizio MyBank</td></tr><tr><td><code>dataAttivazioneIban</code></td><td>Y</td><td>yyyy-mm-gg</td><td>Data alla quale l’IBAN dovrà essere attivato sul Nodo dei Pagamenti-SPC</td></tr><tr><td><code>operazione</code></td><td>Y</td><td>String (1)</td><td><p>Indica l’operazione da eseguire sull’IBAN:</p><ul><li><code>I</code> = Inserimento</li><li><code>M</code> = Modifica</li><li><code>C</code> = Cancella</li></ul></td></tr></tbody></table>

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

{% hint style="info" %}
Pattern del file: "EC\_Code"+"\_"+"DateTime".JSON

Esempio: 01307110484\_20231128160300.JSON
{% endhint %}

```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"
    },
  ]
} 
```

{% file src="/files/GgvXAAU7YmwkdebAFo6y" %}
Esempio di JSON
{% endfile %}

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

{% tabs %}
{% tab title="EC Diretto" %}
"IBAN\_UPSERT"+"\_"+"EC\_Code"+"\_"+"DateTime".JSON

Esempio: IBAN\_UPSERT\_01307110484\_20231128160300.zip

{% file src="/files/tqSv6u5JkMgEmJQXtuVq" %}
{% endtab %}

{% tab title="Intermediario EC" %}
"IBAN\_UPSERT"+"\_"+"PT\_Code"+"\_"+"DateTime".JSON

Esempio: IBAN\_UPSERT\_01307110999\_20231128160300.zip

{% file src="/files/vKCTZbnKNn7uQgkajgDy" %}
{% endtab %}
{% endtabs %}

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

<figure><img src="/files/YdkAo93AOaXGsmJ2GxZW" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Se vi fossero dei problemi durante il caricamento del file il servizio di assistenza risponderà nel ticket con le evidenze del caso.
{% endhint %}

### Controlli e vincoli

{% hint style="warning" %}
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.
{% endhint %}

{% hint style="warning" %}
Vincoli per la creazione dei file, archivio `zip`

Max numero file per archivio: 10

Dimensione massima archivio zip: 10 MB
{% endhint %}

{% hint style="warning" %}
Si ricorda che in caso di IBAN Postale non è ammessa l'associazione a più di un EC.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pagopa.it/manuale-back-office-pagopa/readme/funzionalita/gestione-iban/caricamento-massivo-iban.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.