Con la integración de Shopify, tu tienda en línea y QPayPro trabajan como un solo sistema: el catálogo, el inventario de tus sucursales y los pedidos se mantienen al día en ambos lados, sin que tengas que pasarlos a mano.

¿Qué hace QPayPro con tu tienda Shopify?

• Catálogo: trae tus productos de Shopify a QPayPro (con sus variaciones, fotos y precios) y publica en Shopify los productos que creaste en QPayPro.
• Inventario: Shopify muestra el stock de tus sucursales físicas. Cuando vendes en el punto de venta, el stock de la tienda en línea se actualiza solo.
• Pedidos: cada pedido de Shopify entra automáticamente a QPayPro, descuenta inventario y lo puedes despachar, cobrar o marcar como preparado desde el panel.
• Devoluciones: las devoluciones que abras en Shopify marcan la orden como "Devolución en curso" y, al reembolsarse, quedan registradas en QPayPro.
• Bitácora: ves cada aviso que tu tienda envía y qué se hizo con él, para saber al instante si algo no está llegando.

Antes de empezar

• Tu plan de QPayPro debe incluir la integración con Shopify.
• Necesitas acceso de administrador a tu tienda Shopify.
• Ten a mano el dominio .myshopify.com de tu tienda (lo ves en Shopify → Configuración → Dominios). Tu dominio propio (por ejemplo mitienda.com) no sirve para vincular.

Paso 1. Abre la integración en QPayPro

En el panel de QPayPro entra a Integraciones y, en la tarjeta Shopify, haz clic en Configurar.

Paso 2. Crea la app de QPayPro en Shopify

Shopify ya no permite crear apps personalizadas desde el admin de la tienda: ahora se crean en el Dev Dashboard.

1. En Shopify ve a Configuración → Apps → Desarrollar apps → Desarrollar apps en Dev Dashboard.
2. Crea una app (por ejemplo, QPayPro).
3. En Versiones → Nueva versión → Alcances, agrega estos permisos y lanza la versión:

   read_products, write_products, read_inventory, write_inventory, read_locations, write_locations, read_orders, write_orders, read_draft_orders, write_draft_orders, read_product_listings, write_product_listings, read_product_feeds, write_product_feeds, unauthenticated_read_product_inventory, read_merchant_managed_fulfillment_orders, write_merchant_managed_fulfillment_orders, read_third_party_fulfillment_orders, write_third_party_fulfillment_orders

4. Instala la app en tu tienda y acepta los permisos. Al terminar la verás en Configuración → Apps:

Paso 3. Conecta la tienda en QPayPro

En la pestaña Conexión completa Credenciales de la tienda:

• Dominio de la tienda: solo el subdominio de tu tienda, por ejemplo mi-tienda (o la URL completa .myshopify.com).
• ID de cliente de la app y Secreto de cliente de la app: los copias del Dev Dashboard, en Configuración de la app → Credenciales. Con estas dos llaves QPayPro renueva el acceso solo; no necesitas pegar un token.
• Token de acceso Admin API: déjalo vacío. Solo se usa si tu tienda ya tenía una app personalizada antigua.

Activa Sincronización con Shopify: Sí.

Paso 4. Configura los webhooks (avisos de Shopify)

Los webhooks son los avisos que Shopify le manda a QPayPro cada vez que pasa algo en tu tienda. Sin ellos los pedidos no llegan.

En QPayPro, en la misma pestaña Conexión, copia la URL de destino:

https://app.qpaypro.com/api/shopify/webhook

Luego, en Shopify ve a Configuración → Notificaciones → Webhooks → Crear webhook y crea uno por cada evento de la lista, todos con formato JSON y la misma URL:

Así se ve una tienda con los webhooks de QPayPro configurados:

Al final de esa misma página Shopify muestra el texto "Tus webhooks se firmarán con…". Copia ese valor, pégalo en QPayPro en el campo Secreto de firma y presiona Guardar.

Paso 5. Ajusta la sincronización de inventario

En la pestaña Sincronización avanzada decides cómo se mueve el stock:

• ¿Qué inventario publica Shopify? La suma de todas tus sucursales físicas, o el de una sucursal específica.
• ¿De dónde se descuenta el pedido al entrar? De la sucursal del canal (una sucursal virtual "Shopify"; al despachar eliges la física de donde sale la mercadería) o de la sucursal con más stock.

• Flujo de stock desde Shopify: qué pasa cuando cambias el stock directamente en Shopify.
  • Solo sucursal Shopify: el cambio se queda en la sucursal del canal.
  • Copiar el número: las sucursales que elijas quedan con el mismo número que Shopify (Shopify pasa a 10 → la sucursal queda en 10).
  • Aplicar el movimiento: se aplica la diferencia (sube o baja) en una sucursal.
• Traer productos de Shopify: importa o actualiza tu catálogo desde la tienda. Hazlo la primera vez para vincular los productos.
• Publicar todos en Shopify: sube a la tienda los productos que creaste en QPayPro y todavía no existen allá.

Paso 6. Verifica que todo esté funcionando

La pestaña Movimientos muestra cada cambio de stock que llegó desde Shopify, con su sucursal, el saldo y el detalle. Todo queda también en el kardex.

Más abajo, Eventos recibidos lista los avisos que tu tienda envió en los últimos 30 días y qué se hizo con cada uno:

• Procesado: se aplicó (entró el pedido, se actualizó el producto o se movió el stock).
• Ignorado: llegó bien, pero a propósito no se hizo nada; el motivo dice por qué.
• Duplicado: Shopify reenvió un aviso que ya se había procesado.
• Rechazado: la firma no coincide. Revisa el Secreto de firma.
• Error: falló al procesarse. Shopify lo reintenta durante 48 horas.

Alcances y límites

• En productos simples, QPayPro envía a Shopify el precio y el stock. En productos con variaciones envía solo el stock de cada variación; el precio de cada variación se administra en Shopify.
• En productos simples, el código de barras de Shopify llega a QPayPro como Identificador, y el lector del punto de venta lo reconoce igual que el SKU.
• Los pedidos con más de 60 días de antigüedad no se consultan (Shopify exige un permiso especial).
• Editar los artículos de un pedido (agregar o quitar líneas) se hace en Shopify.
• Emitir el saldo de una devolución como tarjeta de regalo de Shopify requiere un permiso que se solicita a Shopify.
• Los eventos recibidos se conservan 30 días.

Problemas comunes

• Un pedido no entró: búscalo en Eventos recibidos. Si no aparece, revisa que exista el webhook "Creación de pedido". Si aparece como Rechazado, corrige el Secreto de firma: si lo haces dentro de 48 horas, el pedido entra solo.
• "El producto no está vinculado": usa Traer productos de Shopify en Sincronización avanzada.
• Error de permisos al "Marcar como preparada": falta un permiso en la app. Agrégalo en el Dev Dashboard, vuelve a aceptar los permisos en la tienda y presiona Guardar en la pestaña Conexión.
• "Sincronización apagada": activa Sincronización con Shopify: Sí en la pestaña Conexión.

¿Necesitas ayuda? Escríbenos desde el botón de soporte de tu panel y con gusto te acompañamos en la configuración.