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í.
Č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 hodnotsearchaexport, výchozísearch; nepovinný):export= celý katalog jako CSV, bez filtrů.jobId(UUID; nepovinný): Jenexport:export.job_idz 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;totalpak počítá jen shody.categoryId(__uncategorizednebo UUID; nepovinný): ID kategorie zeshopzi_list_catalog(categories), jen přímé zařazení, ne podstrom;__uncategorized= bez kategorie.status(text; nepovinný): Stav, např.activenebodraft.updatedSince(text se vzorem; nepovinný): ISO datum: jen produkty nové nebo změněné od té doby.sort(jedna z hodnotprice_ascaprice_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) zeshopzi_search_products.include(pole, položka: jedna z hodnotmodifiers,attributes,links,page_content,wholesaleadetails, nejvýš 6 položek; nepovinný): Karty navíc, jen potřebné: modifiers (úpravy s příplatkem a pomocným textem), attributes (icustom_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
categoriesvendorsattributesprice_listssize_guides(Tabulky velikostí)info_panelsai_runsimportswholesale_pricescategory_products
shopzi_list_catalog: parametry
resource(jedna z hodnotcategories,vendors,attributes,price_lists,size_guides,info_panels,ai_runs,imports,wholesale_pricesacategory_products; povinný): Která část katalogu.entityId(UUID; nepovinný): Jenai_runs: běh i s položkami; uimportsimport i s produkty; ucategory_productspovinná 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(truenebofalse; nepovinný): Jencategories: true přidá poleshopzi_manage_category(popisy, SEO, obrázek); zužtesearchnebolimit.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. Proshopzi_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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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.
- 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í
-
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 hodnotcreate,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_simpleaset_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 zeshopzi_search_products. Povinné u všeho kroměcreate.categoryId(UUID; nepovinný): ID kategorie zeshopzi_list_catalog(resource: categories). Povinné u assign_category a unassign_category.categoryIds(pole, položka: UUID; nepovinný): Jen uset_categories: CELÁ sada kategorií zeshopzi_list_catalog(categories); chybějící se odebere, prázdná vyřadí ze všech.primaryCategoryId(UUID; nepovinný): Jen uset_categories: hlavní kategorie zcategoryIds; vynechaná = první.productIds(pole, položka: UUID, 1 až 100 položek; nepovinný): Ubulk_status,delete,set_wholesale_termsa hromadnéhoassign_category: vyjmenovaná ID zeshopzi_search_products, nejvýše 100, žádný filtr.jobId(UUID; nepovinný): Import zimports: uaccept_importvynechané = poslední; ucommit_import,cancel_importadiscard_importpovinné.variantIds(pole, položka: UUID, 1 až 100 položek; nepovinný): Jen uset_wholesale_price,set_retail_pricearemove_variants: vyjmenovaná ID zeshopzi_get_product, nejvýše 100, žádný filtr.wholesaleNetMinor(celé číslo nebonull; nepovinný): Jen uset_wholesale_price: jedna cena v haléřích pro celou dávku; povinné,nullcenu z ceníku smaže (prodej za běžnou cenu).wholesalePrices(pole objektů, 1 až 100 položek; nepovinný): Jen uset_wholesale_price, místovariantIds+wholesaleNetMinor: vlastní cena každé variantě, nejvýše 100.wholesalePrices[].variantId(UUID; povinný)wholesalePrices[].wholesaleNetMinor(celé číslo nebonull; povinný): Cena v haléřích; prázdná hodnota ji z ceníku smaže.wholesalePriceBasis(jedna z hodnotnetagross; nepovinný): Jen uset_wholesale_price:net(výchozí) = částka bez DPH,gross= s DPH; ukládá se bez DPH.retailPriceMinor(celé číslo; nepovinný): Jen uset_retail_price: nová běžná cena S DPH v haléřích (999 Kč = 99900) pro celou dávku.retailCompareAtMinor(celé číslo nebonull; nepovinný): Jen uset_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 uset_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 nebonull; nepovinný): Přeškrtnutá cena; vynechaná = ponechat,null= zrušit.wholesaleEnabled(truenebofalse; nepovinný): Jen uset_wholesale_terms: prodávat velkoobchodně; vypnutý produkt má i pro velkoobchod běžnou cenu.minWholesaleQty(celé číslo; nepovinný): Jen uset_wholesale_terms: minimální odběr na řádek objednávky; 1 = bez minima.
shopzi_manage_product: parametry fields až links
fields(objekt; nepovinný): Údaje produktu: ucreatecelý nový produkt, uupdatejen měněná pole (cenu, DPH ani SKU ne), ubulk_statusstatus, uset_vat_ratevatRate.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. Uupdatesamostatným voláním, stará přesměruje 301.fields.subtitle(text nebonull; nepovinný)fields.shortDescription(text, nejvýš 400 znaků nebonull; nepovinný): Krátký souhrn u nákupního boxu, prostý text bez HTML, nejvýš 400 znaků.fields.description(text nebonull; nepovinný): Hlavní popis (HTML).fields.availabilityNote(text nebonull; nepovinný)fields.status(jedna z hodnotdraft,activeaarchived; nepovinný): Výchozídraft;active= do prodeje, rozhoduje obchodník.fields.brand(text nebonull; nepovinný): Značka; propojí se s kartou značky téhož jména (chybějící založí).nullji odebere.fields.withdrawalExcluded(truenebofalse; nepovinný): true = bez 14denního odstoupení (§ 1837); nastavujte jen na pokyn obchodníka.fields.manufacturerName(text nebonull; nepovinný): GPSR: název výrobce.fields.manufacturerAddress(objekt nebonull; 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 nebonull; 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ů nebonull; nepovinný): Obrázek pro sdílení; bez něj hlavní fotka.fields.canonicalOverride(text, nejvýš 2000 znaků nebonull; nepovinný): Kanonická adresa, jen když je originálem jiná stránka.fields.productType(jedna z hodnotphysical,digital,service,gift_card,bundleasubscription; nepovinný): Druh zboží, výchozíphysical. Uupdatesamostatný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ějiset_retail_price.fields.compareAtMinor(číslo; nepovinný): Přeškrtnutá cena v haléřích, jen nadpriceMinor.fields.vatRate(číslo; nepovinný): Sazba DPH v celých procentech (21, 12 nebo 0). U existujícího produktu jenset_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 nebonull; nepovinný): SEO titulek. null smaže.fields.metaDescription(text nebonull; nepovinný): SEO popisek (meta description). null smaže.fields.geoSummary(text nebonull; nepovinný): Stručná přímá odpověď pro AI vyhledávače (GEO). Dvě až tři věty. null smaže.fields.noindex(truenebofalse; nepovinný): true = stránku nemají vyhledávače indexovat.modifiers(pole objektů; nepovinný): Jen usave_modifiers: CELÁ sada skupin modifikátorů.modifiers[].name(text; povinný)modifiers[].modifierType(jedna z hodnotaddon,removal,choiceaother; nepovinný): addon = doplněk, removal = odebrání součásti, choice = volba (výchozí), other = ostatní.modifiers[].isRequired(truenebofalse; nepovinný)modifiers[].minSelections(číslo; nepovinný)modifiers[].maxSelections(číslo nebonull; 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ů nebonull; 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(truenebofalse; nepovinný)modifiers[].options[].isActive(truenebofalse; nepovinný)attributes(pole objektů; nepovinný): Jen usave_attributes: CELÁ sada filtrovatelných vlastností, bez vlastností variant.attributes[].attributeKey(text; povinný): Klíč vlastnosti zeshopzi_list_catalog(attributes).attributes[].valueText(text nebonull; nepovinný)attributes[].valueNumeric(číslo nebonull; nepovinný)attributes[].valueBool(truenebofalsenebonull; nepovinný)attributes[].unit(text nebonull; nepovinný)attributes[].isFilterable(truenebofalse; 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 nebotruenebofalse; nepovinný): Jen usave_attributes: CELÁ sada volných parametrů (custom_params); vynechané = beze změny,{}je smaže.links(pole objektů; nepovinný): Jen usave_links: CELÁ sada vazeb na jiné produkty.links[].linkedProductId(UUID; povinný): ID produktu zeshopzi_search_products.links[].linkType(jedna z hodnotrelated,cross_sell,up_sell,accessory,replacement,bundle_memberavariant_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ý): Uadd_variants: jen NOVÉ varianty. Ucreatesaxes: všechny varianty, každá kombinace jednou, první výchozí. Uset_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 nebonull; nepovinný): Jedinečné katalogové číslo.variants[].ean(text nebonull; nepovinný)variants[].priceMinor(číslo; povinný): Cena varianty s DPH v haléřích, celé číslo (129 Kč = 12900).csvText(text, nejvýš 2000000 znaků; nepovinný): Jenimport_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éslugatitle,price_minorv haléřích,statusactive zveřejní.csvDryRun(truenebofalse; nepovinný): Jenimport_csv: true = jen náhled, nic se nezapíše.starterPhase(jedna z hodnotimages,productsalayout; nepovinný): Jenseed_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 uimport_from_url: kořenová adresa cizího e-shopu (https://obchod.cz), ne kategorie.axes(pole objektů, nejvýš 3 položky; nepovinný): Ucreateaset_variant_axes: vlastnosti, které určují varianty (velikost, barva).axes[].attributeKey(text; povinný): Klíč vlastnosti, napříkladvelikostnebobarva.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 uset_variant_axes: hodnotyaxespro stávající variantu, která zůstane výchozí.pageContent(objekt; nepovinný): Jen usave_page_content: pole ke změně; vynechané zůstane beze změny.pageContent.sizeGuideMode(jedna z hodnotinherit,customanone; nepovinný): Tabulka velikostí: inherit = podle kategorie, custom =sizeGuideId, none = nezobrazovat.pageContent.sizeGuideId(text nebonull; nepovinný): Jen usizeGuideMode: custom: ID zeshopzi_list_catalog(size_guides).pageContent.descriptionMode(jedna z hodnottextabuilder; nepovinný): text = pole Popis; builder = bloky sestaveného popisu.pageContent.descriptionHeadingMode(jedna z hodnotinherit,customahidden; nepovinný): Nadpis nad popisem.pageContent.descriptionHeading(text, nejvýš 80 znaků nebonull; nepovinný): Jen udescriptionHeadingMode: custom: text nadpisu.pageContent.contentWidth(jedna z hodnotboxedafull; nepovinný): Šířka sestaveného popisu.pageContent.pageTemplateKey(text, nejvýš 40 znaků nebonull; nepovinný): Varianta šablony stránky produktu (klíč zshopzi_list_contentpage_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 hodnotheading,rich_text,image,image_text,gallery,video,banner,columns,spacer,notice,usp_strip,process_steps,faqapromo_split; povinný)pageContent.blocks[].config(objekt s libovolnými klíči; povinný): Nastavení bloku jako v editoru stránek.pageContent.blocks[].isActive(truenebofalse; 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 hodnotshowahide, nebonull; povinný)variantUpdates(pole objektů; nepovinný): Jen uupdate_variants: existující varianty podle ID, jen měněná pole (cenu ne).variantUpdates[].variantId(UUID; povinný): ID varianty zeshopzi_get_product(u jednoduchého produktu ta sis_default: true).variantUpdates[].sku(text nebonull; nepovinný): Jedinečné katalogové číslo; prázdné ho vymaže.variantUpdates[].ean(text nebonull; nepovinný)variantUpdates[].gtin(text nebonull; nepovinný)variantUpdates[].mpn(text nebonull; nepovinný)variantUpdates[].weightGrams(číslo nebonull; nepovinný): Hmotnost v gramech (1,2 kg = 1200); bez ní dopravce zásilku nenacení.variantUpdates[].dimensionsMm(objekt nebonull; 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(truenebofalse; nepovinný): true = výchozí varianta; výchozí se jen přenáší, vypnout nejde.variantUpdates[].lowStockThreshold(číslo nebonull; nepovinný): Vlastní práh nízkého stavu;nullnebo 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. Proshopzi_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 hodnotstart_ai_run,regenerate_ai_item,cancel_ai_runarevert_ai_run; povinný): Operace, viz popis nástroje.aiMode(jedna z hodnoteditacreate; nepovinný): Jenstart_ai_run:edit(výchozí) = vyjmenované produkty,create= nové koncepty.productIds(pole, položka: UUID, 1 až 300 položek; nepovinný): Jenstart_ai_runv režimuedit: vyjmenovaná ID zeshopzi_search_products, bez filtru.productId(UUID; nepovinný): Jenregenerate_ai_item: produkt, jehož návrh se přepíše.itemId(UUID; nepovinný): Jenregenerate_ai_itemmístoproductId(u konceptu z režimucreate): položka zeshopzi_list_catalog(ai_runssentityId).aiContentFields(pole, položka: jedna z hodnottitle,short_description,description,meta_title,meta_description,geo_summary,faqaattributes; nepovinný): Jenstart_ai_run: textová pole k napsání; v režimueditaspoň jedno pole nebo jedna operace s fotkami.aiImageOps(pole, položka: jedna z hodnotalt_text,image_generate_missing,image_upscale,image_backgroundaimage_style_transfer; nepovinný): Jenstart_ai_runv režimuedit: operace s fotkami, účtují se za každou fotku;image_style_transferpodleaiStyleRefProductId.aiStyleRefProductId(UUID; nepovinný): Jen simage_style_transfer: vzorový produkt, který pojmenoval obchodník; nikdy ho nevybírejte sami.aiFillMissingOnly(truenebofalse; nepovinný): Jenstart_ai_runv režimuedit: true = jen PRÁZDNÁ pole (obchodník řekl „doplň“, ne „přepiš“).aiInstructions(text, nejvýš 600 znaků; nepovinný): Jenstart_ai_runv režimuedit: pokyn k tónu a délce textů.aiBrief(text, nejvýš 2000 znaků; nepovinný): Jen režimcreate: co navrhnout, aspoň 20 znaků.aiCreateCount(celé číslo od 1 do 20; nepovinný): Jen režimcreate: kolik konceptů navrhnout, 1 až 20.aiCreateImages(truenebofalse; nepovinný): Jen režimcreate: true = i fotka ke konceptu, účtuje se zvlášť.aiCreatePriceMinor(celé číslo aspoň 0; nepovinný): Jen režimcreate: 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žimcreate: názvy kategorií pro koncepty, nové vzniknou po schválení; vynechané navrhne AI.note(text, nejvýš 300 znaků; nepovinný): Jenregenerate_ai_item: co bylo na návrhu špatně.runId(UUID; nepovinný): Jenrevert_ai_run: běh zai_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. Proshopzi_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 hodnotcreate,update,move,reorderadelete; povinný): Operace, viz popis nástroje.categoryId(text; nepovinný): ID kategorie zeshopzi_list_catalog. Povinné u update, move a delete.parentId(text nebonull; nepovinný): Nadřazená kategorie ucreate,moveareorder;null= nejvyšší úroveň.position(číslo; nepovinný): Jen umove: pořadí mezi sourozenci, 0 = první.orderedIds(pole, položka: text; nepovinný): Jen ureorder: ID VŠECH kategorií dané úrovně v novém pořadí.fields(objekt; nepovinný): Ucreatenová kategorie, uupdatejen měněná pole.fields.name(text; nepovinný): Název, povinný při zakládání.fields.slug(text; nepovinný): Adresa; ucreatevynechaná se odvodí z názvu. Uupdatesamotná: změní i podkategorie, staré adresy přesměrují 301.fields.descriptionHtml(text nebonull; nepovinný): Text nad výpisem (HTML).fields.descriptionHtmlBottom(text nebonull; nepovinný): Text pod výpisem (HTML).fields.h1Override(text nebonull; nepovinný)fields.isFeatured(truenebofalse; nepovinný)fields.showInMenu(truenebofalse; nepovinný)fields.imageUrl(text nebonull; nepovinný): Obrázek kategorie,/media/…z knihovny médií obchodu;nullho odebere.fields.pageTemplateKey(text, nejvýš 40 znaků nebonull; nepovinný): Varianta šablony výpisu (page_templates, druh collection); dědí podkategorie,null= zdědit.fields.productTemplateKey(text, nejvýš 40 znaků nebonull; nepovinný): Varianta šablony detailu produktů v kategorii a podkategoriích (druh product);null= zdědit.fields.metaTitle(text nebonull; nepovinný): SEO titulek. null smaže.fields.metaDescription(text nebonull; nepovinný): SEO popisek (meta description). null smaže.fields.geoSummary(text nebonull; nepovinný): Stručná přímá odpověď pro AI vyhledávače (GEO). Dvě až tři věty. null smaže.fields.noindex(truenebofalse; 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. Proshopzi_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 hodnotvendor,attribute,size_guideainfo_panel; povinný): Co se ukládá;fieldsmusí patřit k němu.operation(jedna z hodnotsave,delete,reorder,create_from_brands,apply_presetaduplicate; nepovinný):apply_presetjen uattribute,create_from_brandsuvendor,duplicateusize_guideainfo_panel,reorderu všeho kromě značky.id(text; nepovinný): Bezidse zakládá; s ním úprava,deleteneboduplicate.axisDeleteConfirmed(truenebofalse; nepovinný): Jendeletevlastnosti, 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ý): Jenreorder: 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ý): Jencreate_from_brands: vyjmenované názvy značek; bez nich nástroj vypíše nabídku.presetKey(jedna z hodnotobleceni,elektronika,domacnost,sportaobecne; nepovinný): Jenapply_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 nebonull; nepovinný)fields.descriptionHtml(text nebonull; nepovinný): Značka: popis na její stránce (HTML).fields.websiteUrl(text nebonull; nepovinný)fields.email(text nebonull; nepovinný)fields.phone(text nebonull; nepovinný)fields.region(text nebonull; nepovinný)fields.position(číslo; nepovinný): Pořadí, 0 = první.fields.isFeatured(truenebofalse; nepovinný)fields.h1Override(text nebonull; nepovinný)fields.label(text; nepovinný): Vlastnost: název pro zákazníka, povinný při zakládání.fields.control(jedna z hodnotselect,range,booleanaswatch; 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 nebonull; nepovinný): Vlastnost: jednotka u range.fields.isFilterable(truenebofalse; nepovinný): Vlastnost: filtr ve výpisu.fields.groupLabel(text nebonull; nepovinný)fields.variantDisplay(jedna z hodnotauto,badgesalist; nepovinný)fields.isActive(truenebofalse; nepovinný)fields.templateKey(jedna z hodnotwomen-tops,women-bottoms,women-dresses,men-tops,men-bottoms,shoes,kids,bras,rings,hats,glovesablank; nepovinný): Tabulka velikostí: šablona při zakládání.fields.table(objekt; nepovinný): Tabulka velikostí: CELÁ tabulka;cellsje 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 nebonull; 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 sescope: 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 hodnotinfo,shirt,droplets,leaf,scissors,truck,undo,shield,package,gift,ruler,sparkles,awardamap-pin, nebonull; nepovinný)fields.scope(jedna z hodnotallacategories; nepovinný): Informační panel: pro všechny produkty, nebo jen kategorie.fields.metaTitle(text nebonull; nepovinný): SEO titulek. null smaže.fields.metaDescription(text nebonull; nepovinný): SEO popisek (meta description). null smaže.fields.geoSummary(text nebonull; nepovinný): Stručná přímá odpověď pro AI vyhledávače (GEO). Dvě až tři věty. null smaže.fields.noindex(truenebofalse; 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ý.