Instala la app de PHP Point Of Sale desde la Shopify App Store, ingresa la URL de tu POS, activa la facturación (14 días de prueba gratis y luego un cobro mensual vía Shopify) y elige las opciones de sincronización en el asistente guiado. Este artículo cubre los escenarios de arranque, el mapeo campo por campo en ambas direcciones, cada ajuste por defecto, los intervalos de sincronización y la cancelación.

La app de PHP Point Of Sale para Shopify conecta tu tienda Shopify y tu caja para que el inventario, los artículos y las ventas queden centralizados en un solo lugar. Funciona en ambos sentidos: un cliente del POS puede expandirse a un sitio de ecommerce, y una tienda Shopify existente puede sumar una caja física, sin mantener dos catálogos. Una venta en el mostrador actualiza la cantidad en Shopify; un pedido de Shopify entra al POS como una venta.

Del lado del POS todo vive en Configuración (busca ecommerce), y cambiarlo requiere el permiso del módulo Configuración (permisos y plantillas). El motor general de sincronización — orden de operaciones, sincronización manual, registros, conflictos — se cubre en cómo funciona la sincronización de ecommerce; este artículo cubre todo lo específico de Shopify.

Antes de instalar

Necesitas una tienda Shopify y una tienda de PHP Point Of Sale, con credenciales de acceso a ambas. Una regla evita casi todos los problemas: si estás creando una tienda nueva en cualquiera de los dos lados, no le agregues productos ni artículos antes de instalar la app. Qué opciones de sincronización marcar depende por completo de qué lado ya tiene datos — mira los escenarios de abajo y léelos antes de tu primera sincronización. Elegir mal la dirección en la primera corrida puede crear duplicados.

Instala la app

1. En tu admin de Shopify, abre Apps en el menú izquierdo y entra a la App Store.
2. Busca php point of sale, abre la ficha de la app PHP Point of Sale y haz clic en Agregar app. (También puedes ir directo a apps.shopify.com/php-point-of-sale.)
3. Shopify muestra una página de confirmación con los permisos que tendrá la app (productos, clientes, pedidos, inventario, ubicaciones, archivos y publicaciones, lectura y escritura). Baja y haz clic en Instalar app.
4. Se te pide tu URL del POS — ingrésala y haz clic en Enviar. En una tienda en la nube es https://tunombretienda.phppointofsale.com.
5. Shopify se conecta a tu POS y te devuelve ahí, donde un asistente de cuatro pasos termina la configuración: Instalar la aplicación Shopify → Conectar facturación → Elegir opciones de sincronización → Sincronizar.
6. En el paso de facturación, haz clic en Activar la facturación: prueba de 14 días y luego $[precio] por mes. Shopify muestra el precio mensual y la fecha exacta en que termina la prueba gratis antes de que apruebes nada; el cobro llega por tu cuenta de Shopify. Haz clic para iniciar la prueba gratis.
7. Llegas al paso de opciones de sincronización. Elige las operaciones para tu situación (siguiente sección), haz clic en Guardar, luego Siguiente, luego Sincronizar. El POS avisa que la sincronización corre en segundo plano y que los ajustes pueden cambiarse después en Configuración.

Después, la sección Configuración de Shopify en Configuración muestra Estás conectado a Shopify [tutienda.myshopify.com], junto con los controles Volver a conectarse a Shopify, Desconectarse de Shopify y Cancelar facturación de Shopify.

Elige las opciones de sincronización según tu situación

El asistente (y luego Operaciones de sincronización de comercio electrónico en Configuración) ofrece cinco operaciones para Shopify: Sincronizar cambios de inventario, Importar artículos a PHP POS, Importar pedidos en PHP POS, Exportar categorías a comercio electrónico y Exportar artículos a comercio electrónico. Cuáles habilitar depende del estado de tus dos tiendas. Toma en cuenta que la importación y la exportación de artículos no pueden estar activas a la vez — cada escenario elige una dirección.

