Skip to main content

How To Configure Fiscal Italy RT Printer

Fiscal Overview​

For shared background on Enactor fiscalisation, see Fiscal Overview.

Italy Fiscalisation Introduction​

In Italy, fiscalisation is a legal requirement for businesses to ensure accurate and transparent financial reporting.

It is important for businesses in Italy to select a certified fiscal solution and ensure proper installation and configuration of the system to meet fiscalisation requirements. Failure to comply with fiscalisation regulations can result in penalties, fines, or legal consequences.

Overall, fiscalisation in Italy aims to enhance transparency, combat tax evasion, and streamline the process of tax collection by leveraging electronic recording and reporting of sales transactions.

info

The Enactor solution works with the RT printer provided by NCR Voyix, approved by the Italy Tax Authority for fiscalisation. This avoids the need for the solution to be certified, instead relying on the certification obtained by NCR Voyix.

Deployment Overview​

Deploy the fiscal module to POS devices using the following steps:

  1. Using the EM application update broadcaster, first send the application updater update.zip to the devices you wish to deploy the fiscal solution on to.

Deployment overview showing the application updater broadcast screen

  1. Wait until it succeeds.

  2. Then send the update POS min.zip file.

  3. Wait until it succeeds.

  4. Send the Fiscal Module Update.zip.

  5. Then send the PrinterResources-Italy.zip.

  6. Once both updates are completed, the POS will be ready with the new POS Fiscal Module.

  7. To verify the updates:

    1. Check the installation location's custom-lib (pos/custom-lib) folder for JAR files containing "fiscal" in their names.

    2. Check the ext-lib folder for these files:

      • CUSTOMJPOSF-3.10.38.jar
      • javapos-1.14.3.jar
      • log4j-1.2.13.jar
      • xercesImpl.jar

    3. Check the bin and scripts folders to ensure they contain the four required .dll files.

    4. Check the config folder for the jpos.xml file. Ensure that the jpos.properties file is also present inside the jpos/res directory.

  8. Deploy the fiscalisation JARs to the EM using the JAR Deployer maintenance.

Configuration Overview​

The following configuration changes are required and must be broadcast to all Italy devices in preparation for go live. Detailed steps for how to do this are contained in supplementary how-to guides available on the Enactor Insights portal, as well as being covered in the Introduction to Enactor training course.

warning

Although steps have been taken to ensure that the POS will not start or perform transactions without a valid configuration, it is the retailer's responsibility to ensure a valid configuration is present and not to try to circumvent any of the requirements of the Italy Fiscal Legislation through misconfiguration of the solution.

Region​

Region must be configured before continuing with the other configurations related to fiscalisation. A region for Italy should be created within the Region Group Hierarchy.

Region Group Hierarchy showing the Italy region configuration

Create the Italy region within the Region Group Hierarchy to enable fiscal configuration for Italian devices.

Region Maintenance showing Italy region details

Configure the region details for Italy. This region will be referenced by subsequent fiscal configuration entities.

Tax Groups​

The following tax groups should be configured and broadcast to the appropriate Italy devices.

Tax Group IDDescription
IT1Standard IVA - 22%
IT2Reduced IVA 1 - 10%
IT3Reduced IVA 2 - 5%
IT4Super reduced IVA - 4%
IT5Special IVA
IT6IVA Esente - 0%
IT7Esclusa - 0%
IT8Non Soggetta - 0%
IT9Non Imponibile - 0%
IT10Regime del Margine - 0%
IT11Operazione Non IVA - 0%
IT12Ventilazione IVA - 0%

Tax Rates​

The following tax rates should be configured and broadcast to the appropriate Italy devices.

warning

For fiscal tax rate references 1 to 5, setting the percentage to 0% is not permitted.

Tax Rate TypeTax Rate IDDescriptionDisplay CodePercentageFiscal Tax Rate Reference
VATIT1Standard IVA - 22%S22%1
VATIT2Reduced IVA 1 - 10%R110%2
VATIT3Reduced IVA 2 - 5%R25%3
VATIT4Super reduced IVA - 4%SR4%4
VATIT5Special IVASP4%5
VATIT6IVA Esente - 0%N10%6
VATIT7Esclusa - 0%N20%7
VATIT8Non Soggetta - 0%N30%8
VATIT9Non Imponibile - 0%N40%9
VATIT10Regime del Margine - 0%N50%10
VATIT11Operazione Non IVA - 0%N60%11
VATIT12Ventilazione IVA - 0%N70%12

