Tabella dei contenuti

Modello dei dati V1

Schema logico (ER)

{% img src="../../.gitbook/assets/ER-V1.png" alt="ER-V1.png" / %}

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

Una Payment Position è collegata a un Debtor. Se esiste un Debtor esiste almeno una Payment Position ad esso collegata.
Una Payment Position può avere più Payment Option. Ne esiste almeno una. Una Payment Option è collegata ad una sola Payment Position.

Ad esempio, una delle opzioni più comuni di pagamento per un tributo annuale sono:

rata unica
prima rata
...
n-esima rata

Una Payment Option può avere più Transfer, tanti quanti gli Enti Creditori (EC) a cui deve afferire. Ne esiste almeno uno con un massimo di cinque. Un Transfer è collegato ad una sola Payment Option.

Ad esempio, una opzione di pagamento 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).

Sia la Payment Option che il Transfer possono avere più Metadata, ogni Metadata può essere associato a più Payment Option o Transfer. Vi sono due tipologie di Metadata: PaymentOptionMetadata e TransferMetadata.

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.
Data di Validità validityDate : Data dalla quale è valida e pagabile la Posizione Debitoria e le Opzione di Pagamento 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.

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.
Nome completo fullName : Nome per esteso, nome e cognome.
Indirizzo [optional] streetName, civicNumber, postalCode, city, province, region, country.
Email [optional] email.
Numero di telefono [optional] phone.

Opzione di Pagamento (Payment Option)

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

Numero Avviso (NAV) nav : Identificativo dell’avviso emesso 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 Opzione di Pagamento.
Importo amount : Importo previsto per la Opzione di Pagamento.
Descrizione description : Descrizione della Opzione di Pagamento.
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] paymentOptionMetadata : Array per permettere agli EC di inserire informazioni custom tipicamente relative alla riconciliazione contabile, allineamento programmi gestionali, etc.

Versamento (Transfer)

Le principali caratteristiche di un Versamento sono le seguenti:

Id idTransfer : Identificativo (progressivo) di un versamento all’interno di una Opzione di Pagamento.
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 verra 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