Table of contents
š Technical specifications
Page format
The specifications are intended to guarantee reproducibility in an A4 format suitable for printing. The variants section provides other formats, such as those suitable for receipts of portable thermal transfer printers.
Back-front printing
It is possible to print the pagoPA payment notice on both sides of a sheet of page, making sure to select a paper density that does not make it difficult to read the provided information, in particular the QR code.
Text coding
It is mandatory to use the coding of UTF-8 characters that support all the Unicode characters, including those extended to languages such as Slovenian (Ä, Å”, ž) and German (Ƥ, ƶ, ü, Ć). This guarantees that multi-language texts can be correctly displayed and managed.
Page structure
The payment notice is comprised of various modules. There are some fixed and other variables based on the type of payment and the way in which the creditor manages collections.
| Order | Name |
|---|---|
| 1 | Header |
| 2.1 | Information about the creditor |
| 2.2 | Information about the recipient |
| 3.1 | Amount and due date |
| 3.2 | Where to pay |
| 4 | Payment data |
The various pages that describe the modules use placeholder texts, which are identified by keys according to the syntax ""property1.property2"", such as, for example, Avviso importo or Destinatario cf.
The images, instead, are shown with gray blocksāidentified always with a variable (e.g.: Avviso qrcode).
The data models that include all the possible variables used in the notice is the follows:
1notice:
2 subject: TARI 2021
3 amount: 150,00
4 date: 31/01/2022
5 code: 0000 0000 0000 0000 00
6 qrcode: PAGOPA|002|000000000000000000|01199250158|0000015000
7 installments:
8 total: 3
9 info: "You can pay the full amount or in 3 installments"
10 1:
11 amount: 50,00
12 date: 31/12/2021
13 code: 0000 0000 0000 0000 00
14 qrcode: PAGOPA|002|000000000000000000|01199250158|0000015000
15 2:
16 amount: 50,00
17 date: 31/01/2022
18 code: 0000 0000 0000 0000 00
19 qrcode: PAGOPA|002|000000000000000000|01199250158|0000015000
20 3:
21 amount: 50,00
22 date: 28/02/2022
23 code: 0000 0000 0000 0000 00
24 qrcode: PAGOPA|002|000000000000000000|01199250158|0000015000
25institution:
26 cf: 01199250158
27 cbill: A0EDT
28 name: Municipality of Milan
29 sector: Local taxes
30 info: "For information www.comune.milano.it/TARI Ā· tel. 02 0202"
31 logo: logo-ente.png
32 canale:
33 online: "on the website of the Municipality of Milan"
34 physical: ""
35recipient:
36 cf: RSSMRA60D20F205R
37 completename: Mario Rossi
38 address: Vicolo Corto 12 20133 Milano MI
39Fixed texts
Texts that cannot be changed are indicated in section Stringhe dei testi fissi.
Tell us what you think
For clarifications on implementation specifications, such as SACI and SANP, you can open an issue on GitHub