8. 6. 2026 - Novinky v API
- Připojené aplikace přes API mohou nově spravovat SEO údaje produktů i kategorií (SEO titulek a popis) a texty kategorií (úvodní a spodní text).
- K produktům lze přes integrace získat i interní poznámku a SEO pole.
- Přehledy a výpisy nově ukazují přesný celkový počet záznamů (např. „nalezeno 58 566 položek").
- API integrace umí nově získat odkaz na PDF štítek zásilky (přepravní štítek ke stažení).
- Snazší výpis hlavních kategorií e-shopu pro připojené aplikace.
- Odstranili jsme chyby, kvůli kterým některé integrace občas selhávaly při načítání údajů o objednávkách, fakturách a kategoriích (např. adresa dodavatele na faktuře, odkaz na kategorii, příznak „pozdržená objednávka"). Načítání těchto dat je teď spolehlivé.
- Opravili jsme funkce pro přidání poznámky a sledovacího odkazu k objednávce přes propojené systémy.
- Kompletní changelog pro vývojáře níže. Schema a dokumentace API na www.byznysweb.cz/api byla aktualizována.
Nové funkce
- Nový dotaz
listRootCategories: [Category!]— výpis kořenových kategorií (náhrada za dřívější bezargumentovégetCategory). - Nová mutace
updateCategory(category_id: ID!, lang_id: ID!, data: CategoryInput): Category(partner-only) — úprava kategorie. - Nový vstupní typ
CategoryInput(title, intro, bottom, url_identificator, seo_title, seo_description). - Nový typ
InvoicingCompanyData— dodavatel na fakturách/zálohách. - Nová pole produktu:
Product.internal_note,Product.seo_title,Product.seo_description(+ zápis přesProductInput.seo_title/seo_description). - Nová pole kategorie:
Category.intro,Category.bottom,Category.seo_title,Category.seo_description. PageInfo.totalRecords: Int— celkový počet záznamů (konec hackutotalPages * limit).ShipmentInfo.download_pdf: Url— odkaz na PDF štítek zásilky.WebPage.link: Url!— URL stránky.@partnerTokendirektiva v SDL označuje partner-only argumenty/mutace (např.getOrderList(filter: { sum_from })).
Změny (pozor, mohou být breaking)
- Breaking:
getCategory(category_id:)je nyníID!(povinné). Pro kořenové kategorie použijtelistRootCategories. Invoice.supplieraPreinvoice.supplier:InvoicingCompany!→InvoicingCompanyData!. Nový typ nemá poleid— odebertesupplier { id }z dotazů.ICompany.emailaInvoicingCompany.email:Email→Email!(non-null).lang_codesjednoceno naCountryCodeAlpha2napříč dotazy.
Opravy (dříve vracely HTTP 500 „Internal server error")
Order.blocked— nyní funguje.Invoice.supplier.address— nyní funguje.Category.link— nyní funguje.- Mutace
addCustomInfoForOrderaaddTrackingUrlForOrder— již nepadají. getCategorybezcategory_idvrací čistou validační chybu (místo HTTP 500).
Poznámky
Customerzůstává union (Company | Person | UnauthenticatedEmail). InterfaceICustomerbyl testován a vrácen zpět (rollback) — pole dotazujte přes fragmenty... on Person/Company/UnauthenticatedEmail. Díky sjednocenémuemail: Email!už nevzniká konflikt typů.