Open a Session (Login Request)

In Nexo Retail protocol, a Login message is initiated by the Sale System to begin the association (or the session) between two components of the Sale System and the POI System.
A Login message can be sent several times. The closure of the session using Logout message is optional.

Usage: Within Arkos, Login message can be sent after the occurence of some events like:

the change of Cashier,
the end of initialisation of the Sale System or the POI System,
the beginning of trip for In-Transit transactions.

Nexo Login Request Layout Examples

XML Format

<?xml version="1.0"?>
 <SaleToPOIRequest>
  <MessageHeader ProtocolVersion="3.0" MessageClass="Service" MessageCategory="Login" MessageType="Request" ServiceID="205" SaleID="SaleTermA" POIID="ArkosTerm1"/>
  <LoginRequest OperatorLanguage="en" OperatorID="101" >
   <DateTime>2018-01-09T09:13:51.0+01:00</DateTime>
   <SaleSoftware ManufacturerID="PointOfSaleCo" ApplicationName="SaleSys" SoftwareVersion="1.2.3" CertificationCode="ECTS2PS001"/>
  </LoginRequest>
 </SaleToPOIRequest>

JSON Format

{
    "SaleToPOIRequest" : 
    {
        "MessageHeader" : 
        {
            "ProtocolVersion" : "3.0",
            "MessageClass" : "Service",
            "MessageCategory" : "Login",
            "MessageType" : "Request",
            "ServiceID" : "205",
            "SaleID" : "SaleTermA",
            "POIID" : "ArkosTerm1"
        },
        "LoginRequest" : 
        {
            "DateTime" : "2018-01-09T09:13:51.0+01:00",
            "SaleSoftware" : 
            {
                "ManufacturerID" : "PointOfSaleCo",
                "ApplicationName" : "SaleSys",
                "SoftwareVersion" : "1.2.3",
                "CertificationCode" : "ECTS2PS001"
            },
            "OperatorLanguage" : "en",
            "OperatorID" : "101"
        }
    }
}

Nexo Login Response Layout Examples

XML Format

<?xml version="1.0"?>
<SaleToPOIResponse>
  <MessageHeader ProtocolVersion="3.0" MessageClass="Service" MessageCategory="Login" MessageType="Response" ServiceID="205" SaleID="SaleTermA" POIID="ArkosTerm1"/>
  <LoginResponse>
    <Response Result="Success"/>
    <POISystemData>
      <DateTime>2018-03-20T11:40:08.0+05:00</DateTime>
      <POISoftware ManufacturerID="Amadis" ApplicationName="ARKOS" SoftwareVersion="1.0" CertificationCode="L3UNI"/>
      <POIStatus GlobalStatus="OK"/>
    </POISystemData>
  </LoginResponse>
</SaleToPOIResponse>

JSON Format