Overview

Samples of the key POS events that are sent by TruModule to TruService, either individually, generally realtime or batch, before the transaction completes.

These messages are described further in the POS event section.

TruService responses

In every case TruService responds either with a simple acknowledgement, or with an indication that a question should now be asked:

Simple acknowledgment

<?xml version="1.0" encoding="UTF-8"?>
<Response PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd"/>

Question indicator

<?xml version="1.0" encoding="UTF-8"?>
<Response PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
  <Event>
    <Question Trigger="DWELLTIMEEXTEND"/>
  </Event>
</Response>

Example POS event message (requests)

StartTransaction

<?xml version="1.0" encoding="UTF-8"?>
<Request PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
  <PosEvent>
    <StartTransaction AttendantType="ATTENDED" OperatorId="James" SalesPersonId="Toby" TillType="STANDARD" />
  </PosEvent>
</Request>

StartTilling

<?xml version="1.0" encoding="UTF-8"?>
<Request PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
  <PosEvent>
    <StartTilling/>
  </PosEvent>
</Request>

ScanItem

<?xml version="1.0" encoding="UTF-8"?>
<Request PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
  <PosEvent>
    <Item  Quantity="1" Description="A description" RetailAmount="1000" SellingAmount="1000" Sku="a stock keeping unit" UnitMeasurement="KG" Operation="ADD">
      <Barcode Type="SYMBOLOGY"><![CDATA[asdfjansdkjfnaskjdfnaksjdnfkjasdnfkjasndkjansfdkjansdkjfnaskjdfnkj]]></Barcode>
    </Item>
  </PosEvent>
</Request>

EndTilling

<?xml version="1.0" encoding="UTF-8"?>
<Request PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v210.xsd">
  <PosEvent>
    <EndTilling SubTotalAmount="1000"/>
  </PosEvent>
</Request>

EndTransaction

<?xml version="1.0" encoding="UTF-8"?>
<Request PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
  <PosEvent>
    <EndTransaction />
  </PosEvent>
</Request>

Example POS event list message (request)

<?xml version="1.0" encoding="UTF-8"?>
<Request PartnerId="1" MerchantId="2" TerminalId="3" SessionId="2349572348" xmlns="http://docs.trurating.com/schema/truservice/v230.xsd">
  <PosEventList>
    <StartTransaction AttendantType="ATTENDED" OperatorId="James" SalesPersonId="Toby" TillType="STANDARD" />
    <StartTilling/>
    <Item  Quantity="1" Description="A description" RetailAmount="1000" SellingAmount="1000" Sku="a stock keeping unit" UnitMeasurement="KG" Operation="ADD">
      <Barcode Type="SYMBOLOGY"><![CDATA[asdfjansdkjfnaskjdfnaksjdnfkjasdnfkjasndkjansfdkjansdkjfnaskjdfnkj]]></Barcode>
    </Item>
    <EndTilling SubTotalAmount="1000"/>
    <EndTransaction />
  </PosEventList>
</Request>
Feedback