Skip to main content

POS Printer

5 Steps to Successfully Connect Your Epson Printer

C
Written by Chris Neuner
Updated over 2 months ago

Introduction – What are the benefits of this integration?

The POS Printer module allows you to automatically send Roomservice orders directly to a receipt printer – reliably, quickly, and without manual effort. This ensures smooth operations in your kitchen or service area – seamlessly integrated into your Guestnet platform.


Feature Overview

The following features are available in the POS Printer module:

  • Automatic printing of orders on compatible Epson POS printers

  • Connection via public IP with port access

  • Use of a unified device ID ("local_printer")

  • Support for Epson’s ePOS-Print technology


How to Set Up the POS Printer Module

  1. Basic printer setup
    Download and install the utility program TM-T88VI Utility v1.52:
    πŸ”— Download Epson TM-T88VI Utility
    ​

  2. Enable ePOS-Print
    Open the configuration program and activate the option "Enable ePOS-Print".
    ​

    Bild (3).png


    ​

  3. Set device ID to "local_printer"
    Navigate to Device Management > Printer Registration
    Set the device ID to:
    ​local_printer
    ​
    ​

    Bild (4).png


    ​

  4. Make the printer accessible externally

    • Ensure that the printer is reachable via a static public IP address

    • Port 80 must be open for external HTTP access

    • Restrict access to Guestnet IP addresses
      πŸ”— View Guestnet IP addresses
      ​
      πŸ’‘ Alternatively, a different port may be used for external access. Internally, a port forwarding rule to port 80 must be configured.


      ​

  5. Enter the URL in Guestnet
    In Guestnet, the following URL must be entered either in the Roomservice settings or in the respective serving location:
    ​

    https://[YOUR_IP]:[PORT]/cgi-bin/epos/service.cgi?devid=local_printer&timeout=60000

    Example:
    ​
    ​https://203.0.113.5:5000/cgi-bin/epos/service.cgi?devid=local_printer&timeout=60000


FAQ – POS Printer Module

Which printer models are supported?

The following devices have been successfully tested:

  • EPSON TM-T88VI

  • EPSON TM-T20III

Printers must support ePOS-Print technology.
πŸ”— View list of compatible Epson printers with ePOS-Print

What issues might occur during setup?

Firewall:

  • Could the firewall be blocking the public IP?

  • Is the required port open?

Port:

  • Has the correct port been configured?

  • Is port forwarding properly set up?

Printer:

  • Is the printer powered on and connected to the network?

ePOS-Print:

  • Is the ePOS-Print feature activated?

  • Is the device ID correctly set (default: local_printer)?

How can the feature be tested

To properly test the function, you must allow your own IP address in the firewall in addition to the Guestnet IP addresses.

Then, a print command can be sent via curl using the CLI:

curl -X POST -d "<?xml version='1.0' encoding='utf-8'?><s:Envelope xmlns:s='http://schemas.xmlsoap.org/soap/envelope/'><s:Body><epos-print xmlns='http://www.epson-pos.com/schemas/2011/03/epos-print'><text align='center'/><text linespc='0'/><text>*********&#10;</text><text width='2' height='2'/><text linespc='55'/><text>GUESTNET&#10;</text><text width='1' height='1'/><text>*********&#10;</text><text linespc='28'/><text align='left'/><text>Test&#10;</text><text>&#10;</text><cut type='feed'/></epos-print></s:Body></s:Envelope>" http://[IHRE_IP]:[PORT]/cgi-bin/epos/service.cgi?devid=local_printer&timeout=60000

Replace [YOUR_IP] and [PORT] with the correct values.

If the request is successful, the printer will print a test page, and curl will return a success message in XML format.

If an error message appears, it should be analyzed β€” it usually indicates a configuration issue.

If a timeout message appears after approximately 60 seconds, the printer is not reachable from the outside. This typically means the IP address was not properly allowed in the firewall, or the port is misconfigured.


Would you like to use this feature?

Our Customer Success Team is happy to support you with setup and configuration:
πŸ“© support@guest.net

Did this answer your question?