Cómo sincronizar tu catálogo de Shopify con Passerelle

Antes de empezar".

-->

Título: Cómo sincronizar tu catálogo de Shopify con Passerelle

Extracto: Si vendes vestidos en Shopify, no tienes que capturarlos dos veces. Importa tu catálogo y mantenlo al día con un enlace, desde tu panel.

---

Antes de empezar

Si ya vendes tus prendas en Shopify, capturar cada una también en Passerelle es trabajo doble. La integración hace dos cosas:

1. Importa tu catálogo actual de una sola vez.
2. Lo mantiene al día: cuando creas, cambias o quitas un producto en tu tienda, Passerelle lo recibe.

Conviene saber cómo funciona hoy, para que no haya sorpresas:

• Tú eliges si tus productos son de venta o de renta. Por defecto llegan como prendas en venta, y el precio de Shopify es el precio de venta. Si tu tienda renta, cámbialo a «renta» en Integraciones (ver más abajo).
• Se importa lo básico: nombre, descripción (sin formato), precio, talla, color y hasta 5 fotos. Passerelle reconoce si el producto es un vestido, una bolsa, un zapato, una blusa, un pantalón, una chaqueta o un accesorio.
• Lo que Shopify no tiene se llena con valores genéricos, como el material «Otros». Ajústalo en tu inventario para que las clientas filtren mejor.
• Los productos sin precio se ignoran, porque no hay nada que publicar.
• Tu plan manda: no se pasa del límite de prendas de tu plan. Lo que exceda se omite y lo verás en el historial.

Paso 0: elige si tus productos son de venta o de renta

En Integraciones → Cómo tratar tus productos de Shopify elige una opción:

• Son prendas en venta: el precio de Shopify es el precio de venta. Si un producto se agota en Shopify, se oculta.
• Son prendas en renta: el precio de Shopify es el precio de renta (si el producto tiene variantes, se usa el más bajo, como «desde»). El inventario de Shopify no las oculta, porque una prenda rentada regresa.

Si mezclas ambas cosas en la misma tienda, agrega a cada producto en Shopify la etiqueta renta o venta: esa etiqueta manda sobre la opción general. El cambio aplica a los productos que lleguen desde ese momento; las prendas que ya estaban en Passerelle conservan su tipo.

Ojo con el calendario: las rentas que hagas por Shopify no aparecen en el calendario de Passerelle. Si rentas por los dos canales, bloquea las fechas a mano para no reservar dos veces la misma prenda.

Paso 1: importa tu catálogo actual

Este paso trae los productos que ya tienes. Necesitas una clave de solo lectura de tu tienda.

En Shopify

1. Entra a Configuración → Aplicaciones y canales de ventas → Desarrollar aplicaciones y pulsa Crear una aplicación. Ponle un nombre, por ejemplo «Importación Passerelle».
2. En Configuración de la API de Admin, activa únicamente el permiso read_products (lectura de productos).
3. Instala la aplicación y copia el Token de acceso de la API de Admin. Shopify lo muestra una sola vez.

En Passerelle

1. Abre tu Panel de negocio → Integraciones.
2. En «Importar mi catálogo actual», escribe el dominio de tu tienda (por ejemplo mitienda.myshopify.com) y pega el token.
3. Pulsa Importar catálogo. Al terminar verás cuántas prendas se importaron, cuántas ya estaban y cuántas se omitieron.

Passerelle usa el token solo durante la importación y no lo guarda. Aun así, trátalo como una contraseña: no lo compartas por correo, redes sociales ni mensajes públicos. Cuando termines, elimina la aplicación en Shopify y el token deja de servir.

La importación trae hasta 500 productos activos y no modifica lo que ya estaba en Passerelle.

Paso 2: crea tu enlace secreto

1. En Integraciones, pulsa Generar URL secreta y luego Copiar URL.
2. Trata ese enlace como una contraseña: quien lo tenga puede agregar o quitar prendas de tu catálogo.

Paso 3: crea los webhooks en Shopify

Un webhook es un aviso automático: le dice a Passerelle «pasó esto en mi tienda». Necesitas tres, uno por cada tipo de cambio.

1. En la administración de Shopify entra a Configuración (esquina inferior izquierda) y luego a Notificaciones.
2. Baja hasta Webhooks y pulsa Crear webhook.
3. Crea estos tres, todos con formato JSON y pegando el mismo enlace de Passerelle:

• Creación de producto: agrega la prenda a tu catálogo.
• Actualización de producto: cambia título, descripción, precio y fotos.
• Eliminación de producto: oculta la prenda.

Después de guardarlos, crea o edita un producto de prueba en Shopify y revisa Estado de la sincronización en la misma pestaña de Integraciones: ahí aparece cada aviso que llega, si se creó, se actualizó o se omitió, y el motivo si hubo un error.

Qué tener en cuenta

• Shopify manda en lo suyo. Cada actualización desde Shopify reescribe el título, la descripción, el precio y las fotos (el precio de venta o el de renta, según el tipo de la prenda). Haz esos cambios en Shopify. Lo demás (color, material, eventos, si es destacada, la limpieza) es tuyo y Passerelle no lo toca.
• La visibilidad se respeta. Si ocultas o muestras una prenda en Passerelle, esa decisión se mantiene hasta que Shopify cambie el estado del producto, por ejemplo al pasarlo a borrador, agotarlo o volverlo a publicar.
• Los productos agotados o en borrador se ocultan. Los productos nuevos en borrador no se crean hasta que los publiques.
• Eliminar un producto en Shopify solo oculta la prenda en Passerelle, para conservar su historial.
• Las fotos se revisan. Passerelle comprueba que cada imagen abra. Si ninguna responde, la prenda conserva sus fotos anteriores o usa una imagen provisional.
• Si crees que el enlace se filtró, pulsa Rotar llave secreta. El enlace anterior deja de funcionar y tendrás que pegar el nuevo en tus tres webhooks de Shopify.

¿Te atoraste?

Escríbenos a soporte@passerelle.mx con el nombre de tu boutique y una captura de la pantalla donde te quedaste. No nos envíes tu token.