Skip to content
background-image background-image

Terminal protocol GPE CloseTotals Connector

[ | version 3.1]

Connector

The connector is forbidden for use by the platform background agent.

Connector processing type: Row by row!

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.1.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.
IpAddress String Yes Destination IP address of terminal
IpPort Integer Yes Destination port of terminal

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.1.0

  • Extended input scheme for IpAddress and IpPort

3.0.0

  • First release