Order Thermal Printer App

Disclaimer 

For quick access to the topic you are looking for, click the corresponding link below:

• Functionality 
• Direct Printing vs Cloud Printing
• Additional Printing Options with Treefrog Digital
• Installing the App (Setup)
• Cloud Printing - Setting up your Thermal Printer
  • Adding the Printer in Commerce7
  • Setting up your Epson Printer
• Direct to Print - Setting up your Thermal Printer
  • Static IP Address Setup
  • SSL Certificate Installation
  • Enable EPOS Print
  • POS Profile Setup
  • Try a Test Print
• How to use your Thermal Printer
• How to add a Tip Line
• How to change your Receipt Template
• How to Factory Reset My Espon TM-T88VI or TM-U220B Printer

Functionality

The Order Thermal Printer app allows Commerce7 stores to connect a Thermal Printer to their store for printing order receipts. For custom receipts templates, please contact us for more details. 

This app is integrated with the Epson TM-T88VI, VII & V-i series Receipt Printer, and this documentation follows the steps on how to configure and install this thermal Printer. 

Direct Printing vs Cloud Printing, what’s the difference…

Direct printing prints the receipt instantly when you click the button and has a few requirements. 

1. You must set up a static IP address on the printer or assign one using DHCP. This IP address must be set in your POS Profile so you don't want it to change on the printer. You may need your IT provider to assist you with setting up an assigned/static IP address.
2. An SSL certificate provided by Commerce7 must be installed annually on all printers. For support with this installation, please contact us at support@treefrogdigital.com.

Cloud printing has a 1-15 second delay in printing receipts. The requirements are a one-time configuration of the printer. No static IP or SSL certificate is required.

The following printers are now integrated with Commerce7 and can be purchased through the links below.

Printers with Direct Print Option

Epson T88-VI

Epson T88-V-i

Epson T88-VI-i

Printers with Cloud Printing

Epson T88-VII

Epson T88-V-i

Epson T88-VI-i

Additional Printing Options with Treefrog Digital

These printing options required Installation, Annual SSL Certificate Updates, and Support through Treefrog Digital. 

We have worked diligently to establish additional printing solutions for our clients. We have partnered up with Commerce7 as they are focused on building customer-centric shopping experiences to offer you more flexibility with your printing setup.

Treefrog Digital will install these printers as there is required software installed directly at the winery location. A fee may be charged to set up printing on these devices; also, on a yearly basis, we will need to renew the SSL certificates on printers. Wineries should expect a charge for that annual procedure as well.

The reason for this partnership is simple; today, we print through the cloud - every 30 seconds, the printer checks the cloud to see if any receipts are there. If there are, it prints them; if not it does nothing. 

Previously we were unable to direct print to a local printer because it is not possible to go from a secure web app to an unsecured IP address (and printers by default, don’t have SSL and are unsecured). 

So by partnering up with Commerce7, Treefrog Digital is able to install an SSL on the receipt printer and support the additional software required to print in this way. 

Please contact us for any additional questions regarding setup, cost, and support for these devices. 

Installing the App (Setup)

To get started, navigate to the app store in your Commerce7 admin panel and click on the Order Thermal Printer app.

Before installing, you must first choose a Template to use on your Thermal Printer; choose Template 1 (you’ll be able to change the temple from the app settings); for now, ignore the other fields; we will configure this inside the app.

Scroll down and click on INSTALL

Once installed the application will show up on your Store Menu Page from your admin panel.

Cloud Printing - Setting up your Thermal Printer

Commerce 7 and our app are integrated with the Epson OmniLink TM-T88VII Receipt Printer. Using this integration, you can print receipts in the tasting room

If you have yet to purchase your thermal printer, please refer to the Direct Printing vs Cloud Printing section for a list of compatible printers for either cloud or direct printing options. Please only purchase through the links listed in that section, as there are many fake/knock-off devices on Amazon and we only recommend the listed site.

Please note that we do not recommend or support the WiFi connectivity as it is complicated to set up and maintain.

You will require a cat5/cat6 ethernet cable to connect this to your network.

Adding the Printer in Commerce7

1. To set up this integration, first, navigate to Settings > POS Profiles
2. Select the POS Profile you want the printer added to

3. Once you have selected the POS Profile, scroll to the bottom of the selected POS profile to reach the Receipt Printers section.
4. First, select the Printer Receipt Format. You can choose from any of our three predetermined templates. (For custom receipts templates, please contact us for more details)
5. Then for each receipt printer, you'd like to add to a POS profile, add a Printer ID and Title.
   1. Type - Select Cloud this is the default and what you need to set for Cloud Printing.
   2. PrinterID - Create your own 6-30 digit, alphanumeric ID. You cannot have spaces or use special characters in this ID (numbers and letters only).
   3. Title - Give your receipt printer a title. Staff will select a printer by title when deciding which printer to send receipts to. Example titles could be "Printer1", "Counter Printer", etc.
   4. Click on Add Printer
6. After entering all your receipt printers, click Save. 

Setting up your Epson Thermal Printer

Now we need to set up the actual receipt printer

