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 actualizarea articolelor catre clienti.

TJSONObject

Camp

Descriere

Camp Obligatoriu

Tip Date

IDSMARTCASH

Codul unic al articolului 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 de indentificare unica a unui articol in baza de date a aplicatiei terte. Transmiterea sa este obligatorie.

DA

String

ARTICLE_DESCRIPTION

Descrierea principala articolului, echivalentul campului Denumire Principala din SmartCash. Se ia totdeauna in considerare pentru articole care nu exista inca in baza de date a SmartCash si este deci obligatoriu la prima aparitie a articolului. (doar la insert). Campul poate fi luat in considerare optional (daca este setata optiunea in SmartCash) si in cazul in care articolul exista deja in baza de date SmartCash. (modificare denumire din exterior). Poate avea maxim 250 caractere.

DA/NU

String

ARTICLE_DESCRIPTION_1

Descrierea optionala 1 a articolului, echivalentul campului Descriere Secundara din SmartCash. Se ia totdeauna in considerare pentru articole care nu exista inca in baza de date a SmartCash. (doar la insert). Campul poate fi luat in considerare optional (daca este setata optiunea in SmartCash) si in cazul in care articolul exista deja in baza de date SmartCash. (modificare denumire din exterior). Poate avea maxim 120 caractere.

NU

String

ARTICLE_DESCRIPTION_2

Descrierea optionala 2 a articolului, echivalentul campului Detalii din SmartCash. Se ia totdeauna in considerare pentru articole care nu exista inca in baza de date a SmartCash. (doar la insert). Campul poate fi luat in considerare optional (daca este setata optiunea in SmartCash) si in cazul in care articolul exista deja in baza de date SmartCash. (modificare denumire din exterior). Poate avea maxim 120 caractere.

NU

String

ARTICLE_NOTE

Observatii optionale articol. Echivalentul campului Observatii din SmartCash. Se ia totdeauna in considerare pentru articole care nu exista inca in baza de date a SmartCash. (doar la insert). Campul poate fi luat in considerare optional (daca este setata optiunea in SmartCash) si in cazul in care articolul exista deja in baza de date SmartCash. (modificare denumire din exterior). Poate avea maxim 1000 caractere.

NU

String

SALECODE

Codul de bare utilizat la vanzarea articolului. Campul este luat in considerare doar pentru articolele care nu sunt cuplate deja dupa IDEXTAPP. Pentru un articol existent deja cuplat in nomenclatorul clientului este ignorat.

DA/NU

String

ISDEFAULT_CODE

Daca campul este furnizat, codul SALECODE devine codul implicit (principal) si in SmartCash RMS.

NU

Integer

SALE_UM

Unitatea de masura a articolului in unitarea de vanzare SmartCash (Ex. Buc.).

DA

String

ALTERNATE_UM

Unitatea de masura alternativa a articolului utilizata pentru afisarea pretului unitar pe raft. (ex Gris SALE_UM=1 Buc, ALTERNATE_UM=kg, ALTERNATE_UM_RATIO=0.5, pentru un pachet de gris de jumatate de kg)

NU

String

ALTERNATE_UM_RATIO

Cantitatea din articol exprimata in unitatea de vanzare alternativa care corespunde unei unitati de vanzare. (ex Gris SALE_UM=1 Buc, ALTERNATE_UM=kg, ALTERNATE_UM_RATIO=0.5, pentru un pachet de gris de jumatate de kg)

NU

Float

SUPP_UM

Unitatea de masura de aprovizionare valabila la livrarea din sistemul extern (Ex. Bax).

DA

String

SUPP_UM_RATIO

Numarul de articole exprimate in unitatea de vanzare din SmartCash care incap intr-o unitate de livrare a aplicatiei externe. (Ratia dintre SALE_UM si SUPP_UM). (ex: 12 Buc/Bax, ratia = 12).

DA

Integer

ISFRACTIONABLE

Flag care poate avea valoarea 0 sau 1. Daca are valoarea 1 articolul este cantaribil (se vinde fractionat cu precizie maxima de 3 zecimale; Ex. 12.575 Kg). Daca are valoarea 0 articolul se vinde totdeauna in cantitati intregi (Ex. 5 Buc). Daca campul nu este furnizat se considera implicita valoarea 0.

