Manual de Integración
Guía operativa para la sincronización entre Shopify e Intelisis.
1 Introducción y Propósito
Este documento describe el funcionamiento de la plataforma intermediaria que sincroniza la tienda Shopify con el sistema ERP Intelisis. La integración sigue un modelo de "intermediario"; las plataformas no se comunican directamente, sino a través del Conector.
Arquitectura General
Shopify
Ventas, Imágenes Extra, Fulfillment
CONECTOR
Motor de traducción y transferencia
Intelisis
Fuente de Verdad (Productos, Precios, Inventario)
2 Acceso y Responsabilidades
Shopify
Gestionado por Administración y agente designado de la Tienda.
Intelisis
Gestionado exclusivamente por Administración.
Flujos de Datos y Procesos
3.1. Creación y Actualización de Productos
Intelisis -> Shopify
REGLA DE ORO:
NO crear productos manualmente en Shopify. Cualquier ajuste de texto, precio o descripción debe realizarse exclusivamente en Intelisis. El Conector sobrescribirá cualquier cambio manual hecho en Shopify.
Paso 1: Activación en Intelisis
- Crear nuevo producto en Intelisis.
- Disparador: Marcar la casilla
MostrarEnShopify. - El conector solo procesa artículos con esta marca activa.
- articulo: SKU (ej: CI2720-412232530)
- titulo: Nombre del producto
- descripcion1/2: Descripción corta
- atributos: Descripción larga/Marketing
- precioLista: Precio
- subCuentaDetallada: Atributos visibles (Talla, Color)
- disponible: Stock inicial
- categoria/grupo...: Se convierten en tags/colecciones.
Paso 2: Gestión de Imágenes (En Shopify)
Una vez sincronizado el producto, suba imágenes adicionales en Shopify siguiendo la regla de nomenclatura:
// Formato requerido:
[SKU_DE_VARIANTE]_[CUALQUIER_TEXTO].[jpg|png]
// Ejemplos válidos:
CI2720_TOP_vista1.jpg
CI2720_MAIN_detalle.png
3.2. Sincronización de Inventario
Intelisis -> Shopify
El inventario físico y disponible se gestiona exclusivamente en Intelisis. El Conector actualiza Shopify automáticamente.
- El stock cambia en Intelisis (recepción, ajuste, venta física).
- El Conector detecta el nuevo total.
- Se actualiza el "Stock Disponible" en Shopify para el SKU correspondiente.
- Frecuencia: [ 5 min]
3.3. Gestión de Pedidos
Shopify -> Intelisis
-
Cliente compra en Shopify
Se genera la Orden #XXXX.
-
Procesamiento del Conector
Lee la orden, valida datos y envía a Intelisis.
-
Registro en Intelisis
Reserva inventario y prepara facturación electrónica.
3.4. Fulfillment (Envío)
Acción en Shopify
Responsable: Encargado de Tienda.
- Recibe notificación en App Shopify.
- Realiza Picking & Packing.
- Prepara envío en Shopify y solicita motorizado.
- Verifica dirección del cliente en ese momento.
- Shopify notifica al cliente (email/SMS) automáticamente.
Gestión Visual y Diseño (CMS)
Personalización del Tema
A diferencia de los productos, el contenido visual (Banners, Sliders, Colecciones Destacadas, Blog) NO se sincroniza desde Intelisis. Se gestiona directamente en el editor visual de Shopify.
Pantalla del Editor de Shopify
← Panel Izquierdo
- 📄 Páginas
- ✏️ Secciones
- 🎨 Configuración del tema
Vista Previa Central
Panel Derecho →
- 🖼️ Subir imagen
- 📝 Editar texto
- 🔗 Agregar enlace
- ⚙️ Ajustes
Cómo Editar la Tienda
- Ir al Admin de Shopify.
- Navegar a Tienda Online > Temas.
- Hacer clic en el botón negro Personalizar.
- Seleccionar la sección a editar en la barra lateral izquierda (ej. "Image Banner", "Featured Collection").
Elementos Configurables
- Carrusel (Slideshow): Banners principales del Home.
- Colecciones Destacadas: Grillas de productos (ej. "Nuevos Arribos").
- Anuncios: Barra superior de notificaciones (ej. "Envío Gratis").
Guía: Cómo Modificar un Banner Principal
Acceder al Editor
Admin Shopify → Tienda Online → Temas → Botón "Personalizar"
Seleccionar Sección
En el panel izquierdo, buscar "Image Banner" o "Slideshow" y hacer clic
Subir Nueva Imagen
En el panel derecho, clic en "Seleccionar imagen" → "Subir" → Elegir archivo desde tu computadora
Editar Texto y Enlace
Modificar el título, descripción y botón. Agregar URL de destino (ej: /collections/nuevos-productos)
Vista Previa y Guardar
Revisar en vista Móvil y Escritorio. Clic en "Guardar" (esquina superior derecha)
Buenas Prácticas para Imágenes de Banners
Para evitar que la tienda cargue lento:
- Use formato WebP o JPG comprimido.
- Peso ideal: Menos de 200KB para banners grandes.
- Siempre verifique cómo se ve en la vista Móvil del editor.
4.2. Cómo se Agrupan los Productos
Colecciones, Tags y Categorías
Los productos se organizan automáticamente en Colecciones basándose en los campos de categorización definidos en Intelisis. Esto permite agrupar productos por tipo, marca, temporada, etc.
Flujo de Agrupación de Productos
Intelisis
Campos de Categorización:
- •
categoria - •
grupo - •
familia - •
marca
Conector
Procesa y Convierte:
Categoría → Tag
Grupo → Colección
Shopify
Resultado:
- • Colecciones automáticas
- • Tags de filtrado
- • Navegación organizada
Mapeo de Campos: Intelisis → Shopify
| Campo en Intelisis | Se Convierte en Shopify | Ejemplo |
|---|---|---|
categoria |
Tag | "Ropa Deportiva" → Tag: Ropa Deportiva |
grupo |
Colección | "Zapatillas" → Colección: Zapatillas |
familia |
Tag | "Running" → Tag: Running |
marca |
Tag + Colección | "Reef" → Tag y Colección: Reef |
Ejemplo Práctico de Agrupación
Producto en Intelisis:
articulo: "RF2024-BLK-M"
titulo: "Reef Fanning Black"
categoria: "Calzado"
grupo: "Sandalias"
familia: "Playa"
marca: "Reef"
Resultado en Shopify:
¿Cómo Modificar las Colecciones Visibles en la Tienda?
- Para cambiar la agrupación de un producto: Modificar los campos (categoria, grupo, familia, marca) en Intelisis. El Conector actualizará automáticamente.
- Para crear una colección manual: Ir a Shopify Admin → Productos → Colecciones → "Crear colección" → Seleccionar productos manualmente.
- Para destacar colecciones en el Home: Usar el Editor de Temas (Personalizar) → Agregar sección "Featured Collection" → Seleccionar la colección deseada.
Caso Especial: Colecciones con Filtrado de Variantes
Esta funcionalidad avanzada permite mostrar solo variantes específicas de productos en una colección, filtrando por combinaciones de tags. Es ideal para colecciones segmentadas por género, temporada o características específicas.
Ejemplo Práctico
Escenario: Colección "Sandalias Mujer HO25"
Quieres mostrar solo las sandalias que cumplan: SANDALIAS + Female + HO25
Tags en los productos:
Resultado:
Solo se mostrarán las variantes que tengan los 3 tags clave combinados.
Guía: Configurar Colección con Filtrado de Variantes
Crear la Colección
Admin Shopify → Productos → Colecciones → "Crear colección"
Tipo: Automática
Condiciones: Configurar para incluir todos los productos base (ej: Tag contiene "SANDALIAS")
Seleccionar el Template
En la misma página de la colección, desplazarse a la sección "Theme template"
Seleccionar: espc-variant
Este template especial permite el filtrado por variantes
Definir la Clave de Filtrado
Desplazarse a la sección "Metafields" (al final de la página)
Campo: clave-variante
Valor: La clave que identifica las variantes a mostrar
Ejemplos de claves:
- •
HO25- Muestra variantes de temporada HO25 - •
Female- Muestra solo variantes femeninas - •
HO25-CJ7339- Muestra variantes de modelo específico
Guardar y Verificar
Clic en "Guardar" y visitar la colección en la tienda para verificar que solo aparecen las variantes correctas
Flujo de Filtrado de Variantes
Producto con Tags
Metacampo Filtra
clave-variante: HO25
Resultado
Solo variantes con tag "HO25"
Notas Importantes
- La clave debe coincidir exactamente con uno de los tags del producto
- El template
espc-variantdebe estar instalado en tu tema - Puedes usar cualquier tag como clave (temporada, género, modelo, etc.)
- Si la clave no coincide con ningún tag, se mostrarán todas las variantes
Casos de Uso Comunes
Colección por Género
Clave: Female o Male
Muestra solo productos del género seleccionado
Colección por Temporada
Clave: HO25, SS26
Agrupa productos de la misma temporada
Colección por Modelo
Clave: HO25-CJ7339
Muestra todas las variantes de un modelo específico
Colección Combinada
Clave: SANDALIAS
Filtra por categoría de producto
4.3. Modificar Menús de Navegación
Organizar el menú principal y footer
Los menús de navegación (Header y Footer) se configuran manualmente en Shopify y permiten organizar cómo los clientes navegan por la tienda.
Acceder a Menús
- Admin Shopify → Tienda Online
- Clic en Navegación
- Seleccionar el menú a editar (ej: "Main menu" o "Footer menu")
Tipos de Enlaces
- Colecciones: /collections/nombre-coleccion
- Páginas: /pages/sobre-nosotros
- Productos: /products/nombre-producto
- Externos: https://ejemplo.com
Guía: Agregar un Enlace al Menú Principal
Ir a Navegación
Admin → Tienda Online → Navegación → "Main menu"
Agregar Elemento
Clic en "Agregar elemento del menú"
Configurar Enlace
Nombre: "Nuevos Productos" | Enlace: Buscar y seleccionar la colección
Ordenar (Opcional)
Arrastrar y soltar para cambiar el orden de los elementos
Guardar
Clic en "Guardar menú" (esquina superior derecha)
Tip: Crear Submenús (Menús Desplegables)
Para crear un submenú, arrastra un elemento del menú ligeramente hacia la derecha debajo de otro elemento. Esto creará un menú desplegable cuando el usuario pase el cursor sobre el elemento padre.
Gestión de Productos en Shopify
5.1. Crear y Gestionar Colecciones
Organiza productos en grupos personalizados
Las colecciones permiten agrupar productos de forma manual o automática. Aunque el Conector crea colecciones basadas en Intelisis, puedes crear colecciones adicionales para promociones, temporadas o categorías especiales.
Colección Automática
Los productos se agregan automáticamente según condiciones que defines.
Ejemplo de condiciones:
- • Tag contiene "Verano"
- • Precio mayor a $50
- • Marca es "Reef"
- • Inventario mayor a 0
Colección Manual
Seleccionas manualmente qué productos incluir.
Ideal para:
- • Promociones especiales
- • Productos destacados
- • Ofertas del mes
- • Selecciones curadas
Guía: Crear una Nueva Colección
Acceder a Colecciones
Admin Shopify → Productos → Colecciones → "Crear colección"
Información Básica
Título: "Ofertas de Verano" | Descripción: Texto promocional (opcional)
Tipo de Colección
Elegir "Manual" o "Automática"
Agregar Productos
Manual: Buscar y seleccionar productos | Automática: Definir condiciones (ej: Tag = "Verano")
Imagen de Colección (Opcional)
Subir una imagen representativa que aparecerá en la página de colecciones
SEO y Disponibilidad
Configurar título SEO, descripción meta y canal de ventas (Online Store)
Guardar
Clic en "Guardar" (esquina superior derecha)
Ejemplos de Condiciones para Colecciones Automáticas
Productos en Oferta
Condición: Tag contiene "Oferta" Y Inventario > 0
Nuevos Productos (Últimos 30 días)
Condición: Fecha de publicación es en los últimos 30 días
Productos Premium
Condición: Precio > $100
5.2. Editar Productos en Shopify
Ajustes permitidos y restricciones
IMPORTANTE: Limitaciones de Edición
NO editar en Shopify: Título, Descripción, Precio, SKU, Inventario. Estos campos se sobrescriben desde Intelisis. Solo edita imágenes adicionales, SEO y disponibilidad de canales.
Permitido Editar
- Imágenes adicionales: Subir fotos extra del producto
- SEO: Título y descripción meta para buscadores
- Canales de venta: Activar/desactivar en Online Store
- Organización: Agregar a colecciones manuales
NO Editar (Se Sobrescribe)
- Título del producto
- Descripción
- Precio
- SKU / Código de barras
- Inventario disponible
Guía: Editar Información SEO de un Producto
Buscar el Producto
Admin Shopify → Productos → Buscar por nombre o SKU
Ir a la Sección SEO
Desplazarse hacia abajo hasta "Vista previa del listado en motores de búsqueda"
Editar Metadatos
Clic en "Editar SEO del sitio web" → Modificar título y descripción meta
Guardar Cambios
Clic en "Guardar" (esquina superior derecha)
5.3. Gestión de Variantes
Tallas, colores y opciones de productos
Las variantes (tallas, colores, etc.) se crean automáticamente desde Intelisis basándose en el campo subCuentaDetallada. Sin embargo, puedes visualizar y gestionar su disponibilidad en Shopify.
Cómo Funcionan las Variantes
Cada variante tiene su propio SKU, precio e inventario. Por ejemplo, una camiseta puede tener variantes: "Talla S - Rojo", "Talla M - Azul", etc.
Ver Variantes de un Producto
- Admin Shopify → Productos → Seleccionar producto
- Desplazarse a la sección "Variantes"
- Ver lista de todas las variantes con su SKU, precio e inventario
Ejemplo de Variantes en Shopify
| Variante | SKU | Precio | Inventario |
|---|---|---|---|
| Talla S / Rojo | RF2024-S-RED |
$45.00 | 12 disponibles |
| Talla M / Azul | RF2024-M-BLU |
$45.00 | 8 disponibles |
| Talla L / Negro | RF2024-L-BLK |
$45.00 | 0 disponibles |
Recordatorio
No modifiques manualmente el inventario de variantes en Shopify. El stock se actualiza automáticamente desde Intelisis cada 5 minutos.
5.4. Ocultar o Mostrar Productos
Control de visibilidad en la tienda
Puedes controlar qué productos son visibles en la tienda online sin eliminarlos del sistema.
Método 1: Desde Intelisis (Recomendado)
Desmarcar la casilla MostrarEnShopify en Intelisis.
El producto se ocultará automáticamente en Shopify en el próximo ciclo de sincronización.
Método 2: Desde Shopify (Temporal)
Cambiar el estado del producto a "Borrador" o desactivar el canal "Online Store".
⚠️ Nota: Si el producto sigue activo en Intelisis, podría reactivarse en la próxima sincronización.
Guía: Ocultar un Producto en Shopify
Buscar el Producto
Admin Shopify → Productos → Seleccionar producto
Cambiar Estado
En la sección "Estado", cambiar de "Activo" a "Borrador"
Guardar
El producto ya no será visible en la tienda online
Monitorización y Errores Comunes
Cuándo reportar: Si el stock visible es incorrecto (ej. Intelisis tiene 0 y web tiene stock) o si cambios de precio no se reflejan tras el tiempo de sincronización estándar.
| Error (Síntoma) | Causa Probable | Solución |
|---|---|---|
| Producto no aparece en Shopify |
1. No tiene marca MostrarEnShopify.2. Faltan campos obligatorios (SKU/Precio). |
1. Activar casilla en Intelisis. 2. Completar campos y esperar ciclo. |
| Fallo de Stock (Venta sin inventario) | Sync de stock lenta o fallida. | Notificar Soporte. Gestionar orden manualmente con cliente. |
| Imágenes rotas o incorrectas | Nombre de archivo sin prefijo SKU correcto. |
Renombrar imagen en Shopify: SKU_descripcion.jpg
|