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
    • Adding the Epson OmniLink TM-88VII
    • Adding the Star MC-Printer
  • Setting up your Epson Printer
  • Setting up your Star MC-Printer
• Local Printing - 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 to print order receipts. For custom receipt templates, please contact us for more details. 

This app is integrated with the Epson TM-T88VI, VII & V-i series, Epson OmniLink TM-T88VII, and the Star MC-Print3 Receipt Printer. This documentation follows the steps for configuring and installing these thermal Printers. 

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

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

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. You need to have an Admin Owner role to see this page.

Click on the INSTALL button to install the application. After the installation is complete, the application will appear under the 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 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 Commerce 7

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.

^{Adding the Epson OmniLink TM-T88VII}

1. For each receipt printer you'd like to add to a POS profile, add a Title and Printer ID.
   1. 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.
   2. Printer ID - Create your own 6-30 digit alphanumeric ID or use the printer serial number. This ID cannot contain spaces or special characters (numbers and letters only). Make note of this, as you will use it in the Epson configuration step.
   3. Type - Select Epson Cloud. This is what you need to set for cloud printing.
   4. Kitchen Location - If you're setting up multiple printers for kitchen tickets, items with this location selected will print here when sent to the kitchen.

2. Click on Add Printer if you need to add another printer, then repeat step 4 as many times as necessary.
3. In Receipt Printer select from the drop-down menu one of the four available options. 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
4. If you’re using a printer for the kitchen, then under Kitchen Ticket Format select from the drop-down menu one of the four available options. 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
5. After entering all your receipt printers, click Save POS Profile.

Adding the Star MC-Printer

1. For each receipt printer you'd like to add to a POS profile, add a Title and Printer ID.

a. 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.

b. Printer ID - Enter the printer serial number as the PrinterID, you can find the serial number on the bottom of the printer.

c. Type - Select Star Cloud. This is what you need to set for cloud printing.

d. Kitchen Location - For kitchen tickets if you're setting up multiple printers, items with this location selected will print here when sent to the kitchen.

2. Click on Add Printer if you need to add another printer, then repeat step 4 as many times as necessary.
3. In Receipt Format select from the drop-down menu one of the four available options. 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
4. If you’re using a printer for the kitchen, then under Kitchen Ticket Format select from the drop-down menu one of the four available options. 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
5. After entering all your receipt printers, click Save POS Profile.

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 = 5. (Do not set less than 5 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

Setting up your Star MC-Print3

1. Paper: Put the roll of paper into the printer.
2. Power: Plug in Ethernet & Power & Turn the printer on.
3. The printer should print out its IP address within 1 minute.
   1. Most networks are configured with DHCP to provide new devices with an IP address. If your printer does not print out an IP address within a minute of turning it on, you should consult your IT department or provider for instructions.
4. Enter the IP address on the printout into your browser to get to the printer configuration page. (example: http://192.168.1.100)
5. Enter the default username and password
   1. username = root
   2. password = public
6. You will be prompted to change the password, put in a password, and record this for future use.

Click CloudPRNT in the left-hand navigation under Network Configuration.

a. Under CloudPRNT Service select "ENABLE"

b. Enter the Server URL as https://apigateway.commerce7.com/lambdas/star-print-receipt?tenantId="your-tenant-id-here"

Example: https://apigateway.commerce7.com/lambdas/star-print-receipt?tenantId=spectra-winery

c. Click Submit

d. Click the flashing red Save link in the left-hand navigation

e. Click the Execute button.

f. Go back to CloudPRNT and choose Accept all (warning - not secure) for the HTTPS Client Settings. Save and Execute.

Local Printing - Settings up your Thermal Printer

Local printing is 3-4 seconds faster (than Cloud printing) since it’s direct. It prints the receipt instantly, but it has a few requirements:

• You must use an Espon TM-T88V-i, TM-T88VI, TM-T88VI-ireceipt printer.
• 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. 
• An SSL certificate must be generated and installed for each device (e.g., iPad) from which you'll be printing. 
• You must add the Printer to your POS Profile(s).

Click here for step-by-step articles on setting up a static IP address and generation/installation of the SSL certificate.

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.

 How to Factory Reset my Star MC-Print3 Printer

1. Turn your printer off.
2. Use a pen to press and hold the Rest button.

3. While holding the Reset button, turn on the printer.
4. Keep holding the Reset button until the lights on the front of the printer begin to flash.
5. Release the Reset button.

6. If only the ethernet light is flashing - press and hold Feed button until the network settings print out.

   Note: If other combinations of lights are flashing - press the Feed button until only the ethernet light is flashing, then try step 6 again.

7. The printer is now reset.