View source | Discuss this page | Page history | Printable version   
Main Page
Upload file
What links here
Recent changes

PDF Books
Show collection (0 pages)
Collections help


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 is defined by the Fiscal Authorities for each tax rate.

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 (in progress)

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:

Besides the above this integration will be enhanced by icluding the RT Printer command (9-218) ”Read the status of single lottery receipt,” which will require a new menu option and UI in Openbravo Web POS.(to be defined).

Retrieved from ""

This page has been accessed 13,677 times. This page was last modified on 11 May 2020, at 14:18. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.