Na otázky týkajúce sa analýzy nákupu a predaja cez REST API slúžia dve adresy, volané metódou GET:

GET https://demo.flexibee.eu/c/demo/analyza-nakupu
GET https://demo.flexibee.eu/c/demo/analyza-prodeje

Segment {firma} v adrese označuje databázový identifikátor firmy. Podporované výstupné formáty sa volia príponou .xml alebo .json.

Parametre

Parametre sú až na drobné odchýlky pre obe analýzy zhodné. Povinný je iba analyzovat.

Parameter	Popis	Predvolená hodnota
`analyzovat` — povinný	Určuje, čo je cieľom vykonávanej analýzy. Hodnoty nájdete v tabuľke nižšie.	—
`clenit`	Stanovuje ďalšie členenie analyzovaných dát; prijíma rovnaké hodnoty ako `analyzovat` s výnimkou `id`.	Žiadne ďalšie členenie.
`datumOd`	Spodná hranica dátumu analyzovaných dokladov.	Bez obmedzenia najstaršieho dokladu.
`datumDo`	Horná hranica dátumu analyzovaných dokladov.	Bez obmedzenia najnovšieho dokladu.
`datumyUcetne`	Určuje, či sa zadané dáta berú ako dátumy zaúčtovania. Pri `false` sa berú ako dátumy vystavenia.	`true` — hľadať podľa dátumu zaúčtovania.
`neucetniDoklady`	Ovplyvňuje, či sa do analýzy zahrnú aj neúčtovné doklady.	`true` — zahrnúť aj neúčtovné doklady.
`mesicniSumace`	Nastavuje, či sa majú vykonávať mesačné sumácie obratov.	`true` — vykonávať mesačné sumácie.
`stredisko`	Obmedzí analýzu na vybrané stredisko — ID alebo kód. Pre viac stredísk uveďte parameter viackrát.	Všetky strediská bez obmedzenia.
`nekatalogovePolozky`	Zahrnie do analýzy aj nekatalógové položky. Význam má len pri analýze podľa firiem (`adresar`) alebo skupín firiem (`skupFir`).	`false` — iba katalógové položky.
`cenik`	Obmedzí analýzu na vybranú cenníkovú položku. Význam má pri `analyzovat=cenik`.	Všetky cenníkové položky.
`firma`	Obmedzí analýzu na vybranú spoločnosť. Význam má pri `analyzovat=adresar`.	Všetky firmy bez obmedzenia.

🚨 datumyUcetne=false nemožno kombinovať s mesačnými sumáciami. Ak chcete analyzovať podľa dátumu vystavenia, musíte súčasne vypnúť aj sumácie — teda datumyUcetne=false&mesicniSumace=false. Inak dotaz skončí chybou incompatible_param_values_exception — Hodnoty parametrov [datumyUcetne, mesicniSumace] nejsou vzájemně slučitelné.

Hodnoty parametrov analyzovat a clenit

Hodnota	Význam
`cenik`	Pohyb tovaru.
`skupZboz`	Pohyb súhrnne podľa skupín tovaru.
`skupCen`	Podľa cenníkových skupín.
`vyrobce`	Podľa výrobcu.
`sklad`	Obraty skladov.
`stredisko`	Obraty stredísk.
`zakazka`	Obraty na zákazky.
`adresar`	Obraty podľa firiem.
`skupFir`	Obraty súhrnne podľa skupín firiem.
`zodpOsoba`	Podľa zodpovednej osoby.
`mistUrc`	Obraty podľa miest určenia — iba pre analýzu predaja.
`id`	Jednotlivé záznamy bez zoskupenia. Iba pre `analyzovat`, pri `clenit` túto hodnotu nemožno použiť.

Ukážky

Pohyb tovaru bez ďalšieho obmedzenia:

GET /c/demo/analyza-prodeje?analyzovat=cenik

Obraty podľa firiem za rok 2012, podľa dátumu vystavenia — preto je nutné vypnúť aj mesačné sumácie:

GET /c/demo/analyza-nakupu?analyzovat=adresar&datumOd=2012-01-01&datumDo=2012-12-31&datumyUcetne=false&mesicniSumace=false

Obraty skupín firiem za dve vybrané strediská:

GET /c/demo/analyza-prodeje?analyzovat=skupFir&nekatalogovePolozky=false&stredisko=code:A&stredisko=code:B

Predaj jednej cenníkovej položky členený podľa skladov:

GET /c/demo/analyza-prodeje?analyzovat=cenik&clenit=sklad&cenik=code:KUFR

Chybové stavy

Situácia	Odpoveď
Chýba parameter `analyzovat`	`400`, `missing_param_exception` — K provedení operace je vyžadován parametr 'analyzovat'
Neznáma hodnota `analyzovat` alebo `clenit`, prípadne `mistUrc` pri analýze nákupu	`400`, `unsupported_param_value_exception` — chybová správa vypíše aj zoznam povolených hodnôt
`datumyUcetne=false` bez `mesicniSumace=false`	`400`, `incompatible_param_values_exception`

Súvisiace

Sorodni članki

Analýza nákupu / predaja

Parametre

Hodnoty parametrov analyzovat a clenit

Ukážky

Chybové stavy

Súvisiace