{"schema_version":1,"service":{"name":"Wendoshop Developers MCP","implementation":{"name":"wendoshop-store-admin","version":"1.3.0"},"protocol":"mcp","transport":"streamable_http","server_url":"https://mcp.wendoshop.com/mcp","documentation_url":"https://mcp.wendoshop.com/api/mcp/documentation","discovery":{"authorization_server_metadata_url":"https://mcp.wendoshop.com/.well-known/oauth-authorization-server","protected_resource_metadata_url":"https://mcp.wendoshop.com/.well-known/oauth-protected-resource/mcp"},"contact":{"email":"hola@wendoshop.com"}},"summary":{"scopes":12,"profiles":5,"tools":82,"read_tools":37,"write_tools":45},"access":{"authentication":"OAuth 2.1 con PKCE. Cada conexión opera con los permisos aprobados por el seller.","availability":"Las herramientas disponibles dependen de los scopes concedidos, los permisos del usuario, el plan y el estado de la suscripción.","tenant_isolation":"Cada conexión queda vinculada a una sola tienda y las operaciones se auditan dentro de esa tienda.","write_safety":"Las escrituras sensibles requieren aprobación explícita y aplican controles de idempotencia, versión o vista previa cuando corresponde."},"scopes":[{"id":"products.read","label":"Consultar productos","description":"Permite consultar catálogo, stock y rendimiento de productos."},{"id":"products.write","label":"Crear y editar productos","description":"Permite crear productos en borrador y editar su contenido y estado."},{"id":"products.prices","label":"Modificar precios","description":"Permite cambiar precios y precios de oferta de productos."},{"id":"products.stock","label":"Modificar stock","description":"Permite ajustar inventario de productos."},{"id":"orders.read","label":"Consultar ventas","description":"Permite consultar pedidos, estados y métricas comerciales."},{"id":"orders.write","label":"Gestionar preparación y entrega","description":"Permite avanzar estados de preparación, agregar tracking y editar notas internas. No permite pagos, cancelaciones ni reembolsos."},{"id":"customers.read","label":"Consultar clientes","description":"Permite buscar clientes y consultar su actividad comercial. Los datos de contacto se ocultan por defecto."},{"id":"discounts.read","label":"Consultar cupones","description":"Permite consultar códigos, vigencia, estado y uso de cupones."},{"id":"discounts.write","label":"Gestionar cupones","description":"Permite crear, modificar, activar y desactivar cupones."},{"id":"design.read","label":"Consultar diseño de la tienda","description":"Permite consultar secciones publicadas, borradores y configuración visual."},{"id":"design.write","label":"Modificar diseño de la tienda","description":"Permite guardar y publicar ajustes visuales globales y secciones del inicio respetando los límites del plan."},{"id":"settings.read","label":"Consultar pagos y envíos","description":"Permite consultar medios de pago, métodos de envío y realizar cotizaciones sin modificar la configuración."}],"scope_profiles":[{"id":"read_only","label":"Solo consultar","description":"Productos, ventas, clientes, descuentos, diseño, pagos y envíos sin realizar cambios.","scopes":["products.read","orders.read","customers.read","discounts.read","design.read","settings.read"]},{"id":"catalog","label":"Catálogo y stock","description":"Consulta y administración de productos, precios, inventario y categorías.","scopes":["products.read","products.write","products.prices","products.stock"]},{"id":"sales","label":"Ventas y clientes","description":"Consulta clientes y ventas, y permite gestionar preparación, entrega y descuentos.","scopes":["orders.read","orders.write","customers.read","discounts.read","discounts.write","settings.read"]},{"id":"design","label":"Diseño y contenido","description":"Consulta productos y permite modificar el diseño global, contenido visual, descripciones y el inicio.","scopes":["products.read","products.write","design.read","design.write"]},{"id":"full_access","label":"Acceso completo","description":"Todos los permisos solicitados por esta herramienta.","scopes":["products.read","products.write","products.prices","products.stock","orders.read","orders.write","customers.read","discounts.read","discounts.write","design.read","design.write","settings.read"]}],"tools":[{"name":"add_product_image","title":"Agregar imagen","description":"Agregar imagen con aislamiento por tienda, versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"url":{"type":"string","format":"uri"},"alt":{"default":null,"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"order":{"type":"integer","minimum":0,"maximum":19}},"required":["idempotency_key","expected_version","url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"advance_order_status","title":"Avanzar estado de preparación o entrega","description":"Avanzar estado de preparación o entrega. No permite pagos, reembolsos ni cancelaciones.","kind":"write","required_scopes":["orders.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"order_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"next_state":{"type":"string","enum":["por_empaquetar","empaquetado","listo_para_retirar","enviada","entregada"]},"confirm":{"type":"boolean","const":true}},"required":["idempotency_key","order_id","expected_version","next_state","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"apply_bulk_price_adjustment","title":"Aplicar ajuste masivo de precios","description":"Aplica exactamente una vista previa vigente. Usar solo después de mostrar cantidades, advertencias y ejemplos, y recibir una confirmación explícita y separada del seller.","kind":"write","required_scopes":["products.read","products.prices"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"adjustment":{"type":"object","properties":{"filter":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"all"},"states":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["activo","inactivo","borrador"]}}},"required":["type","states"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"category"},"category_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"states":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["activo","inactivo","borrador"]}}},"required":["type","category_id","states"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"products"},"product_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["type","product_ids"],"additionalProperties":false}]},"item_scope":{"type":"string","enum":["simple_products","variants","all_catalog_prices"]},"variant_scope":{"type":"string","enum":["active_only","all"]},"inherited_variant_prices":{"type":"string","enum":["preserve_inheritance","materialize"]},"price_target":{"type":"string","enum":["base","sale","base_and_sale"]},"operation":{"type":"string","enum":["increase","decrease","set"]},"value_type":{"type":"string","enum":["percentage","amount"]},"value":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["filter","item_scope","variant_scope","inherited_variant_prices","price_target","operation","value_type","value"],"additionalProperties":false},"preview_token":{"type":"string","minLength":20,"maxLength":2000},"confirm":{"type":"boolean","const":true},"confirmation_text":{"type":"string","const":"CONFIRMAR AJUSTE MASIVO DE PRECIOS"}},"required":["idempotency_key","adjustment","preview_token","confirm","confirmation_text"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"apply_bulk_product_update","title":"Aplicar cambio masivo","description":"Aplicar cambio masivo con idempotencia y auditoría.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"update":{"type":"object","properties":{"state":{"type":"string","enum":["activo","inactivo","borrador"]},"category_ids":{"maxItems":20,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"additionalProperties":false},"confirm":{"type":"boolean","const":true}},"required":["idempotency_key","product_ids","update","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"apply_homepage_draft_changes","title":"Guardar borrador del inicio","description":"Guarda como borrador una propuesta previamente consultada y validada. Revalida contraste y puede completar colores u overlays omitidos; usá y comunicá el resultado efectivo devuelto. No altera el inicio publicado y debe usarse después de que el seller apruebe la propuesta.","kind":"write","required_scopes":["design.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"sections":{"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","enum":["hero","marquee","brand_slider","beneficios","categorias","productos","banner_cta","banners","historias","video","ugc","shoppable_images","reviews","faq","newsletter","dos_columnas","editorial_doble","bloques_alternados","texto","custom_html"]},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false}}},"required":["idempotency_key","expected_version","sections"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"apply_product_description_html","title":"Aplicar descripción HTML de producto","description":"Reemplaza la descripción HTML publicada. Usala solo para pedidos explícitos de texto, redacción o SEO, o si el seller acepta esta alternativa por límite de plan. Nunca la uses como sustituto de diseño visual, Editor de diseño, bloques o secciones.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"html":{"type":"string","maxLength":50000},"short_description":{"type":"string","maxLength":500},"seo_title":{"type":"string","maxLength":70},"seo_description":{"type":"string","maxLength":160},"confirm":{"type":"boolean","const":true,"description":"Debe ser true para confirmar el reemplazo del contenido publicado."}},"required":["idempotency_key","product_id","expected_version","html","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"apply_store_change_plan","title":"Aplicar plan de cambios","description":"Aplica todas las acciones de un plan en una única transacción. Si una falla, no se aplica ninguna.","kind":"write","required_scopes":[],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"plan_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"Identificador UUID v4 de un plan de cambios de Wendo."},"confirm":{"type":"boolean","const":true}},"required":["idempotency_key","plan_id","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"plan_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"Identificador UUID v4 de un plan de cambios de Wendo."},"status":{"type":"string","const":"applied"},"applied_actions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"results":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["plan_id","status","applied_actions","results"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"apply_store_design_draft_changes","title":"Guardar diseño global como borrador","description":"Guarda ajustes globales previamente consultados y validados en el borrador de Editor de diseño. No cambia la tienda publicada.","kind":"write","required_scopes":["design.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"changes":{"type":"object","properties":{"colors":{"type":"object","properties":{"color_primario":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color principal de marca para acciones y acentos."},"color_secundario":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color secundario de apoyo y contraste."},"color_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color general de textos de la tienda."},"color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color general de fondo de la tienda."},"color_header":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color de fondo del encabezado."},"color_header_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color del texto y los íconos del encabezado."},"color_footer":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color de fondo del pie de página."},"color_footer_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color del texto del pie de página."}},"additionalProperties":false},"typography":{"type":"object","properties":{"fuente":{"type":"string","enum":["system-ui","Inter","Plus Jakarta Sans","Outfit","Figtree","DM Sans","Work Sans","Space Grotesk","Poppins","Montserrat","Raleway","Nunito","Quicksand","Open Sans","Roboto","Lato","Source Sans 3","Josefin Sans","League Spartan","Bebas Neue","Playfair Display","Cormorant Garamond","Lora","EB Garamond"],"description":"Fuente global de la tienda."},"pack_iconos":{"type":"string","enum":["lucide","heroicons","heroicons-solid","tabler","iconoir","phosphor-thin","phosphor-light","phosphor","phosphor-bold","phosphor-fill","phosphor-duotone"],"description":"Familia visual de los íconos del storefront."}},"additionalProperties":false},"layout_and_buttons":{"type":"object","properties":{"border_radius":{"type":"string","enum":["0rem","0.25rem","0.5rem","0.75rem","1rem"],"description":"Radio de cards y contenedores. No cambia la forma de los botones."},"max_width":{"type":"string","enum":["960px","1120px","1280px","1440px","none"],"description":"Ancho máximo del contenido."},"boton_estilo":{"type":"string","enum":["redondeado","cuadrado","pill"],"description":"Forma global de los botones. Para botones sin redondeo usá cuadrado."},"boton_apariencia":{"type":"string","enum":["solido","contorno","suave","degradado"]},"boton_color_fondo":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}],"description":"Color de botones; vacío hereda el color primario."},"boton_color_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}],"description":"Color del texto; vacío calcula contraste automáticamente."},"boton_hover":{"type":"string","enum":["oscurecer","elevar","crecer","resplandor","relleno","barrido_inverso","relleno_centro","cortina_ascendente","destello","contorno_hover","invertir_relleno","ninguno"]},"boton_hover_borde_ancho":{"type":"string","enum":["","0px","1px","2px","3px","4px"]},"boton_hover_relleno_opacidad":{"anyOf":[{"type":"string","const":""},{"type":"integer","minimum":0,"maximum":100}]},"boton_hover_texto_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_negrita":{"type":"boolean"},"boton_mayusculas":{"type":"boolean"},"boton_sombra_estilo":{"type":"string","enum":["ninguna","suave","marcada"]},"scroll_reveal_enabled":{"type":"boolean"},"scroll_reveal_radius":{"type":"string","enum":["0px","1rem","1.5rem","2rem","2.5rem","3rem"]},"scroll_reveal_shadow":{"type":"boolean"},"flechas_estilo":{"type":"string","enum":["redondo","suave","cuadrado","minimal"]}},"additionalProperties":false},"navigation":{"type":"object","properties":{"header_layout":{"type":"string","enum":["estandar","logo_centro","logo_centro_linea","nav_centrado","barra_inferior"]},"header_height":{"type":"string","enum":["normal","comodo","grande","muy_grande"]},"header_sticky":{"type":"boolean"},"header_flotante":{"type":"boolean"},"header_flotante_separacion":{"type":"integer","minimum":0,"maximum":64},"nav_text_size":{"type":"integer","minimum":12,"maximum":20},"nav_hover_estilo":{"type":"string","enum":["fondo","subrayado","color","ninguno"]},"nav_hover_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"header_transparente":{"type":"boolean"},"header_transparente_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"header_transparente_opacidad":{"type":"integer","minimum":0,"maximum":100},"header_transparente_degrade":{"type":"boolean"},"buscador_estilo":{"type":"string","enum":["modal","textbox"]},"buscador_posicion":{"type":"string","enum":["izquierda","derecha"]},"buscador_color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"buscador_color_borde":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"buscador_color_placeholder":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"buscador_radio":{"type":"integer","minimum":0,"maximum":999}},"additionalProperties":false},"product_cards":{"type":"object","properties":{"aspect_ratio":{"type":"string","enum":["1/1","3/4","2/3","4/3","3/2"]},"object_fit":{"type":"string","enum":["cover","contain"]},"hover_efecto":{"type":"string","enum":["zoom","segunda_imagen","ninguno"]},"card_hover_efecto":{"type":"string","enum":["lift","lift_sutil","borde","ninguno"]},"flechas_imagen_desktop":{"type":"boolean"},"indicadores_imagen_mobile":{"type":"boolean"},"mostrar_bordes":{"type":"boolean"},"mostrar_sku":{"type":"boolean"},"mostrar_variantes":{"type":"boolean"},"variantes_posicion":{"type":"string","enum":["debajo_imagen","debajo_nombre","debajo_precio"]},"variantes_forma":{"type":"string","enum":["miniaturas","circulos","solo_colores","pastillas"]},"variantes_mostrar_titulo":{"type":"boolean"},"compra_rapida":{"type":"boolean"},"compra_rapida_posicion":{"type":"string","enum":["sobre_imagen","siempre_visible","debajo_info"]},"precio_a_mostrar":{"type":"string","enum":["lista","descuento","ambos"]},"mostrar_cuotas":{"type":"boolean"},"wishlist_mostrar":{"type":"boolean"},"wishlist_icono":{"type":"string","enum":["heart","star","bag"]},"wishlist_forma":{"type":"string","enum":["circulo","redondeado","cuadrado"]},"wishlist_estilo":{"type":"string","enum":["translucido","solido","borde","minimal"]},"wishlist_icono_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_icono_activo_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_fondo_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_fondo_opacidad":{"type":"integer","minimum":0,"maximum":100},"wishlist_borde_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_sombra":{"type":"boolean"},"nombre_tamano":{"type":"string","enum":["xs","sm","base","lg"]},"nombre_peso":{"type":"string","enum":["normal","medium","semibold","bold"]},"nombre_alineacion":{"type":"string","enum":["left","center","right"]},"precio_tamano":{"type":"string","enum":["xs","sm","base","lg"]},"precio_peso":{"type":"string","enum":["normal","medium","semibold","bold"]},"precio_alineacion":{"type":"string","enum":["left","center","right"]},"badge_radio":{"type":"string","enum":["pill","redondeado","cuadrado"]},"badge_peso_fuente":{"type":"string","enum":["medium","semibold","bold"]},"badge_promo_bg":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_promo_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_promo_fondo":{"type":"boolean"},"badge_promo_borde":{"type":"boolean"},"badge_promo_borde_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"etiqueta_promocional_estilo":{"type":"string","enum":["marquee","barra","badge","ribbon","pulso","sobre_nombre","debajo_nombre","junto_precio","debajo_precio","oculto"]},"etiqueta_promocional_posicion":{"type":"string","enum":["arriba_izquierda","arriba_derecha","abajo_izquierda","abajo_derecha"]},"etiqueta_promocional_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_descuento_bg":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_descuento_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_descuento_fondo":{"type":"boolean"},"badge_descuento_borde":{"type":"boolean"},"badge_descuento_borde_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"}},"additionalProperties":false},"catalog":{"type":"object","properties":{"default_view":{"type":"string","enum":["comfortable","compact","list"]},"filters_layout":{"type":"string","enum":["sidebar","topbar","drawer"]},"featured_position":{"type":"string","enum":["top","sidebar_left","sidebar_right"]},"header_layout":{"type":"string","enum":["simple","image","editorial"]},"show_buyer_view_switcher":{"type":"boolean"},"show_category_image":{"type":"boolean"},"show_active_filter_chips":{"type":"boolean"},"featured_mode":{"type":"string","enum":["none","manual"]},"featured_title":{"type":"string","maxLength":200},"featured_product_ids":{"maxItems":12,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"additionalProperties":false},"product_page":{"type":"object","properties":{"composicion":{"type":"object","properties":{"layout":{"type":"string","enum":["clasico","editorial","superpuesto"]},"panel_superficie":{"type":"string","enum":["solida","suave","glass"]},"panel_posicion":{"type":"string","enum":["izquierda","centro","derecha"]},"panel_ancho":{"type":"string","enum":["compacto","normal","amplio"]},"panel_color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"panel_opacidad":{"type":"integer","minimum":35,"maximum":100},"panel_blur":{"type":"integer","minimum":0,"maximum":32},"panel_borde":{"type":"boolean"},"panel_radio":{"type":"string","enum":["none","md","lg","xl"]},"panel_texto":{"type":"string","enum":["auto","claro","oscuro"]},"media_altura":{"type":"string","enum":["media","alta","pantalla"]},"media_foco":{"type":"string","enum":["arriba_izquierda","arriba_centro","arriba_derecha","centro_izquierda","centro","centro_derecha","abajo_izquierda","abajo_centro","abajo_derecha"]},"media_overlay_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"media_overlay_opacidad":{"type":"integer","minimum":0,"maximum":70},"media_mostrar_flechas":{"type":"boolean"},"editorial_columnas":{"anyOf":[{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4}]},"editorial_separacion":{"type":"string","enum":["ninguna","sutil","media"]},"editorial_ajuste_imagen":{"type":"string","enum":["cubrir","completa"]},"editorial_transicion":{"type":"string","enum":["corte","deslizar","fundido"]},"superpuesto_mostrar_indicadores":{"type":"boolean"},"superpuesto_transicion":{"type":"string","enum":["fade","corte"]}},"additionalProperties":false},"galeria_layout":{"type":"string","enum":["vertical","dos_columnas","carrusel","carrusel_izquierda","principal_grande","magazine"]},"galeria_layout_mobile":{"type":"string","enum":["carrusel","carrusel_lateral","principal_miniaturas"]},"galeria_aspecto":{"type":"string","enum":["cuadrado","vertical","vertical_grande"]},"galeria_efecto_hover":{"type":"string","enum":["zoom","brillo","ninguno"]},"galeria_bordes_redondeados":{"type":"boolean"},"galeria_autoplay":{"type":"boolean"},"galeria_autoplay_intervalo":{"type":"integer","minimum":2,"maximum":30},"mostrar_sku":{"type":"boolean"},"mostrar_stock":{"type":"boolean"},"mostrar_categoria":{"type":"boolean"},"mostrar_descripcion_corta":{"type":"boolean"},"mostrar_boton_compartir":{"type":"boolean"},"detalle_modo":{"type":"string","enum":["tabs","acordeon"]},"detalle_posicion":{"type":"string","enum":["debajo_grid","debajo_botones"]},"cotizador_envio_activo":{"type":"boolean"},"cotizador_envio_posicion":{"type":"string","enum":["debajo_botones","en_tab_envios"]},"tab_envios_activo":{"type":"boolean"},"tab_envios_titulo":{"type":"string","maxLength":200},"tab_envios_contenido":{"type":"string","maxLength":5000},"tab_envios_imagen_url":{"type":"string","maxLength":2048},"tab_pagos_activo":{"type":"boolean"},"tab_pagos_titulo":{"type":"string","maxLength":200},"tab_pagos_contenido":{"type":"string","maxLength":5000},"tab_pagos_imagen_url":{"type":"string","maxLength":2048},"relacionados_cantidad":{"type":"integer","minimum":0,"maximum":24},"relacionados_layout":{"type":"string","enum":["carrusel","grid"]},"relacionados_titulo":{"type":"string","maxLength":200},"boton_mobile_sticky":{"type":"boolean"},"precio_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"precio_tamano":{"type":"string","enum":["sm","md","lg","xl"]},"precio_peso":{"type":"string","enum":["normal","medium","semibold","bold"]},"precio_tachado_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"precio_secundario_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"precio_mostrar_ahorro":{"type":"boolean"},"precio_mostrar_cuotas":{"type":"boolean"},"precio_mostrar_transferencia":{"type":"boolean"},"precio_mostrar_impuestos":{"type":"boolean"},"variantes_estilo":{"type":"string","enum":["pills","outline","bloques","minimal"]},"variantes_tamano":{"type":"string","enum":["sm","md","lg"]},"variantes_radio":{"type":"string","enum":["inherit","none","sm","md","lg","pill"]},"variantes_swatch_forma":{"type":"string","enum":["inherit","circle","rounded","square"]},"variantes_activo_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_activo_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_activo_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_inactivo_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_inactivo_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_inactivo_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_deshabilitado_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"cantidad_estilo":{"type":"string","enum":["bordeado","suave","compacto"]},"cantidad_radio":{"type":"string","enum":["inherit","none","sm","md","lg","pill"]},"boton_comprar_label":{"type":"string","maxLength":200},"boton_agregar_label":{"type":"string","maxLength":200},"boton_tamano":{"type":"string","enum":["sm","md","lg"]},"boton_layout":{"type":"string","enum":["horizontal","vertical"]},"boton_comprar_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_comprar_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_icono":{"type":"boolean"},"boton_peso_texto":{"type":"string","enum":["normal","medium","semibold","bold"]},"boton_elegir_label":{"type":"string","maxLength":200},"boton_elegir_usar_agregar":{"type":"boolean"},"boton_elegir_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_elegir_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_elegir_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_elegir_radio":{"type":"string","enum":["inherit","none","sm","md","lg","pill"]}},"additionalProperties":false},"announcement_bar":{"type":"object","properties":{"activa":{"type":"boolean"},"modo":{"type":"string","enum":["texto","slider","countdown"]},"texto":{"type":"string","maxLength":500},"url":{"type":"string","maxLength":2048},"textos":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}},"slider_intervalo":{"type":"integer","minimum":2,"maximum":60},"slider_efecto":{"type":"string","enum":["fade","slide"]},"countdown_fecha":{"type":"string","maxLength":80},"countdown_label":{"type":"string","maxLength":200},"countdown_boton_texto":{"type":"string","maxLength":200},"countdown_boton_url":{"type":"string","maxLength":2048},"color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"color_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"tamano_fuente":{"type":"string","enum":["xs","sm","base"]},"cerrable":{"type":"boolean"}},"additionalProperties":false},"footer":{"type":"object","properties":{"slogan":{"type":"string","maxLength":500},"instagram":{"type":"string","maxLength":200},"facebook":{"type":"string","maxLength":500},"tiktok":{"type":"string","maxLength":200},"twitter":{"type":"string","maxLength":200},"ocultar_powered_by":{"type":"boolean"},"color_slogan":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"color_redes":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"redes_estilo":{"type":"string","enum":["simple","circulo","circulo_outline","cuadrado"]},"redes_tamano":{"type":"integer","minimum":12,"maximum":64},"logo_footer_url":{"type":"string","maxLength":2048},"logo_footer_size":{"type":"integer","minimum":20,"maximum":400},"layout":{"type":"string","enum":["completo","minimal"]},"columnas":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"titulo":{"type":"string","maxLength":200},"tipo":{"type":"string","enum":["links","categorias","texto","imagen","newsletter","paginas"]},"items":{"maxItems":30,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":200},"url":{"type":"string","maxLength":2048}},"required":["label","url"],"additionalProperties":false}},"categorias_modo":{"type":"string","enum":["todas","seleccionadas"]},"categorias_slugs":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"paginas_modo":{"type":"string","enum":["todas","seleccionadas"]},"paginas_slugs":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"texto":{"type":"string","maxLength":5000},"imagen_url":{"type":"string","maxLength":2048},"imagen_link":{"type":"string","maxLength":2048}},"required":["id","titulo","tipo"],"additionalProperties":false}},"banner_url":{"type":"string","maxLength":2048},"banner_link":{"type":"string","maxLength":2048},"medios_pago":{"type":"boolean"},"bottom_links":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":200},"url":{"type":"string","maxLength":2048}},"required":["label","url"],"additionalProperties":false}}},"additionalProperties":false}},"additionalProperties":false}},"required":["idempotency_key","expected_version","changes"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"copy_product_visual_description_draft","title":"Copiar descripción visual como borrador","description":"Copia exactamente la vista previa vigente y la guarda como borrador visual del producto destino. Puede reemplazar un borrador existente solo si el seller lo vio en la vista previa y lo confirmó. Nunca publica.","kind":"write","required_scopes":["products.read","products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"copy":{"type":"object","properties":{"source_product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"target_product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"source_product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"target_product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"source_state":{"type":"string","enum":["published","effective_draft"]},"image_policy":{"type":"string","enum":["keep_source_images","require_target_images"]},"target_draft_policy":{"type":"string","enum":["require_empty","replace"]}},"required":["source_state","image_policy","target_draft_policy"],"additionalProperties":false},"preview_token":{"type":"string","minLength":20,"maxLength":2000},"confirm":{"type":"boolean","const":true},"confirmation_text":{"type":"string","const":"CONFIRMAR COPIA DE DESCRIPCIÓN VISUAL"}},"required":["idempotency_key","copy","preview_token","confirm","confirmation_text"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"create_category","title":"Crear categoría","description":"Crear categoría con aislamiento por tienda, versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"name":{"type":"string","minLength":1,"maxLength":200},"slug":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"parent_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"visible":{"default":true,"type":"boolean"}},"required":["idempotency_key","name"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"create_coupon","title":"Crear cupón desactivado","description":"Crea un cupón desactivado. Activarlo requiere una segunda operación aprobada.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"code":{"type":"string","minLength":2,"maxLength":50},"type":{"type":"string","enum":["porcentaje","monto_fijo","envio_gratis","porcentaje_producto","monto_fijo_producto"]},"value":{"type":"number","minimum":0},"minimum_purchase":{"default":0,"type":"number","minimum":0},"usage_limit":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"valid_from":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"valid_until":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"filter_type":{"default":"todos","type":"string","enum":["todos","categorias","productos"]},"filter_ids":{"default":[],"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["idempotency_key","code","type","value"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"create_product_draft","title":"Crear producto en borrador","description":"Crea un producto físico simple como borrador. Si el seller adjuntó una imagen, usá primero upload_product_image y enviá la URL resultante en image_urls. Requiere aprobación explícita; no lo publica automáticamente.","kind":"write","required_scopes":["products.write","products.prices","products.stock"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"name":{"type":"string","minLength":2,"maxLength":200},"price":{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},"sale_price":{"default":null,"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]},"stock":{"default":0,"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"null significa disponibilidad sin un límite cuantificado; 0 significa sin unidades disponibles."},"short_description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"barcode":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"tags":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"category_name":{"type":"string","maxLength":100},"image_urls":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","format":"uri"}}},"required":["idempotency_key","name","price"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"create_product_image_upload_link","title":"Preparar carga segura de imagen","description":"Crea un enlace temporal de Wendo para que el seller elija una imagen y la agregue directamente a un producto cuando el cliente no puede entregar el archivo adjunto al MCP. No usa créditos de IA ni requiere abrir el administrador.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"alt":{"default":null,"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["idempotency_key","expected_version"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"create_product_variant","title":"Crear variante","description":"Crear variante con control de versión e idempotencia.","kind":"write","required_scopes":["products.write","products.prices","products.stock"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"sku":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"barcode":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}]},"cost":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"weight":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"height":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"width":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"depth":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"mpn":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"show_price":{"type":"boolean"},"price":{"default":null,"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]},"sale_price":{"default":null,"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]},"stock":{"default":0,"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"null significa disponibilidad sin un límite cuantificado; 0 significa sin unidades disponibles."}},"required":["idempotency_key","attributes"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"create_promotion_draft","title":"Crear promoción en borrador","description":"Crea una promoción automática inactiva para revisión. Respeta el plan y valida que productos y categorías pertenezcan a la tienda.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"name":{"type":"string","minLength":2,"maxLength":160},"type":{"type":"string","enum":["2x1","precio_tachado","cross_selling","progresivo","carrito"]},"applies_to":{"default":"tienda","type":"string","enum":["tienda","categorias","productos"]},"applies_ids":{"default":[],"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"discount_type":{"default":null,"anyOf":[{"type":"string","enum":["porcentaje","monto_fijo"]},{"type":"null"}]},"discount_value":{"default":null,"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"buy_x":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"pay_y":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"cross_product_id":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"progressive_rules":{"default":[],"maxItems":10,"type":"array","items":{"type":"object","properties":{"from_quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"percentage":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["from_quantity","percentage"],"additionalProperties":false}},"combine_strikethrough":{"default":false,"type":"boolean"},"combine_free_shipping":{"default":false,"type":"boolean"},"combine_cart_discount":{"default":false,"type":"boolean"},"combine_apps":{"default":false,"type":"boolean"},"starts_at":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"ends_at":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]}},"required":["idempotency_key","name","type"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"promotion":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"message":{"type":"string"},"unchanged":{"type":"boolean"}},"required":["promotion"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"delete_product_image","title":"Eliminar imagen","description":"Eliminar imagen con aislamiento por tienda, versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"image_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["idempotency_key","expected_version","image_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"discard_store_change_plan","title":"Descartar plan de cambios","description":"Descarta un plan sin modificar la tienda.","kind":"write","required_scopes":[],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"plan_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"Identificador UUID v4 de un plan de cambios de Wendo."}},"required":["idempotency_key","plan_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"plan_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"Identificador UUID v4 de un plan de cambios de Wendo."},"status":{"type":"string","const":"discarded"}},"required":["plan_id","status"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"duplicate_coupon","title":"Duplicar cupón desactivado","description":"Duplicar cupón desactivado con control de versión e idempotencia.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"coupon_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"new_code":{"type":"string","minLength":2,"maxLength":50}},"required":["idempotency_key","coupon_id","new_code"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"duplicate_product_draft","title":"Duplicar producto como borrador","description":"Duplicar producto como borrador con idempotencia y auditoría.","kind":"write","required_scopes":["products.write","products.prices","products.stock"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"name":{"type":"string","minLength":2,"maxLength":200},"slug":{"type":"string","minLength":1,"maxLength":200}},"required":["idempotency_key"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_catalog_health","title":"Diagnosticar catálogo","description":"Resume productos activos, borradores, agotados, sin imagen, descripción, categoría o precio válido, con muestras acotadas.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"sample_limit":{"default":10,"type":"integer","minimum":1,"maximum":20}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_coupon_performance","title":"Consultar rendimiento de cupón","description":"Devuelve usos, órdenes atribuidas, descuento y ventas pagadas.","kind":"read","required_scopes":["discounts.read"],"input_schema":{"type":"object","properties":{"coupon_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["coupon_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_customer","title":"Consultar cliente","description":"Obtiene actividad y últimos pedidos usando la clave opaca devuelta por search_customers.","kind":"read","required_scopes":["customers.read"],"input_schema":{"type":"object","properties":{"customer_key":{"type":"string","pattern":"^(registered:\\d+|guest:[a-f0-9]{32})$"},"include_contact":{"default":false,"type":"boolean"}},"required":["customer_key"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"customer":{"type":"object","properties":{"customer_key":{"type":"string"},"profile_type":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"email_verified":{"type":"boolean"},"archived":{"type":"boolean"},"order_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"total_spent":{"type":"number"},"last_order_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"recent_orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"numero_orden":{"anyOf":[{"type":"number"},{"type":"null"}]},"estado":{"type":"string"},"pago_estado":{"type":"string"},"total":{"type":"number"},"moneda":{"type":"string"},"created_at":{"type":"string"}},"required":["id","numero_orden","estado","pago_estado","total","moneda","created_at"],"additionalProperties":false}}},"required":["customer_key","profile_type","name","email","phone","email_verified","archived","order_count","total_spent","last_order_at","created_at","recent_orders"],"additionalProperties":false}},"required":["customer"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_homepage_builder","title":"Obtener Editor de diseño del inicio","description":"Primer paso obligatorio cuando el seller pide cambiar, mejorar, renovar o reorganizar las secciones o la composición del home/inicio, incluso con frases vagas como “Quiero modificar el diseño del home de mi tienda.”. Consultá antes de pedir detalles. Para colores, tipografía, botones u otros estilos globales usá get_store_design. Devuelve el diseño actual, borrador, tema, límites y una guía para acompañar a sellers sin conocimientos técnicos.","kind":"read","required_scopes":["design.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_order","title":"Consultar detalle de orden","description":"Muestra orden, ítems, historial y próximos estados seguros.","kind":"read","required_scopes":["orders.read"],"input_schema":{"type":"object","properties":{"order_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["order_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_product","title":"Consultar producto","description":"Obtiene el detalle actual usando nombre, slug, URL o ID. No le pidas un ID interno al seller.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_product_description_context","title":"Obtener contexto para descripción de producto","description":"Primer paso para cambiar una descripción de producto. Acepta nombre, slug, URL o ID: no le pidas un ID interno al seller. Si habla de diseño, presentación visual, descripción Pro, Editor de diseño, bloques o secciones —por ejemplo “Quiero mejorar el diseño de la descripción de mi producto.”— la intención es visual: consultá este contexto y priorizá sections. “Builder” sigue siendo un sinónimo aceptado. Devuelve HTML, imágenes, secciones, plan, contratos y guía conversacional.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_product_description_reference_context","title":"Preparar referencia para descripción visual","description":"Lee en una sola operación el producto de referencia y el producto destino usando nombre, slug, URL o ID. Usala cuando el seller quiera mantener una estructura visual pero adaptar textos e imágenes al producto destino. No guarda ni publica.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"source_product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"target_product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"source_state":{"default":"published","type":"string","enum":["published","effective_draft"]}},"required":["source_product_ref","target_product_ref"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_sales_analytics","title":"Analizar ventas","description":"Calcula facturación, cobros y ticket promedio por días calendario de Argentina. Usá preset_days o from/to en YYYY-MM-DD, nunca ambos. Respeta el plan de Analytics.","kind":"read","required_scopes":["orders.read"],"input_schema":{"type":"object","properties":{"preset_days":{"description":"Atajo de período. No lo combines con from o to.","anyOf":[{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":60}]},"from":{"description":"Primer día incluido. No lo combines con preset_days; si se omite, Wendo completa el rango.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"to":{"description":"Último día incluido. No lo combines con preset_days; si se omite, usa el día actual de Argentina.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"include_rankings":{"default":true,"type":"boolean"},"ranking_limit":{"default":5,"type":"integer","minimum":1,"maximum":10}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_sales_summary","title":"Resumen comercial","description":"Lee ventas, órdenes y ticket promedio.","kind":"read","required_scopes":["orders.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_store_change_plan","title":"Revisar plan de cambios","description":"Devuelve la vista previa, acciones, estado y vencimiento de un plan sin modificar la tienda.","kind":"read","required_scopes":[],"input_schema":{"type":"object","properties":{"plan_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"Identificador UUID v4 de un plan de cambios de Wendo."}},"required":["plan_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"Identificador UUID v4 de un plan de cambios de Wendo."},"title":{"type":"string"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"actions":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"preview":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string"},"expires_at":{"type":"string"},"applied_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"discarded_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","intent","status","actions","preview","created_at","expires_at","applied_at","discarded_at"],"additionalProperties":false}},"required":["plan"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"get_store_design","title":"Obtener diseño global de la tienda","description":"Primer paso obligatorio ante pedidos de diseño global, colores, tipografía, botones, navegación, tarjetas, catálogo, página de producto, barra o footer. Usala incluso ante frases vagas como “Hacé que mi tienda se vea más moderna y profesional.”. Devuelve el diseño publicado, el borrador efectivo, referencias reales y una guía para sellers no técnicos.","kind":"read","required_scopes":["design.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_best_selling_products","title":"Top productos","description":"Lista productos con más ventas recientes.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_categories","title":"Consultar categorías y colecciones","description":"Lista la jerarquía de categorías usada por Wendo para organizar y agrupar productos.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_coupons","title":"Listar cupones","description":"Lista cupones y devuelve la versión necesaria para modificarlos o cambiar su estado.","kind":"read","required_scopes":["discounts.read"],"input_schema":{"type":"object","properties":{"status":{"default":"all","type":"string","enum":["all","active","inactive"]},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_low_stock_products","title":"Stock bajo","description":"Lista productos activos con stock crítico.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_payment_methods","title":"Listar medios de pago","description":"Lista los medios de pago activos sin exponer credenciales.","kind":"read","required_scopes":["settings.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"methods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"nombre":{"type":"string"},"tipo":{"type":"string"},"imagenMediosPago":{"type":"string"}},"required":["id","nombre","tipo"],"additionalProperties":false}}},"required":["methods"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_pending_orders","title":"Pedidos para revisar","description":"Lista pedidos pendientes, pagos pendientes y órdenes por preparar.","kind":"read","required_scopes":["orders.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_product_images","title":"Consultar galería de producto","description":"Lista imágenes en su orden actual y devuelve la versión de la galería.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_product_variants","title":"Consultar variantes","description":"Lista variantes, precios, stock y versión de un producto.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_promotions","title":"Listar promociones automáticas","description":"Lista promociones 2x1, precio tachado, cross-selling, progresivas y de carrito.","kind":"read","required_scopes":["discounts.read"],"input_schema":{"type":"object","properties":{"status":{"default":"all","type":"string","enum":["all","active","inactive"]},"types":{"maxItems":5,"type":"array","items":{"type":"string","enum":["2x1","precio_tachado","cross_selling","progresivo","carrito"]}},"applies_to":{"type":"string","enum":["tienda","categorias","productos"]},"applies_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"combines_free_shipping":{"type":"boolean"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"promotions":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"pagination":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"next_offset":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"has_more":{"type":"boolean"}},"required":["total","limit","offset","next_offset","has_more"],"additionalProperties":false}},"required":["promotions","pagination"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_shipping_methods","title":"Listar métodos de envío","description":"Lista métodos de envío activos sin exponer credenciales de proveedores.","kind":"read","required_scopes":["settings.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"methods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"type":{"type":"string"}},"required":["id","name","description","type"],"additionalProperties":false}}},"required":["methods"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"list_stale_products","title":"Productos sin movimiento","description":"Lista productos activos sin ventas recientes.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"patch_coupon","title":"Editar parcialmente un cupón","description":"Editar parcialmente un cupón con control de versión e idempotencia.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"coupon_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"code":{"type":"string","minLength":2,"maxLength":50},"type":{"type":"string","enum":["porcentaje","monto_fijo","envio_gratis","porcentaje_producto","monto_fijo_producto"]},"value":{"type":"number","minimum":0},"minimum_purchase":{"type":"number","minimum":0},"usage_limit":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"valid_from":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"valid_until":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"filter_type":{"type":"string","enum":["todos","categorias","productos"]},"filter_ids":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["idempotency_key","coupon_id","expected_version"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"plan_store_changes","title":"Preparar plan de cambios","description":"Prepara una vista previa consolidada para varios cambios relacionados. No modifica catálogo, descuentos ni diseño hasta aplicar el plan.","kind":"write","required_scopes":[],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"title":{"type":"string","minLength":3,"maxLength":160},"intent":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"actions":{"minItems":1,"maxItems":50,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"product_create_draft"},"name":{"type":"string","minLength":2,"maxLength":200},"price":{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},"sale_price":{"default":null,"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]},"stock":{"default":0,"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"null significa disponibilidad sin un límite cuantificado; 0 significa sin unidades disponibles."},"short_description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"barcode":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"tags":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"category_name":{"type":"string","maxLength":100},"image_urls":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","format":"uri"}}},"required":["type","name","price"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"product_update"},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"patch":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":200},"short_description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"barcode":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"tags":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"state":{"type":"string","enum":["activo","inactivo","borrador"]}},"additionalProperties":false},"price":{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},"sale_price":{"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]},"stock":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"null significa disponibilidad sin un límite cuantificado; 0 significa sin unidades disponibles."}},"required":["type","product_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"variant_stock_update"},"variant_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"stock":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["type","variant_id","stock"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"category_update"},"category_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"patch":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"parent_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"visible":{"type":"boolean"},"order":{"type":"integer","minimum":0,"maximum":10000}},"additionalProperties":false}},"required":["type","category_id","patch"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"coupon_status"},"coupon_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"active":{"type":"boolean"}},"required":["type","coupon_id","active"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"promotion_status"},"promotion_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"active":{"type":"boolean"}},"required":["type","promotion_id","active"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"homepage_draft"},"sections":{"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","enum":["hero","marquee","brand_slider","beneficios","categorias","productos","banner_cta","banners","historias","video","ugc","shoppable_images","reviews","faq","newsletter","dos_columnas","editorial_doble","bloques_alternados","texto","custom_html"]},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false}}},"required":["type","sections"],"additionalProperties":false}]}}},"required":["idempotency_key","title","actions"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"seller_message":{"type":"string"},"plan":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$","description":"Identificador UUID v4 de un plan de cambios de Wendo."},"title":{"type":"string"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"actions":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"preview":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string"},"expires_at":{"type":"string"},"applied_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"discarded_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","intent","status","actions","preview","created_at","expires_at","applied_at","discarded_at"],"additionalProperties":false},"next_step":{"type":"string"}},"required":["seller_message","plan","next_step"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_bulk_price_adjustment","title":"Previsualizar ajuste masivo de precios","description":"Paso obligatorio antes de cambiar precios en masa. Requiere definir alcance, estados, productos/variantes, precio base/oferta y tratamiento de precios heredados. No modifica datos.","kind":"read","required_scopes":["products.read","products.prices"],"input_schema":{"type":"object","properties":{"adjustment":{"type":"object","properties":{"filter":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"all"},"states":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["activo","inactivo","borrador"]}}},"required":["type","states"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"category"},"category_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"states":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["activo","inactivo","borrador"]}}},"required":["type","category_id","states"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"products"},"product_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["type","product_ids"],"additionalProperties":false}]},"item_scope":{"type":"string","enum":["simple_products","variants","all_catalog_prices"]},"variant_scope":{"type":"string","enum":["active_only","all"]},"inherited_variant_prices":{"type":"string","enum":["preserve_inheritance","materialize"]},"price_target":{"type":"string","enum":["base","sale","base_and_sale"]},"operation":{"type":"string","enum":["increase","decrease","set"]},"value_type":{"type":"string","enum":["percentage","amount"]},"value":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["filter","item_scope","variant_scope","inherited_variant_prices","price_target","operation","value_type","value"],"additionalProperties":false}},"required":["adjustment"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_bulk_product_update","title":"Previsualizar cambio masivo","description":"Dry-run: no modifica datos y muestra el efecto esperado sobre hasta 50 productos.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"product_ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"update":{"type":"object","properties":{"state":{"type":"string","enum":["activo","inactivo","borrador"]},"category_ids":{"maxItems":20,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"additionalProperties":false}},"required":["product_ids","update"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_coupon_discount","title":"Previsualizar descuento de cupón","description":"Valida vigencia, usos, compra mínima y alcance sin consumir el cupón.","kind":"read","required_scopes":["discounts.read"],"input_schema":{"type":"object","properties":{"coupon_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"unit_price":{"type":"number","minimum":0}},"required":["product_id","quantity","unit_price"],"additionalProperties":false}}},"required":["coupon_id","items"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_homepage_changes","title":"Previsualizar cambios del inicio","description":"Valida una propuesta completa del inicio sin guardar, incluyendo legibilidad de textos sobre fondos e imágenes. Si devuelve contrast_blockers, corregilos y repetí la vista previa. Usá candidate_sections como propuesta efectiva porque puede incluir correcciones automáticas. Explicá el resultado como cambios visibles, sin exponer IDs, versiones ni estructura interna.","kind":"read","required_scopes":["design.read"],"input_schema":{"type":"object","properties":{"sections":{"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","enum":["hero","marquee","brand_slider","beneficios","categorias","productos","banner_cta","banners","historias","video","ugc","shoppable_images","reviews","faq","newsletter","dos_columnas","editorial_doble","bloques_alternados","texto","custom_html"]},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false}}},"required":["sections"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_order_shipping_quote","title":"Recotizar envío de una orden","description":"Cotiza nuevamente una orden existente con sus ítems, destino y configuración logística actual. No modifica la venta.","kind":"read","required_scopes":["settings.read","orders.read"],"input_schema":{"type":"object","properties":{"order_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["order_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"order_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"subtotal":{"type":"number"},"currency":{"type":"string"},"requires_shipping":{"type":"boolean"},"quotes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"plugin_id":{"type":"string"},"nombre":{"type":"string"},"descripcion":{"type":"string"},"precio":{"type":"number"},"dias_estimados":{"type":"number"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","plugin_id","nombre","descripcion","precio","dias_estimados"],"additionalProperties":false}}},"required":["order_id","subtotal","currency","requires_shipping","quotes"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":false,"open_world":true}},{"name":"preview_package_shipping_quote","title":"Cotizar paquete por medidas","description":"Cotiza uno o varios paquetes genéricos por peso, dimensiones, valor declarado y destino. No crea pedidos.","kind":"read","required_scopes":["settings.read"],"input_schema":{"type":"object","properties":{"packages":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":100},"weight_grams":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"length_cm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"width_cm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"height_cm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"declared_unit_value":{"type":"number","minimum":0,"maximum":1000000000}},"required":["quantity","weight_grams","length_cm","width_cm","height_cm","declared_unit_value"],"additionalProperties":false}},"postal_code":{"type":"string","minLength":2,"maxLength":20},"city":{"default":"","type":"string","maxLength":120},"province":{"default":"","type":"string","maxLength":120}},"required":["packages","postal_code"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"subtotal":{"type":"number"},"currency":{"type":"string"},"requires_shipping":{"type":"boolean"},"quotes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"plugin_id":{"type":"string"},"nombre":{"type":"string"},"descripcion":{"type":"string"},"precio":{"type":"number"},"dias_estimados":{"type":"number"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","plugin_id","nombre","descripcion","precio","dias_estimados"],"additionalProperties":false}}},"required":["subtotal","currency","requires_shipping","quotes"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":false,"open_world":true}},{"name":"preview_product_description_update","title":"Previsualizar nueva descripción de producto","description":"Valida HTML, secciones visuales o ambos sin guardar. Ante una intención de diseño/visual/Pro debe recibir sections completas según section_contracts; no reemplaces ese pedido enviando solamente html.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"html":{"type":"string","maxLength":50000},"sections":{"maxItems":8,"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"beneficios"},"config":{"type":"object","properties":{"titulo_seccion":{"type":"string","maxLength":120},"subtitulo_seccion":{"type":"string","maxLength":240},"estilo":{"type":"string","enum":["barra","cards"]},"items":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"object","properties":{"icono":{"type":"string","enum":["truck","shield","refresh","headphones","star","package","clock","check","credit_card","map_pin","map","navigation","building","store"]},"titulo":{"type":"string","minLength":1,"maxLength":120},"subtitulo":{"type":"string","minLength":1,"maxLength":240}},"required":["icono","titulo","subtitulo"],"additionalProperties":false}}},"required":["items"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"faq"},"config":{"type":"object","properties":{"titulo_seccion":{"type":"string","maxLength":120},"subtitulo_seccion":{"type":"string","maxLength":240},"estilo":{"type":"string","enum":["acordeon","cards","dos_columnas"]},"items":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"pregunta":{"type":"string","minLength":1,"maxLength":160},"respuesta":{"type":"string","minLength":1,"maxLength":600}},"required":["pregunta","respuesta"],"additionalProperties":false}}},"required":["estilo","items"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"bloques_alternados"},"config":{"type":"object","properties":{"titulo":{"type":"string","maxLength":120},"bloques":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"object","properties":{"imagen_url":{"type":"string","minLength":1,"maxLength":1000},"imagen_posicion":{"type":"string","enum":["izquierda","derecha"]},"titulo":{"type":"string","minLength":1,"maxLength":120},"descripcion":{"type":"string","minLength":1,"maxLength":800},"imagen_radio":{"type":"string","enum":["none","sm","md","lg","xl","full"]},"texto_alineacion":{"type":"string","enum":["left","center","right"]},"texto_boton":{"type":"string","maxLength":100},"url_boton":{"type":"string","maxLength":1000},"color_fondo":{"type":"string","maxLength":100}},"required":["imagen_url","imagen_posicion","titulo","descripcion"],"additionalProperties":false}}},"required":["bloques"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"texto"},"config":{"type":"object","properties":{"html":{"type":"string","minLength":1,"maxLength":20000},"alineacion":{"type":"string","enum":["left","center","right"]},"padding_vertical":{"type":"string","enum":["sm","md","lg"]},"max_ancho":{"type":"boolean"}},"required":["html","alineacion","padding_vertical","max_ancho"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"custom_html"},"config":{"type":"object","properties":{"html":{"type":"string","minLength":1,"maxLength":20000},"alineacion":{"type":"string","enum":["left","center","right"]},"padding_vertical":{"type":"string","enum":["sm","md","lg"]},"max_ancho":{"type":"boolean"}},"required":["html","alineacion","padding_vertical","max_ancho"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false}]}}},"required":["product_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_product_publish","title":"Previsualizar publicación","description":"Revisa bloqueos y advertencias antes de publicar un producto.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_product_visual_description_copy","title":"Previsualizar copia de descripción visual","description":"Prepara una copia exacta de las secciones visuales de un producto a otro sin guardar. Acepta nombre, slug, URL o ID y Wendo resuelve ambos productos internamente; no pidas product_id ni sections al seller. Usá defaults seguros cuando la intención sea clara y mostrálos en la vista previa.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"copy":{"type":"object","properties":{"source_product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"target_product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"source_product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"target_product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"source_state":{"type":"string","enum":["published","effective_draft"]},"image_policy":{"type":"string","enum":["keep_source_images","require_target_images"]},"target_draft_policy":{"type":"string","enum":["require_empty","replace"]}},"required":["source_state","image_policy","target_draft_policy"],"additionalProperties":false}},"required":["copy"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"preview_shipping_quote","title":"Cotizar envío","description":"Cotiza un conjunto de productos para un destino. Puede consultar proveedores externos y no crea pedidos.","kind":"read","required_scopes":["settings.read","products.read"],"input_schema":{"type":"object","properties":{"items":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"variant_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"quantity":{"type":"integer","minimum":1,"maximum":100}},"required":["product_id","quantity"],"additionalProperties":false}},"postal_code":{"type":"string","minLength":2,"maxLength":20},"city":{"default":"","type":"string","maxLength":120},"province":{"default":"","type":"string","maxLength":120}},"required":["items","postal_code"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"subtotal":{"type":"number"},"currency":{"type":"string"},"requires_shipping":{"type":"boolean"},"quotes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"plugin_id":{"type":"string"},"nombre":{"type":"string"},"descripcion":{"type":"string"},"precio":{"type":"number"},"dias_estimados":{"type":"number"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","plugin_id","nombre","descripcion","precio","dias_estimados"],"additionalProperties":false}}},"required":["subtotal","currency","requires_shipping","quotes"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":false,"open_world":true}},{"name":"preview_store_design_changes","title":"Previsualizar diseño global","description":"Valida ajustes globales sin guardarlos. Usala antes de crear un borrador y explicá el resultado como cambios visibles. Un pedido sobre botones no debe cambiar cards salvo que el seller también lo pida.","kind":"read","required_scopes":["design.read"],"input_schema":{"type":"object","properties":{"changes":{"type":"object","properties":{"colors":{"type":"object","properties":{"color_primario":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color principal de marca para acciones y acentos."},"color_secundario":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color secundario de apoyo y contraste."},"color_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color general de textos de la tienda."},"color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color general de fondo de la tienda."},"color_header":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color de fondo del encabezado."},"color_header_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color del texto y los íconos del encabezado."},"color_footer":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color de fondo del pie de página."},"color_footer_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$","description":"Color del texto del pie de página."}},"additionalProperties":false},"typography":{"type":"object","properties":{"fuente":{"type":"string","enum":["system-ui","Inter","Plus Jakarta Sans","Outfit","Figtree","DM Sans","Work Sans","Space Grotesk","Poppins","Montserrat","Raleway","Nunito","Quicksand","Open Sans","Roboto","Lato","Source Sans 3","Josefin Sans","League Spartan","Bebas Neue","Playfair Display","Cormorant Garamond","Lora","EB Garamond"],"description":"Fuente global de la tienda."},"pack_iconos":{"type":"string","enum":["lucide","heroicons","heroicons-solid","tabler","iconoir","phosphor-thin","phosphor-light","phosphor","phosphor-bold","phosphor-fill","phosphor-duotone"],"description":"Familia visual de los íconos del storefront."}},"additionalProperties":false},"layout_and_buttons":{"type":"object","properties":{"border_radius":{"type":"string","enum":["0rem","0.25rem","0.5rem","0.75rem","1rem"],"description":"Radio de cards y contenedores. No cambia la forma de los botones."},"max_width":{"type":"string","enum":["960px","1120px","1280px","1440px","none"],"description":"Ancho máximo del contenido."},"boton_estilo":{"type":"string","enum":["redondeado","cuadrado","pill"],"description":"Forma global de los botones. Para botones sin redondeo usá cuadrado."},"boton_apariencia":{"type":"string","enum":["solido","contorno","suave","degradado"]},"boton_color_fondo":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}],"description":"Color de botones; vacío hereda el color primario."},"boton_color_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}],"description":"Color del texto; vacío calcula contraste automáticamente."},"boton_hover":{"type":"string","enum":["oscurecer","elevar","crecer","resplandor","relleno","barrido_inverso","relleno_centro","cortina_ascendente","destello","contorno_hover","invertir_relleno","ninguno"]},"boton_hover_borde_ancho":{"type":"string","enum":["","0px","1px","2px","3px","4px"]},"boton_hover_relleno_opacidad":{"anyOf":[{"type":"string","const":""},{"type":"integer","minimum":0,"maximum":100}]},"boton_hover_texto_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_negrita":{"type":"boolean"},"boton_mayusculas":{"type":"boolean"},"boton_sombra_estilo":{"type":"string","enum":["ninguna","suave","marcada"]},"scroll_reveal_enabled":{"type":"boolean"},"scroll_reveal_radius":{"type":"string","enum":["0px","1rem","1.5rem","2rem","2.5rem","3rem"]},"scroll_reveal_shadow":{"type":"boolean"},"flechas_estilo":{"type":"string","enum":["redondo","suave","cuadrado","minimal"]}},"additionalProperties":false},"navigation":{"type":"object","properties":{"header_layout":{"type":"string","enum":["estandar","logo_centro","logo_centro_linea","nav_centrado","barra_inferior"]},"header_height":{"type":"string","enum":["normal","comodo","grande","muy_grande"]},"header_sticky":{"type":"boolean"},"header_flotante":{"type":"boolean"},"header_flotante_separacion":{"type":"integer","minimum":0,"maximum":64},"nav_text_size":{"type":"integer","minimum":12,"maximum":20},"nav_hover_estilo":{"type":"string","enum":["fondo","subrayado","color","ninguno"]},"nav_hover_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"header_transparente":{"type":"boolean"},"header_transparente_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"header_transparente_opacidad":{"type":"integer","minimum":0,"maximum":100},"header_transparente_degrade":{"type":"boolean"},"buscador_estilo":{"type":"string","enum":["modal","textbox"]},"buscador_posicion":{"type":"string","enum":["izquierda","derecha"]},"buscador_color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"buscador_color_borde":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"buscador_color_placeholder":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"buscador_radio":{"type":"integer","minimum":0,"maximum":999}},"additionalProperties":false},"product_cards":{"type":"object","properties":{"aspect_ratio":{"type":"string","enum":["1/1","3/4","2/3","4/3","3/2"]},"object_fit":{"type":"string","enum":["cover","contain"]},"hover_efecto":{"type":"string","enum":["zoom","segunda_imagen","ninguno"]},"card_hover_efecto":{"type":"string","enum":["lift","lift_sutil","borde","ninguno"]},"flechas_imagen_desktop":{"type":"boolean"},"indicadores_imagen_mobile":{"type":"boolean"},"mostrar_bordes":{"type":"boolean"},"mostrar_sku":{"type":"boolean"},"mostrar_variantes":{"type":"boolean"},"variantes_posicion":{"type":"string","enum":["debajo_imagen","debajo_nombre","debajo_precio"]},"variantes_forma":{"type":"string","enum":["miniaturas","circulos","solo_colores","pastillas"]},"variantes_mostrar_titulo":{"type":"boolean"},"compra_rapida":{"type":"boolean"},"compra_rapida_posicion":{"type":"string","enum":["sobre_imagen","siempre_visible","debajo_info"]},"precio_a_mostrar":{"type":"string","enum":["lista","descuento","ambos"]},"mostrar_cuotas":{"type":"boolean"},"wishlist_mostrar":{"type":"boolean"},"wishlist_icono":{"type":"string","enum":["heart","star","bag"]},"wishlist_forma":{"type":"string","enum":["circulo","redondeado","cuadrado"]},"wishlist_estilo":{"type":"string","enum":["translucido","solido","borde","minimal"]},"wishlist_icono_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_icono_activo_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_fondo_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_fondo_opacidad":{"type":"integer","minimum":0,"maximum":100},"wishlist_borde_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"wishlist_sombra":{"type":"boolean"},"nombre_tamano":{"type":"string","enum":["xs","sm","base","lg"]},"nombre_peso":{"type":"string","enum":["normal","medium","semibold","bold"]},"nombre_alineacion":{"type":"string","enum":["left","center","right"]},"precio_tamano":{"type":"string","enum":["xs","sm","base","lg"]},"precio_peso":{"type":"string","enum":["normal","medium","semibold","bold"]},"precio_alineacion":{"type":"string","enum":["left","center","right"]},"badge_radio":{"type":"string","enum":["pill","redondeado","cuadrado"]},"badge_peso_fuente":{"type":"string","enum":["medium","semibold","bold"]},"badge_promo_bg":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_promo_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_promo_fondo":{"type":"boolean"},"badge_promo_borde":{"type":"boolean"},"badge_promo_borde_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"etiqueta_promocional_estilo":{"type":"string","enum":["marquee","barra","badge","ribbon","pulso","sobre_nombre","debajo_nombre","junto_precio","debajo_precio","oculto"]},"etiqueta_promocional_posicion":{"type":"string","enum":["arriba_izquierda","arriba_derecha","abajo_izquierda","abajo_derecha"]},"etiqueta_promocional_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_descuento_bg":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_descuento_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"badge_descuento_fondo":{"type":"boolean"},"badge_descuento_borde":{"type":"boolean"},"badge_descuento_borde_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"}},"additionalProperties":false},"catalog":{"type":"object","properties":{"default_view":{"type":"string","enum":["comfortable","compact","list"]},"filters_layout":{"type":"string","enum":["sidebar","topbar","drawer"]},"featured_position":{"type":"string","enum":["top","sidebar_left","sidebar_right"]},"header_layout":{"type":"string","enum":["simple","image","editorial"]},"show_buyer_view_switcher":{"type":"boolean"},"show_category_image":{"type":"boolean"},"show_active_filter_chips":{"type":"boolean"},"featured_mode":{"type":"string","enum":["none","manual"]},"featured_title":{"type":"string","maxLength":200},"featured_product_ids":{"maxItems":12,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"additionalProperties":false},"product_page":{"type":"object","properties":{"composicion":{"type":"object","properties":{"layout":{"type":"string","enum":["clasico","editorial","superpuesto"]},"panel_superficie":{"type":"string","enum":["solida","suave","glass"]},"panel_posicion":{"type":"string","enum":["izquierda","centro","derecha"]},"panel_ancho":{"type":"string","enum":["compacto","normal","amplio"]},"panel_color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"panel_opacidad":{"type":"integer","minimum":35,"maximum":100},"panel_blur":{"type":"integer","minimum":0,"maximum":32},"panel_borde":{"type":"boolean"},"panel_radio":{"type":"string","enum":["none","md","lg","xl"]},"panel_texto":{"type":"string","enum":["auto","claro","oscuro"]},"media_altura":{"type":"string","enum":["media","alta","pantalla"]},"media_foco":{"type":"string","enum":["arriba_izquierda","arriba_centro","arriba_derecha","centro_izquierda","centro","centro_derecha","abajo_izquierda","abajo_centro","abajo_derecha"]},"media_overlay_color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"media_overlay_opacidad":{"type":"integer","minimum":0,"maximum":70},"media_mostrar_flechas":{"type":"boolean"},"editorial_columnas":{"anyOf":[{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4}]},"editorial_separacion":{"type":"string","enum":["ninguna","sutil","media"]},"editorial_ajuste_imagen":{"type":"string","enum":["cubrir","completa"]},"editorial_transicion":{"type":"string","enum":["corte","deslizar","fundido"]},"superpuesto_mostrar_indicadores":{"type":"boolean"},"superpuesto_transicion":{"type":"string","enum":["fade","corte"]}},"additionalProperties":false},"galeria_layout":{"type":"string","enum":["vertical","dos_columnas","carrusel","carrusel_izquierda","principal_grande","magazine"]},"galeria_layout_mobile":{"type":"string","enum":["carrusel","carrusel_lateral","principal_miniaturas"]},"galeria_aspecto":{"type":"string","enum":["cuadrado","vertical","vertical_grande"]},"galeria_efecto_hover":{"type":"string","enum":["zoom","brillo","ninguno"]},"galeria_bordes_redondeados":{"type":"boolean"},"galeria_autoplay":{"type":"boolean"},"galeria_autoplay_intervalo":{"type":"integer","minimum":2,"maximum":30},"mostrar_sku":{"type":"boolean"},"mostrar_stock":{"type":"boolean"},"mostrar_categoria":{"type":"boolean"},"mostrar_descripcion_corta":{"type":"boolean"},"mostrar_boton_compartir":{"type":"boolean"},"detalle_modo":{"type":"string","enum":["tabs","acordeon"]},"detalle_posicion":{"type":"string","enum":["debajo_grid","debajo_botones"]},"cotizador_envio_activo":{"type":"boolean"},"cotizador_envio_posicion":{"type":"string","enum":["debajo_botones","en_tab_envios"]},"tab_envios_activo":{"type":"boolean"},"tab_envios_titulo":{"type":"string","maxLength":200},"tab_envios_contenido":{"type":"string","maxLength":5000},"tab_envios_imagen_url":{"type":"string","maxLength":2048},"tab_pagos_activo":{"type":"boolean"},"tab_pagos_titulo":{"type":"string","maxLength":200},"tab_pagos_contenido":{"type":"string","maxLength":5000},"tab_pagos_imagen_url":{"type":"string","maxLength":2048},"relacionados_cantidad":{"type":"integer","minimum":0,"maximum":24},"relacionados_layout":{"type":"string","enum":["carrusel","grid"]},"relacionados_titulo":{"type":"string","maxLength":200},"boton_mobile_sticky":{"type":"boolean"},"precio_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"precio_tamano":{"type":"string","enum":["sm","md","lg","xl"]},"precio_peso":{"type":"string","enum":["normal","medium","semibold","bold"]},"precio_tachado_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"precio_secundario_color":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"precio_mostrar_ahorro":{"type":"boolean"},"precio_mostrar_cuotas":{"type":"boolean"},"precio_mostrar_transferencia":{"type":"boolean"},"precio_mostrar_impuestos":{"type":"boolean"},"variantes_estilo":{"type":"string","enum":["pills","outline","bloques","minimal"]},"variantes_tamano":{"type":"string","enum":["sm","md","lg"]},"variantes_radio":{"type":"string","enum":["inherit","none","sm","md","lg","pill"]},"variantes_swatch_forma":{"type":"string","enum":["inherit","circle","rounded","square"]},"variantes_activo_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_activo_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_activo_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_inactivo_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_inactivo_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_inactivo_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"variantes_deshabilitado_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"cantidad_estilo":{"type":"string","enum":["bordeado","suave","compacto"]},"cantidad_radio":{"type":"string","enum":["inherit","none","sm","md","lg","pill"]},"boton_comprar_label":{"type":"string","maxLength":200},"boton_agregar_label":{"type":"string","maxLength":200},"boton_tamano":{"type":"string","enum":["sm","md","lg"]},"boton_layout":{"type":"string","enum":["horizontal","vertical"]},"boton_comprar_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_comprar_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_agregar_icono":{"type":"boolean"},"boton_peso_texto":{"type":"string","enum":["normal","medium","semibold","bold"]},"boton_elegir_label":{"type":"string","maxLength":200},"boton_elegir_usar_agregar":{"type":"boolean"},"boton_elegir_bg":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_elegir_texto":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_elegir_borde":{"anyOf":[{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},{"type":"string","const":""}]},"boton_elegir_radio":{"type":"string","enum":["inherit","none","sm","md","lg","pill"]}},"additionalProperties":false},"announcement_bar":{"type":"object","properties":{"activa":{"type":"boolean"},"modo":{"type":"string","enum":["texto","slider","countdown"]},"texto":{"type":"string","maxLength":500},"url":{"type":"string","maxLength":2048},"textos":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":500}},"slider_intervalo":{"type":"integer","minimum":2,"maximum":60},"slider_efecto":{"type":"string","enum":["fade","slide"]},"countdown_fecha":{"type":"string","maxLength":80},"countdown_label":{"type":"string","maxLength":200},"countdown_boton_texto":{"type":"string","maxLength":200},"countdown_boton_url":{"type":"string","maxLength":2048},"color_fondo":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"color_texto":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"tamano_fuente":{"type":"string","enum":["xs","sm","base"]},"cerrable":{"type":"boolean"}},"additionalProperties":false},"footer":{"type":"object","properties":{"slogan":{"type":"string","maxLength":500},"instagram":{"type":"string","maxLength":200},"facebook":{"type":"string","maxLength":500},"tiktok":{"type":"string","maxLength":200},"twitter":{"type":"string","maxLength":200},"ocultar_powered_by":{"type":"boolean"},"color_slogan":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"color_redes":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"redes_estilo":{"type":"string","enum":["simple","circulo","circulo_outline","cuadrado"]},"redes_tamano":{"type":"integer","minimum":12,"maximum":64},"logo_footer_url":{"type":"string","maxLength":2048},"logo_footer_size":{"type":"integer","minimum":20,"maximum":400},"layout":{"type":"string","enum":["completo","minimal"]},"columnas":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"titulo":{"type":"string","maxLength":200},"tipo":{"type":"string","enum":["links","categorias","texto","imagen","newsletter","paginas"]},"items":{"maxItems":30,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":200},"url":{"type":"string","maxLength":2048}},"required":["label","url"],"additionalProperties":false}},"categorias_modo":{"type":"string","enum":["todas","seleccionadas"]},"categorias_slugs":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"paginas_modo":{"type":"string","enum":["todas","seleccionadas"]},"paginas_slugs":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"texto":{"type":"string","maxLength":5000},"imagen_url":{"type":"string","maxLength":2048},"imagen_link":{"type":"string","maxLength":2048}},"required":["id","titulo","tipo"],"additionalProperties":false}},"banner_url":{"type":"string","maxLength":2048},"banner_link":{"type":"string","maxLength":2048},"medios_pago":{"type":"boolean"},"bottom_links":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":200},"url":{"type":"string","maxLength":2048}},"required":["label","url"],"additionalProperties":false}}},"additionalProperties":false}},"additionalProperties":false}},"required":["changes"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"publish_homepage_draft","title":"Publicar borrador del inicio","description":"Publica exactamente el borrador validado del inicio y vuelve a controlar su legibilidad. Si solicita contrast_review_required, guardá primero la propuesta corregida y mostrá una nueva vista previa. Antes de invocarla, explicá qué se hará visible y avisá que la aplicación pedirá una última autorización; recomendá “Permitir una vez”. Usala solo ante una confirmación explícita y separada del seller; no publica el tema ni otros cambios de Editor de diseño.","kind":"write","required_scopes":["design.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"confirm":{"type":"boolean","const":true,"description":"Debe ser true para publicar el inicio."}},"required":["idempotency_key","expected_version","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"publish_product","title":"Publicar producto","description":"Publica un producto que ya fue revisado con preview_product_publish. Requiere confirmación explícita y una versión vigente.","kind":"write","required_scopes":["products.read","products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"confirm":{"type":"boolean","const":true},"preview_token":{"type":"string","minLength":20,"maxLength":2000}},"required":["idempotency_key","expected_version","confirm","preview_token"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"publish_product_description_sections","title":"Publicar descripción visual de producto","description":"Publica exactamente el borrador visual validado. Antes de invocarla, nombrá el producto, explicá que quedará visible y avisá que la aplicación pedirá una última autorización; recomendá “Permitir una vez”. Requiere una confirmación explícita y separada; aprobar la propuesta o el borrador no autoriza publicar.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"confirm":{"type":"boolean","const":true,"description":"Debe ser true para publicar el borrador visual."}},"required":["idempotency_key","product_id","expected_version","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"publish_store_design_draft","title":"Publicar diseño global","description":"Publica solamente los ajustes globales admitidos que están en el borrador. Antes de invocarla, explicá qué cambios quedarán visibles y avisá que la aplicación pedirá una última autorización; recomendá “Permitir una vez”. Requiere una confirmación explícita y separada; no publica secciones, logo, favicon ni CSS personalizado.","kind":"write","required_scopes":["design.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"confirm":{"type":"boolean","const":true,"description":"Debe ser true después de una confirmación explícita del seller."}},"required":["idempotency_key","expected_version","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"reorder_product_images","title":"Reordenar imágenes","description":"Reordenar imágenes con aislamiento por tienda, versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"image_ids":{"maxItems":20,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["idempotency_key","expected_version","image_ids"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"save_product_description_sections_draft","title":"Guardar borrador visual de descripción","description":"Guarda secciones visuales completas como borrador sin publicar. Es la escritura correcta después de aprobar una propuesta de diseño o descripción Pro.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"sections":{"maxItems":8,"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"beneficios"},"config":{"type":"object","properties":{"titulo_seccion":{"type":"string","maxLength":120},"subtitulo_seccion":{"type":"string","maxLength":240},"estilo":{"type":"string","enum":["barra","cards"]},"items":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"object","properties":{"icono":{"type":"string","enum":["truck","shield","refresh","headphones","star","package","clock","check","credit_card","map_pin","map","navigation","building","store"]},"titulo":{"type":"string","minLength":1,"maxLength":120},"subtitulo":{"type":"string","minLength":1,"maxLength":240}},"required":["icono","titulo","subtitulo"],"additionalProperties":false}}},"required":["items"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"faq"},"config":{"type":"object","properties":{"titulo_seccion":{"type":"string","maxLength":120},"subtitulo_seccion":{"type":"string","maxLength":240},"estilo":{"type":"string","enum":["acordeon","cards","dos_columnas"]},"items":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"pregunta":{"type":"string","minLength":1,"maxLength":160},"respuesta":{"type":"string","minLength":1,"maxLength":600}},"required":["pregunta","respuesta"],"additionalProperties":false}}},"required":["estilo","items"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"bloques_alternados"},"config":{"type":"object","properties":{"titulo":{"type":"string","maxLength":120},"bloques":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"object","properties":{"imagen_url":{"type":"string","minLength":1,"maxLength":1000},"imagen_posicion":{"type":"string","enum":["izquierda","derecha"]},"titulo":{"type":"string","minLength":1,"maxLength":120},"descripcion":{"type":"string","minLength":1,"maxLength":800},"imagen_radio":{"type":"string","enum":["none","sm","md","lg","xl","full"]},"texto_alineacion":{"type":"string","enum":["left","center","right"]},"texto_boton":{"type":"string","maxLength":100},"url_boton":{"type":"string","maxLength":1000},"color_fondo":{"type":"string","maxLength":100}},"required":["imagen_url","imagen_posicion","titulo","descripcion"],"additionalProperties":false}}},"required":["bloques"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"texto"},"config":{"type":"object","properties":{"html":{"type":"string","minLength":1,"maxLength":20000},"alineacion":{"type":"string","enum":["left","center","right"]},"padding_vertical":{"type":"string","enum":["sm","md","lg"]},"max_ancho":{"type":"boolean"}},"required":["html","alineacion","padding_vertical","max_ancho"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"visible":{"default":true,"type":"boolean"},"orden":{"type":"integer","minimum":0,"maximum":9007199254740991},"visible_desktop":{"type":"boolean"},"visible_mobile":{"type":"boolean"},"spacing_desktop":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"spacing_mobile":{"type":"string","enum":["default","none","xs","sm","md","lg","xl"]},"tipo":{"type":"string","const":"custom_html"},"config":{"type":"object","properties":{"html":{"type":"string","minLength":1,"maxLength":20000},"alineacion":{"type":"string","enum":["left","center","right"]},"padding_vertical":{"type":"string","enum":["sm","md","lg"]},"max_ancho":{"type":"boolean"}},"required":["html","alineacion","padding_vertical","max_ancho"],"additionalProperties":{}}},"required":["id","tipo","config"],"additionalProperties":false}]}}},"required":["idempotency_key","product_id","expected_version","sections"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"search_customers","title":"Buscar clientes","description":"Busca perfiles registrados e invitados y resume compras. Oculta email y teléfono por defecto.","kind":"read","required_scopes":["customers.read"],"input_schema":{"type":"object","properties":{"query":{"type":"string","maxLength":200},"activity":{"default":"all","type":"string","enum":["all","with_orders","without_orders"]},"archived":{"default":false,"type":"boolean"},"include_contact":{"default":false,"type":"boolean"},"registered_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},"registered_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},"last_order_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},"last_order_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"customers":{"type":"array","items":{"type":"object","properties":{"customer_key":{"type":"string"},"profile_type":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"email_verified":{"type":"boolean"},"archived":{"type":"boolean"},"order_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"total_spent":{"type":"number"},"last_order_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["customer_key","profile_type","name","email","phone","email_verified","archived","order_count","total_spent","last_order_at","created_at"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"next_offset":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"has_more":{"type":"boolean"}},"required":["total","limit","offset","next_offset","has_more"],"additionalProperties":false}},"required":["customers","pagination"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"search_orders","title":"Buscar pedidos","description":"Busca pedidos por cliente, número, fecha, estado, pago o monto. Oculta el email salvo que se solicite explícitamente.","kind":"read","required_scopes":["orders.read"],"input_schema":{"type":"object","properties":{"query":{"type":"string","maxLength":200},"fulfillment_states":{"maxItems":7,"type":"array","items":{"type":"string","enum":["pendiente","por_empaquetar","empaquetado","listo_para_retirar","enviada","entregada","cancelada"]}},"payment_states":{"maxItems":4,"type":"array","items":{"type":"string","enum":["pendiente","pagado","rechazado","reembolsado"]}},"created_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},"created_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},"min_total":{"type":"number","minimum":0},"max_total":{"type":"number","minimum":0},"include_contact":{"default":false,"type":"boolean"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"summary":{"type":"string"},"data":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"numero_orden":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"estado":{"type":"string"},"pago_estado":{"type":"string"},"comprador_nombre":{"type":"string"},"comprador_email":{"type":"string"},"total":{"type":"number"},"moneda":{"type":"string"},"metodo_pago":{"anyOf":[{"type":"string"},{"type":"null"}]},"metodo_envio":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","numero_orden","estado","pago_estado","comprador_nombre","comprador_email","total","moneda","metodo_pago","metodo_envio","created_at"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"next_offset":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"has_more":{"type":"boolean"}},"required":["total","limit","offset","next_offset","has_more"],"additionalProperties":false}},"required":["orders","pagination"],"additionalProperties":false},"meta":{"type":"object","properties":{"schema_version":{"type":"string","const":"2026-07-27"}},"required":["schema_version"],"additionalProperties":false}},"required":["ok","summary","data","meta"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"search_products","title":"Buscar productos","description":"Busca productos por nombre, SKU, slug, URL completa o ID y devuelve la versión necesaria para editarlos. Si el seller pegó un enlace, pasalo literalmente como query.","kind":"read","required_scopes":["products.read"],"input_schema":{"type":"object","properties":{"query":{"type":"string","maxLength":1000},"state":{"type":"string","enum":["activo","inactivo","borrador"]},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":true,"destructive":false,"idempotent":true,"open_world":false}},{"name":"set_coupon_active","title":"Activar o desactivar cupón","description":"Cambia el estado de un cupón con control de versión. La activación respeta el límite del plan.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"coupon_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"active":{"type":"boolean"}},"required":["idempotency_key","coupon_id","expected_version","active"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"set_order_tracking","title":"Cargar seguimiento de orden","description":"Cargar seguimiento de orden. No permite pagos, reembolsos ni cancelaciones.","kind":"write","required_scopes":["orders.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"order_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"tracking_number":{"type":"string","minLength":1,"maxLength":300}},"required":["idempotency_key","order_id","expected_version","tracking_number"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"set_product_categories","title":"Asignar categorías al producto","description":"Asignar categorías al producto con aislamiento por tienda, versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"category_ids":{"maxItems":20,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["idempotency_key","expected_version","category_ids"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"set_product_variant_active","title":"Activar o desactivar variante","description":"Activar o desactivar variante con control de versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"variant_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"active":{"type":"boolean"}},"required":["idempotency_key","variant_id","expected_version","active"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"set_promotion_active","title":"Activar o desactivar promoción","description":"Cambia el estado de una promoción con control de versión y confirmación explícita.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"promotion_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"active":{"type":"boolean"},"confirm":{"type":"boolean","const":true}},"required":["idempotency_key","promotion_id","expected_version","active","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"promotion":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"message":{"type":"string"},"unchanged":{"type":"boolean"}},"required":["promotion"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"unpublish_product","title":"Despublicar producto","description":"Quita un producto de la tienda sin eliminarlo. Requiere confirmación explícita y una versión vigente.","kind":"write","required_scopes":["products.read","products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"confirm":{"type":"boolean","const":true}},"required":["idempotency_key","expected_version","confirm"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":true,"idempotent":true,"open_world":false}},{"name":"update_category","title":"Editar categoría","description":"Editar categoría con aislamiento por tienda, versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"category_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"name":{"type":"string","minLength":1,"maxLength":200},"slug":{"type":"string","maxLength":200},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"parent_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"visible":{"type":"boolean"},"order":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["idempotency_key","category_id","expected_version"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_coupon","title":"Modificar cupón","description":"Reemplaza la configuración de un cupón sin cambiar si está activo, usando control de versión.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"coupon_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"code":{"type":"string","minLength":2,"maxLength":50},"type":{"type":"string","enum":["porcentaje","monto_fijo","envio_gratis","porcentaje_producto","monto_fijo_producto"]},"value":{"type":"number","minimum":0},"minimum_purchase":{"default":0,"type":"number","minimum":0},"usage_limit":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"valid_from":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"valid_until":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"filter_type":{"default":"todos","type":"string","enum":["todos","categorias","productos"]},"filter_ids":{"default":[],"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["idempotency_key","coupon_id","expected_version","code","type","value"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_order_notes","title":"Editar notas internas de orden","description":"Editar notas internas de orden. No permite pagos, reembolsos ni cancelaciones.","kind":"write","required_scopes":["orders.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"order_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"required":["idempotency_key","order_id","expected_version","notes"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_product_content","title":"Editar contenido de producto","description":"Modifica contenido, categoría, imágenes o estados no publicados usando control de versión. Para publicar o despublicar usá las herramientas específicas. No cambia precio ni stock.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"name":{"type":"string","minLength":2,"maxLength":200},"short_description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"barcode":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"tags":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"state":{"type":"string","enum":["activo","inactivo","borrador"]},"category_name":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"image_urls":{"maxItems":20,"type":"array","items":{"type":"string","format":"uri"}}},"required":["idempotency_key","expected_version"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_product_image","title":"Editar imagen","description":"Editar imagen con aislamiento por tienda, versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"image_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"url":{"type":"string","format":"uri"},"alt":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"order":{"type":"integer","minimum":0,"maximum":19}},"required":["idempotency_key","expected_version","image_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_product_price","title":"Modificar precio de producto","description":"Cambia precio y oferta de un producto simple con control de versión y aprobación explícita.","kind":"write","required_scopes":["products.prices"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"price":{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},"sale_price":{"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]}},"required":["idempotency_key","expected_version","price","sale_price"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_product_stock","title":"Modificar stock de producto","description":"Ajusta stock de un producto simple con control de versión y registra el movimiento de inventario.","kind":"write","required_scopes":["products.stock"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"product_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"product_ref":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","minLength":1,"maxLength":1000}],"description":"Nombre, slug, URL completa o ID del producto. Preferí copiar literalmente lo que indicó el seller."},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"stock":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"null significa disponibilidad sin un límite cuantificado; 0 significa sin unidades disponibles."}},"required":["idempotency_key","expected_version","stock"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_product_variant_content","title":"Editar variante","description":"Editar variante con control de versión e idempotencia.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"variant_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"sku":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"barcode":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}]},"cost":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"weight":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"height":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"width":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"depth":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"mpn":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"show_price":{"type":"boolean"}},"required":["idempotency_key","variant_id","expected_version"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_product_variant_price","title":"Modificar precio de variante","description":"Modificar precio de variante con control de versión e idempotencia.","kind":"write","required_scopes":["products.prices"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"variant_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"price":{"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]},"sale_price":{"anyOf":[{"type":"number","minimum":0,"description":"0 es válido para un producto gratuito; los ajustes masivos no pueden llevar precios a cero accidentalmente."},{"type":"null"}]}},"required":["idempotency_key","variant_id","expected_version","price","sale_price"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_product_variant_stock","title":"Modificar stock de variante","description":"Modificar stock de variante con control de versión e idempotencia.","kind":"write","required_scopes":["products.stock"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"variant_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"stock":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"null significa disponibilidad sin un límite cuantificado; 0 significa sin unidades disponibles."}},"required":["idempotency_key","variant_id","expected_version","stock"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"update_promotion","title":"Editar promoción","description":"Reemplaza la configuración editable de una promoción con control de versión. No cambia su estado activo.","kind":"write","required_scopes":["discounts.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"promotion_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expected_version":{"type":"string","minLength":1,"maxLength":80,"description":"Versión exacta obtenida al consultar el recurso antes de modificarlo."},"name":{"type":"string","minLength":2,"maxLength":160},"type":{"type":"string","enum":["2x1","precio_tachado","cross_selling","progresivo","carrito"]},"applies_to":{"default":"tienda","type":"string","enum":["tienda","categorias","productos"]},"applies_ids":{"default":[],"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"discount_type":{"default":null,"anyOf":[{"type":"string","enum":["porcentaje","monto_fijo"]},{"type":"null"}]},"discount_value":{"default":null,"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"buy_x":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"pay_y":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"cross_product_id":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"progressive_rules":{"default":[],"maxItems":10,"type":"array","items":{"type":"object","properties":{"from_quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"percentage":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["from_quantity","percentage"],"additionalProperties":false}},"combine_strikethrough":{"default":false,"type":"boolean"},"combine_free_shipping":{"default":false,"type":"boolean"},"combine_cart_discount":{"default":false,"type":"boolean"},"combine_apps":{"default":false,"type":"boolean"},"starts_at":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]},"ends_at":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Instante RFC3339 completo con zona horaria, por ejemplo 2026-07-27T15:30:00-03:00."},{"type":"null"}]}},"required":["idempotency_key","promotion_id","expected_version","name","type"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{"promotion":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"message":{"type":"string"},"unchanged":{"type":"boolean"}},"required":["promotion"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}},{"name":"upload_product_image","title":"Subir imagen de producto","description":"Recibe una imagen adjunta generada o elegida por el seller, la valida, optimiza y guarda en Wendo sin consumir créditos de IA. No crea, asocia ni publica el producto.","kind":"write","required_scopes":["products.write"],"input_schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":200,"description":"Clave única y estable para reintentar exactamente esta operación sin duplicarla."},"image_file":{"type":"object","properties":{"download_url":{"type":"string","maxLength":8000,"format":"uri"},"file_id":{"type":"string","minLength":1,"maxLength":500},"mime_type":{"type":"string","minLength":1,"maxLength":100},"file_name":{"type":"string","minLength":1,"maxLength":255}},"required":["download_url","file_id"],"additionalProperties":false}},"required":["idempotency_key","image_file"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"output_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{}},"annotations":{"read_only":false,"destructive":false,"idempotent":true,"open_world":false}}]}