Epson TM-T88V-DT User manual

Server Direct Print
User’s Manual
M00062905
Rev.F
Overview
Sample Program
Request and Response
Status Notification
Describes the operating environment and system
configuration of Server Direct Print.
Describes how to use the sample program and how to
configure the system.
Describes the requests and responses of Server Direct
Print.
Describes the Status Notification function.

2
Cautions
• No part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or
by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written
permission of Seiko Epson Corporation.
• The contents of this document are subject to change without notice. Please contact us for the latest
information.
• While every precaution has taken in the preparation of this document, Seiko Epson Corporation assumes
no responsibility for errors or omissions.
• Neither is any liability assumed for damages resulting from the use of the information contained herein.
• Neither Seiko Epson Corporation nor its affiliates shall be liable to the purchaser of this product or third
parties for damages, losses, costs, or expenses incurred by the purchaser or third parties as a result of:
accident, misuse, or abuse of this product or unauthorized modifications, repairs, or alterations to this
product, or (excluding the U.S.) failure to strictly comply with Seiko Epson Corporation’s operating and
maintenance instructions.
• Seiko Epson Corporation shall not be liable against any damages or problems arising from the use of any
options or any consumable products other than those designated as Original EPSON Products or EPSON
Approved Products by Seiko Epson Corporation.
Trademarks
EPSON is a registered trademark of Seiko Epson Corporation.
Exceed Your Vision is a registered trademark or trademark of Seiko Epson Corporation.
Windowsand Internet Explorerare either registered trademarks or trademarks of Microsoft Corporation in
the United States and other countries.
All other trademarks are the property of their respective owners and used for identification purpose only.
© Seiko Epson Corporation 2013 - 2014. All rights reserved.

3
For Safety
Key to Symbols
The symbols in this manual are identified by their level of importance, as defined below. Read the following
carefully before handling the product.
Restriction of Use
When this product is used for applications requiring high reliability/safety such as transportation devices
related to aviation, rail, marine, automotive etc.; disaster prevention devices; various safety devices etc; or
functional/precision devices etc, you should use this product only after giving consideration to including fail-
safes and redundancies into your design to maintain safety and total system reliability. Because this product
was not intended for use in applications requiring extremely high reliability/safety such as aerospace
equipment, main communication equipment, nuclear power control equipment, or medical equipment
related to direct medical care etc, please make your own judgment on this product’s suitability after a full
evaluation.
Provides information that must be observed to avoid damage to your equipment or a
malfunction.
Provides important information and useful tips.

4
About this Manual
Aim of the Manual
This manual presents information that is necessary information for using the TM-Intelligent.
The TM-Intelligent series in this manual is a generic term for the TM-DT series and TM-i series.
The TM-DT series in this manual is a generic term for the following printers.
The TM-i series in this manual is a generic term for the following printers.
Manual Content
The manual is made up of the following sections:
TM-T88V-DT TM-T70II-DT TM-H6000IV-DT
TM-T88V-i TM-T70-i TM-T20II-i TM-T82II-i TM-T83II-i TM-L90-i
Chapter 1 Overview
Chapter 2 Sample Program
Chapter 3 Request and Response
Chapter 4 Status Notification

5
Contents
■For Safety .............................................................................................................................. 3
Key to Symbols ....................................................................................................................................... 3
■Restriction of Use .................................................................................................................. 3
■About this Manual................................................................................................................ 4
Aim of the Manual ................................................................................................................................. 4
Manual Content .................................................................................................................................... 4
■Contents................................................................................................................................ 5
Overview ........................................................................................7
■Overview of Server Direct Print ........................................................................................... 7
Printing Process....................................................................................................................................... 9
■Overview of Status Notification......................................................................................... 10
■Operating Environment ..................................................................................................... 11
How to Access the Web server .......................................................................................................... 11
Number of URLs accessible for Server Direct Print............................................................................ 11
TM Intelligent Printer............................................................................................................................. 12
TM Printer............................................................................................................................................... 12
■Contents In the Package................................................................................................... 13
Manual.................................................................................................................................................. 13
Sample Program .................................................................................................................................. 13
Utility ...................................................................................................................................................... 13
Download ............................................................................................................................................. 13
■Restriction ........................................................................................................................... 14
Sample Program ..........................................................................15
■Overview............................................................................................................................. 15
Hardware Configuration ..................................................................................................................... 17
File Configuration................................................................................................................................. 17
Printing Result ....................................................................................................................................... 18
Program Flow........................................................................................................................................ 18
■Environment Settings.......................................................................................................... 19
Sample Program Configuration ......................................................................................................... 20
TM Intelligent Printer Settings .............................................................................................................. 21
■Execution of Sample Program .......................................................................................... 26

