API priebehu objednávky

Krížový prehľad dokladov podľa produktu — objednávka zákazníka, objednávka u dodávateľa, dodací list a faktúra v jednom riadku

Základná URL

https://{tenant}.logzi.com/api/product-flow/

Každá požiadavka vracia odpoveď vo formáte JSON. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0.

GET /api/product-flow/list

Získanie zoznamu priebehu objednávok podľa produktu. Každý riadok zobrazuje jednu položku objednávky zákazníka spolu s priradenou objednávkou u dodávateľa, dodacím listom a faktúrou.

Query parametre

Parameter Typ Povinné Popis
list_count int Počet záznamov na stránku (predvolene: 10)
list_offset int Posun pre stránkovanie (predvolene: 0)
list_condition[product_name] string Filter podľa názvu produktu (čiastočná zhoda, nerozlišuje veľkosť písmen)
list_condition[product_partnumber] string Filter podľa katalógového čísla (čiastočná zhoda)
list_condition[date_from] date Dátum plnenia objednávky zákazníka od (formát: RRRR-MM-DD)
list_condition[date_to] date Dátum plnenia objednávky zákazníka do (formát: RRRR-MM-DD)
list_condition[partner_id] int Identifikátor partnera zákazníka — iba objednávky patriace danému partnerovi
list_sort[field] string Názov poľa na zoradenie (napr. order_in_date_perform, partnumber, product_name)
list_sort[sort] string Smer zoradenia: ASC alebo DESC (predvolene: DESC)

Príklad požiadavky

GET /api/product-flow/list?list_count=20&list_offset=0&list_condition[date_from]=2025-01-01&list_condition[date_to]=2025-12-31
X-API-KEY: {vas_api_kluc}

Príklad odpovede

{
  "result": { "code": 1, "message": "success" },
  "list_count": 20,
  "list_offset": 0,
  "list_all": 142,
  "data": [
    {
      "order_in_item_id": 1501,
      "order_in_id": 312,
      "order_in_identify": "VREND-2025-0312",
      "identify_customer": "VEVOI-REF-001",
      "order_in_date_create": "2025-03-10",
      "order_in_date_perform": "2025-03-20",
      "order_in_quantity": 5,
      "order_in_incoming_price": 8000,
      "order_in_price_margin": 10000,
      "order_in_price_margin_percent": 20.0,
      "order_in_price_netto": 50000,
      "order_in_price_brutto": 63500,
      "order_in_price_tax": 13500,
      "order_in_tax_id": 3,
      "order_in_currency_id": 1,
      "order_in_status_id": 3,
      "order_in_status_name": "Teljesítve",
      "customer_status_id": 2,
      "order_in_customer_status_name": "Átadva",
      "order_in_paymod_id": 1,
      "order_in_paymod_name": "Átutalás",
      "order_in_shipping_id": 2,
      "order_in_shipping_name": "Futárszolgálat",
      "order_in_partner": "Minta Kft.",
      "order_in_shipping_addr": "1117 Budapest, Példa utca 1.",
      "order_in_shipping_user": "Kovács János",
      "order_in_billing_addr": "1117 Budapest, Számla utca 2.",
      "product_id": 88,
      "product_group_id": 45,
      "partnumber": "TERM-0088",
      "product_name": "Minta termék",
      "category_id": 7,
      "stockable": 1,
      "synchronizable": 0,
      "drs": 0,
      "excisable": 0,
      "acquisition_partner_id": 12,
      "ledger_number_in_id": 3,
      "ledger_number_out_id": 5,
      "order_out_id": 201,
      "order_out_identify": "SZREND-2025-0201",
      "order_out_date_create": "2025-03-11",
      "order_out_date_perform": "2025-03-18",
      "order_out_status_id": 3,
      "order_out_status_name": "Teljesítve",
      "order_out_quantity": 5,
      "order_out_price_netto": 40000,
      "order_out_price_brutto": 50800,
      "order_out_price_tax": 10800,
      "order_out_partner": "Szállító Zrt.",
      "dn_id": 98,
      "dn_identify": "SZLEV-2025-0098",
      "dn_date_create": "2025-03-17",
      "dn_date_perform": "2025-03-18",
      "dn_status_id": 2,
      "dn_status_name": "Lezárva",
      "dn_quantity": 5,
      "dn_price_netto": 40000,
      "dn_price_brutto": 50800,
      "dn_price_tax": 10800,
      "dn_partner": "Szállító Zrt.",
      "invoice_id": 455,
      "invoice_identify": "SZL-2025-0455",
      "invoice_receipt_type_cr_id": null,
      "invoice_date_create": "2025-03-20",
      "invoice_date_perform": "2025-03-20",
      "invoice_date_validity": "2025-03-20",
      "invoice_date_payoff": "2025-04-03",
      "invoice_status_id": 2,
      "invoice_status_name": "Kiállítva",
      "invoice_paymode_id": 1,
      "invoice_paymod_name": "Átutalás",
      "invoice_quantity": 5,
      "invoice_price_netto": 50000,
      "invoice_price_brutto": 63500,
      "invoice_price_tax": 13500,
      "invoice_partner": "Minta Kft."
    }
  ]
}

