Tabella dei contenuti
Rata unica
Questo template permette di stampare un bollettino standard, ovvero quello pagabile in un'unica soluzione secondo le specifiche tecniche.
Di seguito un esempio della POST/notices/generate da effettuare con il popolamento dei campi per la generazione del template rata unica.
1{
2 "templateId": <template_id>,
3 "data": {
4 "notice": {
5 "subject": <Avviso.Oggetto>,
6 "paymentAmount": <Avviso.Importo>,
7 "dueDate": <Avviso.Data>,
8 "code": <Avviso.Codice>,
9 "installments": [
10 {
11 "code": <Avviso.Rata1.Codice>,
12 "amount": <Avviso.Rata1.Importo>,
13 "dueDate": <Avviso.Rata1.Data>
14 }
15 ]
16 },
17 "creditorInstitution": {
18 "taxCode": <Ente.CF>
19 },
20 "debtor": {
21 "taxCode": <Destinatario.CF>,
22 "fullName": <Destinatario.NomeCompleto>,
23 "address": <Destinatario.Indirizzo>,
24 "postalCode": <Destinatario.CodicePostale>,
25 "city": <Destinatario.Citta>,
26 "buildingNumber": <Destinatario.Building>,
27 "province": <Destinatario.Provincia>
28 }
29 }
30 }
31
32Le sezioni di cui si compone il template rata unica sono le seguenti:
Intestazione:
Questa sezione contiene l’oggetto dell’avviso, ossia un testo chiaro e significativo per chi riceve l’avviso:
- Avviso.Oggetto -> stringa di max 90 caratteri, corrispondente al campo subject della POST/notices/generate).
Informazioni sull’Ente Creditore:
Questa sezione contiene le informazioni relative all’Ente Creditore:
- Ente.CF -> stringa di max 16 caratteri corrispondente al campo codice fiscale recuperato dal Backoffice pagoPA (vedi Compilazione dati configurazione su Backoffice pagoPA);
- Ente.Nome -> stringa di max 50 caratteri corrispondente al campo nome recuperato dal Backoffice pagoPA (vedi Compilazione dati configurazione su Backoffice pagoPA);
- Ente.Settore -> stringa di max 50 caratteri corrispondente al campo settore opzionalmente valorizzato nello step preliminare sul portale Backoffice pagoPA (vedi Compilazione dati configurazione su Backoffice pagoPA);
- Ente.Info -> riferimenti dei canali di contatto dell'Ente Creditore destinati ai cittadini, come ad esempio sito web, call center o email dedicata, informazioni inserite nello step preliminare sotto la voce "Contatti per l'assistenza" sul portale Backoffice pagoPA (vedi Compilazione dati configurazione su Backoffice pagoPA).
Informazione sul destinatario:
Questa sezione contiene le informazioni relative al soggetto debitore:
- Destinatario.CF -> stringa di max 16 caratteri che indica il codice fiscale del soggetto debitore (in assenza la p.iva del soggetto debitore) corrispondente al campo taxCode della POST/notices/generate;
- Destinatario.NomeCompleto -> stringa di max 70 caratteri corrispondente al campo fullname della POST/notices/generate;
- Destinatario.Indirizzo -> stringa di max 140 caratteri corrispondente ai campi address, postalCode, city, buildingNumber, province della POST/notices/generate.
Importo e scadenza:
È la sezione che contiene le informazioni sul quanto pagare, in che modalità e con le relative scadenze:
- Avviso.Data -> nel formato dd/mm/yyyy corrispondente al campo dueDate della POST/notices/generate. Nel caso in cui questo campo non venga passato in input, l'avviso pdf risultante sarà l'avviso rata unica senza scadenza;
- Avviso.Importo -> con valore massimo 999.999.999,99 corrisponde al campo Amount della POST/notices/generate.
Dati del pagamento:
È la sezione che contiene tutte le informazioni necessarie per effettuare il pagamento:
- Avviso.QRCode -> segue le logiche descritte nelle Specifiche Tecniche - sezione Dati per il Pagamento della "Guida tecnica agli avvisi di pagamento".
- Avviso.Codice -> corrispondente al campo code della POST/notices/generate;
- Ente.Cbill -> codice interbancario dell'Ente Creditore, conosciuto anche come Codice SIA recuperato dal Backoffice pagoPA (vedi Compilazione dati configurazione su Backoffice pagoPA).
Le varianti del bollettino rata unica sono il template con bollettino postale ed il template senza scadenza.
Dicci cosa ne pensi
Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub