Založte si e-shop zdarma a získejte 10 000 AI kreditů na start. Bez karty, bez závazku.E-shop zdarma + 10 000 AI kreditů na start

Začít zdarma
Přeskočit na obsah

MCP: katalog produktů

Nástroje MCP pro produkty, kategorie, značky a vlastnosti: oprávnění, potvrzení, kredity, důsledky zápisu a všechny parametry včetně operací.

Upraveno Markdown verze

Čtení a úpravy katalogu: vyhledání a detail produktu i export katalogu do CSV, strom kategorií a jejich obrázky, značky, vlastnosti, ceníky a velkoobchodní ceny, tabulky velikostí a informační panely, zakládání produktů rovnou s variantami a údaji pro dopravu, import z jiného e-shopu od náhledu po zahození i založení produktů z CSV, startovní ukázkový obsah, úpravy produktů včetně obsahu stránky produktu a varianty šablony stránky, údajů GPSR, běžné ceny a sazby DPH existujících variant, změny struktury variant (z jednoduchého produktu variantní a zpět), smazání produktu a hromadná AI úprava i s jejím stavem.

Nástroje volá klient přes server MCP na doméně obchodu, například https://muj-eshop.cz/api/mcp, a v odpovědi na tools/list dostane jen ty, na jejichž oprávnění klíč dosáhne. Jak server mluví, kdy se ptá člověka a jak se změny vracejí, popisuje článek MCP server.

U každého nástroje stojí oprávnění, které chce, jestli se server před provedením zeptá člověka a kudy, jestli volání strhne kredity obchodu nebo peníze z karty, co vrací pro deník změn a jakou větu o důsledku člověk v potvrzení uvidí. Všechno z toho se vyhodnocuje z téhož kódu, podle kterého se server rozhoduje. Popisy parametrů jsou převzaté ze schématu, které server posílá v tools/list; kde se v něm text obrací přímo k modelu, je tady převedený do vykání. Povinnost parametru platí uvnitř objektu, ve kterém parametr leží.

Před zápisem, který přepisuje nebo maže, před útratou kreditů nebo platbou kartou a před hledáním mimo obchod se server ptá člověka a do té doby neprovede nic. Nejdřív použije schválení, které pro totéž volání se stejnými hodnotami už v administraci leží schválené. Jinak se zeptá formulářem, když ho klient deklaruje a politika akce ho dovoluje; formulář potvrzuje ten, kdo drží klíč, takže před ukradeným klíčem takové potvrzení nechrání. Otázka ve formuláři nese pod nadpisem „Co se změní“ tytéž řádky jako stránka schválení. Klient s elicitací URL dostane odkaz na stránku schválení v administraci a klient bez elicitace odmítnutí approval_required s odkazem v _meta; po schválení volání zopakuje se stejnými hodnotami. Na stránce schválení rozhoduje jen přihlášený člověk, kterého u každé akce jmenuje odrážka Potvrzení přes MCP, a účet podpory SHOPZI nikdy. Když politika nedovoluje nic, co klient umí, přijde odmítnutí confirmation_required a neprovede se nic. Výsledek potvrzeného volání nese v _meta["cz.shopzi/confirmation"] údaj, že akci potvrdil člověk a kde (form nebo approval), a v obsahu českou větu pro model, u placené akce i s cenou a zůstatkem kreditů z dotazu. Na otázku formulářem je 15 minut, schválení na stránce platí 60 minut, pokud u akce není uvedeno jinak.

Zápisové nástroje vracejí v poli change_id ID záznamu v deníku změn; co pole u kterého nástroje nese, říká jeho odrážka Deník změn. Změnu z deníku vrací shopzi_undo_change podle jejího druhu: obnoví předchozí hodnoty, u skladu zapíše vyrovnávací pohyb, u běžné ceny zapíše návrat do 30denní historie cen (nic z ní nemaže) a změnu, která už opustila obchod, stála peníze nebo je nevratná (vystavený doklad, odeslaný e-mail, stržené kredity, platbu kartou), odmítne s vysvětlením. Zápis ze schváleného běhu nese ID běhu; všechny zápisy jednoho běhu vrátí najednou shopzi_manage_run s operací undo_run.

shopzi_search_products

Vrátí stránku produktů seřazenou od nejnovějších, s parametrem sort od nejlevnějšího nebo od nejdražšího, a k ní souhrn spočítaný nad celým výběrem: průměr, součet, minimum, maximum a zásobu. Produkt najde podle názvu, značky, adresy nebo SKU a výpis zúží kategorií, stavem nebo časem poslední změny. V režimu export vydá celý katalog jako soubor CSV, stejný jako export v administraci.

  • Oprávnění: products:read, u klíče „Katalog: produkty, kategorie, dodavatelé (čtení)“.
  • Druh: čtení (readOnlyHint).
  • Potvrzení přes MCP: ne.
  • Kredity a platba kartou: ne.

shopzi_search_products: parametry

  • mode (jedna z hodnot search a export, výchozí search; nepovinný): export = celý katalog jako CSV, bez filtrů.
  • jobId (UUID; nepovinný): Jen export: export.job_id z předchozí odpovědi u exportu na pozadí.
  • search (text, 1 až 120 znaků; nepovinný): Text v názvu, značce, adrese nebo SKU, i uvnitř slova; total pak počítá jen shody.
  • categoryId (__uncategorized nebo UUID; nepovinný): ID kategorie ze shopzi_list_catalog (categories), jen přímé zařazení, ne podstrom; __uncategorized = bez kategorie.
  • status (text; nepovinný): Stav, např. active nebo draft.
  • updatedSince (text se vzorem; nepovinný): ISO datum: jen produkty nové nebo změněné od té doby.
  • sort (jedna z hodnot price_asc a price_desc; nepovinný): Použijte VŽDY na nejlevnější, nejdražší a cenové pořadí (jinak je pořadí od nejnovějších); vrací jen první stránku.
  • limit (celé číslo od 1 do 100, výchozí 25; nepovinný): Položek na stránku, 1 až 100. Berte jen tolik, kolik potřebujete: přerostlou odpověď nástroj odmítne.
  • cursor (text; nepovinný): Průběžná pozice z předchozí odpovědi (next_cursor). Vynechte pro první stránku.

shopzi_get_product

Vrátí jeden produkt i s variantami, cenami, zásobou a zařazením do kategorií včetně té hlavní. Každá varianta nese svůj název složený z hodnot voleb, třeba Černá / 42, a každá cena přijde v haléřích i jako hotový text pod jménem bez _minor, třeba price vedle price_minor. Parametr include přidá další karty editoru ve tvaru, v jakém je přijímá shopzi_manage_product: modifikátory, vlastnosti, vazby, obsah stránky produktu (i variantu šablony stránky), velkoobchodní ceny a podrobnosti (DPH, značka, údaje GPSR, vyloučení z odstoupení, další SEO a logistika variant).

  • Oprávnění: products:read, u klíče „Katalog: produkty, kategorie, dodavatelé (čtení)“.
  • Druh: čtení (readOnlyHint).
  • Potvrzení přes MCP: ne.
  • Kredity a platba kartou: ne.

shopzi_get_product: parametry

  • productId (UUID; povinný): ID produktu (UUID) ze shopzi_search_products.
  • include (pole, položka: jedna z hodnot modifiers, attributes, links, page_content, wholesale a details, nejvýš 6 položek; nepovinný): Karty navíc, jen potřebné: modifiers (úpravy s příplatkem a pomocným textem), attributes (i custom_params), links (propojené produkty), page_content (bloky, panely), wholesale (cena bez DPH), details (DPH, značka, GPSR, SEO, logistika variant).

shopzi_list_catalog

Vrátí podle resource strom kategorií (s detail: true i popisy, SEO, obrázek a varianty šablon stránek každé kategorie), produkty jedné kategorie v ručním pořadí, značky a výrobce uvedené u produktů, definice vlastností, cenové hladiny, velkoobchodní ceník, tabulky velikostí, informační panely stránky produktu, stav hromadné AI úpravy produktů (ai_runs), nebo posledních dvacet importů z jiného e-shopu (imports). V položkách katalogu umí hledat podle názvu.

  • Oprávnění: products:read, u klíče „Katalog: produkty, kategorie, dodavatelé (čtení)“.
  • Druh: čtení (readOnlyHint).
  • Potvrzení přes MCP: ne.
  • Kredity a platba kartou: ne.

shopzi_list_catalog: oblasti

  • categories
  • vendors
  • attributes
  • price_lists
  • size_guides (Tabulky velikostí)
  • info_panels
  • ai_runs
  • imports
  • wholesale_prices
  • category_products

shopzi_list_catalog: parametry

  • resource (jedna z hodnot categories, vendors, attributes, price_lists, size_guides, info_panels, ai_runs, imports, wholesale_prices a category_products; povinný): Která část katalogu.
  • entityId (UUID; nepovinný): Jen ai_runs: běh i s položkami; u imports import i s produkty; u category_products povinná kategorie.
  • search (text, 1 až 120 znaků; nepovinný): Text v názvu, i uvnitř slova; u kategorie i v nadřazených, u značky v adrese, u vlastnosti v klíči.
  • detail (true nebo false; nepovinný): Jen categories: true přidá pole shopzi_manage_category (popisy, SEO, obrázek); zužte search nebo limit.
  • limit (celé číslo od 1 do 100, výchozí 25; nepovinný): Položek na stránku, 1 až 100. Berte jen tolik, kolik potřebujete: přerostlou odpověď nástroj odmítne.
  • offset (celé číslo od 0 do 100000, výchozí 0; nepovinný): Kolik položek přeskočit. 0 = první stránka.

shopzi_manage_product

Zakládá (nový produkt rovnou i s variantami, hmotností, rozměry, nákupní cenou a vlastními parametry), upravuje (včetně značky, údajů GPSR, vyloučení z odstoupení a SEO), archivuje a maže produkty a spravuje jejich zařazení do kategorií, varianty, modifikátory, vlastnosti, vazby, běžné i velkoobchodní ceny a obsah stránky produktu (tabulka velikostí, sestavený popis z bloků, nadpis nad popisem, výjimky informačních panelů, varianta šablony stránky); hromadně přepíná stav, vloží startovní ukázkový obsah jako průvodce prvním spuštěním a uklízí nedotčené ukázkové produkty z něj. Import z jiného e-shopu umí od náhledu přes spuštění po zastavení a zahození, produkty založí i ze souboru CSV. Strukturu variant mění set_variant_axes (z jednoduchého produktu udělá variantní), remove_variants a collapse_to_simple (zpátky na jednoduchý); tyto tři operace vrátit nejde, a proto odmítnou variantu se zásobou, s objednávkami nebo v balíčku. Změna běžné ceny (set_retail_price, pro víc variant s vlastní cenou každé set_retail_prices) se zapisuje do 30denní historie cen podle § 12a a vrací se dalším pohybem ceny zpátky. set_vat_rate změní sazbu DPH všem variantám: cena s DPH zůstane, mění se základ daně dalších prodejů a vystavené doklady zůstanou beze změny. Hromadnou AI úpravu dělá shopzi_manage_ai_run.

  • Oprávnění: products:write, u klíče „Katalog: produkty, kategorie a číselníky (zápis)“.
  • Druh: zápis, který umí přepsat nebo smazat existující data (destructiveHint), sahá mimo obchod na veřejný internet (openWorldHint).
  • Potvrzení přes MCP: podle operation, viz seznam níž.
  • Kredity a platba kartou: ne.
  • Deník změn: výsledek nese change_id. Pro shopzi_undo_change.
  • Věta o důsledku, kterou člověk uvidí v potvrzení: podle operation, viz seznam níž.

shopzi_manage_product: operace (produkt a zařazení)

  • create (založit)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • update (upravit)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • archive (archivovat)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Archivace stáhne produkt z e-shopu zákazníkům i z vyhledávačů. Vrátit to jde jedním krokem přes „vrátit zpět“.

  • assign_category (přiřadit kategorii)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • unassign_category (odebrat z kategorie)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • set_categories (nastavit zařazení do kategorií)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Když je Agent nastavuje najednou, nastaví se kategorie jako CELÁ sada: kategorie, která na kartě není, z produktu zmizí.

  • bulk_status (hromadně přepnout stav)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Hromadná změna stavu se provede na VŠECH produktech vypsaných níž, naráz a přesně na nich (jiných se nedotkne): publikování je zveřejní v e-shopu, koncept a archivace je z něj stáhnou zákazníkům i z vyhledávačů. Vrátit to jde jedním krokem přes „vrátit zpět“, celou dávku najednou.

  • delete_samples (uklidit ukázkové produkty)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Úklid ukázkových produktů vzít zpět nejde: s produkty se smažou i jejich fotky z úložiště a zásoba se odepíše. Týká se jen produktů ze startovního obsahu, kterých se od té doby nikdo nedotkl, a dávku si vybírá sám, takže karta níž NEUKÁŽE ani jejich počet, ani jména: nechte si je před potvrzením vypsat („vyjmenuj ukázkové produkty, které bys smazal“).

  • seed_starter_content (založit startovní ukázkový obsah)

    • Potvrzení přes MCP: ano: odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Do obchodu se vloží startovní ukázkový obsah jako po průvodci prvním spuštěním: ukázkové obrázky ve vaší barvě, tři ukázkové produkty (jen do katalogu bez vlastních produktů) a obrázková domovská stránka (jen nedotčená, upravenou nepřepíše). Je to nevratné: ukázkový produkt se první vaší úpravou stane vaším a nedotčené ukázky smaže až úklid ukázkových produktů.

Hodnota bez odrážky Věta o důsledku v potvrzení žádnou takovou větu nemá.

shopzi_manage_product: operace (karty editoru)

  • save_modifiers (přepsat modifikátory)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Uložení modifikátorů PŘEPÍŠE celou jejich sadu: co v ní není, z produktu zmizí.

  • save_attributes (přepsat vlastnosti)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Uložení vlastností PŘEPÍŠE celou jejich sadu: co v ní není, z produktu zmizí.

  • save_links (přepsat propojení s produkty)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Uložení vazeb PŘEPÍŠE celou jejich sadu: co v ní není, z produktu zmizí.

  • save_page_content (uložit obsah stránky produktu)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Bloky obsahu pod produktem se nahradí CELOU sadou: blok, který v seznamu není, zmizí.

Hodnota bez odrážky Věta o důsledku v potvrzení žádnou takovou větu nemá.

shopzi_manage_product: operace (varianty, ceny a DPH)

  • add_variants (přidat varianty)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • update_variants (upravit údaje variant)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • set_wholesale_price (nastavit velkoobchodní cenu)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • set_wholesale_terms (nastavit podmínky velkoobchodu)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • set_retail_price (změnit cenu)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • set_retail_prices (změnit ceny po variantách)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • remove_variants (odebrat varianty)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Odebrané varianty zmizí z e-shopu i z produktu a vzít to zpět nejde: znovu je lze jen přidat jako nové, s novou cenou a bez historie cen. Variantu se zásobou, s objednávkami nebo v balíčku Agent neodebere.

  • set_variant_axes (rozdělit produkt na varianty)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Z jednoduchého produktu se stane variantní. Stávající varianta si ponechá cenu, zásobu i SKU, nové varianty přibudou s cenou z karty. Vzít zpět to nejde: zpátky na jednoduchý produkt to převede jen převod, který varianty odebere.

  • collapse_to_simple (převést na produkt bez variant)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Variantní produkt se převede na jednoduchý: všechny varianty a vlastnosti, podle kterých se lišily, zmizí a zůstane jedna varianta s cenou a údaji té výchozí. Vzít zpět to nejde. Produkt, jehož varianta má zásobu, objednávky nebo je v balíčku, Agent nepřevede.

  • set_vat_rate (změnit sazbu DPH)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Nová sazba DPH platí pro všechny varianty a další prodeje. Cena s DPH zůstává, mění se základ daně; už vystavené doklady se nemění. Vrátit to jde přes „vrátit zpět“.

Hodnota bez odrážky Věta o důsledku v potvrzení žádnou takovou větu nemá.

shopzi_manage_product: operace (import a smazání)

  • delete (smazat)

    • Potvrzení přes MCP: ano: odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Produkty se TRVALE smažou a je to nevratné: jejich fotky se smažou z úložiště, zásoba všech variant se odepíše do skladové knihy a produkt zmizí z e-shopu, z výsledků vyhledávání i z feedů. Objednávky, ve kterých byl, zůstanou beze změny. Jen stáhnout z prodeje jde archivací, která se vrací.

  • accept_import (přijmout výsledek importu)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Přijetí importu produkty nemění: ty už v obchodě leží jako koncepty. Zavře ale obrazovku s výsledkem i tlačítko „Zahodit vše“, takže hromadně se toho importu pak zbavit nedá. Kolik produktů to je, v jakém rozpětí mají ceny a jak se jmenují, stojí na kartě níž. Přijetí jde vzít zpět: obrazovka i tlačítko se vrátí.

  • import_from_url (připravit import z jiného e-shopu)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Uložení modifikátorů, vlastností, vazeb nebo složení balíčku PŘEPÍŠE celou tu sadu: co v ní není, z produktu zmizí; u kategorií to platí stejně, když je Agent nastavuje najednou. Hromadná změna stavu se provede na VŠECH produktech vypsaných níž, naráz a přesně na nich (jiných se nedotkne): publikování je zveřejní v e-shopu, koncept a archivace je z něj stáhnou zákazníkům i z vyhledávačů. Vrátit to jde jedním krokem přes „vrátit zpět“, celou dávku najednou. Úklid ukázkových produktů vzít zpět nejde: s produkty se smažou i jejich fotky z úložiště a zásoba se odepíše. Týká se jen produktů ze startovního obsahu, kterých se od té doby nikdo nedotkl, a dávku si vybírá sám, takže karta níž NEUKÁŽE ani jejich počet, ani jména: nechte si je před potvrzením vypsat („vyjmenuj ukázkové produkty, které bys smazal“). Trvalé smazání produktu je nevratné: smažou se i jeho fotky z úložiště a zásoba variant se odepíše. Spuštění, zastavení a zahození importu jsou nevratné stejně. Přijetí importu produkty nemění: ty už v obchodě leží jako koncepty. Zavře ale obrazovku s výsledkem i tlačítko „Zahodit vše“, takže hromadně se toho importu pak zbavit nedá. Kolik produktů to je, v jakém rozpětí mají ceny a jak se jmenují, stojí na kartě níž. Přijetí jde vzít zpět: obrazovka i tlačítko se vrátí.

  • commit_import (spustit import z jiného e-shopu)

    • Potvrzení přes MCP: ano: odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Spustí se import VŠECH nalezených produktů z náhledu jako konceptů, bez textů od AI (kredity se neúčtují). Fotky se přehostí do úložiště obchodu a počítají se do tarifu a ze starých adres vzniknou přesměrování 301. Je to nevratné: běžící import jde jen zastavit a doběhlý zahodit, obojí i s jeho produkty.

  • cancel_import (zastavit import a smazat, co založil)

    • Potvrzení přes MCP: ano: odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Import se zastaví a co už stihl zapsat, se smaže: produkty, řádky jejich fotek v úložišti a přesměrování mířící na jejich adresy, i ta, která jste na ně napsali ručně. Je to nevratné a utracené kredity se nevracejí.

  • discard_import (zahodit import i s produkty)

    • Potvrzení přes MCP: ano: odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Doběhlý import se zahodí: smažou se všechny jeho produkty, řádky jejich fotek v úložišti a přesměrování mířící na jejich adresy, i ta, která jste na ně napsali ručně. Je to nevratné a utracené kredity se nevracejí.

  • import_csv (založit produkty ze souboru CSV)

    • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

    • Věta o důsledku v potvrzení:

      Ze souboru se založí produkty až do limitu tarifu; řádek se sloupcem stavu „active“ se rovnou zveřejní v e-shopu, ostatní vzniknou jako koncepty. Jedním krokem to vrátit nejde, založené produkty se mažou zvlášť. Náhled (bez zápisu) nic nemění.

Hodnota bez odrážky Věta o důsledku v potvrzení žádnou takovou větu nemá.

