BANKSOFT

Cashier POS
Implementation Manual

BANKSOFT
POS-Y30/R103
06.06.2012
1. Physical Layer:

Pyhsical connection is established with RS-232 connection

1.1 Sagem POS Serial Port COM0 Modular 6-pin jack

1-GND
2-VCC (5 Volt)
3-RX
4-TX
5-CTS
6-RTS

1.2 Pyhsical connection

1 (GND), 3 (RX) ve 4 (TX) connections are used for pyhsical connection.

1.3 Connection Specifications:

19200 bps
8 bit
No-parity
2. Data Connection Layer:

2.1 Control Charachters:

STX 02h
ETX 03h
EOT 04h
ENQ 05h
ACK 06h
NAK 15h

2.2 Environmental Structure:

STX Implementation Message ETX LRC

2.2.1 LRC
Except STX and including ETX,
all the error control charachters ,after XOR applied ,for every byte in the frame

2.3 Flow and Error Control:

Sender sends the application message in frame structure

Received checks the LRC info for the frame
If the LRC is correct , ACK is sent to the sender back.
If the LRC is wrong, NAK is sent to sender back and POS swithes to receiving mode
for 2 more times.
If the sender received the NAK, the sender must try to send the frame 2 more times.
The receiver waits 3 seconds incase the frame is somehow cut, for the rest of the
frame.
The sender waits max 3 seconds for ACK or NAK.
In case the receiver do not send ACK or NAK, the frame is not repeated.

2.4 Hand-Shake and Operability:

By sending the ENQ to the POS terminal , the connection aktivity and the POS readyness to
receive the messages , can be checked.

If ACK is sent as a response to ENQ, this means the connection is up and the terminal is
active.
If NAK is sent as a response to ENQ, this means the connection is up but the terminal is not
ready to receive messages.

In case there is no response to ENQ at all, this means that there is a connection problem.
3. Implementation Layer:

3.1 01-Transaction MessageCashier

Field Lenght Type Explanation:

Header 3 AN ASCII BS2
Message Type 2 AN ASCII 01
Cashier No 4N ASCII
Transaction 4N ASCII
Number
Transaction 2N ASCII 01: Sales
Type: 20: Installment
23: Bonus Usage
30: Cash/Other
Amount: 12 N ASCII The last 2 digits are going to accepted as the
bani part for the amount.
Installment 2N ASCII Used only for the installment( Trnx Type
Count: code:20) transactions

3.2 85-Transaction Response Message:

Field Lenght Type Explanation:

Message Type 2 AN ASCII 82
Cashier No 4N ASCII
Transaction 4N ASCII
Number
Transaction 2N ASCII 01: Sales
Type: 20: Installment
23: Bonus Usage
30: Cash/Other
Amount: 12 N ASCII The last 2 digits are going to accepted as the
bani part for the amount.
Installment 2N ASCII
Count:
Response Code: 3N ASCII 000: Approved
All other codes means the transaction is
rejected.
Authorization 6 AN ASCII
Code:
Pos Transaction 3N ASCII 000: Sales
Type: 004: Installment
023: Bonus Usage
061: Cash/Other
Special Input 24 AN ASCII - Right Padded with 0x20
Text - if the field is empty;
Filled with Hex 0x20 ASCII
-This field is used for the POS terminals,
which has Special Input feature activated
only. If its not activated ths field is not
received.