omnilink merchant services operation guide€¦ · merchant services (cloud-based applications) and...

OmniLink MerchantServicesOperation Guide

M00122800 EN

Introduction

Manuals

The following three manuals for OmniLink Merchant Services are provided.

Development Guide

This manual provides necessary information to configure a development environment for developing OmniLinkMerchant Services (cloud-based applications) and migration of developed services to production environments forsystem developers.

Setup Guide

This manual is for an installer who installs TM printers in stores. Provides necessary information for setting up theprinters to use the OmniLink Merchant Services.

Operation Guide (this document)

This document describes printer status monitoring performed daily, error handling procedures, and other aspectsof service operation.

Precautions

o Unauthorized duplication, copying, reproduction, or modification of any part or all of this document is strictlyprohibited.

o Contents of this manual are subject to change without prior notice. Contact us directly for the most recentinformation.

o Every effort is made to ensure that the contents of this manual are without error. Please contact us if any errorsor other issues are found.

o The previous statement notwithstanding, we will not be liable for any negative impact as a result of use.

o Epson shall not be liable for any damages caused as a result of using this product incorrectly, failing to complywith the content of this document, or having repair or modifications performed by third parties other thanEpson or those specified by Epson.

o Epson shall not be liable for any issues as a result of installing optional parts or consumables that are notgenuine Epson parts or parts certified by Epson.

Epson OmniLink Merchant Services Operation Guide

Introduction

2

Usage Limitations

Please use our products in environments and systems designed with consideration to safety and disaster recoverysuch as fail-safe configurations and redundant designs, for example, if this product is used in applications in whicha high level of reliability and safety in functionality and precision is required such as in aircraft, trains, ships,automobiles and other transportation-related applications or in crime prevention equipment and safety equipment.

This product is not intended for use in applications that require extremely high levels of reliability and safety suchas in aerospace equipment, trunk-line communications equipment, nuclear power control equipment, and medicalequipment.

Consider your usage environment and requirements carefully before using this product in such applications.

Terms and Symbols Used in the Manuals

Terms

Definitions of the terms used in this document are as follows.

Service provider

A solutions provider who develops a cloud-based service using Epson Omnilink Merchant Service Web API anddelivers it to customers.

Deployment partner

An installer who installs and sets up TM printers in stores, and configures the production environment.

Service

A cloud-based application such as sales analysis, reward point program, etc., that is developed by a Serviceprovider.

Meaning of Symbols

The following symbols are used in this manual. Make sure to understand the meaning of these symbols beforeusing the product.

Describes usage precautions that must be observed. Incorrect handling due to the disregard of thisinformation may result in product failure or incorrect operation.

Note: Describes additional explanation or other useful information.

UIndicates related reference pages. If the reference section is in blue text, click the blue text to openthe relevant page.


Introduction

3

Contents

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Precautions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Usage Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Terms and Symbols Used in the Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Terms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Meaning of Symbols. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

WorkFlow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Error Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Network Connection Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Receipt Mapping Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Checking Usage Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Monitoring Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Receiving Error Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Configuring Notification Email Reception Conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Configuring Receipt Mapping Error Notification Conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Monitoring Printer Connection Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Monitoring Print/Receipt Mapping Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Check the usage status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Rights and Available Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Rights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Rights and Correspondingly Available Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Updating Printer Firmware/SSL Certificates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Update Firmware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Updating SSL Certificates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Updating Firmware and SSL Certificates in Batches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Operating Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Supported POS Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Supported TM Printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Supported Browsers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Open Source Software License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36OmniLink Merchant Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36TM-T88VI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36TM-T88VI-iHUB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Trademarks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37


Contents

4

WorkFlow

Error Handling

The following section describes the process flow to resolve network issues with TM printers, significant changes inreceipt mapping status, and other issues.

Network Connection Errors

Service provider (Administrator) Deployment partner(Administrator)

Deployment partner(Technician)

Receive notification email that anetwork connection error has

occurred

U “Receiving Error Notifications” onpage 8

Check the network connection error

U “Monitoring Printer ConnectionStatus” on page 12

Determine the cause of the networkconnection error

Resolve the cause


WorkFlow

5

Receipt Mapping Errors

Request a Development partner or Service provider with the Administrator right to make any changes to receiptmapping configurations.

