Order Thermal Printer App
Disclaimer
The Order Thermal Printer app is owned and built by a 3rd party developer (Treefrog Digital). For questions regarding setup, list, printing, or support, please contact support@treefrogdigital.com.
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
- Local Printing - Setting up your Thermal Printer
- 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.
Note: Our app supports cloud printing and direct printing. You must choose one of two configurations, either Cloud Printing or Direct Printing.
Order Thermal Printer works with Star MC-Print 3 and Epson OmniLink TM-T88VII. However, these printers only support cloud printing.
Direct Printing vs Cloud Printing, what’s the difference…
Cloud Printing |
Local Printing |
5-second delay for printing receipts | Prints receipts instantly |
One-time configuration of printer | Must configure each device (iPad, Windows device, etc.) |
No Static IP required | Static IP required |
No SSL Certification required | Self-signed SSL Certification required |
Printers: Epson OmniLink TM-T88VII and the Star MC-Print3. | Printers: Epson TM-T88V-i, TM-T88VI, TM-T88VI-i, and TM-T88VII (Note that only the TM-T88VII is available for purchase as the others have been discontinued) |
Local 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. All printers must have an SSL certificate provided by Commerce7 installed annually. For support with this installation, please email 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.
**Note**
The links below have multiple options for purchase. You must ensure you purchase the models with an ethernet cable interface; we do not recommend or support the Wi-Fi interface.
Please only purchase the printer from the source link below. There are many fake/knockoff devices on Amazon, and we recommend the following site.
Printers with Direct Print Option
Printers with Cloud Printing
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 ordered the older version of this printer model, Epson OmniLink TM-T88VI-i, you can also follow the steps described here, as the setup is the same.
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
- To set up this integration, first, navigate to Settings > POS Profiles
- Select the POS Profile you want the printer added to
- 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
- For each receipt printer you'd like to add to a POS profile, add a Title and Printer ID.
- 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.
- 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.
- Type - Select Epson Cloud. This is what you need to set for cloud printing.
- 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.
- Click on Add Printer if you need to add another printer, then repeat step 4 as many times as necessary.
- 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
- 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
- After entering all your receipt printers, click Save POS Profile.
Adding the Star MC-Printer
- 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.
- Click on Add Printer if you need to add another printer, then repeat step 4 as many times as necessary.
- 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
- 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
- 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
- First, Install the supplied sample paper roll into the printer
- 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.
- Wait around 1 minute the printer will startup and print the local IP address is obtained from your network.
- Type in the IP address into a web browser from a computer on the same network (Example: http://192.168.1.78)
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)
- You will see the EpsonNet Config page as below, click on “Epson OmniLink TM-T88VII”
- You will see the EpsonNet Config for TM-i as follows:
- 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
**Make sure the URL is exact. Spelling it slightly incorrectly, such as "tenantID" will not work**.
- 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
- Paper: Put the roll of paper into the printer.
- Power: Plug in Ethernet & Power & Turn the printer on.
- The printer should print out its IP address within 1 minute.
- 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.
- Enter the IP address on the printout into your browser to get to the printer configuration page. (example: http://192.168.1.100)
- Enter the default username and password
- username = root
- password = public
- 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
- Select EpsonNet Config for TM-i
- Select ePOS-Print under services and change the setting to enable, then click Apply & Restart