DA

Integer

VAT_PERCENT

Procentul de TVA.

DA

Float

LISTED

Reprezinta faptul ca acest articol este sau nu listat pentru comenzi de la furnizor. (furnizorul nu mai doreste sa se comande pe codul respectiv). 1=Listat, 0=Delistat.

DA

Integer

SUPP_QTY_MIN_ORDER

Cantitatea minima de comanda in unitatea de vanzare a unitatea de masura de vanzare valabila in sistemul clientului.

NU

Float

SUPP_QTY_PALET_LINE

Cantitatea unui palet in unitatea de masura de vanzare valabila in sistemul clientului.

NU

Float

SUPP_CATEGORY_1

Clasificarea dupa criteriul de grupare nr. 1 a articolelor folosita la raportare vanzari. Camp optional.

NU

String

SUPP_CATEGORY_2

Clasificarea dupa criteriul de grupare nr. 2 a articolelor folosita la raportare vanzari. Camp optional.

NU

String

SUPP_CATEGORY_3

Clasificarea dupa criteriul de grupare nr. 3 a articolelor folosita la raportare vanzari. Camp optional.

NU

String

SALE_UM_AQPRICE

Pretul de achizitie in unitatea de masura de vanzare valabila in sistemul clientului (Pret/Buc). Campul este luat in considerare doar daca este furnizat si este  completat  si campul AQPRICE_BEGIN_DATE cu o data valida.

DA/NU

Float

SUPP_UM_AQPRICE

Pretul de achizitie in unitatea de masura valabila in sistemul de livrari al furnizorului (Pret/Bax). Campul este luat in considerare doar daca este completat campul AQPRICE_BEGIN_DATE cu o data valida. Luat in considerare numai in cazul in care nu este furnizat campul SALE_UM_AQPRICE.

DA/NU

Float

AQPRICE_BEGIN_DATE

Data de inceput a valabilitatii pretului de achizitie. Este obligatorie daca este furnizat unul din campurile SALE_UM_AQPRICE  sau SUPP_UM_AQPRICE.

DA/NU

DateTime

AQPRICE_END_DATE

Data de sfarsit a valabilitatii pretului de achizitie. Poate sa fie nula. In acest caz valabilitatea pretului de achizitie este infinita. Campul este luat in considerare doar daca este completat campul AQPRICE_BEGIN_DATE cu o data valida.

DA/NU

DateTime

ARTICLE_CATEGORY_1

Categoria dupa criteriul nr. 1 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 1 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_2

Categoria dupa criteriul nr. 2 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 2 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_3

Categoria dupa criteriul nr. 3 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 3 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_4

Categoria dupa criteriul nr. 4 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 4 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_5

Categoria dupa criteriul nr. 5 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 5 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_6

Categoria dupa criteriul nr. 6 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 6 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_7

Categoria dupa criteriul nr. 7 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 7 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_8

Categoria dupa criteriul nr. 8 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 8 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_9

Categoria dupa criteriul nr. 9 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 9 de clasificare.

DA/NU

String

ARTICLE_CATEGORY_10

Categoria dupa criteriul nr. 10 de clasificare din SmartCash. Camp optional. Daca nu este furnizat sau este furnizat fara valoare campul este ignorat. Daca are valoarea rezervata ’0’ (sirul zero) articolul va fi declasificat dupa criteriul numarul 10 de clasificare.

DA/NU

String

ARTICLE_TYPE

Tip articol. Campul are valoarea 0 pentru articole principale, 1 pentru Taxa Verde, 2 pentru ambalaje generice, 3 pentru ambalaje reciclabile si 4 pentru articole principale RetuRo. In cazul in care campul nu este furnizat este asociata automat valoarea 0. Daca nu se folosesc articole asociate campul nu va fi furnizat deloc.

Pentru un articol de tip 4 trebuie obligatoriu furnizat un articol asociat de tip ambalaj (ARTICLE_TYPE = 2) in campul IDSMARTCASH_ASSOCIATED_ARTICLE sau IDEXTAPP_ASSOCIATED_ARTICLE.

DA/NU

Integer

SGR_CODE

Campul reprezinta codul de bare SGR alocat in sistemul RetuRo pentru produsul cu ambalaj reciclabil.

