This is an old revision of the document!
ItemPrices() metoda
Akcija
Metod vraća važeće cene i popuste u skladu sa zadatim parametrima upita.
Sintaksa
ItemPrices (sessToken, [stockID], [groupID], [subgroupID], [itemID], [itemArticle], [itemType], [itemColor], [itemModel], [itemTitle], [itemBarcode], [itemVATCode], [qttMode], [customerID], [priceList], [priceListDate], [recurseGroup], [custDiscID1], [custDiscID2], [custDiscID3], [custDiscID4], [custDiscID5], [priceColumn])
Rezultat
Entitet ItemPrices . Svojstva:
| Naziv | Tip | Opis | Revizija |
|---|---|---|---|
| StockID | Integer | Jedinstveni identifikator skladišta na kojem cenovna struktura važi | 19-6-11 |
| ArtID | Integer | Jedinstveni identifikator artikla na koji se odnosi cena | 19-6-11 |
| Prices | List<PriceStruct> | Kolekcija "PriceStruct" entitet entiteta formirana prema zadatim parametrima metode. | 19-6-11 |
Parametri
| Naziv | Vrsta | Podrazumevana vrednost | Opis | Revizija |
|---|---|---|---|---|
| sessToken | String | nema | Jedinstveni niz znakova dobijen metodom GetToken() koji identifikuje korisničku sesiju. | |
| stockID | int | 0 | Identifikator objekta/skladišta sa kog se vrši prodaja. Spisak objekata/skladišta dobija se metodom StocksAvailable. Parametar se ignoriše ako mu je vrednost 0. | |
| groupID | int | 0 | Jedinstveni identifikator grupe (kataloga) za filtriranje rezultata. Spisak grupa dobija se metodom GroupsAvailable. Ukoliko se preda 0 filter se ignoriše. | |
| subgroupID | int | 0 | Jedinstveni identifikator podgrupe (podkataloga) za filtriranje rezultata. Spisak podgrupa dobija se metodom SubgroupsAvailable. Ukoliko se preda 0 filter se ignoriše. | |
| itemID | int | 0 | Jedinstveni identifikator artikla za filtriranje rezultata. Spisak artikala dobija se metodom ItemsAvailable. Ukoliko se preda 0 filter se ignoriše. Postavka vrednosti ovog parametra može rezultirati sa najviše jednom stavkom rezultata. | |
| itemArticle | String | nema | Filter po tipu artikla (polje Tip). Ukoliko se preda prazan tekst ili ”%” filter se ignoriše. | |
| itemColor | String | nema | Filter po modelu artikla (polje Model). Ukoliko se preda prazan tekst ili ”%” filter se ignoriše. | |
| itemTitle | String | nema | Filter po barkodu artikla. Ukoliko se preda prazan tekst filter se ignoriše. | |
| itemVATCode | String | -1 | Filter po tarifnoj grupi (ID-u poreske tarife). Za vrednosti manje od nula filter se ignoriše. | |
| qttMode | int | nema | Režim filtriranja prema stanju zaliha. Moguće vrednosti su: 0 - stanje zaliha se ignoriše. 1 - prikazuju se samo artikli kojih ima na raspolaganju (zaliha-rezervisano>0). | |
| customerID | int | nema | Identifikacioni broj kupca prema Balans ERP-u. Prosleđivanjem ovog parametra stvaraju se uslovi za analizu posebnih komercijalnih uslova prodaje za konkretnog kupca (posebne rabatne skale, cenovnici, akcije, itd.) Broj nije javno dostupan i ne može se dobiti pozivom Balans Online RT API-ja. Dobija se u proceduri prijave kupca u sistem (login), posebno napravljnoj za B2B Extranet sistem. Vrednost 0 podrazumeva ignorisanje filtera. | |
| priceList | String | nema | Jedinstveni naziv cenovnika koji se koristi za prikaz cena. Ovaj podatak je dostupan iz Balans ERP-a. Balans Online RT API ne dozvoljava listanje dostupnih cenovnika. Podatak se mora dobiti od strane ovlašćenih korisnika Balans ERP-a. Ukoliko se preda prazan tekst filter se ignoriše. | |
| priceListDate | Date | nema | Datum cenovnika čije cene analiziramo. Datum je usko vezan za priceList parametar jer je neophodno da cenovni bude definisan i važeći u priceListDate momentu. | |
| recurseGroup | int | 1 | Pomoćni parametar koji upravlja filterom kada je predat groupID parametar bez subgroupID. Opcije su sledeće: 0 - Filtrirati samo artikle koji pripadaju datoj grupi i nisu razvrstani po podgrupama. 1 - Obuhvatiti artikle koji pripadaju datoj grupi i svim podgrupama u okviru nje. | |
| custDiscID1 | int | 0 | Identifikator posebnog uslova prodaje koji obezbeđuje dodatne popuste (npr. avansna uplata, preuzimanje robe sopstvenim vozilom itd.). Ovi identifikatori definišu se u okviru Balans ERP-a i nisu dostupni kroz Balans Online RT API. | |
| custDiscID2 | int | 0 | Identifikator drugog posebnog uslova prodaje (kada na prodaju deluje više posebnih uslova). | |
| custDiscID3 | int | 0 | Identifikator trećeg posebnog uslova prodaje (kada na prodaju deluje više posebnih uslova). | |
| custDiscID4 | int | 0 | Identifikator četvrtog posebnog uslova prodaje (kada na prodaju deluje više posebnih uslova). | |
| custDiscID5 | int | 0 | Identifikator petog posebnog uslova prodaje (kada na prodaju deluje više posebnih uslova). Podržano je maksimalno pet istovremenih posebnih uslova prodaje. | |
| priceColumn | String | nema | Cenovna kolona koja se zahteva iz predatog cenovnika (priceList i priceListDate parametri). Može se predati punim (npr. cenaf) ili skraćenim (npr. A) nazivom. Nije osetljiva na mala i velika slova. Ukoliko je prijavljen komitent tokom GetToken metode i ima definisanu važeću cenovnu kolonu, ta kolona će se koristiti, dok se ovaj parametar, iako predat, zanemaruje. |