Tax Scheme​

The following tax scheme should be configured and broadcast to the appropriate Italy devices. Make sure to add all the Tax Rates related to Italy as well.

Tax Scheme IDDescriptionPrice Include Tax
ITItaly Tax SchemeTRUE

Tax Scheme Maintenance showing the Italy Tax Scheme configuration

Configure the Italy Tax Scheme with Price Include Tax set to TRUE.

Tax Scheme Maintenance showing the associated tax rates for the Italy scheme

Ensure all Italy-specific tax rates are added to the Italy Tax Scheme.

Tax Group Tax Methods​

The following tax group tax methods should be configured and broadcast to the appropriate Italy devices.

Tax Group IDTax Scheme IDDescriptionTax Rate
IT1ITStandard IVA - 22%22%
IT2ITReduced IVA 1 - 10%10%
IT3ITReduced IVA 2 - 5%5%
IT4ITSuper reduced IVA - 4%4%
IT5ITSpecial IVA4%
IT6ITIVA Esente - 0%0%
IT7ITEsclusa - 0%0%
IT8ITNon Soggetta - 0%0%
IT9ITNon Imponibile - 0%0%
IT10ITRegime del Margine - 0%0%
IT11ITOperazione Non IVA - 0%0%
IT12ITVentilazione IVA - 0%0%

Tax Group Tax Methods Maintenance showing the configuration linking tax groups to the Italy tax scheme

Link each Tax Group to the Italy Tax Scheme and set the corresponding tax rate percentage.

Tender​

The following tenders should be configured and broadcast to the appropriate Italy devices.

Tender IDDescriptionRegionCurrencyFiscal Tender TypeFiscal Tender ID
CASH_ITCashItalyEuros-1
CHQ_ITChequeItalyEuros-2
CARD_ITCardItalyEurosLOTTERY3
GV_ITVoucherItalyEuros-5
BT_ITBank TransferItalyEuros-7
EGC_ITGift CardItalyEuros-53
info

Tenders that should support lottery code capturing must have the Fiscal Tender Type set to LOTTERY.

Tender Maintenance showing the fiscal tender configuration for Italy

Configure each Italy tender with the appropriate Fiscal Tender Type and Fiscal Tender ID. Set the fiscal tender type to LOTTERY for tenders that support lottery code capturing.

Location​

The following locations should be configured and broadcast to the appropriate Italy devices.

Location IDNameRegionPrice GroupBase Currency
IT0001Enactor Store ItalyItalyItaly (All Region)Euros

Add the following details which are needed in the receipt header and trailer.

Navigate to Location Maintenance using the path: Location Maintenance > Receipt tab > Receipt Header Lines

Location Maintenance Receipt tab showing receipt header line configuration

Configure the Receipt Header Lines on the Receipt tab. These lines will be printed at the top of every fiscal receipt.

Configure the receipt header logo to be printed on receipts by the printer.

info

The logo must satisfy the following conditions:

  • Width: 400 pixels
  • Height: 200 pixels
  • Format: Black and white bitmap (.bmp)

Set the address details in Location Maintenance on the Address tab.

Location Maintenance Address tab showing the address configuration for the Italy store

Set the store address details on the Address tab. These details are required for the fiscal receipt header.

Device​

The following device should be configured and broadcast to the appropriate Italy devices.

Device Maintenance showing the configuration for an Italy fiscal POS device

Configure the device for use with the Italy fiscal solution. Ensure the device is associated with the correct Italy location.

POS Terminal​

The POS Terminal Template used by all devices in Italy must be configured to have the Fiscalisation Type set to Italy. Currency should be set to Euro and Locale to Italy.

warning

If a POS terminal configuration with the fiscalisation type set to Italy is broadcast to a POS device that does not have the Italy fiscal module installed, the POS will fail to start. Similarly, if a POS device with the Italy fiscal module installed is configured with anything but the Italy fiscalisation type, the POS will also fail to start. This is to ensure that only versions of the Enactor solution that have been certified for use in Italy are used in Italy.

POS Terminal Maintenance showing Fiscalisation Type set to Italy, Currency set to Euro, and Locale set to Italy

Set the Fiscalisation Type to Italy, Currency to Euro, and Locale to Italy.

Peripherals Tab​

The Peripherals tab should be configured as shown below.

POS Terminal Maintenance Peripherals tab showing the fiscal printer configuration

Configure the Peripherals tab to include the fiscal printer settings.

