Load Simplify File via Secure File Transfer Message (Tran Type 36-07)

Simplify supports a Load Simplify File via Secure File Transfer message from the POS process.

The POS system can send Simplify a Load Simplify File via Secure File Transfer when the POS system wants Simplify to request a file download from a secure file transfer server. The file to be downloaded must be specified in the message from the POS. The location of the secure file transfer server is specified in the Simplify parameter files (by either IP address or host name). This message can be used to initiate a download of a new version of Simplify, new parameters, new form files, etc. After a successful download, Simplify will reboot the PIN pad, without sending a response message to the POS. If Simplify cannot complete the download, Simplify will send a Load Simplify File via Secure File Transfer Response message to the POS system, containing a Status Flag indicating why the download could not be completed.

Load Simplify File via Secure File Transfer Message Format

The Load Simplify File via Secure File Transfer message is a Non-Financial message (Transaction Type 36), with the following format:

API Field #, Value Description
0001,36 Transaction Type 36. Non-Financial message.
0011,xxx.. Field 11 is defined as User Data. See Appendix F for the use of this field
5001,xxx.. Non-Financial Data
In the Request, this field sends the download filename. In the Response (not sent for a successful download), it returns a Status Flag indicating why the download was not completed.
The format of this field is TTTLLLVVV…VV, where:
    TTT = Tag
    LLL = Length of data
    VVV..VV = data
TTT - Currently defined tags for Message Type 06 are:
    007 – File download information
Request:
LLL = Must be set to 050
VVV..VV = Name of file to be downloaded, including full path from secure file transfer home directory. Must be exactly 50 bytes ; if necessary, include padding.
Response:
LLL – Must be set to 052
VVV..VV
    Positions 1-50 – Name of download file. Echoed from Request message. Must be exactly 50 bytes including any padding.
    Positions 51-52 – Download Status Flag
      01 – Simplify is busy with customer interaction
      02 – Secure file transfer parameter missing from parameter file
      09 – Error in secure file transfer

Sample Load Simplify File via Secure File Transfer Message

Request

An example of a Load Simplify File via Secure File Transfer Request message (from the POS process to Simplify) is:

API Field #, Value Description
0001,36 Transaction Type. A value of 36 indicates a Non-Financial transaction
0011,xxx.. Field 11 is defined as User Data.See Appendix F for the use of this field
5001,007050simpapp.tgz 007 = Tag for File download information
050 = Length of File name data (must be 50)
simpapp.tgz = name of download file
(must be exactly 50 bytes)

Response

An example of a Load Simplify File via Secure File Transfer Response** message (from Simplify to the POS process) is:

API Field #, Value Description
0001,36 Transaction Type. A value of 36 indicates a Non-Financial transaction
0011,xxx.. Field 11 is defined as User Data
See Appendix F for the use of this field
5001,007052simpapp.tgz01 007 = Tag for File download information
052 = Length of data (must be 52)
simpapp.tgz = name of download file
(must be exactly 50 bytes)
01= Download Status Flag (01 = Simplify busy with customer interaction)
5002,169018710 PIN Pad serial number

Note: if the secure file transfer download is successful, no Load Simplify File via Secure File Transfer Response message will be sent from Simplify to the POS process.