Czym dokładnie jest wsad? Każda utworzona transakcja należy do partii. Podobnie jak paragon, każda partia ma numer i jest pakietem transakcji. Zamknięcie to operacja administracyjna, w której terminal zamyka partię i monituje systemy o zamknięcie partii i otwarcie nowej.
Inicjalizacja terminu
Transakcja może zostać zainicjowana przez wywołanie:
gptom://batch/close?…
gdzie do utworzenia raportu używane są następujące parametry:
Zmienna/Pole
Format/Format
Opis/Description
Przykład
clientID
ciąg
redirectUrl
ciąg
CZ: Adres URL aplikacji, na który przekierujemy klienta po upływie terminu.
PL: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu zamykania partii.
PL: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu zamykania partii.
fb://Success
printByPaymentApp
bool
CZ: Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP tom. Domyślną wartością jest true (tj. GP tom zaoferuje metodę przekazania paragonu do klienta). Jeśli wyślesz wartość “false”, zwrócimy użytkownika do Twojej aplikacji natychmiast po transakcji i to do Ciebie należy przekazanie paragonu.
PL: Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP Tom. Domyślną wartością jest true (tj. GP zaoferuje sposób przekazania paragonu do klienta). Jeśli wyślesz wartość "false", zwrócimy użytkownika do Twojej aplikacji natychmiast po transakcji i to do Ciebie należy przekazanie paragonu.
PL: Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP Tom. Domyślną wartością jest true (tj. GP zaoferuje sposób przekazania paragonu do klienta). Jeśli wyślesz wartość "false", zwrócimy użytkownika do Twojej aplikacji natychmiast po transakcji i to do Ciebie należy przekazanie paragonu.
prawda/fałsz
preferableReceiptType
enum (sms,email,qr,print)
CZ: W przypadku wysyłania paragonu z aplikacji GP tom możliwe jest wstępne zdefiniowanie metody wysyłania paragonu przez API. Możliwe wartości to:
PL: W przypadku wysyłania paragonu z aplikacji GP tom możliwe jest wstępne zdefiniowanie metody wysyłania paragonu przez API. Możliwe wartości to:
TELEFON
EMAIL
QR
DRUK
PL: W przypadku wysyłania paragonu z aplikacji GP tom możliwe jest wstępne zdefiniowanie metody wysyłania paragonu przez API. Możliwe wartości to:
TELEFON
QR
DRUK
tekst
clientPhone
ciąg
CZ: Numer telefonu klienta.
PL: Numer telefonu klienta.
PL: Numer telefonu klienta.
+420606505404
clientEmail
ciąg
CZ: Adres e-mail klienta.
PL: Adres e-mail klienta.
PL: Adres e-mail klienta.
info@gptom.com
Przykład połączenia:
gptom://batch/close?preferableReceiptType=QR&redirectUrl=gp://batch/close&clientEmail=info@gptom.com&clientID=223&printByPaymentApp=true&clientPhone=+420606505404
Odpowiedź będzie zawierać następujące pola:
Zmienna/Pole
Format/Format
Opis/Description
Przykład
STATUS ZADANIA
CZ: Podaje odpowiedź, w jakim stanie zakończyło się żądanie.
PL: Informuje, w którym stanie zakończyło się żądanie.
PL: Informuje, w którym stanie zakończyło się żądanie.
ZAKOŃCZONE
ODWOŁANE
BŁĄD
ODWOŁANE
BŁĄD
communicationId
12345678
voidAmount
CZ: Łączna kwota anulowanych transakcji.
PL: Łączna kwota unieważnionych transakcji.
PL: Łączna kwota unieważnionych transakcji.
5
totalAmount
CZ: Całkowita kwota zamknięcia.
PL: Łączna kwota zamkniętej partii.
PL: Łączna kwota zamkniętej partii.
100
totalCount
CZ: Liczba wszystkich transakcji w zamknięciu.
PL: Liczba wszystkich transakcji w zamykanej partii.
PL: Liczba wszystkich transakcji w zamykanej partii.
15
saleAmount
CZ: Łączna kwota transakcji SPRZEDAŻY.
PL: Łączna kwota transakcji SPRZEDAŻY.
PL: Łączna kwota transakcji SPRZEDAŻY.
105
voidCount
CZ: Liczba anulowanych transakcji w zamknięciu.
PL: Kwota unieważnionych transakcji w zamykanej partii.
PL: Kwota unieważnionych transakcji w zamykanej partii.
1
previousBatchDate
CZ: Poprzednia data zamknięcia.
PL: Data poprzedniej partii.
PL: Data poprzedniej partii.
2024-10-20T15:11:08.152Z
data
CZ: Data bieżącego zamknięcia.
PL: Data przetworzenia tej zamkniętej partii.
PL: Data przetworzenia tej zamkniętej partii.
2024-10-29T12:14:00.198Z
saleCount
CZ: Liczba transakcji SPRZEDAŻY na zamknięciu.
PL: Liczba transakcji SPRZEDAŻY w zamkniętej partii.
PL: Liczba transakcji SPRZEDAŻY w zamkniętej partii.
14
firstTransactionDate
CZ: Data pierwszej transakcji w ramach zamknięcia.
PL: Data pierwszej transakcji w zamkniętej partii.
PL: Data pierwszej transakcji w zamkniętej partii.
2024-10-21T17:19:20.015Z
subBatches
CZ: Tutaj znajdziesz podział według metody płatności.
PL: Tutaj znajdziesz przegląd poszczególnych metod płatności.
PL: Tutaj znajdziesz przegląd poszczególnych metod płatności.
GOTÓWKA
KARTA
KARTA