Contents
Who this article is for: it applies to clubs operating in Italy that must comply with its tax regulations.
What is this integration?
The Italian tax compliance integration covers Italy's two tax obligations from Golfmanager:
Fiscal printer (scontrino): it sends the POS sale receipts to the Italian fiscal printer, which prints the scontrino fiscale and handles the daily closing (Z report).
FatturaPA: it generates the Italian electronic invoice in FatturaPA format (XML) to send to the SdI (Sistema di Interscambio).
The scontrino is the fiscal receipt printed by the fiscal printer (registratore telematico). The FatturaPA is the electronic invoice file that in Italy is sent to the Agenzia delle Entrate through the SdI. Golfmanager generates the XML file; sending it to the SdI is done by you or your accountant.
What problem does it solve?
It meets Italian tax regulations for the POS and for invoicing, without manual steps.
It prints the scontrino automatically when charging and handles the daily closing (Z).
It generates the FatturaPA ready to send to the SdI.
It validates the fiscal data (VAT, exemptions, departments) to avoid errors.
Which systems does it connect, and which way does the data flow?
Fiscal printer: the POS sends the receipt to the fiscal printer over the local network (to its IP address), and receives the scontrino number and the result.
FatturaPA: Golfmanager generates the invoice XML file, which is then sent to the SdI (through your channel or your accountant).
The printer works on the club's local network; the FatturaPA is a file you download and deliver to the SdI. There is no automatic sending to the SdI from Golfmanager.
What does the integration produce?
Item | What it is |
Fiscal scontrino | The POS fiscal receipt, printed by the fiscal printer |
Refund receipt | When a sale with a scontrino is cancelled, it references the original receipt |
Z report | The daily closing the printer prints, resetting the counters |
FatturaPA (XML) | The electronic invoice for the SdI (invoice TD01 or credit note TD04) |
Prerequisites (before turning the integration on)
Operate in Italy and be subject to its tax regulations.
Have a compatible fiscal printer (Epson/compatible) connected to the POS network.
Have the module installed, along with the billing and POS modules.
Have the company's fiscal data (Partita IVA, codice fiscale, fiscal regime, province, address).
Billing management permissions to configure.
How to set it up (step by step)
Step 1 — Install the module
Install the Italian tax compliance module (Italy Fiscal Printer). Afterwards the Italy Fiscal Printer menu appears with the configuration, the transactions and the receipts.
Step 2 — Company fiscal data
On the company record, the Italian Fiscal Data section, fill in the Fiscal Regime (RF01–RF19), the Codice fiscale and the Province.
Check that the Partita IVA and the address are complete.
Save your changes.
Step 3 — Fiscal printer on the POS
On each POS, the Italian Fiscal Printer section, enter the fiscal printer IP and its serial number (the latter is used in refunds).
Make sure the POS is on the same network as the printer.
Save your changes.
Step 4 — Fiscal departments by family
On each product family, fill in the Fiscal Department ID, which tells the printer which type of VAT to apply.
Save.
Step 5 — Exempt products (exemption reason)
On each exempt product (0% VAT), set the tax exemption reason (Natura IVA, N1–N7).
Save. The system requires it when saving a 0% product without a reason.
Step 6 — Payment methods (FatturaPA mode)
On each payment method, assign the FatturaPA payment mode: MP01 cash, MP02 cheque, MP05 bank transfer, MP08 card or MP09 direct debit.
Save.
Step 7 — Customers' fiscal data
On the record of each customer who receives an electronic invoice, fill in, as applicable, the codice fiscale/Partita IVA, the SDI code and the recipient code (7 characters).
Save.
⚠️ If any required data is missing (the printer IP, a family's fiscal department, the exemption reason of a 0% product, or the company's fiscal regime for the FatturaPA), the corresponding operation will error. It's best to configure everything before starting.
Each configuration field explained
Below, each field is explained: what it is, how it affects the system, how it behaves, and an example of use. They're grouped by screen.
General settings (Settings > Italy Fiscal Printer)
Printer IP address (default)
Field name: Printer IP address.
Description: a fallback printer IP, used if a POS has no IP of its own.
System impact: it lets a POS without its own IP use this one.
System behavior: the IP set on the POS takes priority; this is only the fallback.
Example of use / what happens: you use it if all POS terminals share the same printer.
Fiscal Serial Number (default)
Field name: Fiscal Serial Number.
Description: the printer's serial number, as a fallback, if the POS doesn't have one.
System impact: it's used in the refund reference when the POS has no serial of its own.
System behavior: the POS one takes priority; this is the fallback.
Example of use / what happens: you leave it filled as a common value if you share the printer.
Company data
Fiscal Regime
Field name: Fiscal Regime.
Description: the club's fiscal regime (RF01 ordinary, RF02 minimum taxpayers, etc.).
System impact: it's required to generate the FatturaPA; it appears in the XML.
System behavior: if it's missing, when downloading the FatturaPA the system warns to "configure the fiscal regime for the company".
Example of use / what happens: you select RF01 (ordinary) if that's your case.
Codice fiscale
Field name: Codice fiscale (Fiscal Code) of the company.
Description: the company's fiscal identifier.
System impact: it's included in the FatturaPA as sender data.
System behavior: it's needed for the electronic invoice.
Example of use / what happens: you fill it with the club's codice fiscale.
Province
Field name: Province.
Description: the province abbreviation (for example, RM for Rome, MI for Milan).
System impact: it's part of the fiscal address in the FatturaPA.
System behavior: it's included in the sender data.
Example of use / what happens: you set the abbreviation of the club's province.
Partita IVA
Field name: Partita IVA (the company's VAT number).
Description: the club's VAT number.
System impact: it identifies the sender in the FatturaPA and names the XML file.
System behavior: it's a key fiscal datum of the sender.
Example of use / what happens: you fill it with the club's Partita IVA.
POS (fiscal printer)
Fiscal Printer IP
Field name: Fiscal Printer IP.
Description: the address of that POS's fiscal printer on the local network.
System impact: it's where the POS sends the receipts to be printed.
System behavior: without it (or the fallback), it can't print; the system warns that "the fiscal printer IP must be configured on the POS or in settings".
Example of use / what happens: you set the IP of the printer connected to that counter.
Fiscal Serial Number (on the POS)
Field name: Fiscal Serial Number, on the POS.
Description: the serial number of that POS's printer.
System impact: it's used in the refund reference (along with the scontrino number and the Z report).
System behavior: recommended so refunds are well identified.
Example of use / what happens: you fill it with the printer's serial number.
Families, products, payment methods and customers
Fiscal Department ID (family)
Field name: Fiscal Department ID, on each family.
Description: the printer department number that defines the VAT of that family.
System impact: it's what tells the printer which VAT to apply to those products.
System behavior: if a family doesn't have it, the VAT may come out wrong on the receipt.
Example of use / what happens: you assign each family the department that has its VAT type set on the printer.
Tax exemption reason (product)
Field name: Tax exemption reason, on each exempt product.
Description: the VAT nature code (N1–N7) for 0% products.
System impact: it's required if the product is at 0%; it appears in the FatturaPA.
System behavior: when saving a 0% product without a reason, the system warns that "tax exemption reason is mandatory for products with 0% tax".
Example of use / what happens: you set an exempt product its corresponding N code.
FatturaPA Payment Mode (payment method)
Field name: FatturaPA Payment Mode, on each payment method.
Description: the FatturaPA payment code (MP01 cash, MP02 cheque, MP05 bank transfer, MP08 card, MP09 direct debit).
System impact: it's included in the electronic invoice XML (independent of the scontrino's payment type).
System behavior: it classifies the payment means in the FatturaPA.
Example of use / what happens: you set "Card" to MP08.
Customer fiscal data
Field name: Codice fiscale/Partita IVA, SDI Code and Recipient Code (on the customer record).
Description: the recipient data for the electronic invoice.
System impact: they identify the customer in the FatturaPA. The recipient code is 7 characters.
System behavior: if there's no recipient code, it defaults to
0000000(Italian customers) orXXXXXXX(foreign).Example of use / what happens: for a business customer you set their Partita IVA and their recipient code or SDI code.
How it works day to day
At the POS (scontrino)
When charging a sale, the receipt is sent automatically to the fiscal printer, which prints the scontrino.
Refunds: when cancelling a sale with a scontrino, a refund receipt is printed referencing the original. Partial cancellations are not allowed: the whole sale must be cancelled.
Reprint: if a receipt was already printed, a reprint is generated instead of a new scontrino.
Daily closing: press the "Z Report" button at the POS for the day's closing. You'll see "Z Report sent successfully".
FatturaPA (invoices)
One invoice: on the invoice detail, use the "FatturaPA" action to download its XML (with a name like
IT[PartitaIVA]_[no.].xml).Several invoices: on the invoice list, use the "FatturaPA" action, choose the period (and the company) and download a ZIP with all the XML files.
Then, you send those files to the SdI through your channel or accountant. Golfmanager generates the file, but doesn't send it to the SdI.
ℹ️ Sales that already have an invoice, those paid with a voucher only, and Opera room charges (if the Opera module is installed) are not sent to the fiscal printer.
Checking transactions and fiscal receipts
The Italy Fiscal Printer menu includes:
Fiscal Transactions: each communication with the printer (what was sent and the response, successful or failed), with the POS and the sale.
Fiscal Receipts: the scontrini issued, with their number, amount, date, time and associated Z report.
It's the first information to check when a receipt hasn't been issued correctly.
Limitations to keep in mind
The fiscal printer must be on the local network and reachable from the POS.
Partial cancellations are not allowed: the whole sale must be cancelled.
The following don't go through the printer: already-invoiced sales, those paid with a voucher only, and Opera room charges.
Exempt products need their exemption reason; families need their fiscal department.
The FatturaPA is downloaded and sent to the SdI through your channel or accountant; the module generates the file but doesn't transmit it.
Only confirmed invoices with a customer are exported to FatturaPA.
It's specific to Italy.
Frequently asked questions
What two things does this integration do?
Two: (1) it sends the POS receipts to the fiscal printer to print the scontrino and do the daily closing (Z report), and (2) it generates the FatturaPA (electronic invoice XML) to send to the SdI.
Does Golfmanager send the FatturaPA to the SdI automatically?
No. Golfmanager generates the XML file; you download it and send it to the SdI through your channel or your accountant. There is no automatic transmission.
The scontrino doesn't print. What should I check?
It's almost always the network or the IP: that the printer IP is configured on the POS (or in settings), and that the printer is on and reachable. If the IP is missing, the system warns that "the fiscal printer IP must be configured on the POS or in settings".
I get "Error communicating with the fiscal printer". What do I do?
The POS couldn't contact the printer. Check that it's on and on the same network, and that the IP is correct; then retry.
I get "Printing error: …" with a code. What does it mean?
The printer returned an error while processing the receipt (for example, out of paper or a document datum). Check the detail in Fiscal Transactions and, if it doesn't resolve, contact the printer's support.
It won't let me save a product without VAT. Why?
Exempt (0%) products are missing the exemption reason (N1–N7). Set it on the product; the system warns that "tax exemption reason is mandatory for products with 0% tax".
The VAT comes out wrong on the receipt. What should I check?
The product's family doesn't have its Fiscal Department ID, or it's wrong. Review it on the family: that department is what defines the VAT on the printer.
How do I make a refund at the POS?
Cancel the sale: a refund receipt is printed referencing the original scontrino (with its number, date, Z report and serial number). You can't refund a part: the whole sale must be cancelled.
It won't let me cancel just a part of the sale. Is that normal?
Yes. Partial cancellations are not allowed: the system warns that "partial ticket cancellation is not allowed; the entire ticket must be canceled". Cancel the whole sale.
I reprinted a receipt and no new scontrino came out. Why?
That's correct: if the receipt was already printed, a reprint is generated, not a new fiscal scontrino (which would duplicate the document).
How do I do the daily closing?
Press the "Z Report" button at the POS. The printer prints the day's closing and resets the counters. You'll see "Z Report sent successfully".
Which sales aren't sent to the fiscal printer?
Those that already have an invoice, those paid with a voucher only, and Opera room charges (if the Opera module is installed). Everything else does go through the printer.
How do I download the FatturaPA of an invoice?
On the invoice detail, use the "FatturaPA" action and the XML downloads. For several, use the "FatturaPA" action on the list, choose the period and download a ZIP.
I get "A customer is required to generate the FatturaPA". What do I do?
The invoice has no customer. The FatturaPA needs a recipient; assign the customer and download again.
I get "Configure the fiscal regime for the company". What should I check?
The company's fiscal regime (RF01–RF19) is missing. Fill it in on the company record, along with the codice fiscale and the Partita IVA.
What is the "recipient code" and what do I put if I don't have it?
It's a 7-character recipient code for the electronic invoice. If it's not on file, it defaults to 0000000 (Italian customers) or XXXXXXX (foreign). If the customer has an SDI or recipient code, put it on their record.
What's the difference between TD01 and TD04?
In the FatturaPA, TD01 is an invoice and TD04 a credit note. Golfmanager assigns it automatically based on the document.
Is the FatturaPA payment mode the same as the scontrino's payment?
No. The FatturaPA payment mode (MP01–MP09) is only for the electronic invoice XML; the scontrino's payment type is handled separately by the printer.
Is there any automatic background process (cron)?
No. Everything happens at the moment: the scontrino when charging, the refund when cancelling, the Z report when you press it, and the FatturaPA when you download it. There are no scheduled sends.
What permissions do I need to configure the integration?
Billing management permissions, which give access to the configuration, the transactions and the fiscal receipts.
What should I do when rolling it out to make sure it works?
Configure all the fiscal data (company, departments by family, exemptions, payment methods, customers), do a test receipt and a Z report, and validate a test FatturaPA with your accountant before operating.
Recommended best practices
Configure all the fiscal data (company, departments by family, exemptions, payment methods, customers) before operating.
Test the printer with a test receipt and a Z report.
Keep the local network stable between the POS and the fiscal printer.
Validate a test FatturaPA with your accountant before starting to send them to the SdI.
On a failure, check Fiscal Transactions first: there you'll find what was sent and the printer's response.