The Receipt Printer Address should be set to the logical name of the JposEntry defined in the jpos.xml file, which must be placed in the config folder.

Example jpos.xml:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE JposEntries PUBLIC "-//JavaPOS//DTD//EN" "jpos/res/jcl.dtd">
<JposEntries>
  <JposEntry logicalName="EthernetFiscalPrinter">
    <creation factoryClass="com.custom.jpos.services.CustomJposServiceInstanceFactory"
              serviceClass="com.custom.jpos.services.FiscalPrinterService"/>
    <vendor name="Custom, SPA" url="http://www.custom.it"/>
    <jpos category="FiscalPrinter" version="1.7"/>
    <product description="Custom FiscalPrinter from Custom Corporation"
             name="Custom FiscalPrinter Service for JavaPOS(TM) Standard"
             url="http://www.custom.it"/>
    <prop name="deviceBus" type="String" value="Ethernet"/>
    <prop name="portName" type="String" value="172.16.251.124"/>
    <prop name="logStatusCommands" type="String" value="false"/>
    <prop name="deleteEmptyHeaderLines" type="String" value="false"/>
    <prop name="debugDll" type="String" value="true"/>
  </JposEntry>
</JposEntries>

The value of the portName property should be the IP address of the physical printer.

To find the printer IP address, refer to the device manual and follow these steps:

  1. Turn the printer off and then back on using the power button.
  2. When the startup beep ends, press and hold both buttons simultaneously until the printer prints a slip.
  3. Press the Feed button once.
  4. Press the Open Lid button.

This prints a long receipt containing the IP address and other printer details. Once the receipt is printed, press the Open Lid button again to return the printer to FPU mode.

POS Terminal Maintenance Peripherals tab showing receipt printer address configuration

Set the Receipt Printer Address to the logical name defined in the jpos.xml file (e.g. EthernetFiscalPrinter).

POS Terminal Maintenance showing additional fiscal printer peripheral settings

Verify the remaining peripheral settings are configured correctly for the fiscal printer.

Receipt Configuration​

The primary receipt should be set to Fiscal 44 Standard Receipt.

POS Terminal Maintenance Printing tab with primary receipt set to Fiscal 44 Standard Receipt

Set the primary receipt to Fiscal 44 Standard Receipt on the Printing tab.

Print Receipt for Void Transaction - Set to false (unchecked). Available under: Printing > Flags

Order Deposit Per Delivery Option - Set to true (checked). Available under: General > Transaction

Receipt Templates​

The following receipt templates should be configured under Printing > Cards:

Voucher TypeReceipt Template
Card Voucher, Merchant CopyCard Mer Copy IT RTP 44
Card Voucher, Customer CopyCard Cust Copy IT RTP 44
Card Voucher, Merchant Cancelled CopyCard Cancelled Mer Copy IT RTP 44
Card Voucher, Customer Cancelled CopyCard Cancelled Cust Copy IT RTP 44
Gift Card Advice SlipGift Card Advice Slip IT RTP 44
Customer Signature SlipCustomer Signature Slip IT RTP 44

POS Terminal Maintenance Printing Cards tab showing the receipt template configuration for Italy

Configure the receipt templates on the Cards sub-tab. Each voucher type must be assigned the corresponding Italy RTP 44 receipt template.

Lottery​

Configure lottery code validation using Field Validator Set Maintenance and Field Validator Definition Maintenance.

Field Validator Set Maintenance showing lottery code validation configuration

Create a Field Validator Set for lottery code validation.

Field Validator Definition Maintenance showing lottery code validation rules

Define the validation rules for the lottery code in Field Validator Definition Maintenance.

Field Validator Definition showing additional lottery validation settings

Configure additional validation settings for the lottery code field.

Field Validator Definition showing format and length validation for lottery codes

Set the format and length requirements for the lottery code.

Field Validator Definition showing the completed lottery code validation configuration

Review the completed lottery code validation configuration.

Product Tax​

The following tax configurations should be configured against the products and broadcast to the appropriate Italy devices. Tax groups can be either configured to have an Italian tax group or a tax group by tax region.

Product Maintenance showing the tax group assignment for Italy products

Assign the appropriate Italy Tax Group to each product, either directly or by tax region.

Privileges​

The following privileges need to be configured against the appropriate roles and broadcast to the Italian devices. Consideration should be given to whether it is desirable for all operators to have all of these privileges or if some should only be granted to managers.

tip

For more detail on privileges and roles, refer to the How To Configure Users, User Roles and User Templates guide. Ensure the fiscalisation JAR files are deployed to the EM.