shopzi_manage_product: parametry operation až minWholesaleQty

  • operation (jedna z hodnot create, update, archive, assign_category, unassign_category, set_categories, save_modifiers, save_attributes, save_links, save_page_content, add_variants, update_variants, bulk_status, set_wholesale_price, set_wholesale_terms, set_retail_price, set_retail_prices, delete_samples, seed_starter_content, delete, accept_import, import_from_url, commit_import, cancel_import, discard_import, import_csv, remove_variants, set_variant_axes, collapse_to_simple a set_vat_rate; povinný): Operace, viz popis nástroje. accept_import = potvrdit hotový import („Uložit vše“); produkty už leží jako koncepty.
  • productId (UUID; nepovinný): ID produktu ze shopzi_search_products. Povinné u všeho kromě create.
  • categoryId (UUID; nepovinný): ID kategorie ze shopzi_list_catalog (resource: categories). Povinné u assign_category a unassign_category.
  • categoryIds (pole, položka: UUID; nepovinný): Jen u set_categories: CELÁ sada kategorií ze shopzi_list_catalog (categories); chybějící se odebere, prázdná vyřadí ze všech.
  • primaryCategoryId (UUID; nepovinný): Jen u set_categories: hlavní kategorie z categoryIds; vynechaná = první.
  • productIds (pole, položka: UUID, 1 až 100 položek; nepovinný): U bulk_status, delete, set_wholesale_terms a hromadného assign_category: vyjmenovaná ID ze shopzi_search_products, nejvýše 100, žádný filtr.
  • jobId (UUID; nepovinný): Import z imports: u accept_import vynechané = poslední; u commit_import, cancel_import a discard_import povinné.
  • variantIds (pole, položka: UUID, 1 až 100 položek; nepovinný): Jen u set_wholesale_price, set_retail_price a remove_variants: vyjmenovaná ID ze shopzi_get_product, nejvýše 100, žádný filtr.
  • wholesaleNetMinor (celé číslo nebo null; nepovinný): Jen u set_wholesale_price: jedna cena v haléřích pro celou dávku; povinné, null cenu z ceníku smaže (prodej za běžnou cenu).
  • wholesalePrices (pole objektů, 1 až 100 položek; nepovinný): Jen u set_wholesale_price, místo variantIds + wholesaleNetMinor: vlastní cena každé variantě, nejvýše 100.
  • wholesalePrices[].variantId (UUID; povinný)
  • wholesalePrices[].wholesaleNetMinor (celé číslo nebo null; povinný): Cena v haléřích; prázdná hodnota ji z ceníku smaže.
  • wholesalePriceBasis (jedna z hodnot net a gross; nepovinný): Jen u set_wholesale_price: net (výchozí) = částka bez DPH, gross = s DPH; ukládá se bez DPH.
  • retailPriceMinor (celé číslo; nepovinný): Jen u set_retail_price: nová běžná cena S DPH v haléřích (999 Kč = 99900) pro celou dávku.
  • retailCompareAtMinor (celé číslo nebo null; nepovinný): Jen u set_retail_price: přeškrtnutá cena v haléřích nad novou cenou (ohlásí slevu); vynechaná = ponechat, null = zrušit.
  • retailPrices (pole objektů, nejvýš 100 položek; nepovinný): Jen u set_retail_prices: vlastní běžná cena každé variantě, nejvýše 100.
  • retailPrices[].variantId (UUID; povinný)
  • retailPrices[].retailPriceMinor (celé číslo; povinný): Běžná cena S DPH v haléřích.
  • retailPrices[].retailCompareAtMinor (celé číslo nebo null; nepovinný): Přeškrtnutá cena; vynechaná = ponechat, null = zrušit.
  • wholesaleEnabled (true nebo false; nepovinný): Jen u set_wholesale_terms: prodávat velkoobchodně; vypnutý produkt má i pro velkoobchod běžnou cenu.
  • minWholesaleQty (celé číslo; nepovinný): Jen u set_wholesale_terms: minimální odběr na řádek objednávky; 1 = bez minima.
  • fields (objekt; nepovinný): Údaje produktu: u create celý nový produkt, u update jen měněná pole (cenu, DPH ani SKU ne), u bulk_status status, u set_vat_rate vatRate.
  • fields.title (text; nepovinný): Název produktu, povinný při zakládání.
  • fields.slug (text; nepovinný): Adresa (malá písmena, číslice, pomlčky), vynechaná se odvodí z názvu. U update samostatným voláním, stará přesměruje 301.
  • fields.subtitle (text nebo null; nepovinný)
  • fields.shortDescription (text, nejvýš 400 znaků nebo null; nepovinný): Krátký souhrn u nákupního boxu, prostý text bez HTML, nejvýš 400 znaků.
  • fields.description (text nebo null; nepovinný): Hlavní popis (HTML).
  • fields.availabilityNote (text nebo null; nepovinný)
  • fields.status (jedna z hodnot draft, active a archived; nepovinný): Výchozí draft; active = do prodeje, rozhoduje obchodník.
  • fields.brand (text nebo null; nepovinný): Značka; propojí se s kartou značky téhož jména (chybějící založí). null ji odebere.
  • fields.withdrawalExcluded (true nebo false; nepovinný): true = bez 14denního odstoupení (§ 1837); nastavujte jen na pokyn obchodníka.
  • fields.manufacturerName (text nebo null; nepovinný): GPSR: název výrobce.
  • fields.manufacturerAddress (objekt nebo null; nepovinný): GPSR: adresa výrobce, celá.
  • fields.manufacturerAddress.street (text; nepovinný)
  • fields.manufacturerAddress.city (text; nepovinný)
  • fields.manufacturerAddress.zip (text; nepovinný)
  • fields.manufacturerAddress.country (text; nepovinný)
  • fields.manufacturerAddress.email (text; nepovinný)
  • fields.responsiblePerson (objekt nebo null; nepovinný): GPSR: odpovědná osoba v EU, celá.
  • fields.responsiblePerson.name (text; nepovinný)
  • fields.responsiblePerson.street (text; nepovinný)
  • fields.responsiblePerson.city (text; nepovinný)
  • fields.responsiblePerson.zip (text; nepovinný)
  • fields.responsiblePerson.country (text; nepovinný)
  • fields.responsiblePerson.email (text; nepovinný)
  • fields.ogImageUrl (text, nejvýš 2000 znaků nebo null; nepovinný): Obrázek pro sdílení; bez něj hlavní fotka.
  • fields.canonicalOverride (text, nejvýš 2000 znaků nebo null; nepovinný): Kanonická adresa, jen když je originálem jiná stránka.
  • fields.productType (jedna z hodnot physical, digital, service, gift_card, bundle a subscription; nepovinný): Druh zboží, výchozí physical. U update samostatným voláním; s objednávkami nebo zásobou odmítne.
  • fields.priceMinor (číslo; nepovinný): Jen při zakládání: cena s DPH v haléřích, celé číslo (129 Kč = 12900). Později set_retail_price.
  • fields.compareAtMinor (číslo; nepovinný): Přeškrtnutá cena v haléřích, jen nad priceMinor.
  • fields.vatRate (číslo; nepovinný): Sazba DPH v celých procentech (21, 12 nebo 0). U existujícího produktu jen set_vat_rate.
  • fields.sku (text; nepovinný): Katalogové číslo výchozí varianty.
  • fields.ean (text; nepovinný): Čárový kód (EAN) výchozí varianty.
  • fields.weightGrams (číslo; nepovinný): Jen při zakládání: hmotnost v gramech pro všechny zakládané varianty.
  • fields.dimensionsMm (objekt; nepovinný): Jen při zakládání: rozměry zásilky v milimetrech (délka, šířka, výška), celá čísla.
  • fields.dimensionsMm.l (číslo; povinný)
  • fields.dimensionsMm.w (číslo; povinný)
  • fields.dimensionsMm.h (číslo; povinný)
  • fields.costMinor (číslo; nepovinný): Jen při zakládání: nákupní cena bez DPH v haléřích.
  • fields.customParams (objekt s libovolnými klíči, hodnota: text; nepovinný): Jen při zakládání: volné parametry do tabulky Parametry, např. {"Materiál":"Kamenina"}.
  • fields.categoryIds (pole, položka: text; nepovinný): ID kategorií, první je hlavní; bez kategorie produkt chybí ve výpisech.
  • fields.metaTitle (text nebo null; nepovinný): SEO titulek. null smaže.
  • fields.metaDescription (text nebo null; nepovinný): SEO popisek (meta description). null smaže.
  • fields.geoSummary (text nebo null; nepovinný): Stručná přímá odpověď pro AI vyhledávače (GEO). Dvě až tři věty. null smaže.
  • fields.noindex (true nebo false; nepovinný): true = stránku nemají vyhledávače indexovat.
  • modifiers (pole objektů; nepovinný): Jen u save_modifiers: CELÁ sada skupin modifikátorů.
  • modifiers[].name (text; povinný)
  • modifiers[].modifierType (jedna z hodnot addon, removal, choice a other; nepovinný): addon = doplněk, removal = odebrání součásti, choice = volba (výchozí), other = ostatní.
  • modifiers[].isRequired (true nebo false; nepovinný)
  • modifiers[].minSelections (číslo; nepovinný)
  • modifiers[].maxSelections (číslo nebo null; nepovinný): null = bez omezení.
  • modifiers[].options (pole objektů; povinný): Volby v pořadí zobrazení.
  • modifiers[].options[].name (text; povinný)
  • modifiers[].options[].description (text, nejvýš 240 znaků nebo null; nepovinný): Pomocná věta pod názvem volby v nákupním boxu, třeba co napsat do poznámky; prostý text.
  • modifiers[].options[].priceDeltaMinor (číslo; nepovinný): Příplatek v haléřích, smí být záporný. Výchozí 0.
  • modifiers[].options[].isDefault (true nebo false; nepovinný)
  • modifiers[].options[].isActive (true nebo false; nepovinný)
  • attributes (pole objektů; nepovinný): Jen u save_attributes: CELÁ sada filtrovatelných vlastností, bez vlastností variant.
  • attributes[].attributeKey (text; povinný): Klíč vlastnosti ze shopzi_list_catalog (attributes).
  • attributes[].valueText (text nebo null; nepovinný)
  • attributes[].valueNumeric (číslo nebo null; nepovinný)
  • attributes[].valueBool (true nebo false nebo null; nepovinný)
  • attributes[].unit (text nebo null; nepovinný)
  • attributes[].isFilterable (true nebo false; nepovinný): false = jen v popisu, ne jako filtr. Výchozí true.
  • customParams (objekt s libovolnými klíči, hodnota: text, nejvýš 500 znaků nebo číslo nebo true nebo false; nepovinný): Jen u save_attributes: CELÁ sada volných parametrů (custom_params); vynechané = beze změny, {} je smaže.
  • links (pole objektů; nepovinný): Jen u save_links: CELÁ sada vazeb na jiné produkty.
  • links[].linkedProductId (UUID; povinný): ID produktu ze shopzi_search_products.
  • links[].linkType (jedna z hodnot related, cross_sell, up_sell, accessory, replacement, bundle_member a variant_of; povinný): related = související, cross_sell = k tomu se hodí, up_sell = dražší alternativa, accessory = příslušenství, replacement = náhrada, bundle_member = součást balíčku, variant_of = jiné provedení.

