GetArticleInfo

<< Click pentru afișare cuprins >>

Navigare:  SmartCash Everywhere REST Server > Metode de citire SmartCash Everywhere REST Server > Metode de citire pentru nomenclatoare primare >

GetArticleInfo

Metoda GetArticleInfo este  utilizata pentru intoarcerea tuturor informatiilor disponibile despre un articol din nomenclatorul de produse. Daca articolul este cautat dupa codul dvs. din aplicatie (IDEXTAPP) si acesta nu este unic asociat in SmartCash, atunci sunt intoarse toate articolele care corespund aceluiasi cod. Pentru cautarile dupa IDSMARTCASH totdeauna rezultatul este unic sau vid (daca nu exista nici un articol corespunzator).

 

Parametri Apel

Parametru

Descriere

Tip Date

aIDAPP

ID unic alocat aplicatiei care se conecteaza la serverul REST SmartCash

Integer

aTypeOf

Flag care specifica tipul de cod dupa care se face cautarea articolului in baza de date Smartcash RMS. Daca aTypeOf=1 cautarea se face dupa IDSMARTCASH, codul unic SmartCash pentru orice articol (Camp ARTNR SmartCash) si totdeauna poate fi returnata doar o singura linie (un singur articol). Daca aTypeOf=2 cautarea se face dupa IDEXTAPP, codul de produs din aplicatia dvs., (camp Detalii SmartCash). In acest caz, daca ati alocat codul extern la mai mult de un singur articol in baza SmartCash, vor putea fi returnate mai multe articole, corespunzand la acelasi cod extern. Daca aTypeOf=3 cautarea se face dupa un cod de bare asociat articolului. Acesta trebuie furnizat complet (inclusiv caracterul suma de control in cazul codurilor EAN).

Integer

aNrShop

Numarul de magazin din reteaua SmartCash cu a carui lista de preturi de vanzare este mapata aplicatia terta.

Integer

aValueSearch

Valoarea codului IDSMARTCASH sau IDEXTAPP dupa care se face cautarea corespunzator flag-ului aTypeOf.

String

 

Campuri JSON returnate

Camp

Descriere

Tip Date

RECVERSION

Versiunea ultimei modificari a fiecarei inregistrari. Valoarea se ignora in cazul acestei metode.

Integer

IDSMARTCASH

Codul unic al articolului in sistemul SmartCash (camp ARTNR intern)

Integer

IDEXTAPP

Codul articolului in sistemul extern

String

SALECODE_NAME

Denumirea tipului de cod folosit la identificarea comerciala a produsului (ex: EAN-13, EAN-8, PLU)

String

SALECODE

Codul folosit la identificarea comerciala a produsului (ex: 6420387148210). Pentru codurile EAN acesta include si caracterul de control.

String

NAME

Denumirea principala a articolului

String

DESCRIPTION

Descrierea secundara scurta a articolului

String

DETAILS

Descrierea secundara scurta a articolului

String

NOTES

Observatii de tip text cu lungime mare, despre produs (ex: ingrediente, instructiuni de utilizare, etc)

String

LISTED

Flag care semnalizeaza daca articolul este listat sau delistat de la vanzare, in magazinul cu numarul aNrShop. Valoarea 0 = Delistat si 1 – Listat. (pentru aceasta metoda flagul are mereu valoarea 1)

Integer

DIVISIBLE

Flag care semnalizeaza daca articolul poate sau nu sa fie vandut fractionat (ex: fractionabil la Kg  = 0,65 sau doar bucati intregi). Valoarea 0 = Nefractionabil si 1 – Fractionabil.

Integer

SALE_UM

Denumirea unitatii de masura folosite la vanzarea produsului in SmartCash

String

ALT_UM

Denumirea unitatii de masura alternative din sistemul retail (ex: SALE_UM=Buc si ALT_UM=Kg)

String

ALT_UM_RATIO

Ratia de diviziune a unitatii de vanzare in unitate alternativa. (Ex: SALE_UM=Buc, ALT_UM=Kg, ALT_UM_RATIO=0,5 – inseamna ca o bucata cantreste 0,5 Kg in unitatea alternativa)

Float

SUPP_UM

Denumirea unitatii de masura folosita la aprovizionare. (Ex: Bax)

String

SUPP_UM_RATIO

Ratia de multiplicare a unitatii de vanzare 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)

Float

PRICE

Pretul de vanzare inclusiv TVA, corespunzator articolului respectiv, din magazinul cu numarul aNrShop.

Float

VAT_VALUE

Valoarea cotei procentuale de TVA pentru articolul respectiv (ex: 24 pentru TVA=24%)

