24. 9. 2026 - Vylepšenia BiznisWeb API

Nekompatibilné zmeny — skontrolujte svoju integráciu

addPackage: argument warehouse_number je po novom typu WarehouseNumber (predtým ID). Dotazy, ktoré premennú deklarujú ako ID, skončia validačnou chybou.
is_net_price má po novom jednotný význam vo všetkých častiach API. Ak ste predchádzajúcu nekonzistenciu obchádzali vlastnou úpravou, odstráňte ju.
updateCategory po novom kontroluje, či lang_id zodpovedá jazyku kategórie. Zápis do kategórie iného jazyka skončí chybou (predtým sa lang_id ignoroval).
Filter invoicer v InvoiceFilter a PreinvoiceFilter hľadá podľa názvu fakturačnej firmy alebo IČ DPH (textovo), nie podľa interného ID.
ICompany.email môže byť po novom null.

Novinky

Atribúty produktov a ich preklad

listAttributes(lang_code: CountryCodeAlpha2): [Attribute]

Vráti všetky atribúty produktov a ich hodnoty v požadovanom jazyku. Ak preklad chýba, vráti text základného jazyka. Bez lang_code vráti základný jazyk.

updateAttribute(attribute_id: ID!, lang_id: ID!, data: AttributeInput): Attribute

Preloží názov atribútu do daného jazyka; ostatné jazyky sa nemenia. Zápis title: "" preklad zruší a jazyk sa vráti k textu základného jazyka.

updateAttributeValue(value_id: ID!, lang_id: ID!, data: AttributeValueInput): AttributeValue

Preloží hodnotu atribútu. Zrušenie prekladu: value: "".

Nové vstupné typy AttributeInput { title } a AttributeValueInput { value }.

Zaradenie produktov do kategórií

assignProductsToCategory(category_id: ID!, product_ids: [ID!]!): Category

Priradí jeden alebo viac produktov do kategórie. Existujúce zaradenia zostávajú (aditívne), opakované volanie nič nezmení (idempotentné). Ak product_ids obsahuje neexistujúce ID, nepriradí sa žiadny produkt. Hlavnú kategóriu produktu (main_category) nemení.

unassignProductsFromCategory(category_id: ID!, product_ids: [ID!]!): Category

Odoberie produkty z danej kategórie; podkategórie ani iné zaradenia sa nemenia. Odobratie z kategórie, v ktorej produkt nie je, prejde bez chyby.

Kategórie

Pole	Typ	Popis
`Category.h1`	`String`	nadpis H1 kategórie (samostatne od `title`)
`Category.url_identificator`	`String`	URL identifikátor (slug)
`Category.visibility`	`CategoryVisibility`	viditeľnosť kategórie v e-shope
`CategoryInput.h1`	`String`	zápis H1 cez `updateCategory`
`CategoryInput.visibility`	`CategoryVisibility`	zápis viditeľnosti cez `updateCategory`

Obe polia sú pri zápise nepovinné. Nový vymenovaný typ CategoryVisibility:

Hodnota	Význam
`visible`	viditeľná pre všetkých
`hidden`	skrytá v menu a výpisoch
`full_locked`	úplne neprístupná
`registered`	len pre prihlásených zákazníkov

Produkty

Pole	Typ	Popis
`Product.url_identificator`	`String`	URL identifikátor (slug)
`Product.indicators`	`[Indicator]`	štítky produktu ako „Novinka“ alebo „Akcia“

Nový typ Indicator s poľami id, title, image, color, note.

Zásielky

Pole	Typ	Popis
`ShipmentInfo.label_printed`	`DateTime`	čas poslednej tlače alebo stiahnutia štítka zásielky (v e-shope aj cez API); `null`, ak štítok nikdy nebol vytlačený

Stiahnutie štítka cez API ho označí ako vytlačený. Pri faktúrach (Invoice.download_pdf) to neplatí.

Sklad

Pole	Typ	Popis
`WarehouseStatus.hide_in_list`	`Boolean!`	produkt v tomto skladovom stave zostáva dostupný na svojej stránke, ale nezobrazuje sa vo výpisoch

Fakturačné údaje

Pole	Typ	Popis
`InvoicingCompany.name`	`String`	meno kontaktnej osoby
`InvoicingCompanyData.id`	`ID`	interné ID firmy
`InvoicingCompanyData.name`	`String`	meno kontaktnej osoby
`ICompany.email`	`Email`	po novom môže byť `null` (predtým `Email!`)

Zmeny správania

Ceny: `is_net_price`

Príznak má po novom jednotný význam v celom API: true = hodnota bez DPH, false = s DPH. Predtým sa líšil medzi zoznamom produktov, objednávkami a zoznamami dopráv a platieb. Pri neplatiteľovi DPH sú obe hodnoty rovnaké. Pri PriceInput znamená vynechané is_net_price cenu s DPH; netto si API dopočíta podľa sadzby.

final_price zahŕňa aj zľavy a ďalšie cenové zložky, preto nemusí zodpovedať price × (1 + DPH).

Validácia `lang_id`

updateCategory kontroluje, či lang_id zodpovedá jazyku kategórie (Category … does not belong to the requested language version). Neexistujúci lang_id vráti validačnú chybu namiesto Internal server error. Neexistujúci lang_id odmietne aj updateProduct.

Filter `invoicer`

V InvoiceFilter a PreinvoiceFilter hľadá podľa názvu fakturačnej firmy alebo IČ DPH (textové vyhľadávanie), nie podľa interného ID.

Balenie: `addPackage`

Argument warehouse_number je typu WarehouseNumber.

Dokumentácia

Spresnené popisy v schéme: Price.is_net_price, PriceInput.is_net_price, updateCategory, updateProduct, updateContent, updateNewsPost, únia Customer, formát DateTime (YYYY-MM-DD HH:MM:SS), dôvod zastarania Category.description (použite seo_description) a opravy preklepov.

Späť