Přeskočit na hlavní obsah

Individuální ceník - REST API

Jak získat individuální ceník pro danou firmu či ceníkovou skupinu přes REST API?

Autor: Petr Pech

Přes REST API (i webové rozhraní) lze získat individuální ceník pro danou firmu, pro danou ceníkovou skupinu, nebo v jednom dotazu pro všechny.


Sestavení URL

Individuální ceník je podřízený zdroj konkrétního záznamu. Chcete-li jej získat pro firmu s kódem FIRMA, použijete:

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

Jako obvykle dojde k přesměrování na číselné ID záznamu — má-li firma FIRMA interní ID 400, výsledné URL je /c/demo/adresar/400/individualni-cenik. Použít lze i úroveň detailu a filtraci.

Adresa

Co vrátí

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

Individuální ceník pro firmu, která má ID 400.

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

Individuální ceník pro ceníkovou skupinu, která má ID 2.

/c/{firma}/individualni-cenik

Kompletní přehled cen — všechny varianty pro všechny firmy a ceníkové skupiny.


Parametry

Parametr

Význam

Výchozí stav

date

Datum, ke kterému se má ceník vyexportovat, ve formátu YYYY-MM-DD.

Aktuální datum.

currency

Zkratka měny, ve které se má ceník vyexportovat.

Tuzemská měna.

centre

Zkratka střediska, pro které se má ceník vyexportovat.

Nejlepší ceny bez ohledu na středisko.

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

⚠️ Nesmyslné datum vrací 400 s hlášením Unparseable date, ale neznámou zkratku měny nebo střediska služba nehlásí — mlčky použije tuzemskou měnu, respektive nejlepší ceny. Zkratky si proto ověřte v evidencích mena a stredisko.


Hledání obecné ceny pro zákazníka

Kompletní přehled cen vrací u každého řádku složený identifikátor idString, ceníkovou položku (cenik), cenu (cenaZakl) a podle toho, k čemu se cena váže, také firmu (firma), ceníkovou skupinu (skupCen) nebo cenovou hladinu (cenHlad). Máte-li staženou celou tabulku a hledáte v ní cenu, postupujte v tomto pořadí:

  1. Vyhledejte cenu pro konkrétní firmu a zboží.

  2. Vyhledejte cenu pro cenovou úroveň a zboží — cenovou úroveň najdete u firmy v adresáři.

  3. Použijte standardní cenu zboží z ceníku.

  4. Na výslednou cenu aplikujte procentuální slevu firmy, kterou má firma nastavenou v adresáři.


Přepočet prodejní ceny

Změníte-li parametr ceníku nebo skupiny zboží, který má vliv na výslednou cenu, a k přepočtu nedojde automaticky, lze jej vyvolat ručně — voláním PUT nebo POST na /{filtr}/prepocti-prodejni-cenu nad evidencí cenik či skupina-zbozi. Podrobně to popisuje článek Přepočet prodejních cen.

Totéž lze vyvolat i jako akci importu. V případě ceníku:

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

A v případě skupiny zboží:

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


Související

Dostali jste odpověď na svou otázku?