EKT 10 CCO Hardware Installation Epson TM-88V

SAP Customer Checkout 2.
0 Feature Pack 12
SAP Customer Checkout - Hardware Installation for Epson TM-88V

INTERNAL | SAP Partners
Legal disclaimer
The information in this presentation is confidential and proprietary to SAP and may not be disclosed without the
permission of SAP. This presentation is not subject to your license agreement or any other service or subscription
agreement with SAP. SAP has no obligation to pursue any course of business outlined in this document or any related
presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation
and SAP's strategy and possible future developments, products and or platforms directions and functionality are all
subject to change and may be changed by SAP at any time for any reason without notice. The information in this
document is not a commitment, promise or legal obligation to deliver any material, code or functionality. This document
is provided without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of
merchantability, fitness for a particular purpose, or non-infringement. This document is for informational purposes and
may not be incorporated into a contract. SAP assumes no responsibility for errors or omissions in this document, except
if such damages were caused by SAP´s willful misconduct or gross negligence.
All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ
materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements,
which speak only as of their dates, and they should not be relied upon in making purchasing decisions.
© 2021 SAP SE or an SAP affiliate company. All rights reserved. Internal | SAP Partners 2
SAP Customer Checkout Training: Hardware Installation
The following session is designed to show you how to install

hardware devices in SAP Customer Checkout 2.0 Feature
Pack 12. When you end this training you should know:
➢ How to install and configure JPOS standard hardware in SAP

Customer Checkout
➢ Giving an example of the installation and configuration with the Epson

TM 88V
Warning Notice
• Please be aware that Epson drivers will only work with SapMachine 11 and Java 11 after
the Epson update version from September 2021
• You can download the driver for Java 11 from Epson from below links:
• EPSON JavaPOS ADK (for Windows OS)
• EPSON JavaPOS ADK (for Linux OS)
• For more information, please read the following SAP Note carefully:
https://launchpad.support.sap.com/#/notes/2980664
How to install JPOS standard hardware?
JPOS standard hardware
Note: Ensure that any hardware devices are supporting your operating system (64bit) version and the
JRE (64bit) version installed.
➢ J(ava)POS standard hardware is supported by the majority of manufacturers
➢ Standard POS hardware devices such as:

• Printers
• Customer displays
• Cash drawers
• Etc.
➢ SAP Customer Checkout was used with the following hardware devices:
• Epson TM-88V (Receipt Printer)
• Star Micronics TSP100 (Receipt Printer)
• Verifone H5000 (EFT-Terminal)
Installation/ Configuration - Scenarios
➢ Best Case Scenario

• Printer driver and configuration tools are on the manufacturer’s manual (CD)
• JPOS libraries are automatically installed and path is set
• Simple configuration program with test function
➢ Good Case Scenario

• Configuration files on the manufacturer’s manual (CD)
• Manual copying of JPOS libraries
➢ Worst Case Scenario

• JPOS and/ or printer drivers need to be downloaded
• Installation of the printer software transcribes entire JRE
• Inaccurate documentation
Giving an example of the installation and
configuration with the Epson TM-88V
Example: Installation of Epson TM-88V
To install and configure the Epson TM-88V with SAP Customer Checkout, you need to follow the next steps:
1 Download the latest JAVAPOS ADK from Epson download page:

https://download.epson-biz.com/modules/pos/
Note that you may have to register on the website to gain access to the JavaPOS ADK (see step a) and b) below).
a)
b)
After having
registered,
download the
EPSON
JavaPOS
ADK for TM
Series and
confirm the
technical
specifications
for your
device.
2 Connect the printer* to the system. For instructions refer to the

manufacturer’s manual.
Note!
At the time of creation of this document, the Epson JavaPos ADK does not support
printing via the parallel port. For this reason, this section describes the installation
process for a printer using the USB or serial port.
* If you’re connecting an Epson network printer, we recommend to use Windows driver instead of JPOS driver. This
presentation contains only the installation steps for JPOS driver.
2.1. (Optional)* Download and install the latest TM Virtual Port Driver and
the latest EpsonNet Config from the Epson download page.
2.2. (Optional)* Start the EpsonNet Config:

a) If the connection has been completed successfully, you will
see your printer in the list.
b) Right-click the entry and choose Configuration.
c) Switch to Basic underneath TCP/IP in the tree on the left.
d) Change the Method for Specifying IP Address either to
Automatic for networks using DHCP and to Manual for a
static IP address configuration.
e) IP Address, Subnet Mask and Default Gateway might
need to be set differently depending on your network
settings.
f) If everything is configured, click Transmit.
* Only relevant if you are connecting a network printer.