Privilege IDApplication Package
enactor.pos.RequestSimpleFiscalInvoiceAllowedPOS Fiscalisation
enactor.pos.PrintFiscalReportsAllowedPOS Fiscalisation
enactor.pos.AuthorisesPrintFiscalReportsPOS Fiscalisation
enactor.pos.fiscal.SetHeaderAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSetHeaderPOS Fiscalisation
enactor.pos.fiscal.SetLogoAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSetLogoPOS Fiscalisation
enactor.pos.fiscal.SyncTimeAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSyncTimePOS Fiscalisation
enactor.pos.fiscal.SyncVATAllowedPOS Fiscalisation
enactor.pos.fiscal.AuthorisesSyncVATPOS Fiscalisation

Sale Menu​

Navigate to Menu configuration using the path: Configuration > Systems > Menu

Edit the SALE menu for the Menu Group Standard POS.

Add a folder under Sales > Management > Report called Fiscal Reports.

Add new buttons to the Fiscal Reports folder with the following menu data:

EventIDButton LabelNameJava TypeValue
Fiscal_PrintReports_XFiscal_PrintReports_XFiscal X ReportReportTypeStringX
Fiscal_PrintReports_ZFiscal_PrintReports_ZFiscal Z ReportReportTypeStringZ
Fiscal_PrintReports_PeriodicFiscal_PrintReports_PeriodicPeriodic ReportReportTypeStringPERIODIC

Edit the SALE menu for the Menu Group Standard POS.

Add a new button to Sales > Receipts with the following menu data:

EventIDButton Label
RequestSimpleFiscalInvoiceRequestSimpleFiscalInvoiceRequest Simple Fiscal Invoice

Admin Menu​

Navigate to Menu configuration using the path: Configuration > Systems > Menu

Edit the ADMIN menu for the Menu Group Standard POS.

Create a menu folder named Financial and add the following menu buttons:

EventIDImage URL
TerminalCashManagementTerminalCashManagementNextGen1024x768/Admin/TerminalCashManagementButton.png
SafeCashManagementSafeCashManagementNextGen1024x768/Admin/SafeCashManagementButton.png

Add the following fiscal administration buttons:

EventIDButton LabelNameJava TypeValue
Fiscal_Set_HeaderFiscal_Set_HeaderSet HeaderConfigTypeStringSET_HEADER
Fiscal_Set_LogoFiscal_Set_LogoSet LogoConfigTypeStringSET_LOGO
Fiscal_Sync_VATFiscal_Sync_VATSync VATConfigTypeStringSYNC_VAT
Fiscal_Sync_TimeFiscal_Sync_TimeSync TimeConfigTypeStringSYNC_TIME
Fiscal_Get_Vat_RatesFiscal_Get_Vat_RatesGet VAT RatesConfigTypeStringGET_VAT_RATES
tip

For more detail on menu creation, refer to the POS Functionality guides covering menu configuration.

Operations​

Fiscal X Report​

The X Report gives a report of the transactions. This does not close the fiscal day.

  • The location of this button in the menu structure is configurable.
  • The function is privilege controlled.

Fiscal Z Report​

The Z Report closes the fiscal day.

  • This should be generated at the end of a shift or day.

Set Header​

Set Header is used to define and store mandatory business details that are printed on every fiscal receipt or report.

info

This functionality can only be triggered once the Day End report (Z Report) has been completed.

Set Logo allows businesses to upload and print their company logo on receipts.

  • The logo can be updated (bitmap loading) but this operation is permitted only after a Z Report.
  • The logo size must be approximately 400 x 200 points.

Sync VAT​

Sync VAT synchronises the POS VAT rates with the printer VAT rates.

Sync Time​

Sync Time synchronises the POS date and time with the printer.

Get VAT Rates​

Get VAT Rates retrieves the VAT rates that are currently synced with the printer.

Functional Overview​

Once all configurations have been completed correctly, the first step is to synchronise the VAT rates with the fiscal printer. This can be done by navigating to:

Admin Menu > Fiscalisation > Sync VAT

Upon successful synchronisation, the printer will automatically generate several receipts as confirmation.

After this, the POS is ready for use. You can add an item to the basket, press Total, choose a tender method, and complete the transaction as usual.

To configure receipt headers and synchronise the printer's date and time, use the corresponding options available in the Admin Menu.

warning

It is essential to sync the printer's time with Italian local time to ensure successful submission of the Z report to the server.