Regisztráció Belépés

Termék API

Termékek és cikkek kezelése — lekérés, létrehozás, módosítás és készletinformáció

Végpontok

GET Egyed lekérése
GET Készlet lekérése
GET Kiterjesztett egyed
GET Lista lekérése
GET Kiterjesztett lista
GET Csoportok listája
GET Csoport lekérése
POST Mentés / létrehozás
POST Törlés
POST Súly mentése
POST Raktárinfo mentése
POST Extra info menté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/product/

Minden kérés JSON választ ad vissza. Sikeres válasz esetén result.code == 1, hiba esetén result.code == 0.

GET /api/product/get

Egyetlen termék lekérése azonosító, cikkszám, vonalkód vagy termékcsoport alapján, teljes részletekkel.

Query paraméterek

Paraméter	Típus	Leírás
`id`	int	A termék egyedi azonosítója (vagy használd a `partnumber` paramétert helyette)
`partnumber`	string	Cikkszám szerinti keresés (ha `id` nincs megadva)
`barcode`	string	Vonalkód szerinti keresés
`product_group_id`	int	Termék csoport ID szerint keresés
`store_id`	int	Raktár azonosítója — készletinformáció visszaadásához

Példa kérés

GET /api/product/get?id=42&store_id=1
X-API-KEY: {az_api_kulcsod}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 42,
    "type_id": 6,
    "product_group_id": 10,
    "partnumber": "TERM-0042",
    "name": "Minta termék",
    "product_name": "Minta termék",
    "product_unit_name": "db",
    "vtsz": "8471300000",
    "weight_netto": "0.500",
    "weight_brutto": "0.600",
    "active_id": 1,
    "price": 5000,
    "tax_id": 2,
    "currency_id": 1,
    "incoming_price": 3500,
    "incoming_currency_id": 1,
    "incoming_tax_id": 2
  }
}

GET /api/product/get_stock

Termék készletinformációjának lekérése raktáranként.

Query paraméterek

Paraméter	Típus	Leírás
`id`	int	A termék azonosítója (vagy `partnumber`)
`partnumber`	string	Cikkszám szerinti keresés (alternatíva az `id` helyett)
`list_condition[store_id]`	int	Szűrés adott raktárra

Példa kérés

GET /api/product/get_stock?id=42&list_condition[store_id]=1
X-API-KEY: {az_api_kulcsod}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 42,
    "partnumber": "TERM-0042",
    "quantity_phy": "120.000000",
    "quantity_acc": "5.000000"
  }
}

GET /api/product/get_extended

Termék lekérése kiterjesztett adatokkal — elérhetőség és foglalt mennyiség információval.

Query paraméterek

Paraméter	Típus	Leírás
`id`	int	A termék egyedi azonosítója (vagy `partnumber`)
`partnumber`	string	Cikkszám szerinti keresés
`store_id`	int	Raktár szűrő a készlethez

Példa kérés

GET /api/product/get_extended?id=42
X-API-KEY: {az_api_kulcsod}

GET /api/product/list

Termékek lapozható listájának lekérése szűrési lehetőségekkel.

Query paraméterek

Paraméter	Típus	Leírás
`list_offset`	int	Lapozás eltolása (alapértelmezett: 0)
`list_count`	int	Oldalankénti találatok száma (alapértelmezett: 10)
`list_condition[partnumber]`	string	Szűrés cikkszámra (LIKE)
`list_condition[name]`	string	Szűrés terméknévre (LIKE)
`list_condition[type_id]`	int	Szűrés terméktípusra (1–6)
`list_condition[product_category_id]`	int	Szűrés termék kategória ID-re
`list_condition[active_id]`	int	Szűrés státuszra (1=aktív, 0=inaktív)
`list_condition[store_id]`	int	Raktárkészlet szűrés — csak az adott raktárban elérhető termékek

Példa kérés

