SmartCash Everywhere REST Server > Metode de scriere SmartCash Everywhere REST Server

Metoda SaveSupplier este utilizata pentru salvarea sau actualizarea unui nou furnizor in baza de date centrala a unui lant de magazine SmartCash RMS. In cazul unui rezultat pozitiv, furnizorul devine imediat disponibil.

Pentru determinarea unui furnizor deja existent se foloseste urmatorul algoritm:

1.Mai intai se cauta identificarea unui furnizor in sistemul SmartCash RMS dupa IDEXTAPP (camp obligatoriu);

2.In cazul in care nu s-a identificat nici un furnizor existent la pasul 1 atunci se incearca gasirea si dupa campul IDSMARTCASH daca acesta a fost furnizat.

3.Daca in nici o situatie nu a fost gasit un furnizor existent, atunci furnizorul este adaugat in sistemul SmartCash pe baza campurilor transmise.

4.Daca a fost gasit un furnizor existent prin una din metodele de mai sus, atunci informatiile transmise sunt folosite pentru actualizarea campurilor omoloage la furnizorul respectiv in SmartCash RMS. Campurile care nu se doreste a fi actualizate nu trebuiesc furnizate in cadrul parametrului de apel al metodei.

Parametri Apel

Parametru	Descriere	Tip Date
aIDAPP	ID unic alocat aplicatiei care se conecteaza la serverul REST SmartCash	Integer
aJSONObject	Parametru formatat JSON, cu o sintaxa fixa (vezi exemplu), prin care sunt furnizate toate campurile necesare pentru tipul de date adaugat in sistemul SmartCash RMS.	TJSONObject

Campuri JSON incluse in parametrul aJSONObject

Camp	Descriere	Camp Obligatoriu	Tip Date
IDSMARTCASH	Codul unic al furnizorului in sistemul SmartCash. Campul trebuie furnizat doar daca el a fost salvat si in baza de date a aplicatiei terte. Transmiterea sa nu este obligatorie.	NU	Integer
IDEXTAPP	Codul furnizorului in sistemul extern. Trebuie totdeauna furnizat, indiferent daca este o adaugare de furnizor nou sau o actualizare a datelor pentru un furnizor existent. Totdeauna cautarea unui furnizor in cazul acestei metode in sistemul SmartCash incepe cu acest camp si abia apoi dupa campul IDSMARTCASH daca acestea au fost furnizate.	DA	String
NAME	Numele oficial al furnizorului, asa cum se doreste sa apara pe facturi. Daca este furnizat pentru un furnizor existent va modifica valoarea respectiva in sistemul SmartCash.	DA/NU	String
TOWN	Localitatea. Trebuie sa fie transmis totdeauna pentru furnizorii nou inserati. La o actualizare a unui furnizor existent nu este necesar a fi retransmis.	DA/NU	String
PHONE	Nr. de Telefon	NU	String
FAX	Nr. de Fax	NU	String
GLN	Global Location Number pentru furnizorul respectiv (ILN/GLN)	NU	String
EMAIL	Adresa de e-mail a furnizorului.	NU	String
VAT_NUMBER	Codul fiscal al furnizorului. CUI. Trebuie sa fie transmis totdeauna pentru furnizorii nou inserati. La o actualizare a unui furnizor existent nu este necesar a fi retransmis.	DA/NU	String
TRADE_NUMBER	Nr. Registrul Comertului. Trebuie sa fie transmis totdeauna pentru furnizorii nou inserati. La o actualizare a unui furnizor existent nu este necesar a fi retransmis.	DA/NU	String
BANK_ACCOUNT	Numarul contului. Trebuie sa fie transmis totdeauna pentru furnizorii nou inserati. La o actualizare a unui furnizor existent nu este necesar a fi retransmis.	DA/NU	String
BANK_NAME	Numele Bancii la care e deschis contul furnizorului respectiv. Trebuie sa fie transmis totdeauna pentru furnizorii nou inserati. La o actualizare a unui furnizor existent nu este necesar a fi retransmis.	DA/NU	String
ADDRESS	Adresa furnizorului. Trebuie sa fie transmis totdeauna pentru furnizorii nou inserati. La o actualizare a unui furnizor existent nu este necesar a fi retransmis.	NU	String
NOTES	Observatii optionale diverse de tip text.	NU	String
LISTED	Flag care semnalizeaza daca furnizorul este activ sau inactiv. 1=Activ, 0=Inactiv. Se foloseste pentru blocarea („stergerea”) furnizorilor. La adaugarea unui nou furnizor trebuie transmis totdeauna cu valoarea 1=Activ.	DA/NU	Integer

Campuri JSON intoarse in caz de aplicare cu succes

Camp	Descriere	Tip Date
IDSMARTCASH	Codul unic al furnizorului in sistemul SmartCash.	Integer
IDEXTAPP	Codul furnizorului in sistemul extern.	String

Exemplu de formatare pentru parametrul aJSONObject al metodei SaveSupplier:

{"IDSMARTCASH":5,

"IDEXTAPP":"AVTE1098",

"NAME":"CORTINA SRL",

"TOWN":"Bucuresti",

"PHONE":"0754887889",

"FAX":"021457898",

"GLN":"CRI10",

"EMAIL":"email@noemail.ro",

"VAT_NUMBER":"RO1098766",

"TRADE_NUMBER":"J/2099/1987",

"BANK_ACCOUNT":"ROIBME0099887771",

"BANK_NAME":"BCR",

"ADDRESS":"str. Lacramioareleor",

"NOTES":"",

"LISTED":1……}

Campuri JSON returnate in caz de succes:

{"result":{"IDEXTAPP":"AVTE1098","IDSMARTCASH":5,"RETURN":true}}

Campuri JSON returnate in caz de eroare (exemplu):

{"error":"invalid IDEXTAPP"}