Preskoči na glavno vsebino

Individuálny cenník - REST API

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

Avtor: Petr Pech

Prostredníctvom REST API (aj webového rozhrania) je možné získať individuálny cenník pre danú firmu alebo danú cenníkovú skupinu.

Chceme-li napr. získať individuálny cenník pre firmu, ktorá má kód FIRMA, použijeme URL .../c/{firma}/adresar/code:FIRMA/individualni-cenik[.xml].

Ako obvykle dôjde k presmerovaniu na číselné ID záznamu, výsledné URL je .../c/{firma}/adresar/400/individualni-cenik (pokiaľ má firma FIRMA interné ID 400).

Samozrejme je možné použiť aj úroveň detailu.

/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

Parametre

Parametrom date v URL (formát YYYY-MM-DD) sa nastaví, pre aký dátum sa má individuálny cenník vyexportovať. Ak parameter nie je uvedený, použije sa aktuálny dátum.

Parametrom currency v URL sa nastaví, pre akú menu sa má individuálny cenník vyexportovať. Ak parameter nie je uvedený, použije sa domáca mena. Hodnotou tohto parametra je skratka požadovanej meny.

Parametrom centre v URL sa nastaví, pre aké stredisko sa má individuálny cenník vyexportovať. Ak parameter nie je uvedený, vyexportujú sa najlepšie ceny bez ohľadu na stredisko. Hodnotou tohto parametra je skratka požadovaného strediska.

?date=2011-12-01

Individuálny cenník k dátumu 1. decembra 2011.

?currency=EUR

Individuálny cenník v inej mene ako domácej. V tomto prípade EUR.

?centre=C

Individuálny cenník pre konkrétne stredisko. V tomto prípade stredisko so skratkou C.

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

Obdobne je možné získať všetky varianty cien tovaru pre všetky firmy a cenníkové skupiny:

/c/{firma}/individualni-cenik

Kompletný prehľad cien

Pri hľadaní ceny v prípade, že máte stiahnutú celú tabuľku „individualni-cenik“, je nutné postupovať podľa týchto krokov:

  1. vyhľadať cenu pre konkrétnu firmu a tovar

  2. vyhľadať cenu pre cenovú úroveň a tovar (cenovú úroveň je možné nájsť u firmy v adresári)

  3. použiť štandardnú cenu tovaru z cenníka

  4. na výslednú cenu je nutné aplikovať percentuálnu zľavu firmy (je uvedená u firmy v adresári)

Ste s tem dobili odgovor na svoje vprašanje?