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