Tabella dei contenuti

Modello dei dati V3

Schema logico (ER)

La Posizione Debitoria (Payment Position) ha le seguenti relazioni:

Una Payment Position può avere più Payment Option. Ne esiste almeno una. Una Payment Option è collegata ad una sola Payment Position.
Una Payment Option può avere più Installment (i.e. Rata). Ne esiste almeno una. Un Installment è collegato ad una sola Payment Option.
Una Payment Option è collegata a un Debtor. Se esiste un Debtor esiste almeno una Payment Option ad esso collegata.

Questa struttura permette di gestire non solo i modelli retro-compatibili con le API-V1, ma anche scenari avanzati non supportati in precedenza, come la gestione dei co-obbligati e i pagamenti multi-rateali.

Un Installment può avere più Transfer (i.e. Versamenti), tanti quanti gli Enti Creditori (EC) a cui deve afferire. Ne esiste almeno uno con un massimo di cinque. Un Transfer è collegato ad un solo Installment.

Ad esempio, una rata potrebbe avere la seguente suddivisione:

Pagamento mono-beneficiario, con singolo versamento (1 EC, 1 versamento);
Pagamento mono-beneficiario , con più versamenti (1 EC, n versamenti);
Pagamento multi-beneficiario (n EC, n versamenti);
Una combinazione dei punti precedenti (n EC, m versamenti con m>n).

Nei paragrafi seguenti sono riportati le principali caratteristiche di una Posizione Debitoria. Maggiori dettagli tecnici sulla logica del sistema e le transizioni di stato dipendenti dai campi specificati sono riportati nella sezione dedicata agli Stati della Posizione Debitoria.

Posizione Debitoria (Payment Position)

Le principali caratteristiche di una Posizione Debitoria sono le seguenti:

IUPD: Identificativo univoco posizione debitoria.

È onere dell’EC la creazione di uno IUPD univoco. Qualora non sia univoco il sistema restituirà un errore.

Ente Creditore organization-fiscal-code : Codice Fiscale dell’ente creditore proprietario della PD.
Anagrafica Ente Creditore: Ragione sociale companyName, ufficio officeName.
Data di pubblicazione publishDate : Data in cui la PD è pubblicata nel sistema.

Opzione di Pagamento (Payment Option)

Le principali caratteristiche di un Opzione di Pagamento sono le seguenti:

Descrizione description : Descrizione dell’Opzione di Pagamento.
Data di Validità validityDate : Data dalla quale è valida e pagabile l’Opzione di Pagamento e le Rate in essa contenute.

È responsabilità dell’EC gestire la PD e ogni informazione ad essa associata, ivi compresa la data di validità.

Scadenza[flag] switchToExpired : Indica se la PD è da rendere non pagabile alla scadenza.Indica se la PD è da rendere non pagabile alla scadenza.

Rata (Installment)

Le principali caratteristiche di una Rata sono le seguenti:

Numero Avviso (NAV) nav : Identificativo della Rata emessa da un determinato Ente Creditore, sarà l’identificativo utilizzato dal Nodo dei Pagamenti per avviare la transazione, emettere la ricevuta e rendicontare il pagamento.
Identificativo Univoco Versamento (IUV) iuv : Identificativo univoco per ogni Rata.
Importo amount : Importo previsto per la Rata.
Descrizione description : Descrizione della Rata.
Data di scadenza dueDate : Data che definisce la data di scadenza del dovuto. Ha un effetto sulla pagabilità qualora sia attivo il flag di scadenza.
Metadati [optional] installmentMetadata : Array per permettere agli EC di inserire informazioni custom.

Debitore (Debtor)

Le principali caratteristiche di un Debitore sono le seguenti:

Tipo type : Indica se è una persona fisica o giuridica.
Identificativo fiscalCode : Codice Fiscale (o anche Partita IVA in caso di persona giuridica) del debitore.
Indirizzo [optional] streetName, civicNumber, postalCode, city, province, region, country.
Email [optional] email.
Numero di telefono [optional] phone.

Versamento (Transfer)

Le principali caratteristiche di un Versamento sono le seguenti:

Id idTransfer : Identificativo (progressivo) di un versamento all’interno di una Rata.
Ente Creditore organizationFiscalCode : Ente beneficiario del versamento.
Importo amount : Importo previsto per il versamento.
Causale versamento remittanceInformation : Causale del singolo versamento.
Tassonomia category : Tassonomia del servizio associato al versamento.
IBAN iban, postalIban : IBAN su cui verrà riversato l’importo.
Metadati [optional] transferMetadata : Array per permettere agli EC di inserire informazioni custom.

L’IBAN viene associato alla PD nel momento in cui viene caricata. Se l’IBAN scelto viene modificato da Back Office, la PD precedentemente caricata avrà associato sempre l’IBAN che è stato associato in fase di creazione.

In questa pagina

Schema logico (ER)

Serve aiuto?

Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata

Dicci cosa ne pensi

Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub