Receipt macro expansion for Italian ADE document number and lottery code
When your organization issues invoices in Italy, Zenoti automatically extracts two fiscal identifiers β an ADE progressive document number and a lottery code β from the invoice record and makes them available as receipt macros. You can embed these macros in receipt header and footer templates so that both identifiers print on every Italian invoice automatically.
Audience: Administrators who configure receipt templates for Italian centers.
On this page
Before you begin
- Your organization must have at least one center operating in Italy (country code 102).
- You need access to POS receipt template configuration in Configuration > POS.
- Confirm that the invoice record populates the fiscal calculation field used for Italian compliance β this is handled automatically by Zenoti when an invoice is issued from an Italy-based center. No manual data entry is required.
Note: These macros expand to a non-empty value only when the invoice is issued from an Italian center. For invoices issued from centers in other countries, both macros expand to an empty string and no text prints in their place.
Steps
Add the ADE progressive number macro to a receipt template
- Select the Configuration icon.
- Navigate to Configuration > POS.
- Select Print and email receipt.
- Locate the Header (HTML) or Footer (HTML) field for the receipt template you want to update.
- In the header or footer field, enter the macro
[AdeProgressiveNumber]at the position where the ADE progressive document number should appear. - Select Save.
Add the lottery code macro to a receipt template
- Select the Configuration icon.
- Navigate to Configuration > POS.
- Select Print and email receipt.
- Locate the Header (HTML) or Footer (HTML) field for the receipt template you want to update.
- In the header or footer field, enter the macro
[LotteryCode]at the position where the Italy lottery code should appear. - Select Save.
Tip: You can include both macros in the same template section. For example, a footer field might read:
ADE Document No: [AdeProgressiveNumber] | Lottery Code: [LotteryCode]
How the macros expand
When a receipt is generated, Zenoti evaluates each macro based on the center from which the invoice was issued:
| Macro | Italian center (country code 102) | All other centers |
|---|---|---|
[AdeProgressiveNumber] |
ADE progressive document number extracted from the fiscal calculation field | Empty string β nothing prints |
[LotteryCode] |
Italy lottery code extracted from the fiscal calculation field | Empty string β nothing prints |
Zenoti parses the fiscal calculation field by splitting on the first comma delimiter. The value before the delimiter becomes the ADE progressive document number; the value after the delimiter becomes the lottery code.
Tips
- Place both macros in your receipt footer so they appear consistently at the bottom of every Italian invoice, separated from the main invoice body.
- If you use the same receipt template across multiple countries, the macros are safe to include β they produce no visible output for non-Italian centers.
- After saving your template changes, issue a test invoice from an Italian center and review the printed or emailed receipt to confirm both values appear as expected.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
[AdeProgressiveNumber] prints literally on the receipt instead of expanding |
The macro text contains a typo or extra space | Check the exact spelling β the macro is case-sensitive. Confirm it reads [AdeProgressiveNumber] with no spaces inside the brackets. |
| Both macros expand to blank text even for Italian invoices | The center is not configured with Italy (country code 102) as its country | Verify the center's country setting under Configuration > Business details. If the country is set incorrectly, update it and retest. |
| The lottery code field is empty on the receipt | The fiscal calculation field for the invoice does not contain a comma-delimited value | Confirm that Italian fiscal compliance is active for the center and that invoices are being issued through the correct flow. If the issue persists, contact Zenoti Support. |