2.3. (Optional)* Start the Epson Virtual Port Driver Assignment Tool
a) Choose one of your unused b) Choose your network printer from the
COM-Ports and press Assign Port. list and click OK.
* Only relevant if you are connecting a network printer.

3 Before you proceed with the installation process, you need to add the path
to your JAVA installation in the windows path environment variable.
To do this, follow the below steps:
a) Choose the windows button and navigate to Control Panel → System → System Properties → Environment
Variables
b) To maintain the Path variable, select the Path (in the System variables section) and choose Edit (or New, if not
existing yet)…
c) Add the respective path of your bin folder of the JAVA installation to the Path variable value :
• For example: “The Path to the JAVA installation (e.g. C:\Program Files\SapMachine\JDK\11\bin)
d) Confirm with “OK”.
4 Execute the Epson JavaPOS ADK installer, and follow the installation
instructions.
5 As soon as the installation has finished, click the windows button and
choose All Programs → SetupPOS
• The SetPOS Application will open
6 To add a JposEntry for your printer choose Add.
7 In the next dialog: a) + b) c)
a) Set Device Category to POSPrinter
b) Choose the correct device, in this case TM-T88V and

proceed to the next dialog page
c) In the Connection Interface area, set Port Type to

USB, Network* or Serial (depending on how your
printer is connected)
d)
d) On the final dialog page, set Receipt Characters per
Line to 56 and choose Done to close the dialog
* If you’re connecting a network printer, make sure to follow the steps described here.
8 The SetupPOS view should have the following structure:
9 To add a JposEntry for your cash drawer choose again Add. *
* Make sure that the drawer is connected with the printer.

10 In the next dialog: a)
a) Set Device Category to CashDrawer and proceed

to the next dialog page
b) In the Connection Interface area, use the same

Port Type configuration as for the printer (e.g. USB,
Network or Serial (depending on how your printer
is connected)).
c) In the USB Specific Settings area: b) + c)
• Set the Connect to port to the port which is used or

the printer connection (indicated by its name)
• Set the Connected Printer/ PC to the correct printer

model and choose Done to close the dialog
d)
10 In the next dialog (continuation of previous page):
d) In the Common area, you can specify further settings for the cash drawer
e) In case your printer is connected via serial port also do the following:
• Choose Service Settings from the menu at the top
• Enable Use operations in serial connection for USB connection at the bottom of
the Service Settings dialog
• Choose OK to close the dialog et the
e)
11 The SetupPOS view should now have the following structure:
12 To save your settings choose Save from the menu and provide the HW
directory of the SAP Customer Checkout application as save location, e.g.:
C:\SapCustomerCheckout\cco\POSPlugins\HW\jpos.xml
13 Confirm to update the file location in jpos.properties with Yes.
14 To test the printer or cash drawer, go to your Epson installation folder, e.g.
C:\Program Files\EPSON\JavaPOS\CheckHealth, and start the
CheckHealth.bat file.
15 Double-click the POSPrinter or CashDrawer and select the sub-entry. Click

the CheckHealth button on the right side.
16 In the next dialog you can test printing or opening the cash drawer.
17 Close the EPSON SetupPOS test program before you proceed.
18 Before the hardware devices can be enabled in SAP Customer Checkout

you have to add the logicalName values from the jpos.xml file to the
JPOSPlugin.properties file which usually resides in the following location:
C:\SapCustomerCheckout\cco\POSPlugins\HW\JPOSPlugin.properties
19 If you have followed the configuration steps above, the logicalName values
of the respective JPosEntry entries in the jpos.xml should be POSPrinter
and CashDrawer.
20 Open the JPOSPlugin.properties file in a text editor and add the

logicalName values to the following two lines, as below:
hardware.posPrinter.name=POSPrinter
hardware.cashDrawer.name=CashDrawer
21 Save your changes.
22 Before starting SAP Customer Checkout, make sure that the following files
are located in the POSPlugins directory. The location is:
C:\SapCustomerCheckout\cco\POSPlugins\HW\
Recommendation: You can also put all the files in a subfolder

