Registrácia Prihlásenie

API cenníka

Získavanie a nastavovanie cien produktov podľa partnera, meny a skladu

Koncové body

Autentifikácia

Ku každej API požiadavke je potrebné odoslať hlavičku X-API-KEY.

X-API-KEY: {vas_api_kluc}

Máte ešte otázky?

Napíšte nám tiket, alebo si pozrite naše centrum pomoci.

Ak sa vám páčilo, podeľte sa s ostatnými

Základná URL

https://{tenant}.logzi.com/api/price_list/

Každá požiadavka vracia odpoveď vo formáte JSON. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0. Ak pri koncovom bode get nie je zadané ani product_id, ani partnumber, vrátia sa ceny všetkých produktov.

GET /api/price_list/get

Získanie ceny produktu podľa zadaných filtrovacích podmienok. Ak nie je zadané ani product_id, ani partnumber, vrátia sa ceny všetkých produktov.

Query parametre

ParameterTypPovinnéPopis
product_idintIdentifikátor produktu
company_idintIdentifikátor spoločnosti
partner_idintFiltrovanie ceny špecifickej pre partnera
currency_idintIdentifikátor meny
store_idintIdentifikátor skladu
price_list_idintIdentifikátor cenníka

Príklad požiadavky

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

Stránkovateľné získavanie záznamov cenníka s možnosťou filtrovania.

Query parametre

ParameterTypPovinnéPopis
list_offsetintPosun stránkovania (predvolené: 0)
list_countintPočet záznamov zobrazených na stránku
list_conditionarrayFiltrovacie podmienky ako asociatívne pole
list_paramsarrayDoplnkové parametre dopytu

Príklad požiadavky

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

Vytvorenie alebo úprava záznamu cenníka. Produkt je možné zadať pomocou product_id alebo partnumber (katalógové číslo), jedno z týchto polí je povinné. Ak už pre kombináciu produktu, firmy, typu partnera a skladu záznam existuje, upraví sa, inak sa vytvorí nový. Ako desatinný oddeľovač je možné použiť bodku aj čiarku.

POST polia - objekt data

PoleTypPovinnéPopis
product_idintIdentifikátor produktu. Povinné, ak nie je zadané partnumber
partnumberstringKatalógové číslo (min. 3 znaky). Povinné, ak nie je zadané product_id
idintIdentifikátor záznamu cenníka. Nie je potrebné ho zadať: systém identifikuje existujúci záznam podľa produktu, company_id, partner_type_id a store_id (pozri nižšie)
company_idintIdentifikátor firmy (predvolené: 1)
partner_type_idintIdentifikátor typu partnera pre ceny viazané na typ partnera. Ak nie je zadaný, cena je všeobecná
store_idintIdentifikátor skladu pre ceny viazané na sklad. Ak nie je zadaný, cena je všeobecná
pricefloatČistá predajná cena
currency_idintIdentifikátor meny predajnej ceny
tax_idintIdentifikátor sadzby DPH predajnej ceny
price_discountfloatZľava v percentách (%)
price_on_salefloatČistá akciová cena
price_on_sale_date_enddatetimeDátum a čas vypršania akciovej ceny (YYYY-MM-DD HH:MM:SS)
incoming_pricefloatČistá nákupná cena
incoming_currency_idintIdentifikátor meny nákupnej ceny
incoming_tax_idintIdentifikátor sadzby DPH nákupnej ceny
incoming_cost_pricefloatNákladová cena nákupu (nákupná cena zvýšená o vedľajšie náklady)
list_pricefloatČistá cenníková cena
list_currency_idintIdentifikátor meny cenníkovej ceny
list_tax_idintIdentifikátor sadzby DPH cenníkovej ceny

Identifikácia záznamu

Systém hľadá existujúci záznam podľa kombinácie product_id (alebo partnumber), company_id, partner_type_id a store_id. Ak partner_type_id alebo store_id nie je zadané, uloží sa všeobecná cena (nezávislá od typu partnera, resp. skladu). Menia sa iba polia uvedené v požiadavke. Pri úprave obsahuje pole data.id odpovede identifikátor upraveného záznamu.

Príklad požiadavky

POST /api/price_list/save
X-API-KEY: {vas_api_kluc}
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

Zaznamenanie priemernej ceny produktu.

POST polia - objekt data

PoleTypPovinnéPopis
product_idintIdentifikátor produktu
pricefloatPriemerná cena na zaznamenanie

Príklad požiadavky

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

{ "data": { "product_id": 5, "price": 8750.50 } }
POST /api/price_list/delete

Odstránenie záznamu cenníka podľa identifikátora.

POST polia - objekt data

PoleTypPovinnéPopis
idintIdentifikátor záznamu cenníka, ktorý sa má odstrániť

Príklad požiadavky

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

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

Kontaktuj nás

Zaujíma ťa náš softvér? Pokojne nám napíš!

Odoslať dopyt

Potrebuješ pomoc?

Ak nevieš nájsť odpoveď a potrebuješ pomoc

Pozri sa do centra pomoci

Zaregistruj sa teraz,
zaplať neskôr!

Vyskúšaj 3 dni zadarmo, bez rizika a záväzkov!
Vytvorenie registrácie
Registrácia