1. First, Install the supplied sample paper roll into the printer
2. Plugin the printer into a Cat5/Cat6 Ethernet Jack on your local network (meaning connect your printer to your local network by means of the ethernet cable), plug in the power and turn the printer on.
3. Wait around 1 minute the printer will startup and print the local IP address is obtained from your network. 
4. Type in the IP address into a web browser from a computer on the same network (Example: http://192.168.1.78)

5. Login with the following credentials: Username: epson | Password: epson

   (if “epson” doesn’t work, try using the serial number on the side of the printer as the password)

6. You will see the EpsonNet Config page as below, click on “Epson OmniLink TM-T88VII”

7. You will see the EpsonNet Config for TM-i as follows:

8. Click Server Direct Print, and configure the following options

Server1 URL = https://apigateway.commerce7.com/lambdas/print-receipt?tenantId={your tenant identifier}

For example:

https://apigateway.commerce7.com/lambdas/print-receipt?tenantId=spectrawinery

You can find your tenant ID in Commerce7 from the admin panel and navigate to Settings > General

• Interval = 30. (Do not set less than 15 seconds or service may be throttled). 
• ID = The ID of the printer you configured earlier in this documentation in the POS profile section of the Commerce7 admin panel 
• Name = The ID of the printer you configured earlier in this documentation in the POS profile section of the Commerce7 admin panel.
• Server Authentication = Disabled

9. Under Device Admin click Printer and the following page will be displayed. 

Configure the following options:

Device ID = The ID of the printer you configured earlier in this documentation in the POS profile section of the Commerce7 admin panel.

IP Address = Enter the internal IP 127.0.0.1 

10. Click Apply and Restart

Direct Printing - Settings up your Thermal Printer

First we need to configure the printer

Step 1. Plug the printer into ethernet, power and install the paper roll, turn the printer on and if your network automatically provides an IP address, a receipt will print out listing the temporary IP address of the printer.

Step 2. Enter this IP address into a web browser and you will be prompted to login. The username is Epson, and the password is either Epson or the printer serial number.

Static IP Address Setup

On the basic tab after logging in, you will see the Mac address for the printer. You can use this mac address to create a Static IP address assignment on your router, domain controller or device that runs DHCP for your network. You may want to work with your IT provider to get this setup.

Turn the printer off and on again and the printer will always have the same IP address used. You can select TCP/IP to view the IP address and optionally set a Manual (Static) IP address here if your network does not allow for DHCP reservations.

SSL Certificate Installation

Step 1. Import the SSL Certificate

1. Choose Certificate Import

2. Select File Type = Password Protected PKCS#12 Certificate

3. Download this file Commerce7.P12 and then click Choose File and find this file in your downloads folder.

4. Enter the password c72024 and click Import, then click Reset and wait for the printer to restart, this page will be displayed after restarting.

Step 2.  Set the Server Certificate to use the CA-Signed Certificate1

1. Under Security click on SSL/TLS

2. Click on the Server Certificate dropdown menu and choose CA-Signed Certificate1

3. Verify under Authentication - Certificate List that the CA-Signed Certificate1 Subject = *.local.commerce7.com, if not then the certificate was not imported correctly - restart and try the import again.

4. Click Send 

5. Then, restart the printer by clicking on the Reset button.

Enable EPOS Print 

For TM-T88VI, TM-T88VI-i, T88-VI-i

1. Select EpsonNet Config for TM-i

2. Select ePOS-Print under services and change the setting to enable, then click Apply & Restart

POS Profile Setup

1. In Commerce7 Admin select settings --> POS Profile and click the POS profile you want to edit.

2. Scroll down to Receipt Printers and click on the option Add Printer at the bottom right corner of the page.

3. Select the type as Local and enter the static IP of your printer from above into IP Address

4. Enter a Title, this is used when you print a receipt in the printer selection list, so pick a name that makes it easy to identify the printer/location.

5. Click on the Save button.

Try a Test Print

1. Open an order from POS --> Orders and click on More Actions and Print Thermal Receipt, select this new printer you added from the list and click Print. Your receipt should print instantly with no delay.

How to use your Thermal Printer

Head into your POS and create a POS order. Make sure you are in the correct POS profile. To change the POS profile, select the menu (3 lines) icon at the top left.

Next, select POS profiles and use the drop-down menu to select the POS Profile that you added the printer to and Save.

When the order payment is complete, on the confirmation modal, you’ll see a button to Print Receipt.

Order Thermal Printer also allows you to print Commerce7 Carts, this is a great option for those who wish to print an order ticket before actually charging the order. 

How to add a Tip Line

In order to add a Tip Line to your ticket, this needs to be done before you charge the order. Once you charge the order you won’t be able to add a Tip Line.

First add the products or services to the ticket, once you’re ready to send your ticket to the printer, click on the arrow next to the customer name. 

Then click on print receipt,  you’ll be prompted to select the desired printers; just below your printer options, you’ll see an option for Tip Line.

If you wish to add a Tip Line to the ticket, make sure the option is checked. 

Once you send your ticket to the printer, it will automatically add a Tip Line on your receipt.

How to change your Receipt Template

Heading into Settings > POS Profiles 

Select the POS Profile you have configured with your thermal printer, then scroll to the bottom of the selected POS profile to reach the Receipt Printers section. 

Under Printer Receipt Format select from the dropdown menu one of the three available Templates, then click on Save. 

We hope to bring you more template options in the future, but if you need a custom receipt template please contact us for more details at support@treefrogdigital.com.

How to Factory Reset my Epson TM-T88VI or TM-U220B Printer

1. Turn off the printer.
2. Find the Reset button on the back of the printer (leave all the cables plugged in)

3. Use a pen to press and keep holding the  Reset button. 

4. Turn on the printer while still holding the  Reset button. 

5. The printer will print a "Release the Status Sheet button" message. 

6. Release the  Reset button. 

7. The printer will print "Resetting to Factory Default Finished!" message. 

8. The printer is reset.