Service provider(Administrator) Deployment partner(Administrator)


Receive notification email that thereceipt data classification rate has

decreased

U “Receiving Error Notifications” onpage 8

Check the status of the decreasedreceipt data classification rate

U “Monitoring Print/ReceiptMapping Status” on page 15

Determine the cause of the decreasedreceipt data classification rate

Define analysis rules for the receiptfailing classification (receipt mapping)

USetup Guide

Check with the Service provider thatreceipt data is retrieved correctly via

services

Check that receipt data is retrievedcorrectly via services

Parser correction complete


WorkFlow

6

Checking Usage Status

Service provider Deployment partner(Administrator)


Check the usage status

U “Check the usage status” on page 19


WorkFlow

7

Monitoring Printers

Receiving Error Notifications

Notifications can be sent via email when a printer experiences network connectivity issues, significant changes inreceipt mapping status occur, etc.

Configuring Notification Email Reception Conditions

The following section describes the procedure to configure the type of notifications to be received and thefrequency of notifications.

A Access the OmniLink Management Console from the following URL, and sign in.

North America region

https://service.omnilinkworld.com/admin/login

Europe region

https://service.omnilinkmerchantservices.eu/admin/login

B Click at the upper-right of the screen.

C Click My Account.


Monitoring Printers

8

D Click Edit in Notification Subscription.

E Configure the type of notifications to be received and the frequency of notifications can be configured andthen click Save.

Item Description

Connection StatisticsNotifications will be received per the specified Frequency when a network disconnection isdetected.

Receipt Mapping Statistics Notifications will be received per the specified Frequency when the receipt mappingclassification rate changes significantly.

Configuring Receipt Mapping Error Notification Conditions

Administrator can configure receipt mapping error notifications for specific groups.




Europe region



Monitoring Printers

9

B Click Group and Members.

C Click Edit in Group.

D Configure the receipt mapping error notification conditions and then click Save.


Monitoring Printers

10

Item Description

Decline of dataclassification rate (%)

Specifies the rate of decline when comparing the current data classification rate with theaverage data classification rate for the past 7 days. A notification is sent when the dataclassification rate falls below the specified rate.

A notification is sent when the number of prints exceeds the number specified withMinimum print count (sheets/day).

Minimum transaction count(sheets/day)

Specifies the minimum number of prints every 24 hours used as the trigger for notificationsof changes in the data classification rate. A notification is sent when the number of printsexceeds the specified number.


Monitoring Printers

11

Monitoring Printer Connection Status

The following section describes the procedure to check network connection status for printers. The connectionstatus for all printers can also be output as a CSV file.




Europe region


B Click Monitoring.

C Check the network connection status for printers.

Daily

ab

dc

e

f

Description

aChanges the printer displayed.

o All: Displays all printers registered to accessible groups.

o Errors: Displays only printers that have experienced disconnections.

bOutputs connection status data of the last 10 days for the displayed printers to a CSV file.

The name of the CSV file will be output in the following format: OMS-ConnectionStatistics-YYYYMMDD.csv(YYYYMMDD is the date when the file is output).


Monitoring Printers

12

Description

c Filter the display content based on store name, serial number of the printer, or other information.

d Click the date to check the connection status on an hourly basis for that day.

e

Check the connection status by day for each printer within the last 10 days including the current day.

Monitor the connection status on an hourly basis.

Any and all disconnections appear in red (“0“). No disconnections whatsoever appear in white (“1“).

A lack of connection Information appears in gray (blank).

Click the printer to display the Device Detail - Summary screen.

f The display range can be changed once the number of stores exceeds 10.

Hourly

a

b

d

c

e

f

Description



o Errors: Displays only printers that have experienced disconnections.

bOutputs connection status data of printers for the selected day to a CSV file.

The name of the CSV file will be output in the following format: OMS-ConnectionStatisticsDetail-YYYYMMDD.csv(YYYYMMDD is the date when the file is output).

c Filter the display content based on store name or serial number of the printer.

d Returns to the daily display.


Monitoring Printers

13

Description

e

Displays the hourly connection status for the selected day.

Any and all disconnections appear in red (“0“). No disconnections whatsoever appear in white (“1“).

A lack of connection Information appears in gray (blank).