shopzi_manage_product: parametry variants až idempotencyKey

  • variants (pole objektů; nepovinný): U add_variants: jen NOVÉ varianty. U create s axes: všechny varianty, každá kombinace jednou, první výchozí. U set_variant_axes: nové varianty vedle stávající.
  • variants[].axisValues (objekt s libovolnými klíči, hodnota: text; povinný): Hodnota každé vlastnosti varianty podle klíče, např. {"velikost":"XL","barva":"Modrá"}; nová hodnota se doplní.
  • variants[].sku (text nebo null; nepovinný): Jedinečné katalogové číslo.
  • variants[].ean (text nebo null; nepovinný)
  • variants[].priceMinor (číslo; povinný): Cena varianty s DPH v haléřích, celé číslo (129 Kč = 12900).
  • csvText (text, nejvýš 2000000 znaků; nepovinný): Jen import_csv: CSV s čárkou a řádkem hlaviček (slug, title, brand, product_type, status, ai_generated, manufacturer_name, sku, gtin, ean, mpn, price_minor, compare_at_minor, description), tvar exportu katalogu; povinné slug a title, price_minor v haléřích, status active zveřejní.
  • csvDryRun (true nebo false; nepovinný): Jen import_csv: true = jen náhled, nic se nezapíše.
  • starterPhase (jedna z hodnot images, products a layout; nepovinný): Jen seed_starter_content: images (ukázkové obrázky), products (ukázkové produkty, jen do katalogu bez vlastních), layout (nedotčená domovská stránka). Bez něj všechny tři.
  • sourceUrl (text, nejvýš 300 znaků; nepovinný): Jen u import_from_url: kořenová adresa cizího e-shopu (https://obchod.cz), ne kategorie.
  • axes (pole objektů, nejvýš 3 položky; nepovinný): U create a set_variant_axes: vlastnosti, které určují varianty (velikost, barva).
  • axes[].attributeKey (text; povinný): Klíč vlastnosti, například velikost nebo barva.
  • axes[].label (text; povinný): Název pro zákazníka.
  • axes[].values (pole, položka: text, 1 až 30 položek; povinný): Hodnoty v pořadí nabídky.
  • baseAxisValues (objekt s libovolnými klíči, hodnota: text; nepovinný): Jen u set_variant_axes: hodnoty axes pro stávající variantu, která zůstane výchozí.
  • pageContent (objekt; nepovinný): Jen u save_page_content: pole ke změně; vynechané zůstane beze změny.
  • pageContent.sizeGuideMode (jedna z hodnot inherit, custom a none; nepovinný): Tabulka velikostí: inherit = podle kategorie, custom = sizeGuideId, none = nezobrazovat.
  • pageContent.sizeGuideId (text nebo null; nepovinný): Jen u sizeGuideMode: custom: ID ze shopzi_list_catalog (size_guides).
  • pageContent.descriptionMode (jedna z hodnot text a builder; nepovinný): text = pole Popis; builder = bloky sestaveného popisu.
  • pageContent.descriptionHeadingMode (jedna z hodnot inherit, custom a hidden; nepovinný): Nadpis nad popisem.
  • pageContent.descriptionHeading (text, nejvýš 80 znaků nebo null; nepovinný): Jen u descriptionHeadingMode: custom: text nadpisu.
  • pageContent.contentWidth (jedna z hodnot boxed a full; nepovinný): Šířka sestaveného popisu.
  • pageContent.pageTemplateKey (text, nejvýš 40 znaků nebo null; nepovinný): Varianta šablony stránky produktu (klíč z shopzi_list_content page_templates); null = podle kategorie, jinak výchozí šablona.
  • pageContent.blocks (pole objektů, nejvýš 40 položek; nepovinný): CELÁ sada bloků sestaveného popisu v pořadí.
  • pageContent.blocks[].sectionType (jedna z hodnot heading, rich_text, image, image_text, gallery, video, banner, columns, spacer, notice, usp_strip, process_steps, faq a promo_split; povinný)
  • pageContent.blocks[].config (objekt s libovolnými klíči; povinný): Nastavení bloku jako v editoru stránek.
  • pageContent.blocks[].isActive (true nebo false; nepovinný)
  • pageContent.panelOverrides (pole objektů; nepovinný): CELÁ sada výjimek informačních panelů; null = podle nastavení panelu.
  • pageContent.panelOverrides[].panelId (text; povinný)
  • pageContent.panelOverrides[].mode (jedna z hodnot show a hide, nebo null; povinný)
  • variantUpdates (pole objektů; nepovinný): Jen u update_variants: existující varianty podle ID, jen měněná pole (cenu ne).
  • variantUpdates[].variantId (UUID; povinný): ID varianty ze shopzi_get_product (u jednoduchého produktu ta s is_default: true).
  • variantUpdates[].sku (text nebo null; nepovinný): Jedinečné katalogové číslo; prázdné ho vymaže.
  • variantUpdates[].ean (text nebo null; nepovinný)
  • variantUpdates[].gtin (text nebo null; nepovinný)
  • variantUpdates[].mpn (text nebo null; nepovinný)
  • variantUpdates[].weightGrams (číslo nebo null; nepovinný): Hmotnost v gramech (1,2 kg = 1200); bez ní dopravce zásilku nenacení.
  • variantUpdates[].dimensionsMm (objekt nebo null; nepovinný): Rozměry zásilky v milimetrech (délka, šířka, výška); podle nich se nabízí doprava.
  • variantUpdates[].dimensionsMm.l (číslo; povinný)
  • variantUpdates[].dimensionsMm.w (číslo; povinný)
  • variantUpdates[].dimensionsMm.h (číslo; povinný)
  • variantUpdates[].isDefault (true nebo false; nepovinný): true = výchozí varianta; výchozí se jen přenáší, vypnout nejde.
  • variantUpdates[].lowStockThreshold (číslo nebo null; nepovinný): Vlastní práh nízkého stavu; null nebo 0 = práh obchodu.
  • idempotencyKey (text, 1 až 200 znaků; nepovinný): Klíč idempotence: s tímtéž klíčem proběhne zápis jen jednou, opakování vrátí původní výsledek. Pro každou změnu nový.

shopzi_manage_ai_run

Spustí hromadnou AI úpravu textů a fotek vyjmenovaných produktů nebo návrh nových konceptů produktů podle zadání, znovu napíše návrh jednoho produktu, zastaví běžící úpravu a vrátí dokončenou. Úprava vyrábí návrhy, které obchodník schvaluje v Produktech; stav úprav vrací shopzi_list_catalog s resource ai_runs.

  • Oprávnění: products:write, u klíče „Katalog: produkty, kategorie a číselníky (zápis)“.
  • Druh: zápis, který umí přepsat nebo smazat existující data (destructiveHint).
  • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • Kredity a platba kartou: podle operation, viz seznam níž.
  • Deník změn: výsledek nese change_id. Pro shopzi_undo_change.
  • Věta o důsledku, kterou člověk uvidí v potvrzení: podle operation, viz seznam níž.

shopzi_manage_ai_run: operace

  • start_ai_run (spustit a zaplatit hromadnou AI úpravu)

    • Kredity a platba kartou: strhne kredity obchodu.

    • Věta o důsledku v potvrzení:

      Spuštění hromadné AI úpravy STOJÍ KREDITY: strhávají se při zadání a nevracejí se, ani když se výsledek nelíbí. Kolik to bude a kolik vám zbývá, stojí na kartě níž. Do produktů se ale nic nezapíše: úprava vyrobí návrhy (v režimu nových produktů koncepty) a čeká, až je v Produktech schválíte vy, a stisknout „Použít“ za vás nemůžu. Vzít zpět to nejde.

  • regenerate_ai_item (napsat návrh znovu (další kredit))

    • Kredity a platba kartou: strhne kredity obchodu.

    • Věta o důsledku v potvrzení:

      Přegenerování jednoho návrhu je další kredit a původní návrh přepíše. Vzít zpět to nejde.

  • cancel_ai_run (zastavit hromadnou AI úpravu)

    • Kredity a platba kartou: ne.

    • Věta o důsledku v potvrzení:

      Zastavení hromadné AI úpravy platí pro tu, která PRÁVĚ BĚŽÍ: doběhne rozpracovaná položka, kredity za ni se nevracejí a znovu se ta úprava nerozjede. Vzít zpět to nejde.

  • revert_ai_run (vrátit hromadnou AI úpravu)

    • Kredity a platba kartou: ne.

    • Věta o důsledku v potvrzení:

      Vrácení platí pro zvolenou (nebo poslední) dokončenou úpravu a přepíše zpátky jen ty hodnoty, které se pořád rovnají tomu, co napsala AI, takže vaše pozdější úpravy zůstanou; fotky, které úprava k produktům přidala, se ale smažou z úložiště. Vzít zpět to nejde.

Hodnota bez odrážky Věta o důsledku v potvrzení žádnou takovou větu nemá.

shopzi_manage_ai_run: parametry

  • operation (jedna z hodnot start_ai_run, regenerate_ai_item, cancel_ai_run a revert_ai_run; povinný): Operace, viz popis nástroje.
  • aiMode (jedna z hodnot edit a create; nepovinný): Jen start_ai_run: edit (výchozí) = vyjmenované produkty, create = nové koncepty.
  • productIds (pole, položka: UUID, 1 až 300 položek; nepovinný): Jen start_ai_run v režimu edit: vyjmenovaná ID ze shopzi_search_products, bez filtru.
  • productId (UUID; nepovinný): Jen regenerate_ai_item: produkt, jehož návrh se přepíše.
  • itemId (UUID; nepovinný): Jen regenerate_ai_item místo productId (u konceptu z režimu create): položka ze shopzi_list_catalog (ai_runs s entityId).
  • aiContentFields (pole, položka: jedna z hodnot title, short_description, description, meta_title, meta_description, geo_summary, faq a attributes; nepovinný): Jen start_ai_run: textová pole k napsání; v režimu edit aspoň jedno pole nebo jedna operace s fotkami.
  • aiImageOps (pole, položka: jedna z hodnot alt_text, image_generate_missing, image_upscale, image_background a image_style_transfer; nepovinný): Jen start_ai_run v režimu edit: operace s fotkami, účtují se za každou fotku; image_style_transfer podle aiStyleRefProductId.
  • aiStyleRefProductId (UUID; nepovinný): Jen s image_style_transfer: vzorový produkt, který pojmenoval obchodník; nikdy ho nevybírejte sami.
  • aiFillMissingOnly (true nebo false; nepovinný): Jen start_ai_run v režimu edit: true = jen PRÁZDNÁ pole (obchodník řekl „doplň“, ne „přepiš“).
  • aiInstructions (text, nejvýš 600 znaků; nepovinný): Jen start_ai_run v režimu edit: pokyn k tónu a délce textů.
  • aiBrief (text, nejvýš 2000 znaků; nepovinný): Jen režim create: co navrhnout, aspoň 20 znaků.
  • aiCreateCount (celé číslo od 1 do 20; nepovinný): Jen režim create: kolik konceptů navrhnout, 1 až 20.
  • aiCreateImages (true nebo false; nepovinný): Jen režim create: true = i fotka ke konceptu, účtuje se zvlášť.
  • aiCreatePriceMinor (celé číslo aspoň 0; nepovinný): Jen režim create: cena s DPH v haléřích pro všechny koncepty.
  • aiCategoryNames (pole, položka: text, 1 až 60 znaků, nejvýš 20 položek; nepovinný): Jen režim create: názvy kategorií pro koncepty, nové vzniknou po schválení; vynechané navrhne AI.
  • note (text, nejvýš 300 znaků; nepovinný): Jen regenerate_ai_item: co bylo na návrhu špatně.
  • runId (UUID; nepovinný): Jen revert_ai_run: běh z ai_runs, vynechaný = poslední.
  • idempotencyKey (text, 1 až 200 znaků; nepovinný): Klíč idempotence: s tímtéž klíčem proběhne zápis jen jednou, opakování vrátí původní výsledek. Pro každou změnu nový.

shopzi_manage_category

Založí, upraví (včetně obrázku kategorie z knihovny médií a variant šablon výpisu a stránky produktů), přesune, přeskládá nebo smaže kategorii ve stromu o nejvýš třech úrovních. Kategorii s podkategoriemi nebo s produkty smazat odmítne.

  • Oprávnění: products:write, u klíče „Katalog: produkty, kategorie a číselníky (zápis)“.
  • Druh: zápis, který umí přepsat nebo smazat existující data (destructiveHint).
  • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
  • Kredity a platba kartou: ne.
  • Deník změn: výsledek nese change_id. Pro shopzi_undo_change.

shopzi_manage_category: operace

  • create (založit)
  • update (upravit)
  • move (přesunout)
  • reorder (změnit pořadí)
  • delete (smazat)

shopzi_manage_category: parametry

  • operation (jedna z hodnot create, update, move, reorder a delete; povinný): Operace, viz popis nástroje.
  • categoryId (text; nepovinný): ID kategorie ze shopzi_list_catalog. Povinné u update, move a delete.
  • parentId (text nebo null; nepovinný): Nadřazená kategorie u create, move a reorder; null = nejvyšší úroveň.
  • position (číslo; nepovinný): Jen u move: pořadí mezi sourozenci, 0 = první.
  • orderedIds (pole, položka: text; nepovinný): Jen u reorder: ID VŠECH kategorií dané úrovně v novém pořadí.
  • fields (objekt; nepovinný): U create nová kategorie, u update jen měněná pole.
  • fields.name (text; nepovinný): Název, povinný při zakládání.
  • fields.slug (text; nepovinný): Adresa; u create vynechaná se odvodí z názvu. U update samotná: změní i podkategorie, staré adresy přesměrují 301.
  • fields.descriptionHtml (text nebo null; nepovinný): Text nad výpisem (HTML).
  • fields.descriptionHtmlBottom (text nebo null; nepovinný): Text pod výpisem (HTML).
  • fields.h1Override (text nebo null; nepovinný)
  • fields.isFeatured (true nebo false; nepovinný)
  • fields.showInMenu (true nebo false; nepovinný)
  • fields.imageUrl (text nebo null; nepovinný): Obrázek kategorie, /media/… z knihovny médií obchodu; null ho odebere.
  • fields.pageTemplateKey (text, nejvýš 40 znaků nebo null; nepovinný): Varianta šablony výpisu (page_templates, druh collection); dědí podkategorie, null = zdědit.
  • fields.productTemplateKey (text, nejvýš 40 znaků nebo null; nepovinný): Varianta šablony detailu produktů v kategorii a podkategoriích (druh product); null = zdědit.
  • fields.metaTitle (text nebo null; nepovinný): SEO titulek. null smaže.
  • fields.metaDescription (text nebo null; nepovinný): SEO popisek (meta description). null smaže.
  • fields.geoSummary (text nebo null; nepovinný): Stručná přímá odpověď pro AI vyhledávače (GEO). Dvě až tři věty. null smaže.
  • fields.noindex (true nebo false; nepovinný): true = stránku nemají vyhledávače indexovat.
  • idempotencyKey (text, 1 až 200 znaků; nepovinný): Klíč idempotence: s tímtéž klíčem proběhne zápis jen jednou, opakování vrátí původní výsledek. Pro každou změnu nový.

shopzi_save_catalog_entity

Spravuje značky a výrobce uvedené u produktů (vendor), definice vlastností (attribute), tabulky velikostí (size_guide) a informační panely stránky produktu (info_panel): založení, úpravu, kopii, smazání, pořadí, přiřazení kategoriím, šablony vlastností a karty značek podle produktů.

  • Oprávnění: products:write, u klíče „Katalog: produkty, kategorie a číselníky (zápis)“.

  • Druh: zápis, který umí přepsat nebo smazat existující data (destructiveHint).

  • Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

  • Kredity a platba kartou: ne.

  • Deník změn: výsledek nese change_id. Pro shopzi_undo_change.

  • Věta o důsledku, kterou člověk uvidí v potvrzení:

    Smazání vlastnosti NEMAŽE hodnoty u produktů, jen je schová: zmizí filtr ve výpisu i políčko v editoru a vrácení vlastnosti je zase zviditelní. Přeskládání pořadí je jen pořadí a taky se vrací. Smazání značky zruší u jejích produktů vazbu na kartu značky (text značky u produktu zůstane), stejně jako v administraci; vrácení značku postaví zpátky a produkty k ní zase připojí. Založení karet ze značek se provede přesně na značkách vypsaných níž a ty produkty na ně naváže; vrátit to jde jedním krokem, celou dávku najednou. Šablona vlastnosti, které obchod už má, nepřepisuje, jen je přeskočí.

shopzi_save_catalog_entity: oblasti

  • vendor (Značka nebo výrobce)
  • attribute (Vlastnost produktu)
  • size_guide (Tabulka velikostí)
  • info_panel (Informační panel)

shopzi_save_catalog_entity: operace

  • save (uložit)
  • delete (smazat)
  • reorder (změnit pořadí)
  • create_from_brands (založit značky podle produktů)
  • apply_preset (přidat šablonu vlastností)
  • duplicate (vytvořit kopii)

shopzi_save_catalog_entity: parametry

  • resource (jedna z hodnot vendor, attribute, size_guide a info_panel; povinný): Co se ukládá; fields musí patřit k němu.
  • operation (jedna z hodnot save, delete, reorder, create_from_brands, apply_preset a duplicate; nepovinný): apply_preset jen u attribute, create_from_brands u vendor, duplicate u size_guide a info_panel, reorder u všeho kromě značky.
  • id (text; nepovinný): Bez id se zakládá; s ním úprava, delete nebo duplicate.
  • axisDeleteConfirmed (true nebo false; nepovinný): Jen delete vlastnosti, která řídí varianty: true = obchodník výslovně potvrdil smazání (karta Varianty těch produktů přestane fungovat); bez toho nástroj odmítne.
  • orderedIds (pole, položka: text, nejvýš 200 položek; nepovinný): Jen reorder: ID VŠECH položek v novém pořadí, každé právě jednou.
  • brands (pole, položka: text, nejvýš 200 znaků, nejvýš 40 položek; nepovinný): Jen create_from_brands: vyjmenované názvy značek; bez nich nástroj vypíše nabídku.
  • presetKey (jedna z hodnot obleceni, elektronika, domacnost, sport a obecne; nepovinný): Jen apply_preset: šablona; existující vlastnosti přeskočí.
  • fields (objekt; nepovinný): Pole k uložení; vynechané zůstane beze změny.
  • fields.name (text; nepovinný): Značka: název, povinný při zakládání.
  • fields.slug (text; nepovinný): Značka: adresa jen při zakládání, jinak z názvu.
  • fields.perex (text nebo null; nepovinný)
  • fields.descriptionHtml (text nebo null; nepovinný): Značka: popis na její stránce (HTML).
  • fields.websiteUrl (text nebo null; nepovinný)
  • fields.email (text nebo null; nepovinný)
  • fields.phone (text nebo null; nepovinný)
  • fields.region (text nebo null; nepovinný)
  • fields.position (číslo; nepovinný): Pořadí, 0 = první.
  • fields.isFeatured (true nebo false; nepovinný)
  • fields.h1Override (text nebo null; nepovinný)
  • fields.label (text; nepovinný): Vlastnost: název pro zákazníka, povinný při zakládání.
  • fields.control (jedna z hodnot select, range, boolean a swatch; nepovinný): Vlastnost: swatch = barevné vzorky, range = číselný rozsah.
  • fields.options (pole objektů; nepovinný): Vlastnost: CELÁ sada hodnot, povinná u select a swatch.
  • fields.options[].value (text; povinný)
  • fields.options[].color (text; nepovinný): U swatch: #RRGGBB.
  • fields.unit (text nebo null; nepovinný): Vlastnost: jednotka u range.
  • fields.isFilterable (true nebo false; nepovinný): Vlastnost: filtr ve výpisu.
  • fields.groupLabel (text nebo null; nepovinný)
  • fields.variantDisplay (jedna z hodnot auto, badges a list; nepovinný)
  • fields.isActive (true nebo false; nepovinný)
  • fields.templateKey (jedna z hodnot women-tops, women-bottoms, women-dresses, men-tops, men-bottoms, shoes, kids, bras, rings, hats, gloves a blank; nepovinný): Tabulka velikostí: šablona při zakládání.
  • fields.table (objekt; nepovinný): Tabulka velikostí: CELÁ tabulka; cells je text podle id sloupce, míry v cm.
  • fields.table.columns (pole objektů, nejvýš 20 položek; povinný)
  • fields.table.columns[].id (text; povinný)
  • fields.table.columns[].label (text; povinný)
  • fields.table.rows (pole objektů, nejvýš 60 položek; povinný)
  • fields.table.rows[].id (text; povinný)
  • fields.table.rows[].cells (objekt s libovolnými klíči, hodnota: text; povinný)
  • fields.introHtml (text; nepovinný): Tabulka velikostí: úvod (HTML).
  • fields.measureHtml (text; nepovinný): Tabulka velikostí: Jak měřit (HTML).
  • fields.imageUrl (text nebo null; nepovinný): Tabulka velikostí: ilustrace, /media/… z knihovny médií.
  • fields.categoryIds (pole, položka: text, nejvýš 200 položek; nepovinný): CELÁ sada kategorií tabulky velikostí (podkategorie dědí), nebo panelu se scope: categories.
  • fields.title (text; nepovinný): Informační panel: název, povinný při zakládání.
  • fields.bodyHtml (text; nepovinný): Informační panel: text (HTML).
  • fields.icon (jedna z hodnot info, shirt, droplets, leaf, scissors, truck, undo, shield, package, gift, ruler, sparkles, award a map-pin, nebo null; nepovinný)
  • fields.scope (jedna z hodnot all a categories; nepovinný): Informační panel: pro všechny produkty, nebo jen kategorie.
  • fields.metaTitle (text nebo null; nepovinný): SEO titulek. null smaže.
  • fields.metaDescription (text nebo null; nepovinný): SEO popisek (meta description). null smaže.
  • fields.geoSummary (text nebo null; nepovinný): Stručná přímá odpověď pro AI vyhledávače (GEO). Dvě až tři věty. null smaže.
  • fields.noindex (true nebo false; nepovinný): true = stránku nemají vyhledávače indexovat.
  • idempotencyKey (text, 1 až 200 znaků; nepovinný): Klíč idempotence: s tímtéž klíčem proběhne zápis jen jednou, opakování vrátí původní výsledek. Pro každou změnu nový.