Server Direct Print User`s Manual - Epson America, Inc.
Contents
1. Order Entry Print Result PrintResponselnfo Version 1 00 success true code success true code 15 16 Version 2 00 Specification of Version 2 00 is available in the TM i Firmware Ver 4 1 or later ol mts Oe vee croinvsenoinsevnmi 2 E serena e Server Direct Print Order Entry Print Result PrintResponselnfo Version 2 00 devid local_printer printjobid ABC123 success true devid kitchen_printer printjobid ABC124 success true code 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 IM T88V i 192 168 192 20 Router 192 168 192 1 TM Printer 192 168 192 21 T Web Server Its operation has already been checked using IIS and XAMPP T Router 1 TM Intelligent Printer 1 TM Printer File Configuration File Name Description The server returns a response containing print data when the printer sends a request The printing result is retained in this file The file is created after printing Test_print php resultPrint log f Sends a print instruction and displays the printing result index html f For Version 1 00 4 sample xml The data of response message For Version 1 00 emo f Sends a print instruction and displays the printing result indexV2 html For2. fclose handle move file rename REQUEST_XML_PATH RESPONSE_XML_ PATH else if http_request SetResponse get print result xml simplexml_load_string _POST ResponseFile Sversion xml Version if Sversion 1 00 save log Sfhandle fopen ResultPrint log wt fprintf fhandle PrintResponseInfo Version s n version foreach xml gt response as response fprintf Sfhandle nsuccess S ncode s n Sresponse success response code fclose fhandle else if version 2 00 save log Sfhandle fopen ResultPrint log wt fprintf Sfhandle PrintResponseInfo Version s n version foreach xml gt ePOSPrint as Seposprint Sdevid Seposprint gt Parameter gt devid Sprintjobid Seposprint gt Parameter gt printjobid Sresponse Seposprint gt PrintResponse gt response fprintf Sfhandle ndevid s nprintjobid s nsuccess Ss ncode s n devid printjobid response success Sresponse code J fclose fhandle else Ignore other version else Ignore other connectionType than GetRequest and SetResponse Chapter 4 Status Notification Status Notification This chapter describes the Status Notification function Overview Status Notification is used to periodically notify the TM intelligent printer status to the Web server The Web server
3. 4 5 HTTP Request Printing Result 6 1 Register printing result to a database or other system 6 2 HTTP Response Printing Result Ld I I The application can check the printing result if printing is properly finished and the printer status by analyzing request data If communication fails it is attempted again after a specified interval Format of the request message POST demo Test_print php HTTP 1 1 Host 192 168 192 10 Content Type application x www form urlencoded Content Length xxx ConnectionType SetResponse amp ID amp ResponseFile Printing Result Parameter Value ConnectionType SetResponse ID The ID set with WebConfig p 21 ResponseFile Printing result Chapter 3 Request and Response Print Result Configuration Check the lt response gt tag for the printing result lt xml version 1 0 encoding utf 8 gt lt PrintResponselnfo Version 1 00 gt Success lt response xmins http www epson pos com schemas 2011 03 epos print success true code status 251854870 battery 0 gt Failed lt response xmins http www epson pos com schemas 2011 03 epos print success false code EX_BADPORT status 1 battery 0 gt lt PrintResponselnfo gt lt response gt tag When the Print Job ID Is Specified 2 Specification of print job ID is available in the TM i series TM i Firmware Ver 4 1 or late
4. if asb amp 0x00020000 0x00020000 Sstrmsg No paper in the roll paper near end detector In if asb amp 0x00080000 0x00080000 Sstrmsg No paper in the roll paper end detector n if asb amp 0x80000000 0x80000000 Sstrmsg Stop the spooler In result fprintf fhandle Printer name s Status ASB value is s In Sprinterstatus devicename Sasb Sresult fprintf fhandle Ss n Sstrmsg if Sresult OK else N G fclose fhandle TE Chapter 4 Status Notification Request and Response The format of request message is URL encoded form data application x www form urlencoded Parameter ConnectionType Status The ID set with WebConfig p 40 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 amp ID amp Status Status Information The status information configuration is as follows lt xml version 1 0 encoding utf 8 gt lt statusmonitor Version 1 00 gt lt printerstatus devicename kitchen_printer asbstatus OxOO000001 gt Obtain the ASB status _ lt printerstatus devicename kitchen_printer2 asbstatus 0x00000001 gt lt printerstatus devicename local_printer asbstatus OxOFOO003C gt lt statusmonitor gt Response T
5. port number Example http 10 0 0 1 8008 ID Registers the proxy authentication ID Password Registers the proxyauthentication password Automatic Sets whether the proxy is used for automatic update of Web eee Update contents bs 3 eel Si Direct Print Sets whether the proxy is used for Server Direct Print following services aa S es Sets whether the proxy is used for Status Notification Notification 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 e TM i printer cannot be deleted from the device NM The device ID of TM i printer can be changed A Connect all TM printers to the network and power on 2 EPSON TMNet WebConfig starts For TM i Firmware Ver 4 0 or later select Web Service Settings Direct Print For TM i Firmware Ver 3 x or earlier select Configuration Direct Print 3 The Printer Device Settings screen appears Set the following items and click Ada Submit Item Description Device ID Set the ID for the controlled printer Any character string Model Select the model for the controlled printer IP Address Set the printer IP address for each device ID Set the timeout retry interval Retry Interval ms i Specify 100 4 The information of the registered device is displayed Cli
6. 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 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 e TM T88V DT e TM T7OII DT e TM H6000IV DT The TM i series in this manual is a generic term for the following printers e TM T88V i e TM T70 i e TM T20ll i e TM T82ll i e TM T83Il i e TM L90 i Manual Content The manual is made up of the following sections Chapter 1 Overview Chapter 2 Sample Program Chapter 3 Request and Response Chapter 4 Status Notification Contents BE FOr Sate y ESTE Saas ee ieee A Aes ee Se O A ON ON See 3 Key to SYMONS vs cara ae es Ae A AE A AT AA Ta 3 ME Restriction Of USE ccoo ic di did di 3 E About Mis Manual icon ie 4 Aim ofthe Manual dt A Ae a aT Rte aa ATTA AT 4 Manual Cont dinar naaa Aca dedo yey 4 MC iii ii stance iis dev etext 5 OVOEIVIOW succionar ida 7 E Overview
7. 12 gt lt text align center gt lt barcode type code39 hri none font font_a width 2 height 60 gt 0001 lt barcode gt lt feed line 3 gt lt cut type feed gt lt epos print gt lt PrintData gt lt ePOSPrint gt lt PrintRequestinfo gt 29 30 When Specifying the Print Job ID 2 Specification of print job ID is available in the TM i series M i Firmware Ver 4 1 or later When specifying the print job ID specify Version 2 00 for the lt PrintRequestlnfo gt tag It is also required to specify the print job ID in the lt Parameter gt tag HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length xxx lt xml version 1 0 encoding utf 8 gt lt PrintRequestinfo gt tag lt PrintRequestinfo Version 2 00 gt lt ePOSPrint gt lt Parameter gt lt devid gt local_printer lt devid gt lt timeout gt 10000 lt timeout gt lt printjobid gt ABC 123 lt printjobid gt Specify the print job ID lt Parameter gt lt PrintData gt lt epos print xmins http www epson pos com schemas 2011 03 epos print gt lt epos print gt lt PrintData gt lt ePOSPrint gt lt PrintRequestinfo gt Chapter 3 Request and Response Print Data Details Set the lt Parameter gt tag as shown below lt Parameter gt lt devid gt Device ID used for slip printing lt devid g
8. Version 2 00 sampleV2 xml The data of response message For Version 2 00 Printing Result Cooking Slip Delivery Slip 2 Alt Beer Seat A 3 a DELIVERY TICKET 0001 2013 03 19 13 53 15 Order 0001 Time Mar 19 2013 13 53 15 Seat A 3 Alt Beer 6 00 x 2 12 00 TOTAL 12 00 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 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 Chapter 2 Sample Program 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 2 Web Server Settings 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 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 TM
9. 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 A Start the Web browser on the setup computer and enter as follows For TM i Firmware Ver 4 0 or later http IP address of the TM i webconfig For TM i Firmware Ver 3 x or earlier http IP address of the TM i PrinterConfigurationPage 2 EPSON TMNet WebConfig starts For TM i Firmware Ver 4 0 or later select Web Service Settings Direct Print For TM i Firmware Ver 3 x or earlier select Configuration Direct Print 3 The Server Direct Print Setting screen appears Set the following items and click Submit Apply For TM i Firmware Ver 4 0 or later 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 ID also be passed as an ID parameter value for the form data posted to the server Not required for the sample program Set your password used for Digest access authentication Password Not required for the sample program Specify the Test_print ohp address of the Web server URL Example http IP address of the Web server Test_print php Sener Click the Access Test button to check if the address is accessible Set t
10. address for TM DT is 192 168 192 168 If you are making settings from an external device set the TM DT IP address in the Q http IP address of the TM DT webconfig 3 Select as Settings Web service settings Status notification The Status notification screen appears 4 Set the following items and click Apply ltem Description Set ID for the server side program to identify TM DT This ID becomes the user ID used for Digest access authentication The set value will also be ID passed as an ID parameter value for the form data posted to the server Not required for the sample program Set your password used for Digest access authentication Password Not required for the sample program Specify the Test_print php address of the Web server URL Example http IP address of the Web Server Test_status php Click the Access Test button to check if the address is accessible Set the request interval Interval sec Request interval refers to the interval between the end of the previous communication and the start of the next communication 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 N The resultPrint log is created from the message from the TM intelligent printer and th
11. automatically responds with an empty response 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 TM Intelligent Printer 1 1 HTTP Request Status Information 1 2 Register the status to the database 2 1 HTTP Response Status Information For TM DT enable the following settings in EPSON TMNet WebConfig AN e ePOS Device e Service startup settings p 24 Device control p 24 e Server direct print p 25 e Status notification p 24 39 Overview of Status Notification Sample Program 40 This program displays the status of the connected printer on the screen For the configuration such as Hardware Configuration p 17 and Environment Settings p 19 the same configuration is used as with the Server Direct Print File Configuration File Name Description Test_status php Obtains and displays the result in response to a request from the printer resultPrint log The printing result is retained in this file The file is created after printing demo indexStatus html Displays the printer status TM Intelligent Printer Settings e TM i Settings p 40 The registration screen will vary according to the model of TM Intelligent printer Q TM DT Settings p 42 TM i Settings Configure the Status Noti
12. lt PrintResponselnfo Version 2 00 gt lt ePOSPrint gt lt Parameter gt lt devid gt local_printer lt devid gt Print job ID lt printjobid gt ABC 123 lt printjobid gt lt Parameter gt lt PrintResponse gt lt PrintResponse gt lt ePOSPrint gt lt PrintResponselnfo gt 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 ere EPTR_AUTOMATICAL Message An automatically recoverable error occurred Cause Continuous printing of high density printing EPTR_BATTERY_LOW No remaining battery No battery EPTR_COVER_OPEN The device has a problem The cover is open EPTR_CUTTER The device has a problem The cutter has a foreign matter EPTR_MECHANICAL The device has a problem Mechanical error etc EPTR_REC_EMPTY There is no paper No paper EPTR_UNRECOVERABLE An unrecoverable error occurred Low voltage The port is invalid or the device is not connected e The registered information is invalid e The device power is off Errors in Models Supporting Spooler Code Cause EX_SPOOLER No buffer for the print queue JobNotFound The specified job ID does not exist Printing Printing in progress EX_BADPORT e The device is not connected e Other device control software exists on the sys
13. of Server Direct PriDt ocoooooocccccccccconoccccnonononancnnnonnnannnonnnnnnannnnnnnnnnnnnnrrrrrnnnnannnnnn 7 Printing POES Sen i a E ii A 9 E Overview of Status NotificCatiON cmooccconnonconnccccnncncccnannncnnncncnnnnnnnnnnnn craneo 10 E Operating ENVIO MENE ecemtebeeceaeeevcueesasectes 11 How to Access the Web SELVES oc narrar 11 Number of URLs accessible for Server Direct Pri annnniiniiniinnonnnononicinacanonononorrrornnrrrrrnrrrrrrrrrirrr 11 IM INTENIQGSAT Pta a e 12 AE A ON 12 E Contents In the POCkKaOJDEO wi ia ii 13 Man airaa o daunted i nave tank ea alate avi N 13 SEUIMPIS PROOKGIM dra i celda Dedo sugges da os enable sata db Oo Oria cbc 13 Ulla AS A a eee Te a be 13 PIOWINO cra cara ea RSE papaebenataneeuadeesatuerberiees 13 BE ResiticiiON ita a tad 14 SAMBIOS POMO usina u aariaa E 15 MO vel Wilco ada 15 Hardware COMIQUIATION ici ii id EEEE AED DE 17 He ConU Ne a a da castes 17 Printing Result A A A PA As a a Een Ma a 18 Program ROW oy a aa aaa a E Daa DED i DAAE EANET 18 ENVIO Met SeN OS er cascade iaa 19 sample Program COnfiQuration srs seannsaerainei wid pia 20 TM Inteligent Printer Senin umi Asis 21 E Execution of Sample Progra occoccccccnnoncccnnnnnconannnononancnnnnnncnnnnnnnnnnnnnncnnnnnnrannn cer nnnrr enana 26 Request and RESPONSE cceecceeceeseeeeeeseeeeeeeeseeeeeeeseeeseeeesnaaees 27 E Request Print Requesh 0 0 ii 27 M Response Priht Tequest siiaisia add 28 Format
14. the request interval Request interval refers to the interval between the end of the previous communication and the start of the next communication Authenticate Server Sets whether the server authentication is performed with the registered certificate when accessed through https For TM i Firmware Ver 3 x or earlier Item Status Notification Description 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 Not required for the sample program Password Set your password used for Digest access authentication Not required for the sample program URL Specify the Test_print ohp address of the Web server Example http IP address of the Web Server Test_status php Click the Access Test button to check if the address is accessible Interval s Set the request interval Request interval refers to the interval between the end of the previous communication and the start of the next communication 41 42 TM DT Settings Configure the Status Notification settings using EPSON TMNet WebConfig A Connect the TM DT to the network and turn the power ON 2 Start EPSON TMNet WebConfig from the shortcut on the desktop EPSON TMNet WebConfig starts address for the Web browser The default IP
15. the server The server returns a response with HTTP status code 401 Unauthorized The printer sends a print related request containing the user ID and password The server carries out the Digest access authentication process Once authenticatea the server continues to carry out the print related process Digest Access Authentication Settings 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 M i o 21 TM DT p 24 Web Server Settings For detailed information on how to set Web server s Digest access authentication see individual Web server documents etc 37 Program Example 38 See the following programming data file name Test_print php lt 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 Shttp_request _POST ConnectionType if Shttp_request GetRequest send print data ID Sshop_id _POST ID create print data if file_exists REQUEST_XML_PATH return print data Shandle fopen REQUEST_XML_PATH r fpassthru Shandle
16. EPSON EXCEED YOUR VISION 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 Status Notification Describes the Status Notification function M00062905 Rev F 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 e The contents of this document are subject to change without notice Please contact us for the latest information e 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 E
17. Net WebConfig from a Web browser on the setup computer For the configuration procedure refer to the Technical Reference Guide for each TM printer 19 4 1M Intelligent Printer Settings A TMi p 21 e P Address Setting e Server Direct Print Setting Including Server authentication setting and Proxy server set ting e Register the TM Printers Device ID IP Address a TM DT p 24 e Initial OS Settings e Initializing the ePOS Device e P Address Setting Service Startup Settings Server Direct Print Setting Register the TM Printers Device ID IP Address 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 inetpublwwwroot Test_print ohp demo index html XAMPP xampp htdocs sample xml Expansion of epsonsample_eposprint zip A For details about how to create a zip file refer to the Technical Reference Guide for each printer Chapter 2 Sample Program TM Intelligent Printer Settings TM i Settings 1 IP Address Setting Refer to the Technical Reference Guide for each printer T Server Direct Print Setting 21 e Server authentication setting TM i Firmware Ver 4 0 or later available e Proxy server setting TM i Firmware Ver 4 0 or later available T Register the TM Printers hips Server Direct Print Settings Configure the Server Direct Print settings by using EPSON TMNet
18. Reference Guide for each printer Sample Program File name Description SsDP_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 Used to register NV logo to the printer TM T88V Utility e TM T88V DT TM T88V i TM T7OIl Utility e TM T7OII DT a a TM H6000IV Utility e TM H6000IV DT Utility specialized for each model TM T201 Utility e TM T20ll i TM T8211 Utility e TM T82ll i TM T83ll i Utility e TM T83Il i P e TM L90 i Logo registration utility TMFLogo MIOS For the utility to register the NV logo to a printer other than the TM intelligent printer refer to the Q Technical Reference Guide for each printer Download For customers in North America go to the following web site htto 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 Restriction 14 A If power is restored the device or the cover is open during printing printing may not occur properly 1 To turn the device power off and on be sure to allow an interval of five seconds or more between power off and on T 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 offl
19. SiS when using On Off the server direct print function Chapter 2 Sample Program Server Direct Print Settings Configure the Server Direct Print settings using EPSON TMNet WebConfig A EPSON TMNet WebConfig starts Select as Settings Web service settings Direct print 2 The Server direct print screen appears Set the following items and click OK ltem Description Set ID for the server side program to identify TM DT This ID becomes the user ID used for Digest access authentication The set value will ID also be passed as an ID parameter value for the form data posted to the server Not required for the sample program Set your password used for Digest access authentication Password f Not required for the sample program Specify the Test_print ohp address of the Web server URL Example http IP address of the Web server Test_print php Click the Access Test button to check if the address is accessible Set the request interval Intercal sec Request interval refers to the interval between the end of the previous communication and the start of the next communication 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 Use the following procedure for registr
20. ains print data When an invalid print request is received the server retries a request print request after a specified interval Format of the response message HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length xxx lt xml version 1 0 encoding utf 8 gt lt PrintRequestinfo gt Print Data lt PrintRequestinfo gt Basic Configuration HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length xxx lt xml version 1 0 encoding utf 8 gt lt PrintRequestinfo gt lt ePOSPrint gt lt ePOSPrint gt tag Print request 1 lt ePOSPrint gt lt ePOSPrint gt lt ePOSPrint gt tag Print request 2 lt ePOSPrint gt lt PrintRequestinfo gt Note Enclosing the ePOSPrint tag in the PrintRequestinfo tags enables sending multiple print requests to the printer 28 Chapter 3 Request and Response Print Data Configuration Print data consists of the lt Parameter gt tag and the lt ePOSPrint gt tag Describe the print data in the ePOS Print format and specify the data to the lt epos print gt tag For ePOS Print XML reference see Chapter 4 ePOS Print XML Reference in ePOS Print XML User s Manual HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length xxx lt xml version 1 0 encoding utf 8 gt lt PrintRequestinfo gt lt ePOSPrint gt lt Parameter gt lt Parameter gt tag lt dev
21. ation A Connect all TM printers to the network and power on 2 EPSON TMNet WebConfig starts Select as Settings Web service settings Printer 3 The Printer screen appears Set the following items and click Ada Item Description Device ID Set the ID for the controlled printer Any character string Model no Select the model for the controlled printer IP address Set the printer IP address for each device ID Set the timeout retry interval Retry interval ms S ify 100 pecify 4 The information of the registered device is displayed in Registered printers Click Test Print to check if the registered printer operates properly 25 Execution of Sample Program 26 ao AQ N 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 resultPrint log is created from the printing result sent from the TM intelligent printer and the printing result is displayed on the screen 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 t
22. ck Test Print to check if the registered printer operates properly 23 24 TM DT Settings Configure the following settings to TM DT 1 Initial OS Settings Refer to the Technical Reference Guide for each printer A Initializing the ePOS Device Refer to the Technical Reference Guide for each printer 1 IP Address Settings Refer to the Technical Reference Guide for each printer T Service Startup Settings p 24 1 Server Direct Print Settings p 25 1 Registration of TM Printer p25 Service startup settings To make service startup settings use EPSON TMNet WebConfig and the following procedure A 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 Q address for the Web browser The default IP address for TM DT is 192 168 192 168 http IP address of the TM DT webconfig Select as Settings Web service settings Startup settings N The Startup settings screen appears Set the following according to the system you are using and then click Apply Go Item Description Setting Sets whether t TM DTt trol ipheral POS Device c htr l e ether to use o control periphera On Default devices Aut ti date of A T S Sets whether to automatically uodate web content Off web content Server direct print Sets whether to use server direct print On Seea Sets Winen to sane E
23. e result is disolayed on the screen Q 1 8 StatusNotification Windows Internet Explorer YX E N Y tela EJS gt Bit Wdemo IndexStatus htm gt 84 x E sing 3 pr de Favorites 88 E StatusNotification x f Status Notification Printer Status Printer name local_printer Status ASB value is 251658260 Status of the drawer kick number 3 connector pin H Stop the spooler 43 Status Type 44 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 0x00000100 Waiting for online recovery 0x00000200 Paper feed switch is being pressed 0x00000400 Mechanical error occurred 0x00000800 Auto cutter error generated 0x00002000 Unrecoverable error generated 0x00004000 Auto recovery error generated 0x00020000 No paper in the roll paper near end detector 0x00080000 No paper in the roll paper end detector 0x01000000 Buzzer activated supported model only 0x80000000 Stop the spooler Chapter 4 Status Notification Program Example Refer to the programming below File name Test_status php lt php header Content Type text xml charset UTF 8 Open the fil
24. e to save status Sfhandle fopen ResultStatus log wt Update the printer status if isset _POST Status status _POST Status xml simplexml_load_string status foreach xml gt printerstatus as printerstatus Sasb hexdec S printerstatus asbstatus Sstrmsg if asb amp 0x00000001 0x00000001 Sstrmsg No TM printer response n if asb amp 0x00000002 0x00000002 Sstrmsg Print completed n if asb amp 0x00000004 0x00000004 Sstrmsg Status of the drawer kick number 3 connector pinin if asb amp 0x00000008 0x00000008 strmsg Offline status n if asb amp 0x00000020 0x00000020 Sstrmsg Cover is open n if asb amp 0x00000040 0x00000040 Sstrmsg During paper feeding by pressing paper feed switch In if asb amp 0x00000100 0x00000100 strmsg Waiting for online recovery n if asb amp 0x00000200 0x00000200 strmsg Paper feed switch is being pressed ON n if asb amp 0x00000400 0x00000400 strmsg Mechanical error generated n if asb amp 0x00000800 0x00000800 strmsg Auto cutter error generated n 45 46 if Sasb amp 0x00002000 0x00002000 Sstrmsg Unrecoverable error generated n if Sasb amp 0x00004000 0x00004000 Sstrmsg Auto recovery error generated n
25. fication settings using EPSON TMNet WebConfig Use the following procedure for registration A Connect the printer to the network and turn the power ON 2 Start the Web browser on the setup Computer and enter as follows For TM i Firmware Ver 4 0 or later http IP address of the TM i webconfig For TM i Firmware Ver 3 x or earlier http IP address of the TM i PrinterConfigurationPage 3 EPSON TMNet WebConfig starts For TM i Firmware Ver 4 0 or later select Web Service Settings Status Notification For TM i Firmware Ver 3 x or earlier select Configuration Status Notification Chapter 4 Status Notification 4 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 Status Notification Description 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 Not required for the sample program Password Set your password used for Digest access authentication Not required for the sample program URL Specify the Test_print php address of the Web server Example http IP address of the Web Server Test_status php Click the Access Test button to check if the address is accessible Interval s Set
26. he format of response message is XML text xml To indicate that the server received the status notification the Web server returns a response as follows HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length O Digest Access Authentication Digest access authentication can be used for the status notification See Digest Access Authentication 0 37 47 48
27. he request interval Interval s Request interval refers to the interval between the end of the previous communication and the start of the next communication Sets whether the server authentication is performed with the Authenticate Server i registered certificate when accessed through https 21 22 For TM i Firmware Ver 3 x or earli Item Server Direct Print er Description 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 Not required for the sample program Password Set your password used for Digest access authentication Not required for the sample program URL Specify the Test_print ohp address of the Web server Example http IP address of Web server Test_print php Click the Access Test button to check if the address is accessible Interval s Set the request interval Request interval refers to the interval between the end of the previous communication and the start of the next communication 4 When using the proxy server select System Settings Proxy 5 The Proxy screen appears Set the following items then click Apply ltem Proxy URL and Port Number Description Enter the proxy server URL and port number in the following ntto host name
28. id gt local_printer lt devid gt lt timeout gt 10000 lt timeout gt lt Parameter gt lt PrintData gt lt epos print xmins http www epson pos com schemas 2011 03 epos print gt lt text lang en gt lt textsmooth true gt lt text align center gt lt text font font_b gt lt ePOSPrint gt tag lt text width 2 height 2 gt lt text reverse false ul false em true color color_1 gt lt text gt DELIVERY TICKET lt text gt lt feed unit 12 gt lt text gt lt text gt lt text align left gt lt text font font_a gt lt text width 1 height 1 gt lt text reverse false ul false em false color color_1 gt lt text gt Order 0001 lt text gt lt text width 1 height 1 gt lt text reverse false ul false em false color color_1 gt lt text gt Time Mar 19 2013 13 53 15 lt text gt lt text gt Seat A 3 lt text gt lt text gt lt text gt lt text width 1 height 1 gt lt text reverse false ul false em false color color_1 gt lt text gt Alt Beer lt text gt lt text gt 6 00 x 2 lt text gt lt text x 384 gt lt text gt 12 00 lt text gt lt text gt lt text gt lt text reverse false ul false em true gt lt text width 2 height 1 gt lt text gt TOTAL lt text gt lt text x 264 gt lt text gt 12 00 lt text gt lt text reverse false ul false em false gt lt text width 1 height 1 gt lt feed unit
29. ine depending on the traffic condition 4 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 T 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 Chapter 2 Sample Program sample Program This chapter describes how to use the sample program for Server Direct Print e In this chapter a system configuration using a Web server is explained as an example Q e 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 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 seca Go ample_eposprint demo index html O e ServerDirectPrint x tnt B Server Direct Print
30. m 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 Ye 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 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 Traditional Printing Server Direct Print Computer A Web Server Application Application Specifies a printer Global IP Address Print layout data TM Printer 5 a Print data TM Intelligent Printer Chapter Overview Printing Process 4 5 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 When no data to be printed exists an empty response is returned TM intelligent printer prints the data to the specified printer TM intelligent printer sends a request printing result to check whether the data was printed properly Upon receipt of the printing result the application performs
31. o a HTTP POST request print request from the printer It can also check if printing is properly finished by analyzing a HTTP POST request print request from the printer Request Print Request This section describes the request print request from the TM i TM Intelligent Printer Web Server 1 1 HTTP Request Print request 1 2 1 Create XML from a lt database or other system TM intelligent printer periodically sends a HTTP POST request print request shown below The format of request message is URL encoded form data application x www form urlencodeo Set the sending destination and sending interval according to Server Direct Print Settings p 21 If communication fails it is attempted again after a specified interval Parameter Value ComnectionType GetRequest ID The ID set with WebConfig p 21 POST demo Test_print php HTTP 1 1 Host 192 168 192 10 Content Type application x www form urlencoded Content Length 29 Header Connectionlype GetRequest amp ID 27 Response Print request This section describes the response print request containing the print data from the Web server TM Intelligent Printer 1 1 HTTP Request Print request 1 2 1 Create XML from a database or other system Response data created in XML text xml from the application is returned The data also cont
32. of the response MESSAGE i EE rro raro rro eran ren rre nr rene rear rara 28 Basie ConfiguratON narad p eng Cathe ashe a then ss cpueaneien D aa E E Tapas A a a EETA TA 28 Print Data C nfig rAho N erea a ia a A c a Ta A A EA eer 29 Prin A A E E E N 31 Response When No Printing Is Performed ne ener enero 3 E Request Printing Result 2 0002 0 iiecceeiiec inten ici 32 FOrmanof thetequest Message ii it 32 Print Result Configurar 33 Print RSU e de adam e cate 34 os A A UN 35 E Response Printing Result c 0oo iii dida 36 E Digest Access AuthenticatioN oooocoonncccnnnonncncnccnnnnannnnannnnnnnnnnnnnnnennnnnn cnn nen nnnarrnnnanes 37 Digest Access Authentication Settings 0 er rn rr rr 37 E Program Example na aeeai iene de ceeded te re aa aaa kaaa 38 STATUS NOTING OMON iiics ainiaan a 39 Roana iii di 39 E Overview of Status Notification Sample PrograM occconcconincncccnonaccnnnanononncnnnnanannnnnnnns 40 TM Intelligent Printer Setting etnia ira ab re eiiadnae nites 40 Execution Of Sample PrOYAM woe EE EE EEEE EEEE EEEE EEEE EEE 43 E Status TyPO ea aE EE E R EN EREN cerry ree 44 E Request and RESPONSE ccccccecesseceeeeeeesseeeeeeeessneneeeeeeesseaeeeeeeessseaeeeeeesseenaeseeeessneaeeeenss 47 REQUEST de A etna es 47 RESPONSE ae ee A O 47 Digest Access AuMenticalO Mamita mainte bad ania eee natn 47 Chapter Overview Overview This chapter describes the overview of Server Direct Print and Status No
33. pson Corporation s operating and maintenance instructions e 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 resoective owners and used for identification purpose only Seiko Epson Corporation 2013 2014 All rights reserved For Safety AO OS 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 AN malfunction 2 Provides important information and useful tips 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
34. r When the print job ID is specified Version attribute in the lt PrintResponselnfo gt tag is returned as 2 00 lt xml version 1 0 encoding utf 8 gt lt PrintResponselnfo gt tag lt PrintResponselnfo Version 2 00 gt lt ePOSPrint gt lt Parameter gt lt devid gt local_printer lt devid gt lt printjobid gt ABC 123 lt printjobid gt lt Parameter gt lt PrintResponse gt lt PrintResponse gt lt ePOSPrint gt lt PrintResponselnfo gt 33 Print Result Details lt response gt tag Check if the lt response gt tag indicates success or failed Item Description true Success false Failed On failure an error code is described in code For details see Error code p 35 lt PrintResponselnfo Version 1 00 gt Success lt response xmins http www epson pos com schemas 2011 03 epos print success true code status 251854870 battery 0 gt Failed lt response xmins http www epson pos com schemas 2011 03 epos print success false code EX_BADPORT status 1 battery 0 gt lt Printkesponselnfo gt When the Print Job ID Is Specified 2 Specification of print job ID is available in the TM i series TM i Firmware Ver 4 1 or later When the print job ID is specified the print job ID is returned in the lt Parameter gt tag lt xml version 1 0 encoding utf 8 gt
35. s the Web server How to access TM DT TM i Proxy server y v2 Proxy authentication y Digest authentication ve Vv HTTPS Communication v4 v2 HTTPS Communication with server authentication e Vv Y 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 Version Number of URLs accessible TM DT 1 TVE TM i firmware Ver 4 0 or later 3 TM i firmware Ver 3 x or earlier 11 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 i ies TM i firmware Ver 3 0 or later TM T8211 i TM T83ll i TM L90 i For details about how to check the version of TM i Firmware and of ePOS Device refer to the Q Technical Reference Guide for each 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 Chapter Overview Contents In the Package U Server Direct Print User s Manual This Document T Technical
36. t lt timeout gt Timeout time in milliseconds lt timeout gt lt Parameter gt Example lt Parameter gt lt devid gt local_printer lt devid gt lt timeout gt 10000 lt timeout gt lt Parameter gt When Specifying the Print Job ID 2 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 lt Parameter gt tag The print job ID must have 1 to 30 characters and allowable characters are alohanumerical characters underscore hyphen and period lt Parameter gt lt devid gt local_printer lt devid gt lt timeout gt 10000 lt timeout gt Specify the printjob ID lt printiobid gt ABC123 lt printjobid gt lt Parameter gt Response When No Printing ls Performed When no printing is required to notify no print data the following response is returned for a HTTP request print request sent from the TM intelligent printer See Test_print php of the sample program HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length 0 31 Request Printing Result 32 TM intelligent printer sends a HTTP POST request printing result shown below after printing 1 1 HTTP Request Print request 1 2 1 Create XML from a database or other system 3 Create print data 4 Print
37. tem Timeout occurred e The process was not completed within a certain period of time EX_TIMEOUT e Alarge amount of data was sent with 1 method 35 Response Printing Result The Web server sends a response print result upon receipt of print result to the TM intelligent printer dl Web Server 1 1 HTTP Request Print request 1 2 1 Create XML from a database or other system a 3 Create print data 4 Print 5 HTTP Request Printing Result 4 6 1 Register printing result to a database or other system 6 2 HTTP Response Printing Result LJ I I The format of response message is XML text xml To indicate that the server received the printing result the Web server re urns a response as follows HTTP 1 1 200 OK Content Type text xml charset utf 8 Content Length 0 36 Chapter 3 Request and Response Digest Access Authentication This section describes the flow and settings for carrying out Digest access authentication with the web server Web Server 3 HTTP request containing a user ID and password Print request Printing Result 3 1 Server process Po HTTP Response Print request Printing Result y 3 a a ye ee a i i I I For Digest access authentication the printer sends a dummy HTTP request before sending a print related request to
38. 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 TM Intelligent Printer Web Server 1 HTTP Request Print request 1 2 1 Create XML from a i database or other system 2 2 HTTP Response Print request Ms Se O a I I I I I I I I 3 Create print data i 4 Print i I n i I I I i 5 HTTP Request Printing result A 6 1 Register printing result to a database or other system e 6 2 HTTP Response Printing result 4 Overview of Status Notification 10 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 lt a TM Intelligent Printer Web Server 1 1 HTTP Request Status Information 1 2 Register the status to the database Chapter Overview Operating Environment How to Acces
39. tification 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 1 Request 2 Response lt Data to be printed gt Web server Application 3 TM printer print data 1 2 TM Intelligent Printer Qe xD TM intelligent printer periodically sends a print request 1 in the figure above to the Web server TM Printer 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 syste
Download Pdf Manuals
Related Search