Regisztráció Belépés

Árlista API

Termék árak lekérése és beállítása partner, deviza és raktár alapján

Végpontok

GET Ár lekérése
GET Lista lekérése
POST Mentés / létrehozás
POST Átlagár rögzítése
POST Törlés

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/price_list/

Minden kérés JSON választ ad vissza. Sikeres válasz esetén result.code == 1, hiba esetén result.code == 0. Ha sem product_id, sem partnumber nincs megadva a get végpontnál, az összes termék ára visszaadásra kerül.

GET /api/price_list/get

Termék árának lekérése szűrési feltételek szerint. Ha sem product_id, sem partnumber nincs megadva, az összes termék ára visszaadásra kerül.

Query paraméterek

Paraméter	Típus	Leírás
`product_id`	int	Termék azonosítója
`company_id`	int	Cég azonosítója
`partner_id`	int	Partner-specifikus ár szűrése
`currency_id`	int	Pénznem azonosítója
`store_id`	int	Raktár azonosítója
`price_list_id`	int	Árlista azonosítója

Példa kérés

GET /api/price_list/get?product_id=5¤cy_id=1
X-API-KEY: {az_api_kulcsod}

GET /api/price_list/list

Árlista bejegyzések lapozható 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ént megjelenő rekordok száma
`list_condition`	array	Szűrési feltételek asszociatív tömbként
`list_params`	array	Kiegészítő lekérdezési paraméterek

Példa kérés

GET /api/price_list/list?list_offset=0&list_count=50
X-API-KEY: {az_api_kulcsod}

POST /api/price_list/save

Árlista bejegyzés létrehozása vagy módosítása. A termék megadható product_id vagy partnumber (cikkszám) alapján, a két mező közül az egyik megadása kötelező. Ha a termékhez, cég, partnertípus és raktár kombinációjára már létezik bejegyzés, az módosul, egyébként új jön létre. A tizedesjegyek elválasztására pont és vessző is használható.

POST mezők - data objektum

Mező	Típus	Leírás
`product_id`	int	Termék azonosítója. Kötelező, ha nincs megadva a `partnumber`
`partnumber`	string	Cikkszám (min. 3 karakter). Kötelező, ha nincs megadva a `product_id`
`id`	int	Árlista bejegyzés azonosítója. Nem szükséges megadni: a rendszer a termék, `company_id`, `partner_type_id` és `store_id` alapján azonosítja a meglévő rekordot (lásd lent)
`company_id`	int	Cég azonosítója (alapértelmezett: 1)
`partner_type_id`	int	Partnertípus azonosítója, partnertípushoz kötött ár esetén. Ha nincs megadva, az ár általános
`store_id`	int	Raktár azonosítója, raktárhoz kötött ár esetén. Ha nincs megadva, az ár általános
`price`	float	Nettó eladási ár
`currency_id`	int	Az eladási ár pénznemének azonosítója
`tax_id`	int	Az eladási ár ÁFA-kulcsának azonosítója
`price_discount`	float	Kedvezmény mértéke százalékban (%)
`price_on_sale`	float	Akciós nettó ár
`price_on_sale_date_end`	datetime	Az akciós ár lejárati időpontja (`YYYY-MM-DD HH:MM:SS`)
`incoming_price`	float	Nettó beszerzési ár
`incoming_currency_id`	int	A beszerzési ár pénznemének azonosítója
`incoming_tax_id`	int	A beszerzési ár ÁFA-kulcsának azonosítója
`incoming_cost_price`	float	Beszerzési önköltségi ár (járulékos költségekkel növelt beszerzési ár)
`list_price`	float	Nettó listaár
`list_currency_id`	int	A listaár pénznemének azonosítója
`list_tax_id`	int	A listaár ÁFA-kulcsának azonosítója

Rekord azonosítása

A rendszer a product_id (vagy partnumber), company_id, partner_type_id és store_id kombinációja alapján keresi a meglévő bejegyzést. Ha a partner_type_id vagy a store_id nincs megadva, az általános (partnertípustól, illetve raktártól független) ár kerül mentésre. Csak a kérésben szereplő mezők módosulnak. Módosítás esetén a válasz data.id mezője a módosított bejegyzés azonosítóját tartalmazza.

Példa kérés

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

{
  "data": {
    "product_id": 5,
    "company_id": 1,
    "partner_type_id": 2,
    "store_id": 1,
    "price": 9500,
    "currency_id": 1,
    "tax_id": 1,
    "price_discount": 5,
    "price_on_sale": 8900,
    "price_on_sale_date_end": "2026-12-31 23:59:59",
    "incoming_price": 6200,
    "incoming_currency_id": 1,
    "incoming_tax_id": 1,
    "incoming_cost_price": 6350,
    "list_price": 10500,
    "list_currency_id": 1,
    "list_tax_id": 1
  }
}

POST /api/price_list/save_avg

Termék átlagárának rögzítése.

POST mezők - data objektum

Mező	Típus	Kötelező	Leírás
`product_id`	int		Termék azonosítója
`price`	float		Rögzítendő átlagár

Példa kérés

POST /api/price_list/save_avg
X-API-KEY: {az_api_kulcsod}
Content-Type: application/json

{ "data": { "product_id": 5, "price": 8750.50 } }

POST /api/price_list/delete

Árlista bejegyzés törlése azonosító alapján.

POST mezők - data objektum

Mező	Típus	Kötelező	Leírás
`id`	int		A törlendő árlista bejegyzés azonosítója

Példa kérés

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

{ "data": { "id": 12 } }

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ó