API Dokumentáció

Végpontok

GET Lista lekérése

Authentikáció

Minden API kéréshez szükséges az X-API-KEY header küldése.

X-API-KEY: {az_api_kulcsod}

Maradt még kérdésed?

Írj ticketet nekünk, vagy nézz körbe a keresőnkben.

Alap URL

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

Minden kérés JSON választ ad vissza. Sikeres válasz esetén result.code == 1, hiba esetén result.code == 0. Az alap statisztika API az időszak minden hónapjához egy összesítő sort ad vissza. Ez a végpont csak olvasható.

GET /api/base-stat/list

Havi bontású alap statisztika lekérése. Minden sor egy naptári hónapot jelent az időszakban, a forgalmi, nyereség, rendelési és előző évi összehasonlító mutatókkal. A végpont nem lapozható: a megadott időszak összes hónapját egyben adja vissza.

Query paraméterek

Paraméter	Típus	Leírás
`list_condition[date_create_from]`	date	Időszak kezdete - bizonylat létrehozási dátum -tól (formátum: ÉÉÉÉ-HH-NN). Alapértelmezett: az aktuális év január 1-je
`list_condition[date_create_to]`	date	Időszak vége - bizonylat létrehozási dátum -ig (formátum: ÉÉÉÉ-HH-NN). Alapértelmezett: az aktuális hónap utolsó napja. Ha korábbi, mint a kezdő dátum, a két dátum felcserélődik
`list_condition[company_id]`	int	Saját cég azonosítója (alapértelmezett: 1)
`list_condition[store_id]`	int	Szűrés raktárra
`list_condition[partner_id]`	int	Szűrés partnerre (vevő)
`list_condition[partner_company_name]`	string	Partner cégnév szűrő (részleges egyezés)
`list_condition[product_id]`	int	Szűrés termékre
`list_condition[product_name]`	string	Terméknév szűrő (részleges egyezés)
`list_condition[product_partnumber]`	string	Cikkszám szűrő (részleges egyezés)
`list_condition[product_category_id]`	int	Szűrés termék kategóriára
`list_condition[company_user_id]`	int	Szűrés felelős munkatársra

Példa kérés

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}

Példa válasz

{
  "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
}

Megjegyzések

Az értékesítési mutatók (forgalom, elábé, nyereség) a Bolti értékesítés, Számla és Előleg számla bizonylatok tételeiből állnak össze, a vevői rendelés mutatók a Rendelés bizonylatokból. Csak a Lezárt és Teljesített státuszú, nem törölt bizonylatok számítanak.
Az összegek a rendszer alapértelmezett pénznemében szerepelnek, a más pénznemű tételek az árfolyamukkal átszámítva. A pénznem jele a currency_sign mezőben található.
A decimális értékek (összegek, százalékok) a JSON válaszban szövegként (string) is megjelenhetnek.
Az éves összehasonlító mutatók (*_yoy_*) ugyanazon hónap előző évi értékéhez viszonyítanak; ha az előző évben nincs adat, a százalékos érték 0.

Válasz mezők leírása

Mező	Csoport	Leírás
`date_ym`	Időszak	Hónap (ÉÉÉÉ.HH formátum)
`month_name`	Időszak	Hónap magyar neve ékezet nélkül (pl. `Augusztus`), nem nyelvfüggő
`cogs_netto`	Forgalom és költség	Eladott áruk beszerzési értéke (elábé), nettó: mennyiség × beszerzési költségár (ha nincs, a beszerzési ár)
`turnover_netto`	Forgalom és költség	Nettó forgalom (bolti értékesítés, számla, előleg számla)
`turnover_brutto`	Forgalom és költség	Bruttó forgalom
`profit_netto`	Nyereség	Nettó nyereség: `turnover_netto - cogs_netto`
`profit_brutto`	Nyereség	Bruttó nyereség: `turnover_brutto - cogs_netto`
`profit_margin_percent`	Nyereség	Átlagos haszon (%): `profit_netto / turnover_netto × 100`, forgalom nélkül 0
`order_in_count`	Vevői rendelések	Vevői rendelések száma a hónapban
`order_in_price_netto`	Vevői rendelések	Vevői rendelések nettó értéke
`order_in_price_netto_avg`	Vevői rendelések	Átlagos kosárérték: `order_in_price_netto / order_in_count`
`cash_register_turnover_netto`	Csatornák	Bolti értékesítés (pénztárgép) nettó forgalma
`order_in_turnover_percent`	Csatornák	Vevői rendelések értékének aránya a nettó forgalomhoz (%): `order_in_price_netto / turnover_netto × 100`
`turnover_yoy_diff`	Éves összehasonlítás	Nettó forgalom változása az előző év azonos hónapjához képest
`turnover_yoy_percent`	Éves összehasonlítás	Nettó forgalom változása az előző év azonos hónapjához képest (%)
`profit_yoy_diff`	Éves összehasonlítás	Nettó nyereség változása az előző év azonos hónapjához képest
`profit_yoy_percent`	Éves összehasonlítás	Nettó nyereség változása az előző év azonos hónapjához képest (%)
`currency_sign`	Pénznem	Az alapértelmezett pénznem jele (pl. `Ft`)

Alap statisztika API