GET /api/product/list?list_offset=0&list_count=20&list_condition[active_id]=1
X-API-KEY: {az_api_kulcsod}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 42,
      "type_id": 6,
      "partnumber": "TERM-0042",
      "name": "Minta termék",
      "product_name": "Minta termék",
      "product_unit_name": "db",
      "active_id": 1,
      "price": 5000,
      "incoming_price": 3500
    }
  ],
  "params": {
    "list_count": 20,
    "list_offset": 0,
    "list_all": 158
  }
}

GET /api/product/list_extended

Termékek kiterjesztett listája — teljes árlistával, készlettel és kapcsolódó adatokkal.

Query paraméterek

Paraméter	Típus	Leírás
`list_offset`	int	Lapozás eltolása (alapértelmezett: 0)
`list_count`	int	Oldalankénti találatok száma
`list_condition`	array	Szűrési feltételek tömbje (ua. mint `/list`-nél)
`list_params`	array	Kiegészítő paraméterek

Példa kérés

GET /api/product/list_extended?list_offset=0&list_count=10
X-API-KEY: {az_api_kulcsod}

GET /api/product/list_group

Termékcsoportok lapozható listája — csoport szintű adatok készlet- és árinformációval.

Query paraméterek

Paraméter	Típus	Leírás
`list_offset`	int	Lapozás eltolása (alapértelmezett: 0)
`list_condition[active_id]`	int	Szűrés státuszra (1=aktív, 0=inaktív)
`list_condition[type_id]`	int	Szűrés terméktípusra (1–6)

Példa kérés

GET /api/product/list_group?list_offset=0&list_condition[active_id]=1
X-API-KEY: {az_api_kulcsod}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 10,
      "product_group_id": 10,
      "name": "Minta termék csoport",
      "type_id": 1,
      "type_name": "Variációs termék",
      "active_id": 1,
      "partnumber_list": "TERM-001, TERM-002",
      "quantity_phy": "240.000000",
      "price": 5000,
      "incoming_price": 3500
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 42
  }
}

GET /api/product/get_group

Egyetlen termékcsoport lekérése összes kiszerelésével és árlistájával.

Query paraméterek

Paraméter	Típus	Kötelező	Leírás
`product_group_id`	int		A termékcsoport azonosítója
`language_id`	int		Nyelv azonosítója (alapértelmezett: 1 — magyar)

Példa kérés

GET /api/product/get_group?product_group_id=10
X-API-KEY: {az_api_kulcsod}

POST /api/product/save

Termék létrehozása vagy módosítása. Az adatstruktúra a type_id értékétől függ.

Terméktípusok (type_id)

1	Variációs termék	Több kiszerelés — kötelező az `item[]` tömb megadása
2	Szolgáltatás	Egyszerű termék
3	Csomag termék	Egyszerű termékek csomagja
4	Virtuális – Belépőjegy	Jegytípusokhoz
5	Receptúrás termék	Összetevőkből gyártott
6	Egyszerű termék	Legáltalánosabb típus

A) Csoport szintű mezők — minden típusnál érvényes

Ezek a mezők a db_product_group táblát érintik. Módosításnál a ki nem töltött mezők értéke változatlan marad.