Popis polí odpovede

Pole Skupina Popis
order_in_item_idObjednávka zákazníkaJedinečný identifikátor položky objednávky (ID riadku)
order_in_idObjednávka zákazníkaIdentifikátor hlavičky objednávky zákazníka
order_in_identifyObjednávka zákazníkaČíslo objednávky zákazníka
identify_customerObjednávka zákazníkaVlastné číslo objednávky zákazníka
order_in_date_createObjednávka zákazníkaDátum zaevidovania objednávky (RRRR-MM-DD)
order_in_date_performObjednávka zákazníkaDohodnutý dátum plnenia (RRRR-MM-DD)
order_in_quantityObjednávka zákazníkaObjednané množstvo
order_in_incoming_priceObjednávka zákazníkaNákupná cena platná v čase objednávky (Ft)
order_in_price_marginObjednávka zákazníkaSuma marže (Ft)
order_in_price_margin_percentObjednávka zákazníkaVýška marže (%)
order_in_price_nettoObjednávka zákazníkaCena bez DPH (Ft)
order_in_price_bruttoObjednávka zákazníkaCena s DPH (Ft)
order_in_price_taxObjednávka zákazníkaSuma DPH (Ft)
order_in_status_nameObjednávka zákazníkaNázov stavu objednávky
order_in_customer_status_nameObjednávka zákazníkaNázov stavu zákazníka
order_in_paymod_nameObjednávka zákazníkaNázov spôsobu platby
order_in_shipping_nameObjednávka zákazníkaNázov spôsobu dopravy
order_in_partnerObjednávka zákazníkaNázov partnera zákazníka
order_in_shipping_addrObjednávka zákazníkaDodacia adresa
order_in_shipping_userObjednávka zákazníkaMeno kontaktnej osoby na mieste dodania
order_in_billing_addrObjednávka zákazníkaFakturačná adresa
product_idProduktJedinečný identifikátor produktu
product_group_idProduktIdentifikátor skupiny produktu
partnumberProduktKatalógové číslo
product_nameProduktNázov produktu
category_idProduktIdentifikátor kategórie produktu
stockableProduktČi je skladovateľný (1/0)
order_out_idObjednávka u dodávateľaIdentifikátor objednávky u dodávateľa (null ak neexistuje)
order_out_identifyObjednávka u dodávateľaČíslo objednávky u dodávateľa
order_out_date_performObjednávka u dodávateľaDátum plnenia objednávky u dodávateľa
order_out_quantityObjednávka u dodávateľaMnožstvo objednávky u dodávateľa
order_out_price_nettoObjednávka u dodávateľaCena objednávky u dodávateľa bez DPH (Ft)
order_out_price_bruttoObjednávka u dodávateľaCena objednávky u dodávateľa s DPH (Ft)
order_out_partnerObjednávka u dodávateľaNázov partnera dodávateľa
order_out_status_nameObjednávka u dodávateľaNázov stavu objednávky u dodávateľa
dn_idDodací listIdentifikátor dodacieho listu (null ak neexistuje)
dn_identifyDodací listČíslo dodacieho listu
dn_date_performDodací listDátum plnenia dodacieho listu
dn_quantityDodací listMnožstvo dodacieho listu
dn_price_nettoDodací listCena dodacieho listu bez DPH (Ft)
dn_price_bruttoDodací listCena dodacieho listu s DPH (Ft)
dn_partnerDodací listPartner dodacieho listu
dn_status_nameDodací listNázov stavu dodacieho listu
invoice_idFaktúraIdentifikátor faktúry (null ak neexistuje)
invoice_identifyFaktúraČíslo faktúry
invoice_date_performFaktúraDátum plnenia faktúry
invoice_date_payoffFaktúraTermín splatnosti
invoice_quantityFaktúraFakturované množstvo
invoice_price_nettoFaktúraSuma faktúry bez DPH (Ft)
invoice_price_bruttoFaktúraSuma faktúry s DPH (Ft)
invoice_partnerFaktúraPartner faktúry (názov zákazníka)
invoice_status_nameFaktúraNázov stavu faktúry
invoice_paymod_nameFaktúraNázov spôsobu platby faktúry