Productos

La página Productos muestra el catálogo completo con opciones de búsqueda y filtrado.

Funciones del panel

Estadísticas del catálogo

En la parte superior se muestran tres métricas clave:

Métrica	Descripción
Total de productos	Número de productos del catálogo
Categorías	Número de categorías de producto únicas
Marcas	Número de marcas de producto únicas

Filtros

Filtra productos con varios criterios:

Filtro	Descripción
Buscar	Encuentra productos por nombre, descripción o SKU
Categoría	Filtra por categoría de producto
Marca	Filtra por nombre de marca
Estado de inventario	Muestra disponibles, agotados o todos

Tabla de productos

Una tabla ordenable que muestra:

Columna	Descripción
Imagen	Miniatura o marcador de posición del producto
Nombre	Nombre y SKU del producto
Precio	Precio de venta actual y precio de comparación (tachado)
Categoría	Categorías de producto (etiquetas)
Marca	Nombre de la marca
Inventario	Disponible (verde) o agotado (rojo)

Consultar productos

1. Ve a Comercio electrónico > Productos.
2. Usa el cuadro de búsqueda para encontrar productos concretos.
3. Aplica filtros para acotar los resultados.
4. Recorre los resultados paginados.

Comprender los datos de producto

Campos de producto

Campo	Descripción
externalId	Identificador único del producto (por ejemplo, SKU)
name	Nombre de visualización del producto
price	Precio de venta actual
compareAtPrice	Precio original (muestra el descuento)
currency	Código de moneda del precio
categories	Matriz de nombres de categorías
tags	Matriz de etiquetas del producto
brand	Nombre de marca o proveedor
imageUrl	Imagen principal del producto
inStock	Estado de disponibilidad
variants	Variaciones de talla, color u otras opciones

Variantes

Los productos pueden tener varias variantes con distintos:

• Precios
• SKU
• Estados de inventario
• Opciones: talla, color, etc.

Sincronizar productos

Los productos normalmente se sincronizan desde tu plataforma de comercio electrónico. Joryio admite:

• Shopify: sincronización automática mediante webhook.
• WooCommerce: integración con API REST.
• Magento: extensión Joryio Connect.
• Plataformas personalizadas: usa la API de productos.

Importación masiva

Usa la API de actualización o inserción masiva para importar productos: envía mediante POST una matriz JSON sin envoltorio - máximo 500 elementos - al endpoint de productos:

POST /catalog/products
[
  { "productId": "SKU-001", "name": "Product 1", "price": 19.99, "source": "shopify" },
  { "productId": "SKU-002", "name": "Product 2", "price": 29.99, "source": "shopify" }
]

Usar productos en campañas

Recomendaciones de productos

Incluye productos en campañas de email mediante plantillas Liquid:

{% for product in recommended_products %}
  <div class="product">
    <img src="{{ product.imageUrl }}" alt="{{ product.name }}">
    <h3>{{ product.name }}</h3>
    <p>${{ product.price }}</p>
    <a href="{{ product.url }}">Comprar ahora</a>
  </div>
{% endfor %}

Productos del carrito abandonado

Accede a los productos del carrito en emails de recuperación:

{% for item in cart.items %}
  <p>{{ item.name }} x {{ item.quantity }} - ${{ item.total }}</p>
{% endfor %}
<p>Total del carrito: ${{ cart.value }}</p>
<a href="{{ cart.checkoutUrl }}">Completar compra</a>

Selecciones de productos

Una selección es un filtro guardado y reutilizable sobre el catálogo de productos. Por ejemplo: «calzado rebajado», «artículos disponibles por menos de 50 USD» o «todo lo etiquetado como new-arrival». Créala una vez y reutilízala en cualquier lugar donde muestres productos.

Para crear una: en la página Productos, selecciona Selecciones → Nueva selección. Asigna un nombre, añade una o más reglas sobre campos de producto - nombre, marca, precio, inventario, categorías, etiquetas, etc. - con operadores adecuados para cada tipo, elige si deben coincidir todas o cualquiera de las reglas y define el número máximo de productos. La vista previa muestra exactamente qué productos coinciden en ese momento.

Las selecciones son el equivalente en el catálogo de productos a las selecciones de entidades: un árbol de filtros guardado al que puedes dirigir contenido y recomendaciones, en vez de enumerar IDs de productos manualmente.

Buenas prácticas

1. Mantén los productos sincronizados: asegúrate de sincronizar con regularidad la plataforma de comercio electrónico.
2. Usa imágenes de alta calidad: mejoran la interacción con los emails.
3. Mantén un inventario preciso: las notificaciones de agotado dependen de datos correctos.
4. Categoriza de forma coherente: usa categorías consistentes para filtrar mejor.
5. Incluye URL: las URL de producto permiten medir los clics.

Solución de problemas

Los productos no aparecen

• Revisa la autenticación de la API.
• Comprueba que el ID del espacio de trabajo sea correcto.
• Confirma que los productos contienen los campos necesarios: externalId, name y price.

Las imágenes no cargan

• Comprueba que las URL de imagen sean accesibles públicamente.
• Revisa los requisitos de HTTPS.
• Asegúrate de que las URL de imagen no hayan caducado.

El estado de inventario es incorrecto

• Puede ser necesario ajustar el intervalo de sincronización.
• Revisa la configuración del webhook.
• Confirma que el seguimiento del inventario esté activado.

Siguientes pasos

• Crear campañas de recomendaciones de productos
• Configurar flujos de carrito abandonado
• Ver la documentación de la API de productos