Transferul chitanțelor digitale se poate efectua prin intermediul modulului client fiscal (dll/serviciu) sau direct prin intermediul RetailForce Cloud.
Cerințe preliminare
Pentru a utiliza comunicarea directă cu RetailForce Cloud, trebuie să îndepliniți următoarele cerințe preliminare și să dețineți cunoștințele necesare.
- Trebuie să aveți un cont de distribuitor și o cheie API de distribuitor corespunzătoare, precum și un API Secret
- Trebuie să aveți cunoștințe despre apelurile serviciilor web JSON/Rest (HTTP)
- Trebuie să aveți cunoștințe despre autentificarea JWT Bearer (se utilizează)
- Trebuie să creați un terminal în Retailforce Cloud și să îi atribuiți licența corespunzătoare (DigitalReceipt/DigitalReceiptLight)
Puteți găsi informații despre autentificarea JWT Bearer aici:
Transferul chitanței digitale
Pentru a transfera o chitanță digitală, trebuie să apelați următoarele metode în ordinea indicată:

Metode:
-
https://api.retailforce.cloud/api/v1.0/authenticate/logon
(POST)
key: parametru
FORM secret: parametru FORM -
https://api.retailforce.cloud/api/v1.0/licensing/token
(GET)
uniqueClientId: parametru
QUERY accessLicenseId: parametru QUERY -
https://functions.retailforce.cloud/api/digitalReceipt
(POST)
uniqueClientId: parametru QUERY/FORM (ambele posibile)
licenseToken: parametru QUERY/FORM (ambele posibile)
file: parametru FORM (conținut)
Notă: Puteți trimite același nume de fișier de mai multe ori pentru același sistem POS (uniqueClientId).
Pentru informații detaliate despre funcțiile de la https://api.retailforce.cloud, utilizați următorul link: https://api.retailforce.cloud/swagger.
Important: Nu este necesar să parcurgeți întregul proces de fiecare dată. Tokenul de licență pe care îl veți obține de la licensing/token (GET) este valabil timp de 30 de zile. Puteți utiliza jwt/decode pe partea clientului pentru a verifica dacă tokenul de licență este valabil.
NOTĂ: Dacă apelați funcția licensing/token prea des, aceasta va fi blocată. Prin urmare, utilizați-o numai în mod corespunzător, așa cum este descris mai sus.
NOTĂ: Dacă apelați funcția licensing/token prea des, aceasta va fi blocată. Prin urmare, utilizați-o numai în mod corespunzător, așa cum este descris mai sus.
Acest articol a fost tradus automat.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.