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
Transakciu je možné iniciovať volaním:
gptom://batch/close?…
kde jsou použity následující parametry pro sestavení zprávy:
Premenná/Pole
Formát
Popis
Príklad
ID klienta
reťazec
redirectUrl
reťazec
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
tlač cez platobnú aplikáciu
bool
SK: Určuje, či účtenku klientovi odovzdá vaša aplikácia alebo GP tom. Predvolená hodnota je true (t. j. GP tom ponúkne spôsob odovzdania účtenky klientovi). Ak zadáte hodnotu “false”, ihneď po transakcii vrátime používateľa do vašej aplikácie a odovzdanie účtenky je na vás.
EN: Určuje, či potvrdenku odovzdá klientovi vaša aplikácia alebo GP. Predvolená hodnota je true (t. j. GP ponúkne spôsob, ako potvrdenku odovzdať klientovi). Ak zadáte hodnotu "false", používateľa vrátime do vašej aplikácie ihneď po transakcii a odovzdanie potvrdenia je na vás.
EN: Určuje, či potvrdenku odovzdá klientovi vaša aplikácia alebo GP. Predvolená hodnota je true (t. j. GP ponúkne spôsob, ako potvrdenku odovzdať klientovi). Ak zadáte hodnotu "false", používateľa vrátime do vašej aplikácie ihneď po transakcii a odovzdanie potvrdenia je na vás.
pravda/nepravda
preferovaný typ potvrdenia
enum (sms, e-mail, qr, tlač)
SK: Pri odosielaní účtenky z aplikácie GP je možné prostredníctvom API vopred definovať spôsob odoslania účtenky. Možné hodnoty sú:
EN: V prípade zasielania potvrdenia z aplikácie GP je možné vopred nastaviť spôsob zasielania potvrdenia prostredníctvom API. Možné hodnoty sú:
TELEFÓN
E-MAIL
QR
TLAČ
EN: V prípade zasielania potvrdenia z aplikácie GP je možné vopred nastaviť spôsob zasielania potvrdenia prostredníctvom API. Možné hodnoty sú:
TELEFÓN
QR
TLAČ
SMS
telefón klienta
reťazec
SK: Telefónne číslo klienta.
EN: Telefónne číslo klienta.
EN: Telefónne číslo klienta.
+420606505404
e-mail klienta
reťazec
SK: E-mailová adresa klienta.
EN: E-mailová adresa klienta.
EN: E-mailová adresa klienta.
info@gptom.com
Príklad volania:
gptom://batch/close?preferableReceiptType=QR&redirectUrl=gp://batch/close&clientEmail=info@gptom.com&clientID=223&printByPaymentApp=true&clientPhone=+420606505404
Odpoveď bude obsahovať nasledujúce polia:
Premenná/Pole
Formát
Popis
Príklad
STATUS ÚLOHY
SK: Uvádza, v akom stave daná požiadavka skončila.
EN: Poskytuje informácie o tom, v akom stave sa vaša žiadosť nachádza.
EN: Poskytuje informácie o tom, v akom stave sa vaša žiadosť nachádza.
DOKONČENÉ
ZRUŠENÉ
CHYBA
ZRUŠENÉ
CHYBA
identifikátor komunikácie
12345678
voidAmount
CZ: Celková výška stornovaných transakcí.
EN: Total amount of voided transactions.
EN: Total amount of voided transactions.
5
celková suma
CZ: Celková částka uzávěrky.
EN: Total amount of close batch.
EN: Total amount of close batch.
100
celkový počet
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
sumy predaja
CZ: Celková výška transakcí PRODEJ.
EN: Total amount of SALE transactions.
EN: Total amount of SALE transactions.
105
počet neplatných
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
predchádzajúci dátum dávky
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
dátum
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
počet predajov
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
dátum prvej transakcie
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
podsérie
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
KARTA
KARTA