Čo presne je dávka? Každá transakcia, ktorú vytvoríte, patrí do takzvanej dávky. Rovnako ako účtenka má každá dávka svoje číslo a predstavuje súbor transakcií. Uzavretie je administratívna operácia, pomocou ktorej terminál uzavrie dávku a vyzve systémy, aby dávku uzavreli a otvorili novú.
Inicializácia uzávierky
Transakciu je možné iniciovať volaním:
gptom://batch/close?…
kde sa na zostavenie správy používajú nasledujúce parametre:
Premenná/Pole
Formát
Popis
Príklad
ID klienta
reťazec
redirectUrl
reťazec
CZ: URL vašej aplikácie, na ktorú presmerujeme klienta po ukončení uzávierky.
EN: URL vašej aplikácie, na ktorú presmerujeme klienta po dokončení hromadného zatvárania.
EN: URL vašej aplikácie, na ktorú presmerujeme klienta po dokončení hromadného zatvárania.
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á suma zrušených transakcií.
EN: Celkový počet zrušených transakcií.
EN: Celkový počet zrušených transakcií.
5
celková suma
CZ: Celková suma k dátumu uzávierky.
EN: Celková suma uzavretej dávky.
EN: Celková suma uzavretej dávky.
100
celkový počet
CZ: Počet všetkých transakcií v záverečnom vyúčtovaní.
EN: Počet všetkých transakcií v záverečnej dávke.
EN: Počet všetkých transakcií v záverečnej dávke.
15
sumy predaja
CZ: Celková hodnota transakcií PREDAJ.
EN: Celkový počet transakcií typu SALE.
EN: Celkový počet transakcií typu SALE.
105
počet neplatných
CZ: Počet zrušených transakcií v záverečnom zúčtovaní.
EN: Počet zrušených transakcií v záverečnej dávke.
EN: Počet zrušených transakcií v záverečnej dávke.
1
predchádzajúci dátum dávky
CZ: Dátum predchádzajúcej uzávierky.
EN: Dátum predchádzajúcej šarže.
EN: Dátum predchádzajúcej šarže.
2024-10-20T15:11:08.152Z
dátum
CZ: Dátum vykonania aktuálnej uzávierky.
EN: Dátum spracovania tejto uzavretej šarže.
EN: Dátum spracovania tejto uzavretej šarže.
2024-10-29T12:14:00.198Z
počet predajov
CZ: Počet transakcií PREDAJ v záverečnom výkaze.
EN: Počet transakcií SALE v záverečnej dávke.
EN: Počet transakcií SALE v záverečnej dávke.
14
dátum prvej transakcie
CZ: Dátum prvej transakcie v účtovnom období.
EN: Dátum prvej transakcie v uzatvorenej dávke.
EN: Dátum prvej transakcie v uzatvorenej dávke.
2024-10-21T17:19:20.015Z
podsérie
CZ: Tu nájdete prehľad podľa spôsobu platby.
EN: Tu nájdete prehľad podľa spôsobu platby.
EN: Tu nájdete prehľad podľa spôsobu platby.
CASH
KARTA
KARTA