Float

VAT_LETTER

Litera corespunzatoare din echipamentul fiscal pentru cota de TVA VAT_VALUE (ex: A, B, C, D, E)

String

DISCOUNT

Procentul de discount acordat pentru articolul respectiv la vanzare, din magazinul cu numarul aNrShop. O valoare cu – (minus) inseamna reducere iar una pozitiva inseamna majorare procentuala.

Float

DISCOUNT_2

Procentul de discount prag 2 acordat pentru articolul respectiv la vanzare, din magazinul cu numarul aNrShop. O valoare cu – (minus) inseamna reducere iar una pozitiva inseamna majorare procentuala.

Float

DISCOUNT_3

Procentul de discount prag 3 acordat pentru articolul respectiv la vanzare, din magazinul cu numarul aNrShop. O valoare cu – (minus) inseamna reducere iar una pozitiva inseamna majorare procentuala.

Float

DISCOUNT_4

Procentul de discount prag 4 acordat pentru articolul respectiv la vanzare, din magazinul cu numarul aNrShop. O valoare cu – (minus) inseamna reducere iar una pozitiva inseamna majorare procentuala.

Float

IS_DISCOUNT_SUSPENDED

Flag care semnalizeaza daca articolul este suspendat de la orice tip de discount, in magazinul cu numarul aNrShop. Valoarea 0 = Liber la Discount si 1 – Blocat la Discount.

Integer

DISCOUNT_TYPE

Flag care semnalizeaza modul de acordare a discountului, in magazinul cu numarul aNrShop. Valori posibile: 0 = discountul se acorda intotdeauna, 1 = discountul se acorda doar dupa depasirea cantitii minime cumparate returnata in campul DISCOUNT_RATIO, 2 = discountul se acorda doar pentru multipli de DISCOUNT_RATIO (din x in x).

Integer

DISCOUNT_RATIO

Cantitatea minima ce trebuie cumparata pentru aplicarea unui discount, in magazinul cu numarul aNrShop. Valoare este interpretata in conformitate cu specificatiile campului DISCOUNT_TYPE.

Integer

DISCOUNT_RATIO_2

Cantitatea minima prag 2 ce trebuie cumparata pentru aplicarea DISCOUNT_2, in magazinul cu numarul aNrShop. Valoare este interpretata in conformitate cu specificatiile campului DISCOUNT_TYPE.

Integer

DISCOUNT_RATIO_3

Cantitatea minima prag 3 ce trebuie cumparata pentru aplicarea DISCOUNT_3, in magazinul cu numarul aNrShop. Valoare este interpretata in conformitate cu specificatiile campului DISCOUNT_TYPE.

Integer

DISCOUNT_RATIO_4

Cantitatea minima prag 4 ce trebuie cumparata pentru aplicarea DISCOUNT_4, in magazinul cu numarul aNrShop. Valoare este interpretata in conformitate cu specificatiile campului DISCOUNT_TYPE.

Integer

CATEG_1

Denumirea categoriei dupa criteriul de clasificare 1.

String

CATEG_2

Denumirea categoriei dupa criteriul de clasificare 2.

String

CATEG_3

Denumirea categoriei dupa criteriul de clasificare 3.

String

CATEG_4

Denumirea categoriei dupa criteriul de clasificare 4.

String

CATEG_5

Denumirea categoriei dupa criteriul de clasificare 5.

String

CATEG_6

Denumirea categoriei dupa criteriul de clasificare 6.

String

CATEG_7

Denumirea categoriei dupa criteriul de clasificare 7.

String

CATEG_8

Denumirea categoriei dupa criteriul de clasificare 8.

String

CATEG_9

Denumirea categoriei dupa criteriul de clasificare 9.

String

CATEG_10

Denumirea categoriei dupa criteriul de clasificare 10.

String

IDSMARTCASH_LASTSUPPLIER

Codul unic al ultimului furnizor cronologic in sistemul SmartCash.

Integer

IDEXTAPP_LASTSUPPLIER

Codul ultimului furnizor cronologic in sistemul extern.

String

LASTSUPPLIER

Numele ultimului furnizor cronologic in sistemul SmartCash.

String

LASTSUPPLY_DATE

Data ultimei achizitii de la furnizorul LASTSUPPLIER.


LASTSUPPLY_NIR

Numarul Notei de Intrare Receptie (NIR) de la ultima achizitie.


LASTSUPPLY_UNIT_COST

Pretul de achizitie unitar al articolului respectiv la ultima achizitie (nu include TVA).

Float

LASTSUPPLY_QTY

Cantitatea receptionata la ultima achizitie.

Float