6
Request and Response ............................................................... 27
■Request (Print Request)...................................................................................................... 27
■Response (Print request).................................................................................................... 28
Format of the response message .......................................................................................................28
Basic Configuration ..............................................................................................................................28
Print Data Configuration......................................................................................................................29
Print Data Details ..................................................................................................................................31
Response When No Printing Is Performed..........................................................................................31
■Request (Printing Result) .................................................................................................... 32
Format of the request message .........................................................................................................32
Print Result Configuration.....................................................................................................................33
Print Result Details.................................................................................................................................34
Error code..............................................................................................................................................35
■Response (Printing Result) ................................................................................................. 36
■Digest Access Authentication........................................................................................... 37
Digest Access Authentication Settings ..............................................................................................37
■Program Example............................................................................................................... 38
Status Notification........................................................................ 39
■Overview............................................................................................................................. 39
■Overview of Status Notification Sample Program ........................................................... 40
TM Intelligent Printer Settings...............................................................................................................40
Execution of Sample Program ............................................................................................................43
■Status Type.......................................................................................................................... 44
■Request and Response ...................................................................................................... 47
Request..................................................................................................................................................47
Response ...............................................................................................................................................47
Digest Access Authentication.............................................................................................................47

7
Chapter 1 Overview
1
Overview
This chapter describes the overview of Server Direct Print and Status Notification.
Overview of Server Direct Print
Server Direct Print function enables the TM intelligent printer (TM-i and TM-DT) to obtain the print data from
the Web server and print the data. The Web server application performs printing by including print data in
the response to a print request from the TM intelligent printer.
TM intelligent printer periodically sends a print request ((1) in the figure above) to the Web server.
The Web server application includes print data in the response ((2) in the figure above) to a print request
from the TM intelligent printer. (When no print data exists, the Web server returns an empty response.)
If print data for the TM printer is included in a response, the TM intelligent printer controls the TM printer in
order to do the printing ((3) in the figure above).
The print data can be printed in the ePOS-Print XML format.
Upon receipt of a response of print data including print layout from the Web server application, the TM
intelligent printer converts the ePOS-Print XML format into the print layout and prints it.
If the spooler is enabled in the TM intelligent printer, print data can be saved in the spooler, which allows an
operation in which the next print request can be processed regardless of the printer status. *1
In a system consisting of multiple printers, if forwarding is set in the TM intelligent printer, print data can be
printed from another printer when it cannot be printed from the printer. *1 *2
*1 : For TM-i Firmware Ver.4.1 or later of the TM-i series. Not supported by the TM-DT series.
*2 : When forwarding is set in the TM intelligent printer.
Web server
Application
TM Intelligent Printer TM Printer
(1) Request
(2) Response
<Data to be printed>
(3) TM printer print data
(1) (2)
(3)

8
Difference from General Printing System
In general printing systems, the application sends a print instruction to the printer.
With Server Direct Print, the printer sends an Inquiry of print request to the Web application, and the Web
application returns a response that has print data included in it.
Computer
Application
TM Printer
Print layout data
Print data
Specifies a printer
TM Intelligent Printer
Web Server
Global IP Address
Application
Traditional Printing Server Direct Print

