URL de bază
https://{tenant}.logzi.com/api/base-stat/
Fiecare cerere returnează un răspuns JSON. În caz de succes result.code == 1, în caz de eroare result.code == 0. API-ul de statistică de bază returnează câte un rând sumar pentru fiecare lună a perioadei. Acest punct final este doar pentru citire.
/api/base-stat/list
Obținerea statisticii de bază defalcate pe luni. Fiecare rând reprezintă o lună calendaristică a perioadei, cu indicatori de cifră de afaceri, profit, comenzi și comparație cu anul precedent. Punctul final nu este paginat: returnează dintr-o dată toate lunile perioadei indicate.
Parametri query
| Parametru | Tip | Obligatoriu | Descriere |
|---|---|---|---|
list_condition[date_create_from] |
date | Începutul perioadei - data creării documentului de la (format: AAAA-LL-ZZ). Implicit: 1 ianuarie al anului curent | |
list_condition[date_create_to] |
date | Sfârșitul perioadei - data creării documentului până la (format: AAAA-LL-ZZ). Implicit: ultima zi a lunii curente. Dacă este anterioară datei de început, cele două date se inversează | |
list_condition[company_id] |
int | Identificatorul firmei proprii (implicit: 1) | |
list_condition[store_id] |
int | Filtrare după depozit | |
list_condition[partner_id] |
int | Filtrare după partener (client) | |
list_condition[partner_company_name] |
string | Filtru după denumirea firmei partenere (potrivire parțială) | |
list_condition[product_id] |
int | Filtrare după produs | |
list_condition[product_name] |
string | Filtru după denumirea produsului (potrivire parțială) | |
list_condition[product_partnumber] |
string | Filtru după codul articolului (potrivire parțială) | |
list_condition[product_category_id] |
int | Filtrare după categoria produsului | |
list_condition[company_user_id] |
int | Filtrare după colegul responsabil |
Exemplu de cerere
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}Exemplu de răspuns
{
"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
}Observații
currency_sign.*_yoy_*) compară cu aceeași lună a anului precedent; dacă nu există date pentru anul precedent, valoarea procentuală este 0.Descrierea câmpurilor de răspuns
| Câmp | Grup | Descriere |
|---|---|---|
date_ym | Perioadă | Luna (format AAAA.LL) |
month_name | Perioadă | Numele lunii în limba maghiară, fără diacritice (ex. Augusztus), nelocalizat |
cogs_netto | Cifră de afaceri și cost | Costul bunurilor vândute, net: cantitate × preț de cost (dacă lipsește, prețul de achiziție) |
turnover_netto | Cifră de afaceri și cost | Cifră de afaceri netă (vânzări la casă, facturi, facturi de avans) |
turnover_brutto | Cifră de afaceri și cost | Cifră de afaceri brută |
profit_netto | Profit | Profit net: turnover_netto - cogs_netto |
profit_brutto | Profit | Profit brut: turnover_brutto - cogs_netto |
profit_margin_percent | Profit | Profit mediu (%): profit_netto / turnover_netto × 100, fără cifră de afaceri 0 |
order_in_count | Comenzi client | Numărul comenzilor client din lună |
order_in_price_netto | Comenzi client | Valoarea netă a comenzilor client |
order_in_price_netto_avg | Comenzi client | Valoarea medie a coșului: order_in_price_netto / order_in_count |
cash_register_turnover_netto | Canale | Cifra de afaceri netă a vânzărilor la casă (în magazin) |
order_in_turnover_percent | Canale | Ponderea valorii comenzilor client în cifra de afaceri netă (%): order_in_price_netto / turnover_netto × 100 |
turnover_yoy_diff | Comparație anuală | Variația cifrei de afaceri nete față de aceeași lună a anului precedent |
turnover_yoy_percent | Comparație anuală | Variația cifrei de afaceri nete față de aceeași lună a anului precedent (%) |
profit_yoy_diff | Comparație anuală | Variația profitului net față de aceeași lună a anului precedent |
profit_yoy_percent | Comparație anuală | Variația profitului net față de aceeași lună a anului precedent (%) |
currency_sign | Monedă | Semnul monedei implicite (ex. Ft) |