Click the printer to display the Device Detail - Summary screen.



Monitoring Printers

14

Monitoring Print/Receipt Mapping Status

The following section describes the procedure to check printer print/receipt mapping status. The print/receiptmapping for all printers can also be output as a CSV file.




Europe region


B Click Monitoring.

C Click Receipt Statistics.


Monitoring Printers

15

D Check the printer print/receipt mapping status.

Daily

a

b

d

c

e

f

Description



o Errors: Displays only printers for which the previously configured data classification rate has been exceeded.

bOutputs print/receipt mapping status data of the last 10 days for the displayed printers as a CSV file.

The name of the CSV file will be output in the following format: OMS-ReceiptStatistics-YYYYMMDD.csv(YYYYMMDD is the date when the file is output).


d Click the date to check the print/receipt mapping status on an hourly basis for that day.

e

Check the print/receipt mapping status by day for each printer within the last 10 days including the current day.

Monitor print/receipt mapping status on an hourly basis.

o Transaction count [sheets]: Print count

o Data classification rate [%]: Data classification rate (ratio of Receipt, Report, and Shift classifications)

Data appears in red when the result of comparing the data classification rate for the last 24 hours against theaverage data classification rate of the last 7 days exceeds the specified rate, and the specified minimum printcount has also been exceeded.

*Areas on the screen appear in gray when there is insufficient information, such as when a printer is newlyregistered.

*If Transaction count is 0, the Data classification rate appears as “N/A“.

Click the printer to display the Receipt Mapping screen.


Monitoring Printers

16

Description


Hourly

a

b

d

c

e

f

Description



o Errors: Displays only printers for which the previously configured data classification rate has been exceeded.

bOutputs print/receipt mapping status data of printers for the selected day as a CSV file.

The name of the CSV file will be output in the following format: OMS-ReceiptStatisticsDetail-YYYYMMDD.csv(YYYYMMDD is the date when the file is output).


d Returns to the daily display.


Monitoring Printers

17

Description

e

Check the print/receipt mapping status data of printers for the selected day.

Monitor print/receipt mapping status on an hourly basis.

o Transaction count [sheets]: Print count (cumulative over the last 24 hours)

o Data classification rate [%]: Data classification rate (ratio of Receipt, Report, and Shift classifications)

Data appears in red when the result of comparing the data classification rate for the last 24 hours against theaverage data classification rate of the last 7 days exceeds the specified rate, and the specified minimum printcount has also been exceeded.

*Areas on the screen appear in gray when there is insufficient information, such as when a printer is newlyregistered.

*If Transaction count is 0, the Data classification rate appears as “N/A“.

Click the printer to display the Receipt Mapping screen.



Monitoring Printers

18


The following section describes the procedure to check the number of transactions at each store (number ofreceipts that are successfully parsed).




Europe region


B Click Report.

C Check the print history.

a

b

d

c

e

Description

a Changes the year and month of print history that is displayed.

b

The following information appears on-screen.

Stores: Number of stores with receipts that have been successfully parsed

Overage: Total value increments by 1 for every 1,000 receipts once the number of successfully parsed receiptsexceeds 30,000 (Ex.: 2 if the number of receipts is 32,000)



19

Description

c

The following information of the store that the print data is received in the month previous to the displayedmonth is output to a CSV file.

The name of the CSV file will be output in the following format: OMS-Report-YYYYMM.csv (YYYYMM is the yearand month when the file is output).

o Team: Team name

o Group: Group name

o Store: Store name

o Service: Service name

o Stores: Number of stores (1 if the Transaction Count is 1 or more, 0 in all other cases)

o Print Count: Print count

o Transaction Count: Number of successfully parsed receipts

o Active Printers: Number of printers that have received receipt data

o Transaction Overage: Number after subtracting 30,000 from the print count

o Overage Count: Value that increments by one for every 1,000 receipts after the print count exceeds 30,000

d

The following information appears for each service.

o Stores: Number of stores with receipts that have been successfully parsed

o Overage Count: Value increments by 1 for every 1,000 receipts once the number of successfully parsedreceipts exceeds 30,000 (Ex.: 2 if the number of receipts is 32,000)

e The display range can be changed once the number of stores exceeds 10.



20

Appendix

