Cómo funciona Shopify en Beply

Shopify, Beply y el ERP de tu empresa guardan datos distintos y los mueven en direcciones distintas. Esta guía explica qué información viaja de cada lado, en qué momento y quién decide cada paso. Úsala antes de configurar nada: la mayoría de dudas surgen de confundir “leer de Shopify”, “crear en Beply” y “escribir en Shopify”.

Esta guía describe la versión 10.7 del módulo. Cuando una función se añadió en una versión posterior a la 10.3, aparece indicada.

Las tres direcciones de los datos

Esta separación es la regla más importante del módulo. Descargar un pedido no crea el pedido de Beply. Crear el pedido de Beply no emite la factura. Emitir la factura no la publica en Shopify. Cada paso tiene su propio control.

Las piezas

• La tienda Shopify. Es la fuente de las ventas, de los productos de origen y de los envíos que se han realizado. Beply nunca es la fuente de esos datos.
• La cuenta de Shopify en Beply. Guarda la tienda, las credenciales de la app, las opciones de cada función y los permisos de quién puede usarlas. Una tienda puede tener una cuenta; cada cuenta tiene sus propias opciones.
• La copia local del pedido de Shopify. Es un espejo: refleja lo que Shopify dijo en el momento de la descarga. Si el pedido cambia en Shopify, el espejo se actualiza en una nueva descarga, manual o mediante la automatización de pedidos si está activada y el pedido entra en su rango. No es una actualización instantánea.
• El pedido de Beply. Es el documento comercial del ERP. Se crea a partir de la copia local cuando la conversión está habilitada y el pedido cumple sus condiciones.
• El catálogo por lotes. Es el proceso que lee productos y variantes de Shopify, los prepara en una selección y los incorpora al ERP solo cuando confirmas. Se explica en catálogo y lotes.
• Las facturas y el PDF. La factura local se crea en Beply. Su PDF se publica por una cola automática, con controles y reintentos. Desde la versión 10.7, Subir factura a Shopify también permite solicitar su publicación desde la lista o la ficha: pone el documento en esa misma cola y muestra el resultado. La petición no envía el PDF directamente; el estado pasa a synced cuando Shopify confirma la publicación. Ver impuestos y facturación.
• El seguimiento y las expediciones. Beply puede leer el seguimiento que ya figura en Shopify y, si lo activas, enviar un seguimiento a Shopify. Ver seguimiento.
• Las devoluciones y los abonos. Beply observa devoluciones, reembolsos y cancelaciones de la tienda. Puede registrar esa evidencia y, en su modo automático, crear una rectificativa local. Ver devoluciones.

El recorrido de un pedido

1. Descarga. Beply pide a Shopify los pedidos de un intervalo, o los nuevos según la automatización. Guarda una copia local con su estado, sus líneas, sus importes y su desglose fiscal. Si Shopify no responde, la descarga se reintenta o queda pendiente; no se inventa un pedido.
2. Comprobación. Antes de convertir, Beply revisa el estado de pago, la identidad del canal, la dirección y los datos fiscales. Si algo no encaja, el pedido no se convierte. Desde la versión 10.7, abre Histórico en la ficha del pedido y comprueba su cuenta para consultar los motivos previstos de no conversión. No todos los errores dejan un motivo visible.
3. Conversión. Si la conversión está habilitada y el pedido cumple las condiciones, se crea el pedido de Beply. Si no, la copia local permanece para que la revises. Los pedidos que llegan desde otro canal conservan su origen comercial (ver más abajo).
4. Factura local (opcional). Solo si activaste la generación automática y el pedido cumple su corte, su estado de envío y sus datos fiscales.
5. Publicación del PDF (opcional). Una cola automática cada 5 minutos envía las facturas pendientes, si la cuenta tiene la subida de facturas activada y la escritura está en Escritura habilitada. Puede quedar en cuarentena ante un resultado incierto; en ese caso no se repite sola.
6. Seguimiento (opcional). Puedes comunicar el envío a Shopify con su número de seguimiento. Un número guardado en Beply no prueba que Shopify lo haya recibido: contrástalo en Shopify.

El recorrido de un producto

1. Lectura del catálogo. Shopify entrega productos, variantes, SKU, precios de origen, imágenes y, si tu permiso lo permite, inventario y coste. Lo que no se pueda leer aparece como no accesible, no como cero.
2. Preparación. Eliges una selección, opciones de referencia, precio, impuesto, coste y recursos. El lote fija esas decisiones y muestra los efectos antes de confirmar.
3. Incorporación al ERP. Al confirmar, Beply crea o actualiza productos y variantes. Los cambios manuales que ya existían en el ERP se conservan como conflicto; no se sobrescriben en silencio.
4. Sincronización automática (opcional, desde la versión 10.5). Se configura en la pantalla Catálogo Shopify, tarjeta «Sincronización Shopify → ERP». Repite la lectura y aplica solo altas y cambios sin conflicto. No borra ni desactiva productos y no escribe en Shopify.

Stock, precios e inventario