POS nuevo y tienda Shopify nueva (ambos vacíos). Crearás los artículos en el POS y los enviarás a Shopify. Desmarca Importar artículos a PHP POS e Importar pedidos en PHP POS, dejando marcadas: Sincronizar cambios de inventario, Exportar categorías a comercio electrónico, Exportar artículos a comercio electrónico. Crea todos los artículos futuros en el POS (ver crear artículos).

Shopify establecida, POS nuevo. El objetivo es jalar el catálogo de Shopify al POS vacío para no recapturarlo. Desmarca Exportar categorías y Exportar artículos, dejando marcadas: Sincronizar cambios de inventario, Importar artículos a PHP POS, Importar pedidos en PHP POS.

POS establecido, tienda Shopify nueva. Poblarás la tienda Shopify vacía desde el POS. Desmarca Importar artículos e Importar pedidos, dejando marcadas: Sincronizar cambios de inventario, Exportar categorías a comercio electrónico, Exportar artículos a comercio electrónico.

Shopify establecida y POS establecido. Combinar dos tiendas que ya tienen datos está muy desaconsejado — evítalo si es posible. Si es inevitable, prepárate primero:

• Encuentra cada producto que exista en ambos lados y asegúrate de que el SKU de Shopify coincida con el UPC/EAN/ISBN o el Product ID del artículo del POS (según tu ajuste Campo SKU para sincronizar). Cuando el SKU coincide, los datos de Shopify sobrescriben el artículo del POS; cuando no, se crea un artículo duplicado en el POS.
• Conoce tus cantidades: el inventario de Shopify sobrescribe el conteo del POS — los números no se suman.
• Luego sincroniza con las operaciones de exportación desmarcadas, dejando: Sincronizar cambios de inventario, Importar artículos a PHP POS, Importar pedidos en PHP POS. Los productos duplicados se fusionan con los artículos coincidentes del POS y los productos exclusivos de Shopify se agregan.

Ajustes recomendados después de la instalación

Tras la importación o exportación inicial, cambia las operaciones para que en el día a día trabajes solo en el POS y los cambios fluyan hacia Shopify:

1. Ve a Configuración y busca ecommerce.
2. En Operaciones de sincronización de comercio electrónico, desmarca Importar artículos a PHP POS y deja marcadas: Sincronizar cambios de inventario, Importar pedidos en PHP POS, Exportar categorías a comercio electrónico, Exportar artículos a comercio electrónico.
3. Haz clic en Guardar.

Importar pedidos en PHP POS es opcional: márcalo si quieres los pedidos de Shopify en tus informes de ventas (en la primera importación Shopify solo entrega aproximadamente los últimos 60 días de historial; de ahí en adelante se captura todo). Déjalo sin marcar para mantener separados los reportes de Shopify y del POS.

Desde aquí, crea los productos nuevos en el POS. Para que un artículo no aparezca en el sitio, desmarca Artículo es de comercio electrónico en su formulario. Eliminar un artículo en el POS elimina también el producto en Shopify (recuperarlo lo restaura).

Qué se sincroniza de Shopify al POS

No todo campo de Shopify tiene un lugar en el POS. Aquí es donde aterriza cada campo mapeado en el artículo del POS:

Los productos en estado Borrador en Shopify también se importan y quedan como artículos normales del POS. Cuando hay un Nivel de precio en línea seleccionado, el precio de Shopify no se copia al precio de venta del artículo.

Los campos de Shopify que no se mapean al POS se siguen administrando en Shopify: la opción de cobrar impuestos, la de rastrear cantidad, los desgloses de inventario disponible/entrante, las opciones de envío y de producto físico, la información aduanal (área de origen, código HS), el estado del producto, los canales de venta y apps, la disponibilidad programada, la organización y las colecciones. Si eso necesita cambios, cámbialo en Shopify; todo lo demás se edita en el POS después de la sincronización inicial.

