API dokumentácia

Koncové body

GET Získanie zoznamu

Autentifikácia

Ku každej API požiadavke je potrebné odoslať hlavičku X-API-KEY.

X-API-KEY: {vas_api_kluc}

Máte ešte otázky?

Napíšte nám tiket, alebo si pozrite naše centrum pomoci.

Základná URL

https://{tenant}.logzi.com/api/base-stat/

Každá požiadavka vracia odpoveď vo formáte JSON. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0. API základnej štatistiky vracia pre každý mesiac obdobia jeden súhrnný riadok. Tento koncový bod je len na čítanie.

GET /api/base-stat/list

Získanie základnej štatistiky rozdelenej po mesiacoch. Každý riadok predstavuje jeden kalendárny mesiac obdobia s ukazovateľmi obratu, zisku, objednávok a porovnania s predchádzajúcim rokom. Koncový bod nie je stránkovaný: vracia naraz všetky mesiace zadaného obdobia.

Query parametre

Parameter	Typ	Popis
`list_condition[date_create_from]`	date	Začiatok obdobia - dátum vytvorenia dokladu od (formát: RRRR-MM-DD). Predvolené: 1. január aktuálneho roka
`list_condition[date_create_to]`	date	Koniec obdobia - dátum vytvorenia dokladu do (formát: RRRR-MM-DD). Predvolené: posledný deň aktuálneho mesiaca. Ak je skorší ako počiatočný dátum, oba dátumy sa vymenia
`list_condition[company_id]`	int	Identifikátor vlastnej firmy (predvolené: 1)
`list_condition[store_id]`	int	Filtrovanie podľa skladu
`list_condition[partner_id]`	int	Filtrovanie podľa partnera (zákazníka)
`list_condition[partner_company_name]`	string	Filter podľa názvu firmy partnera (čiastočná zhoda)
`list_condition[product_id]`	int	Filtrovanie podľa produktu
`list_condition[product_name]`	string	Filter podľa názvu produktu (čiastočná zhoda)
`list_condition[product_partnumber]`	string	Filter podľa čísla artikla (čiastočná zhoda)
`list_condition[product_category_id]`	int	Filtrovanie podľa kategórie produktu
`list_condition[company_user_id]`	int	Filtrovanie podľa zodpovedného kolegu

Príklad požiadavky

GET /api/base-stat/list?list_condition[date_create_from]=2026-08-01&list_condition[date_create_to]=2026-08-31
X-API-KEY: {az_api_kulcsod}

Príklad odpovede

{
  "language": "HU",
  "api_key": null,
  "result": { "code": 1, "message": null },
  "data": [
    {
      "date_ym": "2026.08",
      "month_name": "Augusztus",
      "cogs_netto": "87774.0775",
      "turnover_netto": "157583.0000000",
      "turnover_brutto": "197949.9400000",
      "profit_netto": "69808.9225",
      "profit_brutto": "110175.8625",
      "profit_margin_percent": "44.2998",
      "order_in_count": "17",
      "order_in_price_netto": "45837.0000000",
      "order_in_price_netto_avg": "2696.2941",
      "cash_register_turnover_netto": "15253.0000000",
      "order_in_turnover_percent": "29.0875",
      "turnover_yoy_diff": "128591.0000000",
      "turnover_yoy_percent": "443.5396",
      "profit_yoy_diff": "253067.9225",
      "profit_yoy_percent": "-138.0930",
      "currency_sign": "Ft"
    }
  ],
  "params": null
}

Poznámky

Predajné ukazovatele (obrat, náklady na predaný tovar, zisk) sa skladajú z položiek dokladov Predaj v obchode, Faktúra a Zálohová faktúra, ukazovatele objednávok zákazníkov z dokladov Objednávka zákazníka. Zohľadňujú sa iba nevymazané doklady v stave Uzavretý alebo Splnený.
Sumy sú uvedené v predvolenej mene systému; položky v iných menách sa prepočítavajú podľa ich výmenného kurzu. Znak meny je v poli currency_sign.
Desatinné hodnoty (sumy, percentá) sa môžu v odpovedi JSON zobraziť aj ako reťazce (string).
Medziročné ukazovatele (*_yoy_*) porovnávajú s rovnakým mesiacom predchádzajúceho roka; ak za predchádzajúci rok nie sú údaje, percentuálna hodnota je 0.

Popis polí odpovede

Pole	Skupina	Popis
`date_ym`	Obdobie	Mesiac (formát RRRR.MM)
`month_name`	Obdobie	Maďarský názov mesiaca bez diakritiky (napr. `Augusztus`), nelokalizovaný
`cogs_netto`	Obrat a náklady	Náklady na predaný tovar, netto: množstvo × nákladová cena (ak nie je, nákupná cena)
`turnover_netto`	Obrat a náklady	Čistý obrat (predaj v obchode, faktúry, zálohové faktúry)
`turnover_brutto`	Obrat a náklady	Hrubý obrat
`profit_netto`	Zisk	Čistý zisk: `turnover_netto - cogs_netto`
`profit_brutto`	Zisk	Hrubý zisk: `turnover_brutto - cogs_netto`
`profit_margin_percent`	Zisk	Priemerný zisk (%): `profit_netto / turnover_netto × 100`, bez obratu 0
`order_in_count`	Objednávky zákazníkov	Počet objednávok zákazníkov v mesiaci
`order_in_price_netto`	Objednávky zákazníkov	Čistá hodnota objednávok zákazníkov
`order_in_price_netto_avg`	Objednávky zákazníkov	Priemerná hodnota košíka: `order_in_price_netto / order_in_count`
`cash_register_turnover_netto`	Kanály	Čistý obrat predaja v obchode (pokladnica)
`order_in_turnover_percent`	Kanály	Podiel hodnoty objednávok zákazníkov na čistom obrate (%): `order_in_price_netto / turnover_netto × 100`
`turnover_yoy_diff`	Medziročné porovnanie	Zmena čistého obratu oproti rovnakému mesiacu predchádzajúceho roka
`turnover_yoy_percent`	Medziročné porovnanie	Zmena čistého obratu oproti rovnakému mesiacu predchádzajúceho roka (%)
`profit_yoy_diff`	Medziročné porovnanie	Zmena čistého zisku oproti rovnakému mesiacu predchádzajúceho roka
`profit_yoy_percent`	Medziročné porovnanie	Zmena čistého zisku oproti rovnakému mesiacu predchádzajúceho roka (%)
`currency_sign`	Mena	Znak predvolenej meny (napr. `Ft`)