• Por defecto, el catálogo no crea stock en el almacén de Beply. La disponibilidad de Shopify se muestra como información externa.
• Desde la versión 10.4, puedes elegir que el stock del ERP tome la disponibilidad de Shopify en las ubicaciones que asignes a almacenes. Es una decisión de la cuenta o del lote.
• Subir stock a Shopify es una operación distinta y de escritura. No puede combinarse con importar el stock de Shopify en la misma cuenta.
• Precio: el ERP guarda el precio sin IVA. Si Shopify muestra precios con IVA, Beply lo convierte en base neta solo cuando el modo elegido y el impuesto del producto lo permiten. Beply no aplica márgenes durante la importación.

Más detalle en stock y precios.

Pedidos de otros canales que pasan por Shopify

Una tienda Shopify puede recibir pedidos que nacieron en otro canal. Beply reconoce ese origen cuando la tienda lo informa en el pedido: una marca de origen (por ejemplo, la propiedad «Source_provider» o la etiqueta «Order placed from») o el nombre del canal. Los canales reconocidos en el código son Temu, Miravia, Leroy Merlin, Maisons du Monde, Amazon, AliExpress, Carrefour, Pinkconnect y TikTok.

Lo que pasa después depende del origen:

• Temu es la excepción: un pedido de Temu que llega por Shopify puede convertirse en pedido de Beply. Exige una serie comercial propia, no «SHP».
• Los demás canales no se convierten desde la integración de Shopify. Quedan como espejo sin convertir (motivo SHOPIFY_HUB_MIRROR), para no contar dos veces la misma venta. La conversión la hace la integración de su marketplace de origen.
• Miravia tiene su propio reenvío; consulta las condiciones siguientes.

Reenvío de Miravia a Shopify

• Con Subir pedidos a Shopify y una Cuenta Shopify elegida y activa en Miravia, Beply puede reenviar el pedido. Shopify exige Crear pedidos en Shopify, perfil de permisos en blanco, permiso de escritura de pedidos y modo global en Escritura habilitada. Con Recibir tracking de Shopify, el seguimiento vuelve a Beply.
• El envío automático sale cuando Beply convierte el pedido automáticamente; «Convertir a pedido» no inicia ese envío. Desde Miravia 17.2, «Reenviar a Shopify» permite solicitarlo manualmente desde la ficha, tras corregir la causa, con permisos de modificación y reenvío activo. La acción no duplica pedidos ya vinculados ni otro reenvío pendiente. Si una creación anterior quedó incierta, compruébala en Shopify antes de repetir: la cola no confirma que haya llegado a Shopify.
• Comprueba la versión instalada. En Miravia 16.7 se enviaban líneas libres (título, cantidad, precio y SKU) y el email del comprador. Desde Miravia 16.9, cada línea debe enlazarse a una variante exacta de la tienda de destino, con una plataforma compatible; Beply la envía marcada como «requiere envío». Con una línea sin enlace, ambigua, de otra cuenta o una plataforma incompatible, no se envía ningún pedido. No se envía el email del comprador.
• Desde Miravia 17.0 puede incluirse el enlace de la etiqueta: exige activar esa opción, Solo guardar en el pedido, etiqueta guardada, pedido vinculado a Shopify y paquete pendiente de recogida.
• Desde Miravia 17.1 puede solicitarse automáticamente la preparación: opción activada, etiqueta publicada, paquete pendiente de recogida y permisos de Shopify para leer pedidos, ubicaciones y órdenes de preparación de terceros y escribir estas últimas. La Ubicación de Shopify del almacén debe coincidir con todas las órdenes de preparación abiertas. La solicitud no confirma que el almacén haya aceptado ni completado la preparación.

El pedido reenviado es un espejo: no se convierte ni se factura como venta de Shopify. Detalle en pedidos de Miravia y etiquetas y envíos de Miravia.

Esto depende de que la tienda envíe la marca de origen en el pedido. Si el pedido no la trae, Beply lo trata como venta de Shopify. Comprueba cómo llega tu caso antes de decidir el flujo.

Qué no ocurre sin tu acción

• No se publican facturas en Shopify sin la publicación explícita o la regla de la función.
• No se envía un seguimiento a Shopify sin la función de subida de tracking activada.
• No se borran productos ni pedidos en Beply por la sincronización del catálogo.
• No se modifican precios de Shopify desde Beply en el flujo actual.
• Beply crea pedidos en Shopify solo con el perfil de permisos en blanco, la opción Crear pedidos en Shopify, el permiso de escritura de pedidos y el modo global en Escritura habilitada. Los perfiles explícitos no lo permiten.
• No se envía la factura por correo al cliente desde Shopify al publicar el PDF: la publicación no usa esa acción.

La lista completa está en qué se puede y qué no se puede hacer con Shopify.

Lecturas siguientes

• Primeros pasos para conectar la tienda y comprobar una función.
• Qué se puede y qué no se puede hacer para decidir si tu caso encaja.
• Preguntas frecuentes y resolución de problemas cuando algo no coincide con lo que esperabas.
• Glosario para los términos del módulo.