Campul trebuie furnizat obligatoriu pentru articole de tip ARTICLE_TYPE=3 si trebuie sa fie unic. Nu trebuie furnizat pentru articole cu ARTICLE_TYPE<>3. In acest caz programul va ridica o exceptie.

DA/NU

String

IDSMARTCASH_ASSOCIATED_ARTICLE

Codul unic al articolului asociat la articolul curent in sistemul SmartCash. Transmiterea sa nu este obligatorie. Daca nu se folosesc articole asociate campul nu va fi furnizat deloc.

DA/NU

Integer

IDEXTAPP_ASSOCIATED_ARTICLE

Codul articolului asociat la articolul curent in sistemul extern. In cazul in care se folosesc articole asociate transmiterea acestui camp este obligatorie. Daca nu se folosesc articole asociate campul nu va fi furnizat deloc.

Daca se doreste dezasocierea unui articol deja asociat, acest camp va fi furnizat cu valoarea 0.

DA/NU

String

RESTRICTION_1

Restrictia 1 la vanzare articol. Aceasta restrictie se refera la varsta cumparatorului care trebuie sa fie de minim 18 ani. Are valoarea 0 pentru fara restrictie si 1 pentru verificarea varstei. Ex Alcool sau tutun.

NU

Integer

RESTRICTION_2

Restrictia 2 la vanzare articol. Nu se foloseste.

NU

Integer

RESTRICTION_3

Restrictia 3 la vanzare articol. Nu se foloseste.

NU

Integer

COMPOSED_ARTICLE_TYPE

Tip articol. Campul are valoarea 0 pentru articol Standard, 1 pentru articol Generic si 2 pentru articol Variatie a unui articol Generic.

DA/NU

Integer

IDSMARTCASH_GENERIC_ARTICLE

Codul unic al articolului Generic la care este asociat articolul curent in sistemul SmartCash. Transmiterea sa nu este obligatorie. Daca acest articol nu este o variatie campul nu va fi furnizat deloc.

DA/NU

Integer

IDEXTAPP_GENERIC_ARTICLE

Codul articolului Generic la care este asociat articolul curent in sistemul extern. Transmiterea sa nu este obligatorie. Daca acest articol nu este o variatie campul nu va fi furnizat deloc.

DA/NU

String

TYPEOF_PRICE_GENERIC

Tipul de politica comerciala a variatiilor acestui articol. Campul are valoarea 0 pentru Politica comerciala stabilita de Articolul Generic si 1 pentru Politica comerciala independenta de Articolul Generic.

DA/NU

Integer

ACCOUNTING_CODE

Codul categoriei contabile din care articolul curent face parte. Daca nu este furnizat este pus automat pe valoarea 1 = Marfa. El este ignorat la modificare. Pentru a putea fi utilizat codul contabil trebuie sa existe in nomenclatorul SmartCash de clase contabile.

DA/NU

String

IS_EXCLUDE_CHECK_WEIGHT

Produs exceptat de la verificarea greutatii nete.

NU

Integer

IS_REQUIRE_PACK

Necesita selectie ambalaj la vanzarea prin POS.

NU

Integer

ITEM_REAL_WEIGHT

Greutatea nominala a articolului.

NU

Float

ITEM_LENGTH

Lungimea articolului.

NU

Float

ITEM_WIDTH

Latimea articolului.

NU

Float

ITEM_HEIGHT

Inaltimea articolului.

NU

Float

NC_CODE

Codul vamal NC.

NU

String

CPV_CODE

Codul CPV SEAP.

NU

String

RETAIL_SALE_PRICES (Nu se mai foloseste)

CLUSTERED_PROPERTIES

Subarray care contine proprietati ce pot fi aplicate diferentiat pe magazinele unei retele SmartCash, in functie de clusterul de atribute la care acestea sunt asociate.

In interiorul array-ului se trimit campuri a caror componenta este descrisa in tabelul urmator.

Daca nodul CLUSTERED_PROPERTIES nu este completat deloc informatia legata de campurile acestuia este ignorata.

In cazul utilizarii nodului daca campul CLUSTER_CODE nu este furnizat, proprietatile se refera la catalogul general SmartCash.

