Manuale BO pagoPA - EC

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 NameMandatoryTypeDescription

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

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:

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

Esempio: IBAN_UPSERT_01307110484_20231128160300.zip

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.

PreviousElimina IBANNextEsportazione Massiva IBAN

Last updated