Preskoči na glavno vsebino

Individuálny cenník - REST API

Ako získať individuálny cenník pre danú firmu alebo cenníkovú skupinu cez REST API?

Avtor: Petr Pech

Cez REST API (aj cez webové rozhranie) je možné získať individuálny cenník pre danú firmu, pre danú cenníkovú skupinu, alebo v jednom dotaze pre všetky.


Zostavenie URL

Individuálny cenník je podriadený zdroj konkrétneho záznamu. Ak ho chcete získať pre firmu s kódom FIRMA, použite:

GET https://demo.flexibee.eu/c/demo/adresar/code:FIRMA/individualni-cenik.xml

Ako obvykle dôjde k presmerovaniu na číselné ID záznamu — ak má firma FIRMA interné ID 400, výsledné URL je /c/demo/adresar/400/individualni-cenik. Použiť je možné aj úroveň detailu a filtráciu.

Adresa

Čo vráti

/c/{firma}/adresar/400/individualni-cenik

Individuálny cenník pre firmu, ktorá má ID 400.

/c/{firma}/cenikova-skupina/2/individualni-cenik

Individuálny cenník pre cenníkovú skupinu, ktorá má ID 2.

/c/{firma}/individualni-cenik

Kompletný prehľad cien — všetky varianty pre všetky firmy a cenníkové skupiny.


Parametre

Parameter

Význam

Predvolený stav

date

Dátum, ku ktorému sa má cenník exportovať, vo formáte YYYY-MM-DD.

Aktuálny dátum.

currency

Skratka meny, v ktorej sa má cenník exportovať.

Tuzemská mena.

centre

Skratka strediska, pre ktoré sa má cenník exportovať.

Najlepšie ceny bez ohľadu na stredisko.

GET .../individualni-cenik.xml?date=2011-12-01
GET .../individualni-cenik.xml?currency=EUR
GET .../individualni-cenik.xml?centre=C

⚠️ Nezmyselný dátum vracia 400 s hlásením Unparseable date, ale neznámu skratku meny alebo strediska služba nehlási — mlčky použije tuzemskú menu, respektíve najlepšie ceny. Skratky si preto overte v evidenciách mena a stredisko.


Hľadanie všeobecnej ceny pre zákazníka

Kompletný prehľad cien vracia pri každom riadku zložený identifikátor idString, cenníkovú položku (cenik), cenu (cenaZakl) a podľa toho, k čomu sa cena viaže, aj firmu (firma), cenníkovú skupinu (skupCen) alebo cenovú hladinu (cenHlad). Ak máte stiahnutú celú tabuľku a hľadáte v nej cenu, postupujte v tomto poradí:

  1. Vyhľadajte cenu pre konkrétnu firmu a tovar.

  2. Vyhľadajte cenu pre cenovú úroveň a tovar — cenovú úroveň nájdete pri firme v adresári.

  3. Použite štandardnú cenu tovaru z cenníka.

  4. Na výslednú cenu aplikujte percentuálnu zľavu firmy, ktorú má firma nastavenú v adresári.


Prepočet predajnej ceny

Ak zmeníte parameter cenníka alebo skupiny tovaru, ktorý má vplyv na výslednú cenu, a k prepočtu nedôjde automaticky, je možné ho vyvolať ručne — volaním PUT alebo POST na /{filtr}/prepocti-prodejni-cenu nad evidenciou cenik či skupina-zbozi. Podrobne to popisuje článok Prepočet predajných cien.

To isté je možné vyvolať aj ako akciu importu. V prípade cenníka:

<winstrom version="1.0">
<cenik filter="kod='CENIK'" action="prepocti-prodejni-cenu"/>
</winstrom>

A v prípade skupiny tovaru:

<winstrom version="1.0">
<skupina-zbozi filter="kod='SKUPINA 2'" action="prepocti-prodejni-cenu"/>
</winstrom>


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?