Cand campul CLUSTER_CODE este furnizat proprietatile (campurile) se refera la clusterul de atribute cu codul respectiv din SmartCash si isi produce efectul asupra tuturor magazinelor alocate la acel cluster.

In cazul in care campul PRICE din subarray nu este furnizat, iar articolul nu exista in catalogul SmartCash si trebuie inserat, la inserarea noului articol este folosit pe catalogul general ca pret de vanzare valoarea 1.

DA/NU

Array

ADDITIONAL_SALE_CODES

Subarray care contine o lista de coduri de vanzare echivalente (in afara celui furnizat in campul. Daca nodul ADDITIONAL_SALE_CODES nu este completat deloc informatia legata de codurile echivalente este ignorata. In cazul utilizarii nodului este obligatorie adaugarea a cel putin unui cod SALECODE unic.

DA/NU

Array

Camp

Descriere

Camp Obligatoriu

Tip Date

NRSHOP

Campul nu mai este folosit si a fost inlocuit cu CLUSTER_CODE.

Numarul magazinului pentru care este valabil pretul PRICE si discountul DISCOUNT. In cazul in care exista, pretul PRICE va fi aplicat exclusiv pe lista alternativa de pret SmartCash pentru magazinul respectiv.
In cazul modificarii simultane a listelor de preturi alternative pentru mai multe magazine, tripletul NRSHOP, PRICE, DISCOUNT trebuie repetat in cadrul array-ului pentru fiecare magazin in parte.
Daca numarul de magazin NRSHOP coincide cu al centralei de magazine din reteaua SmartCash lista de preturi generala este actualizata.
Daca numarul de magazin nu exista in lista SmartCash este ridicata o exceptie.
In cazul unui articol nou inexistent in sistemul SmartCash trebuie furnizata o inregistrare completa de pret corespunzatoare numarului de magazin NRSHOP al centralei. In caz contrar la inserarea noului articol va fi folosita valoarea 1 pentru pret de pe lista generala.

DA

Float

CLUSTER_CODE

Codul Clusterului de atribute alternative din SmartCash pentru care se doreste modificarea campurilor furnizate in array. La un Cluster de atribute din SmartCash pot fi asociate mai multe magazine, iar campurile furnizate pentru cluster isi produc efectul la toate magazinele asociate. Pentru a putea fi actualizate, campurile din array trebuie sa fie definite si in cadrul clusterului de atribute. Campurile care nu exista vor fi ignorate.

Daca CLUSTER_CODE nu e furnizat dar exista campuri cu date in array, acestea isi produc efectul asupra Catalogului General SmartCash.

DA/NU

String

PRICE

Pretul de vanzare de raft inclusiv TVA in unitatea de masura de vanzare valabila in sistemul SmartCash (Pret/Buc). Pretul este valabil exclusiv pentru clusterul transmis (sau catalogul general). Se ia totdeauna in considerare pentru articole care nu exista inca in baza de date a SmartCash. (doar la insert). Campul poate fi luat in considerare optional (daca este setata optiunea in SmartCash) si in cazul in care articolul exista deja in baza de date SmartCash.(modificare pret vanzare din exterior).

DA/NU

Float

LISTED_SHOP

Reprezinta faptul ca acest articol este sau nu listat pentru efectuarea de documente (intrari sau iesiri) cu el. 1=Listat, 0=Delistat.

DA/NU

Integer

DISCOUNT

Discountul procentual de articol. Campul se comporta identic cu PRICE.

DA/NU

Float

DISCOUNT_TYPE

Tip discount. Campul are valoarea 0 pentru acordare discount indiferent de cantitatea cumparata, 1 pentru discount incepand cu cantitatea minima cumparata exprimata in campul QTY_MIN_DISCOUNT si 2 pentru discount de multipli de cantitate minima cumparata exprimata in campul QTY_MIN_DISCOUNT.

DA/NU

Integer

QTY_MIN_DISCOUNT

Cantitate minima/multipla pentru acordare discount.

DA/NU

Float

IDSMARTCASH_SUPPLIER

ID-ul unic al furnizorului implicit asociat la articol. Daca se trimite valoarea zero se dealoca furnizorul existent.

NU

Integer

IDEXTAPP_SUPPLIER

Codul extern al furnizorului implicit asociat la articol. Daca se trimite valoarea zero se dealoca furnizorul existent.

NU

String

IDSMARTCASH_STORE

ID-ul unic al magazinului implicit asociat la articol. Daca se trimite valoarea zero se dealoca furnizorul existent.

NU

Integer

IDEXTAPP_STORE

Codul extern al magazinului implicit asociat la articol. Daca se trimite valoarea zero se dealoca furnizorul existent.

NU

String

IS_SALE_SUSPENDED

Flag care semnalizeaza daca articolul este suspendat de la vanzare. Valoarea 0 = Liber la Vanzare si 1 – Blocat la Vanzare.

NU

Integer

IS_PROMO_PRICE

Flag care semnalizeaza daca pretul de vanzare PRICE este unul promotional. Valoarea 0 = pretul e standard, 1 = pretul este promotional. Pentru articolele cu discount DISCOUNT <> 0, acest camp are totdeauna valoarea 1.

NU

Integer

IS_ORDER_SUSPENDED

Flag care semnalizeaza daca articolul este suspendat de la comenzi de aprovizionare. Valoarea 0 = Liber la aprovizionare si 1 – Blocat la aprovizionare.

NU

Integer

IS_DISCOUNT_SUSPENDED

Flag care semnalizeaza daca articolul este suspendat de la discount-uri. Valoarea 0 = discount permis si 1 – discount blocat.

NU

Integer

IS_T5

Activare/dezactivare program de fidelizare de tipar 5 pentru articol. Are valoarea 0 pentru dezactivare si 1 pentru activare.

NU

Integer

DISCOUNT_T5

Discountul acordat pentru clientii inclusi in programul de fidelizare de Tipar 5.

NU

Float

DISCOUNT_TYPE_T5

Mod aplicare DISCOUNT_T5 pentru programul de fidelizare de Tipar 5. Campul are valoarea 0 pentru acordare discount indiferent de cantitatea cumparata, 1 pentru discount incepand cu cantitatea minima cumparata exprimata in campul QTY_MIN_DISCOUNT_T5 si 2 pentru discount de multipli de cantitate minima cumparata exprimata in campul QTY_MIN_DISCOUNT_T5.

NU

Integer

QTY_MIN_DISCOUNT_T5

Cantitate minima/multipla pentru acordare discount pentru programul de fidelizare de Tipar 5.

NU

Float

TRADE_MARKUP

Adaos comercial de referinta.

NU

Float

IS_MODIFICARE_HOLD

Flag care semnalizeaza daca se permite modificarea articolului prin intermediul SmartCash Everywhere. Valoarea 0 = se permite modificarea si 1 – nu se permite modificarea.

NU

Integer

WARNING_STOCK

Stocul de Atentionare, atunci cand se foloseste metoda de aprovizionare bazata pe stoc optim/stoc atentionare. Stocul de atentionare este valoarea la care trebuie sa ajunga stocul curent pentru ca produsul sa fie adaugat pe o noua comanda la furmizor.

NU

Float

OPTIMAL_STOCK

Stocul Optim atunci cand se foloseste metoda de aprovizionare bazata pe stoc optim/stoc atentionare. Stocul Optim este valoarea pana la care trebuie sa ajunga stocul curent in urma aprovizionarii, diferenta fata de stocul curent fiind adaugata pe o noua comanda la furmizor.

NU

Float

NORMAL_LABEL_CODE

Codul formatului de eticheta corespunzator articolelor care NU se afla in promotie.

NU

String

PROMO_LABEL_CODE

Codul formatului de eticheta corespunzator articolelor care se afla in promotie.

NU

String

HD_LABEL_CODE

Codul formatului de eticheta corespunzator articolelor care se afla in hard discount.

NU

String

IS_ESLLABEL

Flag care semnalizeaza daca articolul foloseste etichete electronice ESL. Valoarea 0 = nu foloseste si 1 – Foloseste.

NU

Integer

ID_ESL_TEMPLATE

ID-ul sablonului de eticheta electronica ESL.

NU

Integer

Camp

Descriere

Tip Date

RETURN

Reprezinta rezultatul faptului ca functia a reusit sa scrie in baza de date actualizarea de articole. Poate avea valoarea True in caz de succes si False in caz de esec.

Boolean