SmartCash Everywhere REST Server > Notiuni Introductive

SmartCash Everywhere REST Server

SmartCash Everywhere REST Server integreaza o suita de tehnologii care permite ca sistemul SmartCash RMS , folosit ca gestiune retail, magazine, retea de magazine, sa se conecteze cu alte aplicatii terte, eCommerce, ERP, eCard sau cu alte componente software din retea.

Acest server REST ofera un API JSON, un API modern, orientat spre web, pe care dezvoltatorii externi il pot folosi pentru a interactiona cu baza de date si functionalitatile SmartCash.

API-ul oferit de SmartCash Everywhere REST permite o gamă largă de integrări și operațiuni:

Printre funcţionalităţi:

Sincronizarea nomenclatorului de articole / listelor de preţuri;

Sincronizarea locaţiilor reţelei (magazine, depozite etc.);

Sincronizarea stocurilor în timp real — ceea ce face posibil să ştii în orice moment ce produse sunt în stoc în fiecare magazin / depozit;

Sincronizarea clienţilor, scheme de fidelizare — util dacă vrei să ai un sistem unificat de clienti/loialitate;

Trimiterea comenzilor online către SmartCash RMS — deci funcţionează şi ca backend pentru magazine online / ecommerce;

Obţinerea informaţiilor despre starea comenzilor online;

Sincronizarea furnizorilor şi comenzilor de aprovizionare / recepţie marfă — deci util şi ca parte din fluxul logistic / de gestiune;

Transferuri interne de marfă, recepţii externe (EDI), raportare documente contabile, rapoarte de stoc, registre de casă global etc.

Interfata REST cu solutia SmartCash RMS implementeaza 3 tipuri de metode. Folosind aceste metode este posibila obtinerea de informatii in format JSON, legate de nomenclatoarele primare ale unui lant de magazine, stoc sau documente emise in lantul de magazine, precum si scrierea de date necesare integrarii cu un lant de magazine.

Cele 3 tipuri de metode sunt:

1.Metode de citire (ex. GetArticleInfo, GetModifiedArticles, etc) care au prefixul Get si care permit extragerea de informatii complete sau incrementale despre datele generate intr-un lant de magazine SmartCash. Metodele de citire folosesc numai comanda HTTP GET.

2.Metoda universala de confirmare si de prelucrare a datelor primite folosind metode de tip GetModified…, ConfirmReceivingDataByTypeOf. Metoda universala de confirmare foloseste comanda HTTP POST.

3.Metode de scriere de date in baza de date SmartCash (ex. AddNewInternalDelivery sau SaveCustomer). Metodele de scriere folosesc comanda HTTP POST.

O metoda REST SmartCash de citire, poate fi apelata cu o comanda HTTP GET folosind urmatoarea sintaxa:

https://<Nume_sau_IP_Server>:<Port>/<Adresa_Endpoint>/<Nume_Metoda>/<Param1>/<Param2>/…/ParamN

<Nume_sau_IP_Server> = Numele complet calificat al serverului web in internet sau adresa IP statica a acestuia

<Port> = Portul TCP la care asculta serverul web. In cazul in care portul este 443 (HTTPS) atunci nu mai e necesara specificarea sa.

<Adresa_Endpoint> = Pentru implementari normale aceasta adresa (cale) lipseste. Daca insa pe acelasi server web sunt gazduite mai multe instante/tipuri de servicii REST aceasta e diferita de la o instanta la alta.

<Nume_Metoda> = Denumirea metodei ce se doreste a fi utilizata (ex: GetArticleInfo)

<Param1…ParamN> = Parametrii de input solicitati de metoda respectiva pentru a putea fi executata. Fiecare parametru este separat de urmatorul printr-un “/”. Parametrii trebuiesc furnizati in cadrul URL-ului in ordinea asteptata de metoda respectiva, corespunzator prezentei documentatii.

De retinut ca parametrii si calea din URL cu exceptia numelui de server, sunt “case sensitive”, prin urmare trebuie respectate literele mari sau mici din numele fiecarei metode.

O metoda REST SmartCash de scriere, ce admite parametru complex de tip JSONObject poate fi apelata cu o comanda POST folosind serverul si portul corespunzatoare si urmatoarea sintaxa aproximativa (dependenta de mediul de dezvoltare):

POST …/%22<Nume_Metoda>%22

....

Accept: application/json

Content-Type: text/plain;charset=UTF-8

{… Parametru JSON …}

%22<Nume_Metoda>%22= Denumirea metodei ce se doreste a fi utilizata (ex: GetArticleInfo) incadrata intre caracter de tip (%22) – quotat.

{… Parametru JSON…} = Sirul formatat JSON, corespunzator fiecarei metode de scriere in parte.

Metoda REST SmartCash universala de confirmare, poate fi apelata cu o comanda POST folosind serverul si portul corespunzatoare si urmatoarea sintaxa aproximativa (dependenta de mediul de dezvoltare):

POST /%22<Nume_Metoda>%22/<Param1>/<Param2>/./ParamN

%22<Nume_Metoda>%22= Denumirea metodei ce se doreste a fi utilizata incadrata intre caracter de tip (%22) – quotat.

Ultima actualizare: Rev.1.105 din 15.01.2026

SmartCash Everywhere REST Server versiunea 14.1.0

Prezentare Generala

Prezentare Generala