Qué se sincroniza del POS a Shopify

Todo artículo exportado a Shopify se crea Activo, y lo que no esté marcado como servicio en el POS se vuelve producto físico. Los demás campos del POS no se transfieren: las categorías secundarias no van a ningún lado en Shopify, las opciones de series/paquetes de los servicios no se trasladan (descríbelas en la descripción del producto) y los datos de envío como país de origen o códigos de armonización deben capturarse en Shopify.

Referencia de ajustes

Estos ajustes de Configuración moldean la sincronización con Shopify (los compartidos se describen a fondo en cómo funciona la sincronización de ecommerce):

• Seleccionar plataforma — debe estar en Shopify (la instalación lo define por ti). Si la pestaña Configuración de Shopify muestra No estás conectado a Shopify. Puedes conectarte a Shopify en App Store, la app no se instaló correctamente; repite la instalación desde la Shopify App Store.
• NO cargar imágenes a E-Commerce — desactivado por defecto. Evita que las imágenes de artículos del POS se envíen como medios del producto en Shopify para todo lo creado o modificado en adelante; las ya subidas se quitan en Shopify a mano.
• Solo sincronizar pedidos de comercio electrónico completados — desactivado por defecto. Solo los pedidos cerrados en Shopify entran a los reportes del POS.
• Importar pedidos de comercio electrónico como suspendidos — desactivado por defecto; importa cada pedido de Shopify como venta suspendida para revisarla en caja.
• Artículos nuevos son de comercio electrónico por defecto — activado por defecto: cada artículo creado en el POS se sincroniza a Shopify salvo que desmarques Artículo es de comercio electrónico en el artículo.
• Localización de la tienda — la tienda donde se registran los pedidos importados de Shopify y donde se aplican las cantidades y correcciones de inventario importadas. La cantidad publicada en Shopify es el total de existencias de las tiendas marcadas en Sincronizar inventario desde la tienda en cómo funciona la sincronización (tu primera tienda si no marcas ninguna).
• Nivel de precio en línea — para vender en línea a un precio distinto del de mostrador, crea un nivel de precios (Configuración → busca tier/nivel → Agregar nivel, nómbralo p. ej. "Shopify Online", Guardar), vuelve a los ajustes de ecommerce, refresca y selecciónalo aquí. El precio del nivel que captures en la pestaña Precios de cada artículo es el que se muestra en Shopify.
• Tamaño de paso de Shopify para productos no enteros — por defecto 1. Shopify cuenta el inventario en números enteros, así que los artículos vendidos por cantidad fraccionaria (peso, longitud) usan este paso para traducir entre las cantidades decimales del POS y los conteos enteros de Shopify.
• El precio general fija el precio de las variantes si no está definido (para Shopify) — desactivado por defecto. Cuando una variación no tiene precio propio, el precio general del artículo lo suple para que la variante liste bien.
• Política de inventario de Shopify — se define por artículo en su pestaña de Inventario: No se permite vender en línea sin existencias (el valor por defecto) o Se permite vender en línea aunque esté agotado.
• Las unidades de peso del formulario de artículo se limitan a las de Shopify — lb, oz, kg, g — mientras Shopify sea la plataforma.

Las categorías exportadas a Shopify se convierten allá en colecciones inteligentes (colecciones automatizadas).

Intervalos de sincronización y tiempo real

Tras la instalación guiada, la Sincronización en tiempo real queda activa y la sincronización programada desactivada — los webhooks de Shopify entregan los cambios de productos y pedidos conforme ocurren, y el POS empuja de inmediato los guardados de artículos y los cambios de existencias. Todo lo demás de la lista (exportación de categorías, exportación o importación masiva de artículos) corre cuando haces clic en Sincronizar en Configuración, o en la tarea programada si desactivas la Sincronización en tiempo real.

