Prenos digitálnych potvrdeniek je možné realizovať pomocou metód modulu daňového klienta (dll/služba) alebo priamo prostredníctvom RetailForce Cloud.
Predpoklady
Na priamu komunikáciu s RetailForce Cloud potrebujete splniť nasledujúce predpoklady a mať potrebné znalosti.
- Musíte mať distribútorský účet a príslušný distribútorský API kľúč a API Secret
- Musíte mať znalosti o volaniach webových služieb JSON/Rest (HTTP)
- Musíte mať znalosti o autentizácii JWT Bearer (používa sa)
- Musíte vytvoriť terminal v Cloud Retailforce a priradiť mu príslušnú licenciu (DigitalReceipt/DigitalReceiptLight).
Informácie o overovaní JWT Bearer nájdete tu:
Prenos digitálnej účtenky
Na odoslanie digitálnej účtenky musíte v nasledujúcom poradí vyvolať nasledujúce metódy:

Metódy:
-
https://api.retailforce.cloud/api/v1.0/authenticate/logon
(POST)
key: parameter
FORM secret: parameter FORM -
https://api.retailforce.cloud/api/v1.0/licensing/token
(GET)
uniqueClientId: parameter
QUERY accessLicenseId: parameter QUERY -
https://functions.retailforce.cloud/api/digitalReceipt
(POST)
uniqueClientId: parameter QUERY/FORM (možné obidve)
licenseToken: parameter QUERY/FORM (možné obidve)
file: parameter FORM (obsah)
Poznámka: Pre ten istý POS systém (uniqueClientId) môžete odoslať súbor s rovnakým názvom viac ako raz.
Podrobné informácie o funkciách na stránke https://api.retailforce.cloud nájdete na nasledujúcom odkaze: https://api.retailforce.cloud/swagger.
Dôležité: Nemusíte vždy používať celý proces. Licenčný token, ktorý získate z licensing/token (GET), je platný 30 dní. Na strane klienta môžete použiť jwt/decode, aby ste zistili, či je licenčný token platný.
POZNÁMKA: Ak budete volať funkciu licensing/token príliš často, bude zablokovaná. Preto ju používajte len správnym spôsobom, ako je popísané vyššie.
POZNÁMKA: Ak budete volať funkciu licensing/token príliš často, bude zablokovaná. Preto ju používajte len správnym spôsobom, ako je popísané vyššie.
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.