Page 1
Server Direct Print User’s Manual Overview Describes the operating environment and system configuration of Server Direct Print. Sample Program Describes how to use the sample program and how to configure the system. Request and Response Describes the requests and responses of Server Direct Print.
Page 2
• 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...
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. Provides information that must be observed to avoid damage to your equipment or a malfunction.
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. TM-T88V-DT TM-T70II-DT TM-H6000IV-DT The TM-i series in this manual is a generic term for the following printers.
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............................
Page 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...
Chapter 1 Overview 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.
Page 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. Server Direct Print Traditional Printing Computer...
Chapter 1 Overview Printing Process TM intelligent printer asks the Web server whether data to be printed exists. When 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.
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.
Chapter 1 Overview Operating Environment How to Access the Web server How to access TM-DT TM-i ✔ ✔ Proxy server ✔ Proxy authentication ✔ ✔ Digest authentication ✔ ✔ HTTPS communication ✔ HTTPS communication with server authentication ✔ : 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...
TM Intelligent Printer TM Intelligent Printer ePOS-Print TM-T88V-DT TM-DT TM-T70II-DT ePOS-Device Ver.2.2 or later TM-H6000IV-DT TM-T88V-i TM-T70-i TM-T20II-i TM-i TM-i firmware Ver.3.0 or later TM-T82II-i TM-T83II-i TM-L90-i 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.
Contains a sample program for ePOS-Print XML. README.txt Describes the changes from the previous version. Utility Used to register NV logo to the printer. Utility TM printer TM-T88V-DT, TM-T88V-i TM-T88V Utility TM-T70II-DT TM-T70II Utility TM-H6000IV-DT TM-H6000IV Utility Utility specialized for each model ...
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.
Chapter 2 Sample Program Sample Program This chapter describes how to use the sample program for Server Direct Print. • 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)....
Page 16
Version 2.00 Specification of Version 2.00 is available in the TM-i Firmware Ver.4.1 or later.
Chapter 2 Sample Program Hardware Configuration The system configuration of the sample program is as shown below. Web Server [192.168.192.10] TM Intelligent Printer (TM-T88V-i) [192.168.192.20] Router [192.168.192.1] TM Printer [192.168.192.21] ❏ Web Server (Its operation has already been checked using IIS and XAMPP .) ❏...
Printing Result Cooking Slip Delivery Slip Program Flow The flow from the initial display to the print completion of the sample program is as shown below. 1. Start the browser. 2. Enter the order. 3. Receive a request from the printer. 4.
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.
4.TM Intelligent Printer Settings ❏ TM-i 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 Initial OS Settings Initializing the ePOS-Device ...
23 Server Direct Print Settings Configure the Server Direct Print settings by using EPSON TMNet WebConfig. For TM-i Firmware Ver.4.0 or later, configure the server authentication and the proxy server settings when necessary. For TM-i Firmware Ver.3.x or earlier, the server authentication and proxy server setting are unavailable.
Page 22
For TM-i Firmware Ver.3.x or earlier Item Description Server Direct Print Select the [Enable]. Set ID for the server-side program to identify TM-i. This ID becomes the user ID used for Digest access authentication. The set value will also be passed as an ID parameter value for the form data posted to the server.
Page 23
Chapter 2 Sample Program Registration of TM Printer Register the device ID and IP address of the controlled TM printer to TM-i. Use EPSON TMNet WebConfig to register the device ID. • TM-i printer cannot be deleted from the device.
Page 24
❏ Registration of TM Printer p. 25 Service startup settings To make service startup settings, use EPSON TMNet WebConfig and the following procedure. Start EPSON TMNet WebConfig from the shortcut on the desktop. EPSON TMNet WebConfig starts. If you are making settings from an external device, set the TM-DT IP address in the address for the Web browser.
Page 25
Registration of TM Printer Register the device ID and IP address of the controlled TM printer to TM-DT. Use EPSON TMNet WebConfig to register the device ID. This printer is already registered with the "local_printer" device ID, and therefore this setting is not required.
Execution of Sample Program Using EPSON TMNet WebConfig, confirm that Server Direct Print settings are valid. Open the sample program page from the Web browser. Example: http://[IP address of the Web server]/demo/index.html Click [Order Entry]. In response to a request from the TM intelligent printer, print data is sent and a slip is printed from the printer.
Chapter 3 Request and Response Request and Response This chapter describes requests from the TM intelligent printer and responses from the Web server. User's application can start printing by returning a response containing print data to a HTTP POST request (print request) from the printer.
Response (Print request) This section describes the response (print request) containing the print data from the Web server. Web Server TM Intelligent Printer 1 : HTTP Request (Print request) 2.1 : Create XML from a database or other system 2.2 : HTTP Response (Print request) Response data created in XML(text/xml) from the application is returned.
Page 30
It is also required to specify the print job ID in the <Parameter> tag. HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: xxx <?xml version="1.0" encoding="utf-8"?> <PrintRequestInfo> tag <PrintRequestInfo Version="2.00"> <ePOSPrint> <Parameter> <devid>local_printer</devid> <timeout>10000</timeout> <printjobid>ABC123</printjobid> Specify the print job ID </Parameter> <PrintData> <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print"> </epos-print> </PrintData> </ePOSPrint> </PrintRequestInfo>...
Chapter 3 Request and Response Print Data Details Set the <Parameter> tag as shown below. <Parameter> <devid>(Device ID used for slip printing)</devid> <timeout>(Timeout time (in milliseconds))</timeout> </Parameter> Example <Parameter> <devid>local_printer</devid> <timeout>10000</timeout> </Parameter> When Specifying the Print Job ID Specification of print job ID is available in the TM-i series (TM-i Firmware Ver.4.1 or later). When specifying the print job ID, specify the print job ID in the <Parameter>...
Request (Printing Result) TM intelligent printer sends a HTTP POST request (printing result) shown below after printing. TM Intelligent Printer Web Server 1 : HTTP Request (Print request) 2.1 : Create XML from a database or other system 2.2 : HTTP Response (Print request) 3 : Create print data 4 : Print 5 : HTTP Request (Printing Result)
Request and Response Print Result Configuration Check the <response> tag for the printing result. <?xml version="1.0" encoding="utf-8"?> <PrintResponseInfo Version="1.00"> #Success <response>tag <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="true" code="" status="251854870" battery="0"/> #Failed <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="false" code="EX_BADPORT" status="1" battery="0"/> </PrintResponseInfo> When the Print Job ID Is Specified Specification of print job ID is available in the TM-i series (TM-i Firmware Ver.4.1 or later).
Failed On failure, an error code is described in "code". For details, see "Error code" (p.35). <PrintResponseInfo Version="1.00"> #Success <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="true" code="" status="251854870" battery="0"/> #Failed <response xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print" success="false" code="EX_BADPORT" status="1" battery="0"/> </PrintResponseInfo> When the Print Job ID Is Specified Specification of print job ID is available in the TM-i series (TM-i Firmware Ver.4.1 or later).
Chapter 3 Request and Response Error code Request Error This occurs when the device has a problem. The following table shows errors that can occur. Errors in Device Code Message Cause An automatically recoverable error Continuous printing of high-density EPTR_AUTOMATICAL occurred.
Response (Printing Result) The Web server sends a response (print result) upon receipt of print result to the TM intelligent printer. TM Intelligent Printer Web Server 1 : HTTP Request (Print request) 2.1 : Create XML from a database or other system 2.2 : HTTP Response (Print request) 3 : Create print data 4 : Print...
Digest access authentication requires settings for the TM intelligence printer and the server. TM Intelligent Printer Use EPSON TMNet WebConfig of TM-i/TM-DT to set your user ID and password required for Digest access authentication. For details, see "Server Direct Print Settings" for individual TM intelligent printers.
Program Example See the following programming data (file name: Test_print.php) <?php header('Content-Type: text/xml; charset=UTF-8'); define("REQUEST_XML_PATH", "demo/request/sample.xml"); define("RESPONSE_XML_PATH", "demo/response/sample.xml"); if (isset($_POST["ConnectionType"])) { $http_request = $_POST["ConnectionType"]; if ($http_request == 'GetRequest') { # send print data # ID $shop_id = $_POST["ID"]; # create print data if (file_exists(REQUEST_XML_PATH)) { # return print data $handle = fopen(REQUEST_XML_PATH, "r");...
Web Server 1 : HTTP Request (Status Information) 2 : Register the status to the database 2.1 : HTTP Response (Status Information) For TM-DT, enable the following settings in EPSON TMNet WebConfig. • ePOS-Device • Service startup settings • Device control •...
• "TM-DT Settings" (p.42) TM-i Settings Configure the Status Notification settings using EPSON TMNet WebConfig. Use the following procedure for registration. Connect the printer to the network and turn the power ON. Start the Web browser on the setup computer and enter as follows: For TM-i Firmware Ver.4.0 or later...
Page 41
Chapter 4 Status Notification The "Status Notification" / "Status Notification Settings" screen appears. Set the following items and click [Apply] / [Submit]. For TM-i Firmware Ver.4.0 or later Item Description Status Notification Select the [Enable]. Set ID for the server-side program to identify TM-i. This ID becomes the user ID used for Digest access authentication.
Page 42
Configure the Status Notification settings using EPSON TMNet WebConfig. Connect the TM-DT to the network and turn the power ON. Start EPSON TMNet WebConfig from the shortcut on the desktop. EPSON TMNet WebConfig starts. If you are making settings from an external device, set the TM-DT IP address in the address for the Web browser.
Chapter 4 Status Notification Execution of Sample Program Confirm that Status Notification of TM intelligent printer is set. Open the sample program page from the Web browser. Example: http://[IP address of the Web Server]/demo/indexStatus.html The “resultPrint.log” is created from the message from the TM intelligent printer and the result is displayed on the screen.
Status Type The following types of ASB (AutoStatusBack) status can be obtained from the TM-i. Code Description 0x00000001 No printer response 0x00000002 Print complete 0x00000004 Status of the drawer kick number 3 connector pin = "H" 0x00000008 Offline status 0x00000020 Cover is open 0x00000040 Paper feed switch is feeding paper...
Page 45
Chapter 4 Status Notification Program Example Refer to the programming below. (File name: Test_status.php) <?php header('Content-Type: text/xml; charset=UTF-8'); # Open the file to save status. $fhandle = @fopen("ResultStatus.log", "wt"); # Update the printer status. if (isset($_POST["Status"])) { $status = $_POST["Status"]; $xml = simplexml_load_string($status);...
Page 46
if (($asb & 0x00002000) == 0x00002000) $strmsg .= " Unrecoverable error generated \n"; if (($asb & 0x00004000) == 0x00004000) $strmsg .= " Auto recovery error generated \n"; if (($asb & 0x00020000) == 0x00020000) $strmsg .= " No paper in the roll paper near end detector \n"; if (($asb &...
Chapter 4 Status Notification Request and Response Request The format of request message is URL-encoded form data (application/x-www-form-urlencoded). Parameter Value ConnectionType Status The ID set with WebConfig ResponseFile Status Information POST /demo/Test_status.php HTTP/1.1 Host: 192.168.192.10 Content-Type: application/x-www-form-urlencoded Content-Length: xxx ConnectionType=SetStatus&ID=&Status=Status Information The status information configuration is as follows: <?xml version="1.0"...