Los webhooks en tiempo real llevan los cambios individuales al instante: los eventos de producto crear, actualizar y eliminar de Shopify actualizan el artículo correspondiente del POS, y los eventos de pedido crear, actualizar y eliminar mantienen al día las ventas importadas (los eventos de edición de pedido no se aplican — el siguiente webhook de actualización o una sincronización manual recoge el cambio). Los webhooks entrantes se procesan como trabajos en segundo plano, así que un producto con muchas variantes no bloquea nada mientras se guarda. Eliminar un pedido en Shopify, o reembolsarlo por completo, marca la venta correspondiente del POS como eliminada; una cancelación que no reembolsa el pago deja la venta del POS en su lugar.

También puedes sincronizar a mano cuando quieras: Configuración → busca ecommerce → confirma las operaciones marcadas → baja hasta debajo de los Registros de sincronización de comercio electrónico → Sincronizar → Sí. Una barra muestra el avance; los registros listan cada corrida y al hacer clic en una fecha ves qué se sincronizó.

Cancelar o desconectar la app

Cancelar es un proceso de dos pasos, desde el POS:

1. Abre Configuración y busca shopify settings.
2. Haz clic en Cancelar facturación de Shopify y confirma en la ventana emergente. El cobro se detiene.
3. La pantalla ofrece entonces Activar facturación (para reanudar) o Desconectarse de Shopify — haz clic en desconectar para romper la conexión.
4. Por último, elimina la app PHP Point of Sale de la página de Apps de tu tienda Shopify para evitar confusiones.

Si más adelante reinstalas o reconectas, el POS te lleva directo al paso de activación de facturación. Restablecer comercio electrónico es aparte: desvincula todos los registros sincronizados sin eliminar nada en ningún lado — úsalo solo para apuntar el POS a otra tienda Shopify o cambiar a WooCommerce, y considera contactar a soporte primero.

Preguntas frecuentes

¿Cuánto cuesta la app de Shopify? Empieza con 14 días de prueba gratis; después hay un cobro mensual facturado por la Shopify App Store. El precio exacto y la fecha de fin de la prueba se muestran en el botón Activar facturación y en la página de confirmación antes de aprobar.

¿Dónde creo los productos nuevos una vez conectado — en Shopify o en el POS? En el POS. Los ajustes recomendados posteriores a la instalación empujan a Shopify los artículos y categorías nuevos automáticamente. Solo los campos exclusivos de Shopify (envíos/aduanas, colecciones, canales de venta) se editan en Shopify.

¿Por qué me quedaron artículos duplicados al sincronizar dos tiendas existentes? Un SKU de Shopify que coincide con un UPC/EAN/ISBN o Product ID del POS se fusiona con ese artículo (los datos de Shopify lo sobrescriben); un SKU sin coincidencia crea un artículo nuevo. Alinea los SKUs antes de sincronizar dos tiendas establecidas — y espera que el inventario de Shopify sobrescriba, no sume, los conteos del POS.

¿Se importan mis pedidos antiguos de Shopify? La primera importación trae aproximadamente los últimos 60 días de historial; a partir de ahí todos los pedidos se capturan conforme ocurren.

¿Por qué no cambia el precio en línea cuando edito el precio del nivel? Primero hay que seleccionar el Nivel de precio en línea en los ajustes de ecommerce. Solo entonces el precio del nivel en la pestaña Precios del artículo controla el precio en Shopify.

¿Puede Shopify seguir vendiendo un artículo que llegó a cero existencias? Por artículo, sí — pon la Política de inventario de Shopify en la pestaña de Inventario del artículo en "Se permite vender en línea aunque esté agotado". El valor por defecto detiene las ventas en cero.

¿Qué pasa en Shopify si elimino un artículo en el POS? El producto se elimina también de Shopify. Recuperar el artículo en el POS lo restaura.

Vendo por peso — ¿cómo funciona con el inventario entero de Shopify? Define el Tamaño de paso de Shopify para productos no enteros. El POS traduce sus cantidades decimales a unidades enteras de Shopify usando ese paso.