Terminal protocol GPE CloseTotals Connector

Version

3.0
Agent restriction

Remote Only
Processing type

Row by row
Multi-input step

Not Supported

The Terminal protocol GPE CloseTotals Connector has the task of closing the accounting period (for example, with a change of operator) and checking the account status of transactions between the payment terminal (or cash register system) and the authorization system. The result of this operation (unlike the Sub-total transaction) is always the accounting of the accumulated state of transactions in all systems.

Configuration

POS Connection

IP Address

Destination IP address of terminal (e.g. 10.0.0.5)

IP Port

Destination port of terminal (e.g. 2050)

Input & Output Schema

Input

Pos GPE CloseTotals Input Schema (ver. 1.0.0)

Column	Data type	Allow null	Description
DebitTransactionCount	Integer	Yes	Number of debit transactions.
DebitTransactionSum	Double	Yes	Sum of amounts of debit transactions.
CreditTransactionCount	Integer	Yes	Number of credit transactions.
CreditTransactionSum	Double	Yes	Sum of amounts of credit transactions.
CashbackCount	Integer	Yes	Number of Cashbacks made.
CashbackTransactionSum	Double	Yes	Sum of Cashbacks made.
RegionCode	String	Yes	Code of Region in the Czech Republic - The field contains code defining the transport region. This field is used by GPE transport solutions only. Example: region Praha, Kladno etc.

Output

Pos GPE CloseTotals Output Schema (ver. 1.0.0)

Column	Data type	Allow null	Description
TerminalId	String	Yes	Terminal logical identifier on which the transaction will be made.
TransactionTimestamp	DateTime	No	Date and Time of transaction. The value is formatted: YYMMDDHHmmSS, where YY – year (last 2 numbers for 2017 only 17 is given) (00 to 99), MM = month (00 to 12), DD = day (01 to 31), HH = hour (00 to 23), mm = minute (00 to 59), SS = second (00 to 59)
Summary	String	Yes	Field is a summary of transactions made since the last transaction “Close day”. It contains a constant prefix, numbers and sums of credit and debit transactions, as well as Cashback withdrawals.
IsTransactionApproved	Bool	No	Flag identifies that the transaction has been approved.
ResponseCode	String	Yes	This field informs about processing results (of transaction or message). Defined codes are in the chapter Transaction response codes below.
CodePage	String	Yes	Info for printing reasons. This field is defined for future use if information is available.
PrintingText	String	Yes	The field contains preformatted text for the printing of the transaction receipt by the ECR. The text is formatted into lines. The line contains formatting characters and/or constant value or directive.

Transaction response codes

Codes of accepted transactions

Code	Description
000 - 009	Accepted
010	Accepted, Partial amount approved

Codes of rejected transactions

Code	Description	Code	Description
050	General processing error	082	Reversal successful. Reversal reason = Card removed too soon
051	Unable to connect with Central Systems	100	Transaction not supported or not allowed
053	A response from the Central System was not delivered	101	Invalid card
055	Declined by chip card without authorization	103	Error in message format (protocol error)
056	Declined by authorization host (online transaction)	106	Error in message CRC (protocol error)
060	Transaction was canceled by the operator	107	Error in MAC (protocol error)
061	Transaction was canceled by the customer	108	Terminal Busy (protocol error)
062	Customer rejected transaction due to amount	110	The amount is not allowed
063	Processing exceeded the designated time limit	160	Totals on ECR, POST are not equal, on AC completed (AC+POST)
070	Transaction was not cancelled	161	161 Totals on ECR, POST are not equal, on AC not finished (POST without Response)
071	Currency not supported (Multicurrency)	200	Mandatory field missing in request message
080	No paper in the internal printer	360	Repeat Last Message – origin message not found
081	Reversal successful	500	Internal application Error

Release notes

3.0.0

First release