Mező	Típus	Leírás
`id`	int	0 = új termék, >0 = meglévő termék módosítása (`product_id`)
`type_id`	int	Terméktípus (1–6) — új terméknél kötelező, módosításnál nem szükséges
`product_group_id`	int	0 = új csoport létrehozása, >0 = meglévő csoport módosítása
`name`	string	Termék neve. Ha nincs megadva, fallback sorrendben: `product_name` → `product_group_name` → `product_unit_name`
`product_name`	string	Egyedi termék megnevezés (fallback `name`-hez)
`product_group_name`	string	Csoport megnevezés (fallback `name`-hez)
`vtsz`	string	KN/TESZOR vámtarifa szám (pl. `8471300000`)
`description`	string	Rövid leírás
`description_long`	string	Hosszú leírás (HTML engedélyezett)
`meta_title`	string	SEO title
`meta_keyword`	string	SEO kulcsszavak (vesszővel elválasztva)
`meta_description`	string	SEO leírás
`packaging_note`	string	Csomagolási megjegyzés
`active_id`	int	Aktív státusz (1=aktív, 0=inaktív — alapértelmezett: 1)
`partner_id`	int	Gyártó/partner azonosítója
`acquisition_partner_id`	int	Preferált beszállító azonosítója
`unnumber_id`	int	UN-szám azonosítója (veszélyes anyag)
`category_id`	int	Termék főkategória azonosítója
`default_store_id`	int	Alapértelmezett raktár azonosítója
`default_store_locality_id`	int	Alapértelmezett raktári helykód azonosítója
`ledger_number_in_id`	int	Bejövő főkönyvi szám azonosítója
`ledger_number_out_id`	int	Kimenő főkönyvi szám azonosítója
`ledger_number_out_abroad_id`	int	Export főkönyvi szám azonosítója
`acquisition_auto`	int	Automatikus rendelés (0/1)
`serialnumber_required`	int	Egyedszámköteles (0=nem, 1=igen)
`stockable`	int	Készletet kezel (0/1 — alapértelmezett: 1 ha `type_id=1`)
`synchronizable`	int	Webshop szinkronizáció (0/1 — alapértelmezett: 1)
`integration_use_price_list`	int	Webrendelésnél eladási ár frissítése (0/1)
`drs`	int	DRS kötelező visszaváltási rendszer (0/1)
`excisable`	int	Jövedéki termék (0/1)
`tax_inverse`	int	Fordított adózású termék (0/1)
`service_intermediate`	int	Közvetített szolgáltatás (0/1)
`erase_code`	int	Adattörlő kód (0/1)
`package`	int	Göngyöleg/csomagolóeszköz (0/1)
`size_width`	decimal	Szélesség (cm)
`size_height`	decimal	Magasság (cm)
`size_depth`	decimal	Mélység (cm)

B) item[] tömb — kizárólag type_id = 1 (Variációs termék) esetén

Legalább 1 elem kötelező. Minden kiszerelés külön cikkszámmal rendelkezik. Az árak kiszerelés szinten adandók meg.

Mező	Típus	Leírás
`item[n][id]`	int	0 = új kiszerelés, >0 = meglévő módosítása
`item[n][partnumber]`	string	Cikkszám — min. 3 karakter, a rendszerben egyedi
`item[n][product_unit_id]`	int	Mennyiségi egység azonosítója (pl. db, kg, l)
`item[n][product_unit_value]`	decimal	Kiszerelési mennyiség (pl. 0.5, 1.0, 6.0)
`item[n][product_unit_name]`	string	Egyedi kiszerelési megnevezés (pl. "0,5l palack")
`item[n][product_url]`	string	Cikk-specifikus URL slug
`item[n][quantity_min]`	decimal	Minimum készletszint (riasztási küszöb)
`item[n][quantity_opt]`	decimal	Optimum készletszint
`item[n][quantity_max]`	decimal	Maximum készletszint
`item[n][weight_netto]`	decimal	Nettó tömeg kg-ban (elfogadja a vesszőt tizedes jelként)
`item[n][weight_brutto]`	decimal	Bruttó tömeg kg-ban (csomagolással)
`item[n][warranty_month]`	int	Garancia hónapokban
`item[n][remove]`	int	1 = törlés jelölés (soft delete)
ÁR MEZŐK — kiszerelés szinten
`item[n][price]`	decimal	Nettó eladási ár
`item[n][currency_id]`	int	Eladási valuta azonosítója
`item[n][tax_id]`	int	ÁFA kulcs azonosítója (eladási)
`item[n][incoming_price]`	decimal	Nettó beszerzési ár
`item[n][incoming_currency_id]`	int	Beszerzési valuta azonosítója
`item[n][incoming_tax_id]`	int	ÁFA kulcs azonosítója (beszerzési)
`item[n][incoming_cost_price]`	decimal	Önköltségi ár
`item[n][price_on_sale]`	decimal	Akciós eladási ár
`item[n][price_on_sale_date_end]`	datetime	Akció lejárata (`YYYY-MM-DD HH:ii:ss`)
`item[n][price_discount]`	decimal	Kedvezmény mértéke (%)
`item[n][list_price]`	decimal	Ajánlott fogyasztói ár (RRP)
`item[n][list_currency_id]`	int	Ajánlott fogyasztói ár valuta azonosítója
`item[n][list_tax_id]`	int	Ajánlott fogyasztói ár ÁFA azonosítója

