View source | Discuss this page | Page history | Printable version   

Retail:Epson RT Printer Fiscal Integration for Italy



This document describes the installation and configuration of the Openbravo integration with the Epson RT 90III Printer. The Epson RT 90III Printer is a device that follows the Italy fiscal rules for RT Printers. It allows the creation of fiscal receipts and fiscal reports.

This integration also includes the use of the customer display and cash drawer attached to the Epson RT 90III, and operates the same way any other customer display or cash drawer supported by Openbravo.

Desktop integration

The Web POS application communicates with the Epson RT 90III printer using the Fiscal ePOS-Print XML API defined by Epson that allows to communicate directly from the Web POS with the printer without needing any proxy.

This is an overview of the architecture:


Installation and configuration

Epson RT 90III Printer

In general the RT Printer should be configured an ready to work by the provider. Usually the only topic you must check is that the printer has installed the SSL certificate in order to allow Secure HTTP (HTTPS) communication. HTTPS is a security requirement by Openbravo Web POS. To install HTTPS in the RT Printer, refer to the installation documentation of the RT Printer. As a summary the steps are the following:

Finally check everything is correct, opening Chrome in the terminal and loading the page https://rtprinter90iii.local where rtprinter90iii.local is the hostmane associated to the RT Printer.


As System Administrator you need first to install the module RT Printer fiscal integration for Italy. After the module is installed you can rebuild the application and start the configuration.

To configure the taxes, go to the window Tax Rate. In this window, for every tax rate used in the POS, it must be defined the field Fiscal department. The value of this field can be defined as described below:

To configure payments, go to the window Channel - Touchpoint Type, for each Touchpoint Type used in the POS, go to the tab Payment Method and fill in the fields Fiscal Department and Fiscal Index for all payment methods.

The values to fill in must follow these rules according to the Italy Fiscal Authorities:

Fiscal Department indicates the payment method:

Fiscal Index is used with either credit cards or tickets to select which kind of credit card or ticket has been used. It is also used with cash to increment different cash totalizers inside the fiscal printer index has no relevance with cheques. The following indexes are available:


The next step is to declare and configure all the RT Printers available and link each Touchpoint with one of the RT Printers available.

To declare RT Printers go to the window RT Printer. In this window create one new record for each RT Printer and fill in the following fields:


To define the template to use to print fiscal receipts, go to the Organization window and select the record for the store that has the POS terminals and select in the field Fiscal Receipt Template the template to use your fiscal receipts.


And finally in the window Channel - Touchpoint. First check the field Fiscal and then select in the field RT Printer the RT Printer this POS terminal will use.



Once everything is configured, you can use the POS terminal as usual. The customer display attached to the RT Printer will show the information of the current transaction, and the cash drawer connected will open after closing transactions. In the moment of closing a transaction a fiscal receipt will be printed according the template configured.

There are some limitations for fiscal receipts that apply to every POS terminal configured as Fiscal. For example.

After the fiscal receipt is created by the RT Printer. The fiscal information returned from the RT Printer is stored in the window Sales order or Return from customer, depending on the document created.


Fiscal Report X

The fiscal report X is the summary report for the daily sales for information purposes. It does not sets the totals to zero and does not send information to the fiscal authorities.

To print a Fiscal Report X, in the POS, go to the menu and select the option Print Report X

Fiscal Report Z

The fiscal report Z is the summary report for the daily sales that sets totals to zero and sends the sales information to the fiscal authorities. It must be created daily.

The fiscal report Z is created after the Cash Up process is completed successfully and the fiscal information returned from the RT Printer is stored in the window Channel - Touchpoint in the tab Cash Up History.


Receipt Lottery

The lottery specification Number 739122/2019, published on October the 31st by IT Tax Authority, defines the following main rules:

Besides the above Art.19 of Decreto Legge 26 ottober 2019, n.124, states that:

As a consecuence of that Epson RT 90III Printer used throughout the day can generate an XML file according to the layout required for Lottery purposes, by processing the data contained in the permanent summary memory. The RT can send data to the Lotteryy Server only if is state is "IN SERVICZIO", that is following at least one Zreport sent to the tax Authority.

The Registratore Telematico will accumulate the requests to participate to the lottery in a special memory and there will be 3 triggers that will trigger the send of the accumulated requests to the Lottery Server:

To get that working it is required that:

Same way, this lottery code needs to be printed in the commercial document.

To print the lottery code, the sequence of the commands is as follow:

To print out a Lottery Refund/Void receipt the commands sequence is as follow:

The LotteryIDCode must be sent if the original sales receipt was not found in the EJ of the RT Printer. If the original receipt is found in the EJ the RT add the Lottery ID Code available in the original receipt.

In Openbravo terms, verified returns will capture the LotteryIDCode of the original sale, so that one can be sent.

Retrieved from ""

This page has been accessed 18,497 times. This page was last modified on 26 August 2021, at 07:47. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.