Co přesně je dávka? Každá transakce, kterou vytvoříte, patří do tzv. dávky. Stejně jako účtenka má každá dávka své číslo a je balíčkem transakcí. Uzávěrka je administrativní operace, pomocí které terminál uzavře dávku a vyzve systémy, aby se dávka uzavřela a otevřela nová.
Inicializace uzávěrky
Die Transaktion kann durch einen Anruf eingeleitet werden:
gptom://batch/close?…
kde jsou použity následující parametry pro sestavení zprávy:
Variable/Feld
Format/Format
Beschreibung/Beschreibung
Beispiel
clientID
String
redirectUrl
String
CZ: URL vaší aplikace na kterou přesměrujeme klienta po dokončení uzávěrky.
EN: The URL of your application to which we will redirect the client after the close batch is complete.
EN: The URL of your application to which we will redirect the client after the close batch is complete.
fb://Success
printByPaymentApp
bool
CZ: Legt fest, ob die Quittung von Ihrer Anwendung oder von GP tom an den Client weitergegeben wird. Der Standardwert ist “true” (d.h. GP tom bietet die Methode zur Weitergabe der Quittung an den Kunden an). Wenn Sie den Wert "false" angeben, geben wir den Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurück und es liegt an Ihnen, die Quittung zu übergeben.
DE: Legt fest, ob die Quittung von Ihrer Anwendung oder von GP tom an den Client weitergegeben wird. Der Standardwert ist "true" (d. h. GP bietet eine Möglichkeit, die Quittung an den Client weiterzugeben). Wenn Sie den Wert "false" senden, wird der Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurückgegeben und es liegt an Ihnen, die Quittung weiterzugeben.
DE: Legt fest, ob die Quittung von Ihrer Anwendung oder von GP tom an den Client weitergegeben wird. Der Standardwert ist "true" (d. h. GP bietet eine Möglichkeit, die Quittung an den Client weiterzugeben). Wenn Sie den Wert "false" senden, wird der Benutzer unmittelbar nach der Transaktion an Ihre Anwendung zurückgegeben und es liegt an Ihnen, die Quittung weiterzugeben.
wahr/falsch
preferableReceiptType
enum (sms,email,qr,print)
CZ: Für den Versand einer Quittung aus der GP tom-Anwendung kann die Methode für den Versand der Quittung über die API vordefiniert werden. Mögliche Werte sind:
DE: Für den Versand einer Quittung aus der GP tom-Anwendung kann die Methode für den Versand der Quittung über die API vordefiniert werden. Mögliche Werte sind:
TELEFON
EMAIL
QR
DRUCKEN
DE: Für den Versand einer Quittung aus der GP tom-Anwendung kann die Methode für den Versand der Quittung über die API vordefiniert werden. Mögliche Werte sind:
TELEFON
QR
Text
KundeTelefon
String
CZ: Telefonnummer des Kunden.
DE: Rufnummer des Kunden.
DE: Rufnummer des Kunden.
+420606505404
clientEmail
String
CZ: E-Mail Adresse des Kunden.
DE: E-Mail Adresse des Kunden.
DE: E-Mail Adresse des Kunden.
info@gptom.com
Beispielanruf:
gptom://batch/close?preferableReceiptType=QR&redirectUrl=gp://batch/close&clientEmail=info@gptom.com&clientID=223&printByPaymentApp=true&clientPhone=+420606505404
Die Antwort wird die folgenden Felder enthalten:
Variable/Feld
Format/Format
Beschreibung/Beschreibung
Beispiel/Beispiel
AUFGABENSTATUS
CZ: Gibt die Antwort, in welchem Zustand die Anfrage beendet wurde.
DE: Gibt Auskunft darüber, in welchem Bundesland Ihr Ersuchen beendet wurde.
DE: Gibt Auskunft darüber, in welchem Bundesland Ihr Ersuchen beendet wurde.
ABGESCHLOSSEN
ANGESAGT
ERROR
ANGESAGT
ERROR
communicationId
12345678
voidAmount
CZ: Celková výška stornovaných transakcí.
EN: Total amount of voided transactions.
EN: Total amount of voided transactions.
5
totalAmount
CZ: Celková částka uzávěrky.
EN: Total amount of close batch.
EN: Total amount of close batch.
100
totalCount
CZ: Počet všech transakcí v uzávěrce.
EN: Number of all transactions in the close batch.
EN: Number of all transactions in the close batch.
15
saleAmount
CZ: Celková výška transakcí PRODEJ.
EN: Total amount of SALE transactions.
EN: Total amount of SALE transactions.
105
voidCount
CZ: Počet stornovaných transakcí v uzávěrce.
EN: Amount of voided transactions in the close batch.
EN: Amount of voided transactions in the close batch.
1
previousBatchDate
CZ: Datum předchozí uzávěrky.
EN: Date of the previous batch.
EN: Date of the previous batch.
2024-10-20T15:11:08.152Z
Datum
CZ: Datum provedení aktuální uzávěrky.
EN: Date of processing this close batch.
EN: Date of processing this close batch.
2024-10-29T12:14:00.198Z
saleCount
CZ: Počet transakcí PRODEJ v uzávěrce.
EN: Number of SALE transactions in the close batch.
EN: Number of SALE transactions in the close batch.
14
firstTransactionDate
CZ: Datum první transakce v uzávěrce.
EN: Date of the first transaction in the close batch.
EN: Date of the first transaction in the close batch.
2024-10-21T17:19:20.015Z
subBatches
CZ: Zde najdete rozpis dle platební metody.
EN: Here you will find overview per payment method.
EN: Here you will find overview per payment method.
CASH
KARTE
KARTE