(e.g. C:\SapCustomerCheckout\cco\POSPlugins\HW\epson\)
If the class DOMParser is not found, please drop the following jar files
in the following folder: Java_home\lib\ext
Note!
All files can be found in the installation folder that has been chosen for the
installation process.
For Example:.
C: \Program files\Epson\JavaPOS\lib → copy ALL Files
23 If you are using JAVAPos ADK 1.14.2 or newer, you also have to perform
the following steps:
a) Open the Epson JPOS ADK installation folder, (e.g. C:\Program Files\Epson).
b) Copy all the files located in the portcommunicationservice folder to the bin folder of your JAVA installation
(e.g. C:\Program Files\SapMachine\JDK\11\bin).
c) Copy all the files located in the JavaPOS\bin folder to the bin folder of your JAVA installation.
d) (Optional – Only for printing in Arabic Language): Copy the apm.dll file (provided by Epson) into the bin
folder within the JavaPOS folder and in the c:/Windows/system32 folder.
This apm.dll file supports printing header and footer on receipts in Arabic language correctly.
For more information and how to get the apm.dll file from Epson, please contact: BS.PreSales@epson.eu
24 The hardware device installation of the printer is done. You can now start
SAP Customer Checkout and continue with the general printer and print
templates settings.
Note!
Please read our Print Templates Configuration Guide available on PartnerEdge for more information
and to configure the print layout and print templates.
Common Mistakes
• Hardware is connected to the wrong USB port

• COM port in the jpos.xml is wrong
• Hardware name in JPOSPlugin.properties does not match with jpos.xml
• Make sure to close the EPSON SetupPOS test program before you start SAP
Customer Checkout and print a test receipt
• Libraries of another manufacturer are located in the class path
• Be aware to use the 64bit DLLs
• Conflicting Java versions → maintain the environmental variable ‘CCO_JAVA_HOME’
to point to the correct Java’s directory
Thank you
SAP Community Questions: https://www.sap.com/community/tag.html?id=67838200100800006251
SAP Community Blogs: https://blogs.sap.com/tags/67838200100800006251/
PartnerEdge: https://partneredge.sap.com/en/products/scc/about.html
Twitter: https://twitter.com/SAPCheckout
© 2021 SAP SE or an SAP affiliate company. All rights reserved.

EKT 10 CCO Hardware Installation Epson TM-88V

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

EKT 10 CCO Hardware Installation Epson TM-88V

Uploaded by

Copyright:

Available Formats

SAP Customer Checkout 2.

SAP Customer Checkout - Hardware Installation for Epson TM-88V

The following session is designed to show you how to install

➢ How to install and configure JPOS standard hardware in SAP

➢ Giving an example of the installation and configuration with the Epson

• EPSON JavaPOS ADK (for Linux OS)

➢ J(ava)POS standard hardware is supported by the majority of manufacturers

➢ Standard POS hardware devices such as:

➢ Best Case Scenario

➢ Good Case Scenario

➢ Worst Case Scenario

1 Download the latest JAVAPOS ADK from Epson download page:

2 Connect the printer* to the system. For instructions refer to the

2.2. (Optional)* Start the EpsonNet Config:

* Only relevant if you are connecting a network printer.

* Only relevant if you are connecting a network printer.

d) Confirm with “OK”.

6 To add a JposEntry for your printer choose Add.

7 In the next dialog: a) + b) c)

a) Set Device Category to POSPrinter

b) Choose the correct device, in this case TM-T88V and

c) In the Connection Interface area, set Port Type to

8 The SetupPOS view should have the following structure:

9 To add a JposEntry for your cash drawer choose again Add. *

* Make sure that the drawer is connected with the printer.

10 In the next dialog: a)

a) Set Device Category to CashDrawer and proceed

b) In the Connection Interface area, use the same

c) In the USB Specific Settings area: b) + c)

• Set the Connect to port to the port which is used or

• Set the Connected Printer/ PC to the correct printer

• Choose Service Settings from the menu at the top

• Choose OK to close the dialog et the

11 The SetupPOS view should now have the following structure:

13 Confirm to update the file location in jpos.properties with Yes.

15 Double-click the POSPrinter or CashDrawer and select the sub-entry. Click

17 Close the EPSON SetupPOS test program before you proceed.

18 Before the hardware devices can be enabled in SAP Customer Checkout

20 Open the JPOSPlugin.properties file in a text editor and add the

21 Save your changes.

Recommendation: You can also put all the files in a subfolder

• Hardware is connected to the wrong USB port

SAP Community Blogs: https://blogs.sap.com/tags/67838200100800006251/

© 2021 SAP SE or an SAP affiliate company. All rights reserved.

You might also like