Przesyłanie cyfrowych paragonów może odbywać się za pomocą modułu klienckiego systemu fiskalnego (dll/usługa) lub bezpośrednio za pośrednictwem RetailForce Cloud.
Wymagania wstępne
Aby korzystać z bezpośredniej komunikacji z RetailForce Cloud, muszą Państwo spełnić poniższe wymagania wstępne i posiadać odpowiednią wiedzę.
- Musi Pan/Pani posiadać konto distributora oraz odpowiadający mu klucz API i API Secret
- Musi Pan/Pani posiadać wiedzę na temat wywołań usług internetowych JSON/REST (HTTP)
- Należy posiadać wiedzę na temat uwierzytelniania JWT Bearer (jest ono stosowane)
- Należy utworzyć terminal w Cloud RetailForce i przypisać do niego odpowiednią licencję (DigitalReceipt/DigitalReceiptLight)
Informacje na temat uwierzytelniania JWT Bearer można znaleźć tutaj:
Przesyłanie cyfrowego paragonu
Aby przesłać paragon cyfrowy, należy wywołać następujące metody w podanej kolejności:

Metody:
-
https://api.retailforce.cloud/api/v1.0/authenticate/logon
(POST)
key: parametr
FORM secret: parametr FORM -
https://api.retailforce.cloud/api/v1.0/licensing/token
(GET)
uniqueClientId: parametr
QUERY accessLicenseId: parametr QUERY -
https://functions.retailforce.cloud/api/digitalReceipt
(POST)
uniqueClientId: parametr QUERY/FORM (możliwe obie opcje)
licenseToken: parametr QUERY/FORM (możliwe obie opcje)
file: parametr FORM (treść)
Uwaga: W przypadku tego samego systemu kasowego (uniqueClientId) można wysłać plik o tej samej nazwie więcej niż raz.
Aby uzyskać szczegółowe informacje na temat funkcji dostępnych pod adresem https://api.retailforce.cloud, proszę skorzystać z poniższego linku: https://api.retailforce.cloud/swagger.
Ważne: Nie ma konieczności stosowania całego procesu za każdym razem. Token licencyjny uzyskany za pomocą funkcji licensing/token (GET) jest ważny przez 30 dni. Można skorzystać z funkcji jwt/decode po stronie klienta, aby sprawdzić, czy token licencyjny jest ważny.
UWAGA: Jeśli funkcja licensing/token będzie wywoływana zbyt często, zostanie zablokowana. Dlatego należy korzystać z niej wyłącznie w sposób zgodny z powyższym opisem.
UWAGA: Jeśli funkcja licensing/token będzie wywoływana zbyt często, zostanie zablokowana. Dlatego należy korzystać z niej wyłącznie w sposób zgodny z powyższym opisem.
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.