Rights and Available Features

OmniLink Merchant Services has 3 user rights. The features available vary by right.

Rights

The following table describes the three user rights.

Type Target group Description

Administrator o Deployment partneradministrators

o Service provideradministrators

This user has access to all OmniLink Merchant Services features.

This user is assigned to users that manage and control the servicein whole.

Technician Deployment partnerusers

This user can install printers in stores, configure settings to senddata to the OmniLink Merchant Services server, and so on.

Developer Service provider users This user can view store and printer information.

Rights and Correspondingly Available Features

The following table describes the specific features available to each user right.

: Available, Blank: Not available

Feature Administrator Technician Developer

Administratormanagement

Administrator accountregistration

Administrator rightassignment

Administrator rightremoval


Appendix

21


Group management/members

Register groups

Change groupinformation

Delete groups

Register members

Delete members

Assign members

Configure receiptmapping errornotification conditions

Store management Register stores

View store information

Change storeinformation

Delete stores

Batch registration ofstores

Select services for use

Printer information Register printers

View printer information

Change printerinformation

Delete printers

Batch registration ofprinters

Receipt mapping Create versions

Edit versions

View versions

Apply versions


Appendix

22


QR Code Setting Create versions

Edit versions

View versions

Apply versions

Contents Print Setting Create versions

Edit versions

View versions

Apply versions

Data Filtering andMasking Setting

Create versions

Edit versions

View versions

Apply versions

Scanner TransmissionSetting

Create versions

Edit versions

View versions

Apply versions

Operational logs View operational logs

Printer monitoring Monitor networkconnectivity

Monitor receiptmapping status

Monitor print counts

Print history View print history

Download print historyas CSV files

Update printerfirmware/SSLcertificate

Update firmware/SSLcertificate


Appendix

23

Updating Printer Firmware/SSL Certificates

Update Firmware

This section describes the Remote Firmware update function of OmniLink Management Console.The functionallows you to update the firmware of TM printer remotely. You can update the firmware just by selecting a targetTM printer, firmware version, and specifying the date and time of update on OmniLink Management Console.

Note:

o OmniLink Management Console provides all data files necessary to update the firmware.

o For information on the latest version of the firmware, please make an inquiry by emailing [email protected] (North America region) / [email protected] (Europe region).




Europe region


B From Team & Group , select the team and then the group for which you want to update the firmware.

C Click the store for which you want to update the firmware.


Appendix

24

D In the Devices section, click the printer for which you want to update the firmware.

E Click Printer Setting.

F Click Choose Update Firmware in Firmware Status.

G In the “Choose firmware“ field, specify the firmware version and the time period to update, then click Save.

Note:

o The TM printer will reboot after the firmware update. Make sure that the TM printer is not used while the printer isrebooting.

o If the TM printer is not powered on or not connected to OmniLink Management Console correctly during thespecified time period, the firmware update is not performed.


Appendix

25

H When the specified time period has passed, check the update result with the “Status“ message in the“Firmware status“ field.

Updating SSL Certificates

SSL certificates installed in printers connected to OmniLink Merchant Services expire.

Printers with SSL certificates that need to be updated will display the update message (See Step5) on the DeviceDetail screen. When this happens, update the SSL certificate promptly.




Europe region



Appendix

26

B From Team & Group , select the team and then select the group for which you want to update the SSLcertificate.

C Click the store for which you want to update the SSL certificate.

D In the Devices section, click the printer for which you want to update the SSL certificate.

E Specify the date and time period to perform the update and then click Save.


Appendix

27

The certificate will be updated at the specified time.

The update message disappears once the SSL certificate update completes.

If the specified update period passes but the update message does not disappear, check the power to theprinter and the connection to OmniLink Merchant Services. Then, try specifying the update date and timeagain.

Note:

o If an old SSL certificate expires, the printer will no longer be able to connect to OmniLink Merchant Services. Assuch, make sure to set the date/time and update the certificate as soon as possible.

o The TM printer will reboot after the certificate update. Make sure that the TM printer is not used while the printer isrebooting.

o If the TM printer is not powered on or not connected to OmniLink Management Services correctly during thespecified time period, the certificate update is not performed.

Updating Firmware and SSL Certificates in Batches