9
Chapter 1 Overview
1
Printing Process
1TM intelligent printer asks the Web server whether data to be printed exists.
2When data to be printed exists, the Web server application creates an XML-format
response containing the data to be printed, and returns it to the TM intelligent
printer.
When no data to be printed exists, an empty response is returned.
3TM intelligent printer prints the data to the specified printer.
4TM intelligent printer sends a request (printing result) to check whether the data
was printed properly. *
5Upon receipt of the printing result, the application performs the required process.
The Web server automatically responds with an empty response.
*: If the spooler is enabled in the TM intelligent printer, a request (print result) is returned upon receipt of a
response (print request) (for TM-i Firmware Ver.4.1 or later of the TM-i series).
The printing flow is as follows:
1 : HTTP Request (Print request)
2.2 : HTTP Response (Print request)
6.2 : HTTP Response (Printing result)
5 : HTTP Request (Printing result)
TM Intelligent Printer Web Server
2.1 : Create XML from a
database or other system
6.1 : Register printing result to a
database or other system
3 : Create print data
4 : Print

10
Overview of Status Notification
Status Notification is the function used to periodically notify the printer status to the Web server. The web
server registers status from TM intelligent printer to database, then responds with an empty response to TM
intelligent printer.
Operating the printer management application created by the user with the Web server enables grasp of
the status of the printers installed in a shop from a remote place.
2 : Register the status to the database
2.1 : HTTP Response (Status Information)
TM Intelligent Printer Web Server
1 : HTTP Request (Status Information)

11
Chapter 1 Overview
1
Operating Environment
How to Access the Web server
✔: Supported, - : Not supported
*1: Available only for Web contents automatic updating
*2: TM-i firmware Ver.4.0 or later
*3: Available only for Server Direct Print and Status Notification
*4: ePOS-Device Ver.2.2 or later (TM-DT software Ver.2.2)
Number of URLs accessible for Server Direct Print
How to access TM-DT TM-i
Proxy server ✔*1 ✔*2
Proxy authentication -✔*2
Digest authentication ✔*3 ✔*2
HTTPS communication ✔*4 ✔*2
HTTPS communication with server authentication - ✔*2
Model Ver sion Number of URLs accessible
TM-DT 1
TM-i TM-i firmware Ver.4.0 or later 3
TM-i firmware Ver.3.x or earlier 1

12
TM Intelligent Printer
TM Printer
TM printers that can be controlled via the TM intelligent printer.
Available TM printers are different depending on the version of the TM-i firmware or TM-DT software installed
in the product. For details, refer to the Technical Reference Guide for each printer.
TM Intelligent Printer ePOS-Print
TM-DT
TM-T88V-DT
TM-T70II-DT
TM-H6000IV-DT
ePOS-Device Ver.2.2 or later
TM-i
TM-T88V-i
TM-T70-i
TM-T20II-i
TM-T82II-i
TM-T83II-i
TM-L90-i
TM-i firmware Ver.3.0 or later
For details about how to check the version of TM-i Firmware and of ePOS-Device, refer to the
Technical Reference Guide for each printer.

13
Chapter 1 Overview
1
Contents In the Package
Manual
❏Server Direct Print User's Manual (This Document)
❏Technical Reference Guide for each printer
Sample Program
Utility
Used to register NV logo to the printer.
Download
For customers in North America, go to the following web site:
http://www.epsonexpert.com/ and follow the on-screen instructions.
For customers in other countries, go to the following web site:
https://download.epson-biz.com/?service=pos
File name Description
SDP_Sample_Vx.x.xE.zip Contains a sample program for Server Direct Print.
epsonsample.zip Contains a sample program for ePOS-Print XML.
README.txt Describes the changes from the previous version.
Utility TM printer
Utility specialized for each model
TM-T88V Utility TM-T88V-DT, TM-T88V-i
TM-T70II Utility TM-T70II-DT
TM-H6000IV Utility TM-H6000IV-DT
TM-T20II Utility TM-T20II-i
TM-T82II Utility TM-T82II-i
TM-T83II-i Utility TM-T83II-i
Logo registration utility (TMFLogo)
TM-L90-i
TM-T70-i
For the utility to register the NV logo to a printer other than the TM intelligent printer, refer to the
Technical Reference Guide for each printer.

