Initiate HEM/IngEstate Message (Tran Type 36-07)

note

HEM and IngEstate are Ingenico PIN Pad management systems implemented by Elavon. Simplify is currently transitioning from the use of IngEstate to HEM.

Simplify supports an Initiate HEM/IngEstate message from the POS process. This message can be used to determine whether an updated package is available for downloading. Packages are used to download an updated Simplify application, parameter files, form files, etc.

This message can also be used to update the TMS Identifier, by sending it in API 5001 of the request (optional). See sample request below for details.

The Initiate HEM/IngEstate Response message includes a Status flag in API 5001 indicating whether the device was able to successfully communicate with HEM/IngEstate.

important

The Initiate HEM/IngEstate Message should only be sent when necessary and based on coordination with Elavon.

Field 5001 Format

MessageDescription
(Generic format)The format of this field is TTTLLLVVV…VV, where:
  • TTT is a Tag
  • LLL is the length of the data.
  • VVV..VV is the data
Request (optional)
  • TTT - Currently defined tags:
    • 881 = New TMSID
Response
  • TTT - Currently defined tags are:
    • 007 – Download information
  • LLL must be 052
  • VVV..VV
    • Bytes 1-50 = Padded Device Serial Number (must be 50 bytes)
    • Bytes 51-52 = Status Flag
      • 00 – Request successfully communicated to HEM/IngEstate
      • 01 – Simplify is busy with customer interaction
      • 02 – Parameter missing from parameter file

Sample Message

Request

An example of a possible Initiate HEM/IngEstate Request message (from the POS process to Simplify) is:

API Field #, ValueDescription
0001,36Transaction Type. A value of 36 indicates a Non-Financial transaction
0011,xxx..User Data. See Simplify-Controlled Field Definitions.
5001,88100899990000
  • 881=Tag for TMSID
  • 008=Length of Data
  • 99990000=new TMSID

Response

An example of a possible Initiate HEM/IngEstate Response message (from Simplify to the POS process) is:

API Field #, ValueDescription
0001,36Transaction Type. A value of 36 indicates a Non-Financial transaction
0011,xxx..User Data. See Simplify-Controlled Field Definitions.
5001,0070528007044000
  • 007 = Tag for File download information
  • 052 = Length of data (must be 52)
  • 80070440 (plus blanks) = padded Device Serial Number (must be exactly 50 bytes)
  • 00 = Status Flag (00 = Simplify successfully communicated with HEM/IngEstate)
5002,80378002Device Serial Number (if present)

HEM/IngEstate Update Flow Chart

The HEM/IngEstate update process commanded from the POS operates as follows:

HEM/Ingestate update process flow. See text just below.

POS sends Initiate HEM/Ingestate (36-07) request to Simplify.

Simplify attempts to communicate with the HEM/Ingestate server.

  • If not successful, Simplify sends Status Flag to POS in an Initiate HEM/Ingestate response:
    • 01 = PIN pad busy.
    • 02 = Comm error. PIN Pad may reboot.
  • If successful, Simplify sends Status Flag = 00 in response. PIN pad displays ‘Connection’ and checks whether updated Simplify file are available.
    • If no, Simplify reboots.
    • If yes, Simplify download the available files from HEM/Ingestate, applies the updates, and reboots.