The firmware and SSL certificates of multiple printers can be updated at the same time by uploading CSV files thatcontain update information for the firmware and SSL certificates.

Note:Up to 2,000 printers can be updated at the same time.




Europe region


B From Team & Group, select the team and then select the group for which you want to update the firmwareand SSL certificates at the same time.


Appendix

28

C Click Bulk Registration and then Download CSV under FW Update.

The name of the CSV file downloaded will be in the following format: firmware_YYYYMMDDHHmmss.csv(YYYYMMDDHHmmss is the date and time when the file is downloaded).

D Specify the CSV file directory and then click Save.

E Open the downloaded CSV file on a PC and then edit printer information as described in “Format ofFirmware/SSL Certificates Information CSV Files” on page 31. Save the file.


Appendix

29

F Click Bulk Registration and then Upload CSV under FW Update.

G Specify the CSV file edited in step 4 and click Open.

Note:An error message appears if registration conditions are not satisfied, such as the maximum character count beingexceeded. If an error message appears, edit the information in accordance with the error message content. No stores willbe registered if there is even one error.


Appendix

30

H Confirm the uploaded content and then click OK.

Format of Firmware/SSL Certificates Information CSV Files

The following table describes the format in which printer information CSV files are to be edited.

The character code is "UTF-8" and the line feed code is "LF" or "CRLF".

Parameter Data format Description

OperationCode

Blank or "EDIT" Specifies the operation to be performed on the printerof the specified serial number.

o Blank: Do nothing

o “EDIT“: Edits firmware/SSL Certificatesinformation

BrandName(Reference)

Text string of 1 to 256characters

Enter the brand name of the store, which is used asreference information. This parameter is referenceinformation, which means that using “EDIT“ in theOperationCode will not update this information.

StoreName(Reference)

Text string of 1 to 256characters

Enter the name of the store, which is used as referenceinformation. This parameter is reference information,which means that using “EDIT“ in the OperationCodewill not update this information.

TargetSerial#

The first 4 characters mustbe numbers or uppercasealphanumeric characters.The next 6 characters mustbe numbers.

Enter the unique serial number of the printer.

Leave this blank if the OperationCode is blank.

FirmwareSetting::FirmwareVersion

o Text string of 1 to 80characters whenStartUpdateOnOrAfter(Day) is not blank

o Blank ifStartUpdateOnOrAfter(Day) is blank

Enter the version of the firmware to be updated.*

FirmwareSetting::Derivative

o Text string of 1 to 80characters whenStartUpdateOnOrAfter(Day) is not blank


Enter the model of the product.*


Appendix

31

Parameter Data format Description

FirmwareSetting::StartUpdateOnOrAfter(Day)

o Text string in the formatDate_YYYY-MM-DD ifthe update date of thefirmware is to bespecified

o Blank if the update dateof the firmware is not tobe specified

Specify the local time zone of the start date for thefirmware update (update will be executed during thespecified time period on this date or a later date).*

FirmwareSetting::Timing(Hour)From

o 0 to 23 whenStartUpdateOnOrAfter(Day) is not blank


Specify the local time zone of the start time period forthe firmware update (the X digit for a time period fromX o'clock to Y o'clock).

FirmwareSetting::Timing(Hour)To

o 0 to 23 and a digitdifferent from theTiming(Hour)From digitwhenStartUpdateOnOrAfter(Day) is not blank


Specify the local time zone of the start time period forthe firmware update (the Y digit for a time period fromX o'clock to Y o'clock).*

CertificateSetting::StartUpdateOnOrAfter(Day)

o Text string in the formatDate_YYYY-MM-DD ifthe update date of theSSL certificates is to bespecified

o Blank if the update dateof the SSL certificates isnot to be specified

Specify the local time zone of the start date for the SSLcertificates update (update will be executed duringthe specified time period on this date or a later date).*

CertificateSetting::Timing(Hour)From

o 0 to 23 whenStartUpdateOnOrAfter(Day) is not blank


Specify the local time zone of the start time period forthe SSL certificates update (the X digit for a timeperiod from X o'clock to Y o'clock).

CertificateSetting::Timing(Hour)To

o 0 to 23 and a digitdifferent from theTiming(Hour)From digitwhenStartUpdateOnOrAfter(Day) is not blank


