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

Metoda AddNewSupplierTransferCorrection este utilizata pentru transmiterea cererilor de corectie a unei livrari de la un furnizor tert catre o locatie din cadrul unei retele de magazine SmartCash. Pentru a putea transmite cereri de corectie catre magazine, sistemul extern trebuie sa salveze in campuri permanente de date, valoarea corspunzatoare campului NRSHOP_DEST 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
IDEXTAPP_SUPPLIER	Codul extern al furnizorului care a emis factura. Trebuie furnizat obligatoriu daca nu se foloseste IDSMARTCASH_SUPPLIER.	DA/NU	String
IDSMARTCASH_SUPPLIER	ID-ul unic SmartCash al furnizorului care a emis factura. Trebuie furnizat obligatoriu daca nu se foloseste IDEXTAPP_SUPPLIER.	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 IDSMARTCASH_SHOP_DEST.	DA/NU	Integer
IDSMARTCASH_SHOP_DEST	ID-ul unic SmartCash al magazinului destinatie, pentru care este livrarea. Trebuie furnizat obligatoriu daca nu se foloseste NRSHOP_DEST.	DA/NU	Integer
ORDER_NUMBER	Numarul comenzii de aprovizionare pentru care se cere corectia.	DA/NU	String
NIR	Numarul Notei de Intrare Receptie (NIR) corespunzatoare.	DA	Integer
DATANIR	Data Notei de Intrare Receptie (NIR) corespunzatoare	DA	String
TYPEOF_DOC	Tipul de document de livrare pentru care se cere corectia. 0 – Factura, 1 – Aviz. Folosit doar pentru verificari. (debug).	DA/NU	Integer
DOC	Numarul Facturii sau Avizului receptionat. Folosit doar pentru verificari. (debug).	DA/NU	String
DATADOC	Data Facturii sau Avizului receptionat. Folosit doar pentru verificari. (debug).	DA/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
RECONCILE_QTY	Cantitatea livrata in UM de ambalare (SUPP_UM - UM furnizor) solicitata de furnizor ca fiind livrata efectiv si transmisa pentru reconciliere catre magazin.	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

Campuri JSON intoarse in caz de aplicare cu succes

Camp	Descriere	Tip Date
IDCORRECTION	ID-ul unic al corectiei proaspat adaugate in sistemul SmartCash (cheia primara crescatoare din tabela respectiva).	Integer

Exemplu de formatare pentru parametrul aJSONObject al metodei AddNewSupplierTransfer:

{"IDSMARTCASH_SUPPLIER":3,"NRSHOP_DEST":"99","DOC":"ALG 1099911","DATADOC":"2016.08.09","ORDER_NUMBER":"AVDDR112","DOC_TOTAL_COST":10,"DOC_TOTAL_COST_VAT":2,

"ITEMS":

[{"IDSMARTCASH_ARTICLE":5,

"IDEXTAPP_ARTICLE":"100",

"NAME":"PETROL",

"VAT_PERCENT":20,

"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"}