NATURA Ecuador

Agregar Producto Al Carrito

Agrega un producto al carrito de compras (carrito de abandonados) de un usuario incógnito identificado por su token de sesión. Si el producto ya está en el carrito, suma la cantidad indicada. Retorna error si el token, el SKU o el producto no son válidos.

Obtener Ruta Revista

Obtiene la URL de la revista (catálogo en PDF) para un ciclo específico. Recibe opcionalmente un ciclo en formato 'numero-año' (ej: 10-2026); si no se indica, usa el ciclo vigente del sector por defecto (Quito). Retorna el ciclo, año, la URL de la revista y si el archivo existe físicamente en el servidor.

Actualizar Usuario Incognito

Actualiza los datos de un usuario incógnito ya registrado: nombre, celular, cédula, correo, ciudad y/o dirección. Solo se modifican los campos que se envíen; el resto permanece sin cambios. Si se indica ciudad y/o dirección, se vuelve a intentar ubicar al usuario en el catálogo de distritos igual que en el registro (locationResolved indica si la nueva ubicación se identificó con buena confianza).

Ping

Verifica que el servidor MCP esté activo y responde correctamente.

Consultar Estado Pedido

Consulta el estado actual de un pedido: indica si ya fue aceptado por una consultora o si sigue pendiente de aceptación. Puede indicar el número de pedido (ID) directamente, o el token de sesión del usuario para buscar su pedido más reciente (si se indican ambos, se prioriza el ID). Si el pedido ya fue aceptado, retorna los datos de la consultora asignada (nombre, código, celular, email).

Listar Productos En Lista

Lista los productos en la lista de favoritos o en el carrito de compras del usuario. Retorna nombre, SKU, cantidad, precio de venta y URL de imagen de cada producto. El parámetro 'lista' acepta 'favoritos' o 'carrito'.

Identificar Ciclo Por Direccion

Identifica, a partir de una dirección en texto libre, la ciudad, barrio/distrito, sector y provincia/estado más probables (búsqueda difusa) usando la vista DistrictCyclesView, y retorna el ciclo de venta actualmente vigente para ese distrito. Si la confianza de la coincidencia es baja o hay varios distritos con score similar, retorna found=false junto con una lista de candidatos para desambiguar.

Agregar A Favoritos

Agrega un producto a la lista de favoritos del usuario identificado por su token de sesión. Solo disponible para usuarios con cuenta registrada (no incógnito). Si el producto ya estaba en favoritos, lo elimina (comportamiento toggle). Recibe el token de sesión y el SKU o ID del producto.

Enviar Catalogo Por Whats App

Envía el catálogo de productos por WhatsApp al número de celular registrado de un usuario incógnito. Usa el token de sesión activo del usuario para personalizar el enlace del catálogo. Retorna error si el usuario no tiene celular registrado o no tiene sesión activa.

Registrar Pedido

Registra el pedido lite (carrito de abandonados) del usuario incógnito identificado por su token de sesión. Convierte el carrito actual en una orden, notifica al usuario por WhatsApp y asigna una consultora. Retorna el ID del pedido creado, o un mensaje de error si el carrito está vacío, los datos del usuario están incompletos, o no hay consultoras disponibles.

Buscar Productos Por Imagen

Busca productos visualmente similares a partir de una imagen, usando comparación de vectores de imagen (embeddings). Recibe la URL pública de una imagen o su contenido codificado en base64 (proporcione solo una de las dos opciones). Retorna hasta 5 productos candidatos con nombre, SKU, webId, porcentaje de confianza de la coincidencia, precio regular y precio de venta para el ciclo vigente (sector por defecto), y el último ciclo en el que el producto estuvo activo ('lastActiveCycle', formato num

Buscar Productos Por Nombre

Busca productos activos en un ciclo por SKU (coincidencia exacta o parcial) o, si no hay coincidencia de SKU, por similitud semántica de nombre (usa embeddings de IA, entiende sinónimos e intención, no solo coincidencia literal de texto). Recibe un SKU o un texto describiendo lo que se busca, y opcionalmente un ciclo en formato 'numero-año' (ej: 10-2026); si no se indica ciclo usa el más reciente disponible. Retorna nombre, descripción, webId, sku, precio regular, precio de venta, url de imagen

Registrar Usuario Incognito

Registra un usuario incógnito (sin cuenta) con nombre y celular, y retorna un código de sesión para usar en siguientes llamadas (equivalente al flujo de invitado de la tienda). Cédula, ciudad, dirección e intereses son opcionales. Si la dirección/ciudad no se indican o no se pueden ubicar con buena confianza en el catálogo, el usuario igual queda registrado con la ubicación por defecto (Quito) y locationResolved=false. Los intereses, si se indican, se usan luego para priorizar productos afines a