14
Restriction
❏If power is restored the device or the cover is open during printing, printing may not occur properly.
❏To turn the device power off and on, be sure to allow an interval of five seconds or more between power
off and on.
❏Use a switching hub to connect the device.
If no switching hubs are used, the device in online status is more likely to be judged as offline depending
on the traffic condition.
❏Drawer open operates when the TM intelligent printer is in online status (when the roll paper is loaded
and the roll paper cover is closed).
If you are using a TM-i (TM-i firmware Version 3.0 or later)/ TM-DT (TM-DT software Version 2.2 or later), if you
designate forced transmission mode with ePOS-Print XML, it will operate offline.
❏When the specified timeout time has passed after printing starts, the printing is canceled, but the data
recognized by the printer before print cancelling process starts is printed.

15
Chapter 2 Sample Program
2
Sample Program
This chapter describes how to use the sample program for Server Direct Print.
Overview
Use the sample program screen to enter orders. The Web server sends a response containing print data for
a request sent from the TM intelligent printer. The TM intelligent printer uses the returned response data to
print a delivery slip to the main unit and two pieces of cooking slip to the TM printer. The print results appear
on the screen.
Version 1.00
• In this chapter, a system configuration using a Web server is explained as an example.
• In this chapter, the Web server is described as a Web server configured with IIS (Microsoft
Internet Information Services).
When using other environment, interpret the descriptions accordingly.

16
Version 2.00
Specification of Version 2.00 is available in the TM-i Firmware Ver.4.1 or later.

17
Chapter 2 Sample Program
2
Hardware Configuration
The system configuration of the sample program is as shown below.
❏Web Server
(Its operation has already been checked using IIS and XAMPP.)
❏Router
❏TM Intelligent Printer
❏TM Printer
File Configuration
File Name Description
Test_print.php The server returns a response containing print data when the
printer sends a request.
resultPrint.log The printing result is retained in this file. The file is created after
printing.
demo
index.html Sends a print instruction and displays the printing result.
(For Version 1.00)
sample.xml The data of response message. (For Version 1.00)
indexV2.html Sends a print instruction and displays the printing result.
(For Version 2.00)
sampleV2.xml The data of response message. (For Version 2.00)
Web Server
[192.168.192.10]
Router
[192.168.192.1]
TM Printer
[192.168.192.21]
TM Intelligent Printer
(TM-T88V-i)
[192.168.192.20]

18
Printing Result
Program Flow
The flow from the initial display to the print completion of the sample program is as shown below.
Cooking Slip Delivery Slip
3. Receive a request from the printer.
2. Enter the order.
1. Start the browser.
4. Responses print data (sample.xml) to the printer.
5. Output the printing result sent from the printer to resultPrint.log after
6. Display the printing result on the screen.

19
Chapter 2 Sample Program
2
Environment Settings
The environment setting flow of the sample program is as shown below.
1. Router Settings
Set information such as SSID, IP address, DHCP and allocated IP address. For details, see
the manual for each device.
1. Web Server Configuration
Configure IIS and XAMPP in the computer.
2. Sample Program Configuration (p.20)
Save the sample program files in the computer.
2. Web Server Settings
3. Network Settings
Configure the network settings such as IP address to the computer.
3. TM Printer Network Settings
Configure the network settings such as IP address to the TM printer to be connected.
Configure the network settings such as IP address to the printer by using EPSON TMNet
WebConfig from a Web browser on the setup computer.
For the configuration procedure, refer to the Technical Reference Guide for each TM
printer.

20
Sample Program Configuration
Save the sample program files to the Web server.
Save the files directly under the following folders:
Environment Folder Saved File
IIS inetpub\wwwroot Test_print.php
demo\index.html
\sample.xml
(Expansion of epsonsample_eposprint.zip)
XAMPP xampp\htdocs
For details about how to create a zip file, refer to the Technical Reference Guide for each printer.
4.TM Intelligent Printer Settings
❏TM-i (p. 21)
IP Address Setting
Server Direct Print Setting (Including Server authentication setting and Proxy server set-
ting)
Register the TM Printers (Device ID, IP Address)
❏TM-DT (p. 24)
Initial OS Settings
Initializing the ePOS-Device
IP Address Setting
Service Startup Settings
Server Direct Print Setting
Register the TM Printers (Device ID, IP Address)