Înregistrare Autentificare

API Listă de prețuri

Preluarea și setarea prețurilor produselor în funcție de partener, valută și depozit

Puncte finale

Autentificare

Fiecare cerere API necesită trimiterea header-ului X-API-KEY.

X-API-KEY: {cheia_dvs_api}

Mai ai întrebări?

Trimite-ne un tichet, sau caută în motorul nostru de căutare.

Dacă ți-a plăcut, distribuie-l și altora

URL de bază

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

Fiecare cerere returnează un răspuns JSON. În caz de succes, result.code == 1, în caz de eroare, result.code == 0. Dacă nu este specificat nici product_id, nici partnumber la punctul final get, se returnează prețul tuturor produselor.

GET /api/price_list/get

Preluarea prețului produsului conform criteriilor de filtrare. Dacă nu este specificat nici product_id, nici partnumber, se returnează prețul tuturor produselor.

Parametri de interogare

ParametruTipObligatoriuDescriere
product_idintIdentificatorul produsului
company_idintIdentificatorul companiei
partner_idintFiltrare preț specific partenerului
currency_idintIdentificatorul valutei
store_idintIdentificatorul depozitului
price_list_idintIdentificatorul listei de prețuri

Exemplu de cerere

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

Preluare paginată a înregistrărilor din lista de prețuri, cu opțiuni de filtrare.

Parametri de interogare

ParametruTipObligatoriuDescriere
list_offsetintDecalajul paginării (implicit: 0)
list_countintNumărul de înregistrări afișate pe pagină
list_conditionarrayCondiții de filtrare sub formă de tablou asociativ
list_paramsarrayParametri suplimentari de interogare

Exemplu de cerere

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

Creare sau modificare a unei înregistrări din lista de prețuri. Produsul poate fi specificat pe baza product_id sau partnumber (cod articol); unul dintre cele două câmpuri este obligatoriu. Dacă există deja o înregistrare pentru combinația produs, companie, tip de partener și depozit, aceasta este modificată, altfel se creează una nouă. Ca separator zecimal se acceptă atât punctul, cât și virgula.

Câmpuri POST - obiectul data

CâmpTipObligatoriuDescriere
product_idintIdentificatorul produsului. Obligatoriu dacă partnumber nu este specificat
partnumberstringCod articol (min. 3 caractere). Obligatoriu dacă product_id nu este specificat
idintIdentificatorul înregistrării din lista de prețuri. Nu este necesar: sistemul identifică înregistrarea existentă pe baza produsului, company_id, partner_type_id și store_id (vezi mai jos)
company_idintIdentificatorul companiei (implicit: 1)
partner_type_idintIdentificatorul tipului de partener, pentru prețuri specifice tipului de partener. Dacă lipsește, prețul este general
store_idintIdentificatorul depozitului, pentru prețuri specifice depozitului. Dacă lipsește, prețul este general
pricefloatPreț de vânzare net
currency_idintIdentificatorul monedei prețului de vânzare
tax_idintIdentificatorul cotei TVA a prețului de vânzare
price_discountfloatReducere în procente (%)
price_on_salefloatPreț net promoțional
price_on_sale_date_enddatetimeData și ora expirării prețului promoțional (YYYY-MM-DD HH:MM:SS)
incoming_pricefloatPreț net de achiziție
incoming_currency_idintIdentificatorul monedei prețului de achiziție
incoming_tax_idintIdentificatorul cotei TVA a prețului de achiziție
incoming_cost_pricefloatPreț de cost al achiziției (preț de achiziție majorat cu costuri suplimentare)
list_pricefloatPreț net de listă
list_currency_idintIdentificatorul monedei prețului de listă
list_tax_idintIdentificatorul cotei TVA a prețului de listă

Identificarea înregistrării

Sistemul caută înregistrarea existentă pe baza combinației product_id (sau partnumber), company_id, partner_type_id și store_id. Dacă partner_type_id sau store_id lipsește, se salvează prețul general (independent de tipul de partener, respectiv de depozit). Se modifică doar câmpurile incluse în cerere. La modificare, câmpul data.id din răspuns conține identificatorul înregistrării modificate.

Exemplu de cerere

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

Înregistrarea prețului mediu al produsului.

Câmpuri POST - obiectul data

CâmpTipObligatoriuDescriere
product_idintIdentificatorul produsului
pricefloatPrețul mediu de înregistrat

Exemplu de cerere

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

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

Ștergerea unei înregistrări din lista de prețuri pe baza identificatorului.

Câmpuri POST - obiectul data

CâmpTipObligatoriuDescriere
idintIdentificatorul înregistrării din lista de prețuri care urmează să fie ștearsă

Exemplu de cerere

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

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

Ia legătura cu noi

Ești interesat de software-ul nostru? Scrie-ne cu încredere!

Trimite o solicitare

Ai nevoie de ajutor?

Dacă nu găsești răspunsul și ai nevoie de asistență

Răsfoiește centrul de ajutor

Creează-ți contul acum,
plătește mai târziu!

Încearcă gratuit timp de 3 zile, fără riscuri și fără obligații!
Creare cont
Înregistrare