Sincronización de productos de Shopify
Cómo se sincronizan los productos, los pedidos y las colecciones entre Shopify y Umbrella.
Sincronización de productos de Shopify
Umbrella usa los webhooks de Shopify para sincronizar automáticamente y en tiempo real tus productos, colecciones, pedidos, clientes y datos de preparación de pedidos. Cuando hay cambios en tu tienda de Shopify, Umbrella actualiza automáticamente la elegibilidad de las garantías, los precios y los registros de pólizas.
Qué se sincroniza
Productos
Umbrella sincroniza el título del producto, el handle, el tipo, el proveedor, las etiquetas, las variantes (ID, título, precio, SKU), las imágenes y la pertenencia a colecciones. Estos datos alimentan las reglas de asignación de los planes de garantía (por ejemplo, “aplicar a todos los productos con la etiqueta ‘electronics’”).
Pedidos
Umbrella procesa el número de pedido, los artículos, la información del cliente, el estado del pago, el estado de preparación y los datos de reembolsos y cancelaciones. Esto permite crear y activar pólizas de garantía y calcular los plazos para presentar reclamos.
Otros datos
- Colecciones — Se usan para las reglas de elegibilidad de garantías basadas en colecciones
- Clientes — Se asocian a las pólizas de garantía para búsquedas por cuenta
- Preparaciones de pedidos — Se rastrean para determinar cuándo empieza el plazo de reclamo (si está configurado para comenzar con el envío)
Reprocesamiento manual
Si los datos parecen desincronizados, inicia un reprocesamiento manual desde Panel → Configuración → Integraciones → Shopify:
- Reprocesar productos — Vuelve a obtener todos los productos y actualiza la caché local
- Reprocesar pedidos — Vuelve a obtener los pedidos recientes y concilia las pólizas de garantía
- Reprocesar colecciones — Vuelve a obtener las colecciones y actualiza las reglas de elegibilidad
Con catálogos grandes, el proceso puede tardar varios minutos.
Confiabilidad de los webhooks
- Shopify entrega cada webhook al menos una vez (los duplicados se manejan de forma segura)
- Si el endpoint del webhook no está disponible temporalmente, Shopify reintenta con espera exponencial durante un máximo de 48 horas
- Usa el reprocesamiento manual para recuperar los datos que se hayan perdido
Solución de problemas
| Problema | Solución |
|---|---|
| Los productos nuevos no aparecen en las reglas de garantía | Espera de 1 a 2 minutos a que se procese el webhook y luego revisa el estado de sincronización del producto |
| El pedido no crea una póliza de garantía | Verifica que el pedido incluya un artículo de garantía y que esté pagado |
| El plazo de reclamo no comienza | Confirma que el pedido se haya preparado |
| Productos desincronizados después de una importación masiva | Usa el reprocesamiento manual para actualizar todos los datos de productos |
Relacionado
- Integración con Shopify — Configuración general de la conexión con Shopify
- Extensiones de checkout de Shopify — Visualización de garantías en el checkout
- Crear planes de garantía — Reglas de elegibilidad de productos