C) Termék szintű mezők — type_id = 2, 3, 4, 5, 6 esetén

Ezeknél a típusoknál a mezők root szinten adandók meg (nem item[] tömbben). Az árak szintén root szinten kerülnek mentésre.

Mező	Típus	Leírás
`partnumber`	string	Cikkszám — min. 3 karakter, a rendszerben egyedi
`weight_netto`	decimal	Nettó tömeg kg-ban
`weight_brutto`	decimal	Bruttó tömeg kg-ban (csomagolással)
`warranty_month`	int	Garancia hónapokban
`product_url`	string	Termék URL slug
ÁR MEZŐK — root szinten
`price`	decimal	Nettó eladási ár
`currency_id`	int	Eladási valuta azonosítója
`tax_id`	int	ÁFA kulcs azonosítója (eladási)
`incoming_price`	decimal	Nettó beszerzési ár
`incoming_currency_id`	int	Beszerzési valuta azonosítója
`incoming_tax_id`	int	ÁFA kulcs azonosítója (beszerzési)
`incoming_cost_price`	decimal	Önköltségi ár
`price_on_sale`	decimal	Akciós eladási ár
`price_on_sale_date_end`	datetime	Akció lejárata (`YYYY-MM-DD HH:ii:ss`)
`price_discount`	decimal	Kedvezmény mértéke (%)
`list_price`	decimal	Ajánlott fogyasztói ár (RRP)
`list_currency_id`	int	Ajánlott fogyasztói ár valuta azonosítója
`list_tax_id`	int	Ajánlott fogyasztói ár ÁFA azonosítója

Példa kérés — TYPE 1 (Variációs termék, item[] tömbbel)

POST /api/product/save
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "type_id": 1,
    "product_group_id": 0,
    "name": "Ásványvíz",
    "vtsz": "2201100090",
    "description": "Természetes ásványvíz",
    "active_id": 1,
    "stockable": 1,
    "synchronizable": 1,
    "category_id": 5,
    "item": [
      {
        "id": 0,
        "partnumber": "ASVANY-05L",
        "product_unit_id": 3,
        "product_unit_value": 0.5,
        "product_unit_name": "0,5l palack",
        "remove": 0,
        "price": 120,
        "currency_id": 1,
        "tax_id": 2,
        "incoming_price": 75,
        "incoming_currency_id": 1,
        "incoming_tax_id": 2
      },
      {
        "id": 0,
        "partnumber": "ASVANY-15L",
        "product_unit_id": 3,
        "product_unit_value": 1.5,
        "product_unit_name": "1,5l palack",
        "remove": 0,
        "price": 250,
        "currency_id": 1,
        "tax_id": 2,
        "incoming_price": 160,
        "incoming_currency_id": 1,
        "incoming_tax_id": 2
      }
    ]
  }
}

Példa kérés — TYPE 6 (Egyszerű termék)

