API-Dokumentation

Endpunkte

GET Liste abrufen

Authentifizierung

Für jede API-Anfrage muss der X-API-KEY-Header gesendet werden.

X-API-KEY: {ihr_api_schluessel}

Haben Sie noch Fragen?

Schreiben Sie uns ein Ticket oder durchsuchen Sie unser Hilfe-Center.

Basis-URL

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

Jede Anfrage liefert eine JSON-Antwort zurück. Bei Erfolg ist result.code == 1, im Fehlerfall result.code == 0. Die Basisstatistik-API liefert für jeden Monat des Zeitraums eine Zusammenfassungszeile. Dieser Endpunkt ist schreibgeschützt.

GET /api/base-stat/list

Abruf der nach Monaten gegliederten Basisstatistik. Jede Zeile entspricht einem Kalendermonat des Zeitraums mit Kennzahlen zu Umsatz, Gewinn, Aufträgen und Vorjahresvergleich. Der Endpunkt unterstützt keine Paginierung: Er liefert alle Monate des angegebenen Zeitraums auf einmal.

Query-Parameter

Parameter	Typ	Beschreibung
`list_condition[date_create_from]`	date	Beginn des Zeitraums - Erstellungsdatum des Belegs ab (Format: JJJJ-MM-TT). Standard: 1. Januar des laufenden Jahres
`list_condition[date_create_to]`	date	Ende des Zeitraums - Erstellungsdatum des Belegs bis (Format: JJJJ-MM-TT). Standard: letzter Tag des laufenden Monats. Liegt es vor dem Startdatum, werden beide Daten vertauscht
`list_condition[company_id]`	int	Kennung der eigenen Firma (Standard: 1)
`list_condition[store_id]`	int	Filter nach Lager
`list_condition[partner_id]`	int	Filter nach Partner (Kunde)
`list_condition[partner_company_name]`	string	Filter nach Firmenname des Partners (Teilübereinstimmung)
`list_condition[product_id]`	int	Filter nach Produkt
`list_condition[product_name]`	string	Filter nach Produktname (Teilübereinstimmung)
`list_condition[product_partnumber]`	string	Filter nach Artikelnummer (Teilübereinstimmung)
`list_condition[product_category_id]`	int	Filter nach Produktkategorie
`list_condition[company_user_id]`	int	Filter nach verantwortlichem Mitarbeiter

Beispielanfrage

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}

Beispielantwort

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

Hinweise

Die Verkaufskennzahlen (Umsatz, Wareneinsatz, Gewinn) setzen sich aus den Positionen der Belege Kassenverkauf, Rechnung und Anzahlungsrechnung zusammen, die Kennzahlen zu Kundenaufträgen aus den Kundenauftrag-Belegen. Berücksichtigt werden nur nicht gelöschte Belege im Status Abgeschlossen oder Erfüllt.
Die Beträge werden in der Standardwährung des Systems angegeben; Positionen in anderen Währungen werden mit ihrem Wechselkurs umgerechnet. Das Währungszeichen steht im Feld currency_sign.
Dezimalwerte (Beträge, Prozentwerte) können in der JSON-Antwort auch als Zeichenketten (String) erscheinen.
Die Vorjahreskennzahlen (*_yoy_*) vergleichen mit demselben Monat des Vorjahres; liegen für das Vorjahr keine Daten vor, ist der Prozentwert 0.

Beschreibung der Antwortfelder

Feld	Gruppe	Beschreibung
`date_ym`	Zeitraum	Monat (Format JJJJ.MM)
`month_name`	Zeitraum	Ungarischer Monatsname ohne Akzente (z. B. `Augusztus`), nicht lokalisiert
`cogs_netto`	Umsatz und Kosten	Wareneinsatz netto: Menge × Einstandspreis (falls nicht vorhanden, der Einkaufspreis)
`turnover_netto`	Umsatz und Kosten	Nettoumsatz (Kassenverkauf, Rechnungen, Anzahlungsrechnungen)
`turnover_brutto`	Umsatz und Kosten	Bruttoumsatz
`profit_netto`	Gewinn	Nettogewinn: `turnover_netto - cogs_netto`
`profit_brutto`	Gewinn	Bruttogewinn: `turnover_brutto - cogs_netto`
`profit_margin_percent`	Gewinn	Durchschnittlicher Gewinn (%): `profit_netto / turnover_netto × 100`, ohne Umsatz 0
`order_in_count`	Kundenaufträge	Anzahl der Kundenaufträge im Monat
`order_in_price_netto`	Kundenaufträge	Nettowert der Kundenaufträge
`order_in_price_netto_avg`	Kundenaufträge	Durchschnittlicher Warenkorbwert: `order_in_price_netto / order_in_count`
`cash_register_turnover_netto`	Kanäle	Nettoumsatz der Kassenverkäufe (Ladengeschäft)
`order_in_turnover_percent`	Kanäle	Anteil des Kundenauftragswerts am Nettoumsatz (%): `order_in_price_netto / turnover_netto × 100`
`turnover_yoy_diff`	Vorjahresvergleich	Veränderung des Nettoumsatzes gegenüber demselben Monat des Vorjahres
`turnover_yoy_percent`	Vorjahresvergleich	Veränderung des Nettoumsatzes gegenüber demselben Monat des Vorjahres (%)
`profit_yoy_diff`	Vorjahresvergleich	Veränderung des Nettogewinns gegenüber demselben Monat des Vorjahres
`profit_yoy_percent`	Vorjahresvergleich	Veränderung des Nettogewinns gegenüber demselben Monat des Vorjahres (%)
`currency_sign`	Währung	Zeichen der Standardwährung (z. B. `Ft`)

Basisstatistik API