Specify the local time zone of the start time period forthe SSL certificates update (the Y digit for a timeperiod from X o'clock to Y o'clock).*

*: Required when SerialNumber is not blank.


Appendix

32

Example Input:

OperationCode BrandName(Reference) StoreName(Reference) TargetSerial#

FirmwareSetting::StartUpdateOnOrAfter(Day) FirmwareSetting::Timing(Hour)To

CertificateSetting::Timing(Hour)From CertificateSetting::Timing(Hour)To

Tom Italian Restaurant #0001

Date_2019-02-07Date_2019-02-07

2121

2323

Tom Italian Restaurant #0002EDITEDIT

EDITEDIT

Tom Italian Restaurant #0003

FirmwareSetting::FirmwareVersion1.401.40

CertificateSetting::StartUpdateOnOrAfter(Day)

Date_2019-02-07Date_2019-02-07

2121

2323

FirmwareSetting::DerivativeESC/POSESC/POS

FirmwareSetting::Timing(Hour)From

MNPQ000001MNPQ000002MNPQ000003MNPQ000004


Appendix

33

Operating Environment

Supported POS Systems

This service can be used for POS systems that use TM-T88VI or TM-T88VI-iHUB printers and satisfy thefollowing conditions.

o The content of receipts printed by the printers is text data.

o The printers are set to cut receipt paper after printing.

Note:Use is not possible with a POS system that sends only graphic data or rasterized data.

Supported TM Printers

Printer name Firmware version Interface

TM-T88VI 40.50 ESC/POS and later

o Serial

o USB

o Ethernet

o Wi-Fi

TM-T88VI-iHUB 50.50 ESC/POS and later

o USB

o Ethernet

o Wi-Fi

Note:

o This service requires a stable internet connection between the printer and the Epson Cloud Server.

o This service uses port 443. Make sure that port 443 is allowing connection to the Epson Cloud Server.

Limitations

True Type fonts cannot be used with the Advanced Printer Driver. Use device fonts instead.

Supported Browsers

Use of OmniLink Management Console is required for configuring the service environment.

OmniLink Management Console is an Epson website that is used for accepting applications for OmniLink servicesfrom stores, and used for managing information about the stores and their TM printers.

OmniLink Management Console supports the latest versions of the following web browsers.

o Microsoft Internet Explorer 11


Appendix

34

o Microsoft Edge

o Google Chrome

o Mozilla Firefox

o Apple Safari


Appendix

35

Open Source Software License

The OmniLink Merchant Services use open source software other than software owned by Epson.

The following is the information of the open source software.

OmniLink Merchant Services

The full text of license agreement contract is available on the following website.


https://omnilinkworld.com/license/document/copyrightinfo.html

Europe region

https://omnilinkmerchantservices.eu/license/document/copyrightinfo.html

TM-T88VI

This product uses open source software in addition to Epson proprietary software.

For information of the open source software used in this product, see the following URL.

http://xxx.xxx.xxx.xxx/licenses.html

Note:For “xxx.xxx.xxx.xxx“ in the above URL, input your printer‘s IP address.

TM-T88VI-iHUB

This product uses open source software in addition to Epson proprietary software.

For information of the open source software used in this product, see the following URL.

http://xxx.xxx.xxx.xxx/webconfig/licenses.html

Note:For “xxx.xxx.xxx.xxx“ in the above URL, input your printer‘s IP address.


Appendix

36

Trademarks

EPSON is a registered trademark of Seiko Epson Corporation.

EXCEED YOUR VISION is a registered trademark or trademark of Seiko Epson Corporation.

OmniLink is a trademark of Epson America, Inc.

Microsoft and Internet Explorer are registered trademarks of Microsoft Corporation in the United States and/orother countries.

Google Chrome is a trademark of Google Inc.

Firefox® is a registered trademark of Mozilla Foundation.

Safari® is a trademark of Apple Inc. registered in the United States of America and other countries.

QR Code is a registered trademark of Denso Wave Incorporated.

All other trademarks are the property of their respective owners and used for identification purpose only.

© Seiko Epson Corporation 2019. All rights reserved.


Appendix

37

omnilink merchant services operation guide€¦ · merchant services (cloud-based applications) and...

Documents