POST /api/product/save
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "type_id": 6,
    "product_group_id": 0,
    "name": "Irodai szék",
    "partnumber": "SZEK-001",
    "vtsz": "9401300000",
    "description": "Ergonomikus irodai szék",
    "active_id": 1,
    "weight_netto": 12.5,
    "weight_brutto": 14.0,
    "warranty_month": 24,
    "price": 45000,
    "currency_id": 1,
    "tax_id": 2,
    "incoming_price": 28000,
    "incoming_currency_id": 1,
    "incoming_tax_id": 2
  }
}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "product_group_id": 15,
    "product_id": 48,
    "partnumber": "SZEK-001"
  }
}

POST /api/product/delete

Termék törlése. Csak olyan termék törölhető, amelyhez nem tartozik készletmozgás.

POST mezők — data objektum

Mező	Típus	Kötelező	Leírás
`id`	int		A törlendő termékcsoport azonosítója (`product_group_id`)

Példa kérés

POST /api/product/delete
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{
  "data": {
    "id": 15
  }
}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}

POST /api/product/save_weight

Termék nettó és bruttó tömegének frissítése cikkszám alapján. Verziót rögzít a db_product_data táblában.

POST mezők — data objektum

Mező	Típus	Leírás
`partnumber`	string	A termék cikkszáma (egyedi azonosító)
`weight_netto`	decimal	Nettó tömeg kg-ban
`weight_brutto`	decimal	Bruttó tömeg kg-ban (csomagolással együtt)

Példa kérés

POST /api/product/save_weight
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{
  "data": {
    "partnumber": "TERM-0042",
    "weight_netto": 0.48,
    "weight_brutto": 0.62
  }
}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}

POST /api/product/save_warehouse_info

Termék raktárinformációjának és bruttó tömegének frissítése. Verziót rögzít mind a db_product_data, mind a db_product_group_data táblában.

POST mezők — data objektum

Mező	Típus	Leírás
`partnumber`	string	A termék cikkszáma
`weight_brutto`	decimal	Bruttó tömeg kg-ban
`store_id`	int	Alapértelmezett raktár azonosítója
`store_locality_id`	int	Alapértelmezett raktári helykód azonosítója

Példa kérés

POST /api/product/save_warehouse_info
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{
  "data": {
    "partnumber": "TERM-0042",
    "weight_brutto": 0.62,
    "store_id": 1,
    "store_locality_id": 14
  }
}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}

POST /api/product/save_extra

Termék méretadatainak, raktárelhelyezésének és vonalkódjának frissítése cikkszám alapján. Ha a megadott vonalkód még nem létezik, automatikusan létrehozza.

POST mezők — data objektum

Mező	Típus	Leírás
`partnumber`	string	A termék cikkszáma
`size_width`	decimal	Szélesség (cm)
`size_height`	decimal	Magasság (cm)
`size_depth`	decimal	Mélység (cm)
`weight_brutto`	decimal	Bruttó tömeg kg-ban
`store_id`	int	Alapértelmezett raktár azonosítója
`store_locality_id`	int	Alapértelmezett helykód azonosítója
`barcode`	string	EAN/vonalkód — ha még nem létezik, automatikusan létrehozza a `db_product_barcode` táblában

Példa kérés

POST /api/product/save_extra
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{
  "data": {
    "partnumber": "TERM-0042",
    "size_width": 30.5,
    "size_height": 20.0,
    "size_depth": 15.0,
    "weight_brutto": 0.62,
    "store_id": 1,
    "store_locality_id": 14,
    "barcode": "5901234123457"
  }
}

Példa válasz

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}

Vedd fel a kapcsolatot velünk

Érdeklődsz a szoftverünkkel kapcsolatban, írj bátran!

Érdeklődés küldése

Segítségre van szükséged?

Ha nem találod a választ és szükséged van segítségre

Nézz körbe a help centerben

Regisztrációdat hozd létre most,
fizess később!

Próbáld ki 3 napig ingyen, kockázatok és kötöttségek nélkül!

Regisztráció