IDSMARTCASH_ASSOCIATED_ARTICLE

Codul unic al articolului in sistemul SmartCash (camp ARTNR intern) al articolului asociat.

Integer

ACCOUNTING_CODE

Codul categoriei contabile din care articolul curent face parte, implicit valoarea 1 = Marfa, 2 = Materie Prima.

String

NORMAL_LABEL_CODE

Codul formatului de eticheta corespunzator articolelor care NU se afla in promotie, din magazinul cu numarul aNrShop.

String

PROMO_LABEL_CODE

Codul formatului de eticheta corespunzator articolelor care se afla in promotie, din magazinul cu numarul aNrShop.

String

HD_LABEL_CODE

Codul formatului de eticheta corespunzator articolelor care se afla in hard discount, din magazinul cu numarul aNrShop.

String

IS_ESLLABEL

Flag care semnalizeaza daca articolul foloseste etichete electronice ESL, din magazinul cu numarul aNrShop. Valoarea 0 = nu foloseste si 1 – Foloseste.

Integer

ID_ESL_TEMPLATE

ID-ul sablonului de eticheta electronica ESL, din magazinul cu numarul aNrShop.

Integer

IDEXTAPP_ASSOCIATED_ARTICLE

Codul articolului asociat la articolul curent in sistemul extern

String

IS_SALE_SUSPENDED

Flag care semnalizeaza daca articolul este suspendat de la vanzare, din magazinul cu numarul aNrShop. Valoarea 0 = Liber la Vanzare si 1 – Blocat la Vanzare.

Integer

IS_PROMO_PRICE

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

Integer

ARTICLE_TYPE

Tip articol. Campul are valoarea 0 pentru articole principale, 1 pentru Taxa Verde si 2 pentru ambalaje.

Integer

ARTICLE_KIND

Tip general articol. Campul are valoarea 0 pentru articole Standard, 1 pentru articole Generice (master pentru variatii) si 2 pentru Variatii ale articolelor Generice.

Integer

IDSMARTCASH_GENERIC_ARTICLE

Codul unic al articolului in sistemul SmartCash (camp ARTNR intern) al articolului generic la care articolul variatie este asociat. Campul are valoare doar pentru articole de tip Variatie (ARTICLE_KIND = 2).

Integer

GENERIC_ARTICLE_PRICE_METHOD

Metoda de aplicare a politicilor comerciale dinspre articolul Generic catre Variatiile lui. Campul are valoarea 0 atunci cand politicile comerciale ale variatiilor sunt identice cu ale articolului Generic si 1 atunci cand politicile comerciale ale variatiilor sunt independente de articolul Generic. Campul are valoare doar pentru articole de tip Generic (ARTICLE_KIND = 1).

Integer

 

 

Campuri JSON returnate pe nodul ITEM_CODES

Camp

Descriere

Tip Date

SALECODE

Lista codurilor de vanzare alternative pentru articolul curent. Contine perechi de campuri SALECODE_NAME si SALECODE. Unul dintre acestea se regaseste si in lista de proprietati generale a articolului curent. Lista are mai multi termeni doar in cazul codificarii multiple.

String

SALECODE_NAME

Denumirea tipului de cod folosit la identificarea comerciala a produsului (ex: EAN-13, EAN-8, PLU sau EXT). Codurile EXT pot fi alfanumerice cu maxim 30 caractere.

String

 

 

Campuri JSON returnate pe nodul ITEM_ATTRIBUTES

Camp

Descriere

Tip Date

IDSMARTCASH_ATTRIBUTE

ID-ul unic al atributului din sistemul SmartCash RMS.

Integer

CODE_ATTRIBUTE

Codul alocat de catre utilizator atributului.

String

NAME_ATTRIBUTE

Denumirea atributului.

String

ORDER_INDEX_ATTRIBUTE

Indexul de ordonare al atributului din sistemul SmartCash RMS.

Integer

IDSMARTCASH_TERM

ID-ul unic al termenului atributului din sistemul SmartCash RMS.

Integer

ISMANDATORY

Semnalizeaza faptul ca atributul este obligatoriu sau nu. In cazul in care are valoarea 1 atunci atributul este folosit pentru generarea de variatii (atribut obligatoriu). In cazul in care are valoarea zero atunci atributul poate fi folosit doar pentru filtari si nu poate fi folosit la generarea de articole variabile (atribut optional). Atributele optionale pot sau nu sa fie completate la un articol. Cele obligatorii trebuiesc completate la orice articol variabil.

Integer

CODE_TERM

Codul alocat de catre utilizator termenului atributului.

String

NAME_TERM

Denumirea termenului atributului.

String