24. 9. 2026 - Vylepšení ByznysWeb API

Nekompatibilní změny — zkontrolujte svou integraci

addPackage: argument warehouse_number je nově typu WarehouseNumber (dříve ID). Dotazy, které proměnnou deklarují jako ID, skončí validační chybou.
is_net_price má nově jednotný význam ve všech částech API. Pokud jste dřívější nekonzistenci obcházeli vlastní úpravou, odstraňte ji.
updateCategory nově kontroluje, že lang_id odpovídá jazyku kategorie. Zápis do kategorie jiného jazyka skončí chybou (dříve se lang_id ignoroval).
Filtr invoicer v InvoiceFilter a PreinvoiceFilter hledá podle názvu fakturační firmy nebo DIČ (textově), ne podle interního ID.
ICompany.email může být nově null.

Novinky

Atributy produktů a jejich překlad

listAttributes(lang_code: CountryCodeAlpha2): [Attribute]

Vrací všechny atributy produktů a jejich hodnoty v požadovaném jazyce. Chybí-li překlad, vrací text základního jazyka. Bez lang_code vrací základní jazyk.

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

Přeloží název atributu do daného jazyka; ostatní jazyky se nemění. Zápis title: "" překlad zruší a jazyk se vrátí k textu základního jazyka.

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

Přeloží hodnotu atributu. Zrušení překladu: value: "".

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

Zařazení produktů do kategorií

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

Přiřadí jeden nebo více produktů do kategorie. Stávající zařazení zůstávají (aditivní), opakované volání nic nezmění (idempotentní). Obsahuje-li product_ids neexistující ID, nepřiřadí se žádný produkt. Hlavní kategorii produktu (main_category) nemění.

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

Odebere produkty z dané kategorie; podkategorie ani jiná zařazení se nemění. Odebrání z kategorie, ve které produkt není, projde bez chyby.

Kategorie

Pole	Typ	Popis
`Category.h1`	`String`	nadpis H1 kategorie (samostatně od `title`)
`Category.url_identificator`	`String`	URL identifikátor (slug)
`Category.visibility`	`CategoryVisibility`	viditelnost kategorie v e-shopu
`CategoryInput.h1`	`String`	zápis H1 přes `updateCategory`
`CategoryInput.visibility`	`CategoryVisibility`	zápis viditelnosti přes `updateCategory`

Obě pole jsou při zápisu nepovinná. Nový výčtový typ CategoryVisibility:

Hodnota	Význam
`visible`	viditelná pro všechny
`hidden`	skrytá v menu a výpisech
`full_locked`	zcela nepřístupná
`registered`	jen pro přihlášené zákazníky

Produkty

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

Nový typ Indicator s poli id, title, image, color, note.

Zásilky

Pole	Typ	Popis
`ShipmentInfo.label_printed`	`DateTime`	čas posledního tisku nebo stažení štítku zásilky (v e-shopu i přes API); `null`, pokud štítek nikdy vytištěn nebyl

Stažení štítku přes API ho označí jako vytištěný. U faktur (Invoice.download_pdf) to neplatí.

Sklad

Pole	Typ	Popis
`WarehouseStatus.hide_in_list`	`Boolean!`	produkt v tomto skladovém stavu zůstává dostupný na své stránce, ale nezobrazuje se ve výpisech

Fakturační údaje

Pole	Typ	Popis
`InvoicingCompany.name`	`String`	jméno kontaktní osoby
`InvoicingCompanyData.id`	`ID`	interní ID firmy
`InvoicingCompanyData.name`	`String`	jméno kontaktní osoby
`ICompany.email`	`Email`	nově může být `null` (dříve `Email!`)

Změny chování

Ceny: `is_net_price`

Příznak má nově jednotný význam v celém API: true = hodnota bez DPH, false = s DPH. Dříve se lišil mezi seznamem produktů, objednávkami a seznamy doprav a plateb. U neplátce DPH jsou obě hodnoty shodné. U PriceInput znamená vynechané is_net_price cenu s DPH; netto si API dopočítá podle sazby.

final_price zahrnuje i slevy a další cenové složky, proto nemusí odpovídat price × (1 + DPH).

Validace `lang_id`

updateCategory kontroluje, že lang_id odpovídá jazyku kategorie (Category … does not belong to the requested language version). Neexistující lang_id vrací validační chybu místo Internal server error. Neexistující lang_id odmítá i updateProduct.

Filtr `invoicer`

V InvoiceFilter a PreinvoiceFilter hledá podle názvu fakturační firmy nebo DIČ (textové vyhledávání), ne podle interního ID.

Balení: `addPackage`

Argument warehouse_number je typu WarehouseNumber.

Dokumentace

Zpřesněné popisy ve schématu: Price.is_net_price, PriceInput.is_net_price, updateCategory, updateProduct, updateContent, updateNewsPost, unie Customer, formát DateTime (YYYY-MM-DD HH:MM:SS), důvod zastarání Category.description (použijte seo_description) a opravy překlepů.

Zpět