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

Metoda AddNewInternalTransfer este utilizata pentru transmiterea continutului unui Aviz de Insotire de la o locatie de livrare din interiorul unei retele de magazine SmartCash catre o alta locatie din cadrul aceleiasi retele de magazine. In mod uzual, locatia de livrare este un depozit de marfa intretinut intr-o aplicatie ERP, care este mapata pe o locatie virtuala omoloaga din lantul de magazine SmartCash RMS. Sistemul extern trebuie sa salveze in campuri permanente de date, valoarea corspunzatoare campului NRSHOP din sistemul SmartCash , pentru fiecare magazin sau locatie SmartCash in parte. Acest camp poate fi obtinut pentru unul sau pentru toate magazinele din retea cu una din metodele: GetAllShops, GetModifiedShops sau GetShopInfo. La transmiterea de documente va fi folosit exclusiv acest camp pentru identificarea locatiilor de livrare/receptie.

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 de tip antet incluse in parametrul aJSONObject

Camp	Descriere	Camp Obligatoriu	Tip Date
NRSHOP_SOURCE	Codul magazinului sursa, (virtual) care face livrarea, stabilit de catre utilizatori in sistemul SmartCash. Trebuie furnizat obligatoriu daca nu se foloseste IDEXTAPP.	DA/NU	Integer
NRSHOP_DEST	Codul magazinului destinatie, pentru care este livrarea, stabilit de catre utilizatori in sistemul SmartCash. Trebuie furnizat obligatoriu daca nu se foloseste IDEXTAPP.	DA/NU	Integer
IDEXTAPP_SOURCE	Codul extern al magazinului sursa, (virtual) care face livrarea. Trebuie furnizat obligatoriu daca nu se foloseste NRSHOP.	DA/NU	String
IDEXTAPP _DEST	Codul extern al magazinului destinatie, pentru care este livrarea. Trebuie furnizat obligatoriu daca nu se foloseste NRSHOP.	DA/NU	String
TRANSFER_NUMBER	Seria si Numarul Avizului de insotire concatenate.	DA	String
TRANSFER_DATE	Data Avizului de Insotire	DA	String
ORDER_NUMBER	Numarul comenzii de aprovizionare pentru care se face livrarea	NU	String

Campuri JSON de tip linii articole incluse in parametrul aJSONObject

Camp	Descriere	Camp Obligatoriu	Tip Date
IDSMARTCASH_ARTICLE	Codul unic al articolului in sistemul SmartCash. Daca nu este furnizat atunci obligatoriu trebuie furnizat campul IDEXTAPP_ARTICLE.	DA/NU	Integer
IDEXTAPP_ARTICLE	Codul articolului din sistemul extern. Daca nu este furnizat atunci obligatoriu trebuie furnizat campul IDSMARTCASH_ARTICLE.	DA/NU	String
NAME	Denumirea articolului. Daca nu exista ea ramane necompletata.	DA/NU	String
QTY	Cantitatea livrata in UM de ambalare (SUPP_UM - UM furnizor)	DA	Float
SUPP_UM	Denumirea unitatii de masura folosita la aprovizionare. (Ex: Bax)	DA	String
SUPP_UM_RATIO	Ratia de multiplicare a unitatii de vanzare din sistemul de retail pentru o unitate de aprovizionare. (Ex: SALE_UM=Buc, SUPP_UM=Bax, SUPP_UM_RATIO=12 – inseamna ca un Bax contine 12 Buc din produsul respectiv)	DA	Float
ACQUISITION_COST	Pretul de achizitie fara TVA repartizat pe SUPP_UM	DA	Float
EXPIRE_DATE	Data de expirare a produsului	NU	String
BATCH	Lotul de fabricatie al produsului	NU	String
BATCH_DATE	Data lotului de fabricatie al produsului	NU	String
BATCH_DESCRIPTION	Descrierea lotului de fabricatie al produsului	NU	String

Campuri JSON intoarse in caz de aplicare cu succes

Camp	Descriere	Tip Date
IDTRANSFER	ID-ul unic al avizului proaspat adaugat in sistemul SmartCash (cheia primara crescatoare din tabela respectiva).	Integer

Exemplu de formatare pentru parametrul aJSONObject al metodei AddNewInternalTransfer:

{"NRSHOP_SOURCE":"84","NRSHOP_DEST":"50"," TRANSFER_NUMBER":"ALG 1099911","TRANSFER_DATE":"2014.01.01","ORDER_NUMBER":"AVDDR112",

"ITEMS":

[{"IDSMARTCASH_ARTICLE ":5,

"IDEXTAPP_ARTICLE":"100",

"NAME":"PETROL",

"QTY":1.56,

"SUPP_UM":"BAX",

"SUPP_UM_RATIO":4,

"ACQUISITION_COST":2.56,

"EXPIRE_DATE":"2014.01.18",

"BATCH":"L1",

"BATCH_DATE":"2013.05.24",

"BATCH_DESCRIPTION":"UNIKA-LINE"}]

}

Rezultat JSON returnat in caz de succes:

{"result":{"IDTRANSFER":1,"RETURN":true}}

Campuri JSON returnate in caz de eroare (exemplu):

{"error":"invalid SOURCE"}