Guía de Integración con Shopify
Para clientes de FlowPOS
| Campo | Detalle |
|---|---|
| Audiencia | Clientes de FlowPOS (no técnico) |
| Módulo | 026-ecommerce-integration |
| Versión | v1 |
| Fecha | Marzo 28, 2026 |
Resumen
Desde la perspectiva del cliente, el proceso es simple — la complejidad técnica está del lado de FlowPOS. No se requiere configuración técnica, llaves de API, ni conocimientos de desarrollo.
Requisitos previos
Antes de conectar Shopify con FlowPOS, el cliente necesita tener:
- Una cuenta de Shopify activa con cualquier plan de pago (no se necesita ser desarrollador)
- Su tienda en Shopify ya configurada con productos, si desea sincronizar inventario existente — aunque también es posible empujar el catálogo desde FlowPOS hacia Shopify
Decisiones previas a la conexión
Antes de hacer clic en "Conectar", es importante que el cliente haya tomado estas decisiones de negocio. El equipo de FlowPOS debe acompañarlo en este proceso durante el onboarding.
1. ¿Qué tienda conectar?
Si el cliente tiene varias tiendas en Shopify, deberá elegir una. En la versión actual, FlowPOS permite una sola tienda conectada por negocio.
2. Dirección de sincronización de productos
Esta es una decisión única que afecta la primera sincronización:
| Escenario | Acción recomendada |
|---|---|
| El catálogo está en FlowPOS y Shopify está vacío | Empujar productos desde FlowPOS hacia Shopify |
| El catálogo ya existe en Shopify | Revisar con el equipo FlowPOS cómo importarlo antes de conectar |
| Catálogo en ambos lados | Requiere revisión manual antes de sincronizar |
3. Fuente de verdad del inventario
⚠️ Este es el punto más importante.
Una vez conectada la integración, FlowPOS es el maestro del inventario. El cliente debe dejar de editar el inventario directamente en Shopify. Si lo hace, se generarán conflictos de sincronización.
Regla simple: Todo movimiento de inventario ocurre en FlowPOS. Shopify solo refleja lo que FlowPOS le envía.
Pasos para conectar
El proceso completo toma menos de 2 minutos:
- En la PWA de FlowPOS, ir a Configuración → Integraciones
- Hacer clic en Conectar Shopify
- Serán redirigidos a la pantalla de autorización de Shopify — iniciar sesión si es necesario y aprobar los permisos solicitados
- Hacer clic en Instalar en la pantalla de Shopify
- Serán redirigidos de vuelta a FlowPOS — la conexión queda activa de inmediato
El flujo OAuth maneja todo automáticamente. El cliente nunca necesita tocar llaves de API ni configuración técnica.
Qué NO necesita hacer el cliente
- Crear llaves de API o tokens
- Configurar webhooks en Shopify
- Acceder a configuración de desarrollador en Shopify
- Tener una cuenta de Shopify Partners
Preguntas frecuentes
¿Funciona con cualquier plan de Shopify? Sí. Todos los planes de pago de Shopify soportan los permisos que FlowPOS necesita.
¿Qué pasa si desconecto la integración? El inventario en Shopify deja de sincronizarse automáticamente. Los productos y el historial de FlowPOS no se ven afectados.
¿Puedo conectar más de una tienda de Shopify? En la versión actual, se puede conectar una tienda por negocio. Soporte para múltiples tiendas está en el roadmap.
¿Qué pasa si edito el inventario directamente en Shopify? FlowPOS sobreescribirá ese valor en la próxima sincronización. Para evitar confusión, todos los ajustes de inventario deben hacerse desde FlowPOS.
Nota para el equipo de onboarding
El punto crítico a cubrir con cada cliente antes de conectar la integración es la fuente de verdad del inventario. Ahí es donde ocurren los conflictos post-activación, no durante la conexión en sí.
Se recomienda incluir este tema como un paso explícito en el checklist de onboarding de la integración.