Cada sincronización ejecuta las operaciones que habilites en un orden fijo: primero los cambios de inventario, luego las importaciones al POS y después las exportaciones a tu plataforma. Este artículo explica cada operación, el tiempo real frente a lo programado, cómo se vinculan los artículos por SKU y cómo leer los registros cuando los dos sistemas no coinciden.

Ya sea que conectes WooCommerce o Shopify, el motor de sincronización por debajo es el mismo. Es una lista de operaciones que corre en un orden fijo, en el modo que tú elijas, y que deja un registro de todo lo que hace. Entender ese modelo hace mucho más fácil predecir qué hará una sincronización — y arreglar las cosas cuando el POS y tu tienda web no coinciden.

Todos los ajustes descritos aquí viven en un solo lugar: abre Configuración en el menú izquierdo y escribe ecommerce en la barra de búsqueda. Cambiarlos requiere el permiso del módulo Configuración en tu cuenta de empleado (ver permisos y plantillas).

Elige una plataforma

En Plataforma de comercio electrónico, el menú Seleccionar plataforma ofrece Ninguna (el valor por defecto), Woocommerce y Shopify. Al elegir una plataforma aparece su pestaña de ajustes (Ajustes de WooCommerce o Configuración de Shopify) más los ajustes compartidos de ecommerce. Solo puede haber una plataforma conectada a la vez — para cambiar de plataforma primero hay que restablecer la integración (ver "Restablecer comercio electrónico" abajo).

La sincronización es una lista de operaciones

La lista Operaciones de sincronización de comercio electrónico controla qué hace realmente una sincronización. Cada operación marcada se ejecuta, y siempre en este orden fijo, de modo que los datos de apoyo (etiquetas, categorías, atributos) existan antes que los artículos que los usan:

1. Sincronizar cambios de inventario — los cambios de existencias van primero, para que las cantidades estén correctas antes de que ocurra cualquier otra cosa.
2. Importar etiquetas en PHP POS (solo WooCommerce)
3. Importar categorías a PHP POS (solo WooCommerce)
4. Importar atributos a PHP POS (solo WooCommerce)
5. Importar clases de impuestos a PHP POS (solo WooCommerce)
6. Importar clases de envío a PHP POS (solo WooCommerce)
7. Importar artículos a PHP POS — los productos web se vuelven artículos del POS (o actualizan el artículo vinculado).
8. Importar pedidos en PHP POS — los pedidos web se vuelven ventas del POS.
9. Exportar etiquetas a comercio electrónico (solo WooCommerce)
10. Exportar categorías a comercio electrónico
11. Exportar atributos a comercio electrónico (solo WooCommerce)
12. Exportar clases de impuestos a comercio electrónico (solo WooCommerce)
13. Exportar artículos a comercio electrónico — los artículos nuevos y modificados del POS se envían a la tienda web.

En una tienda nueva todas las operaciones vienen habilitadas. Shopify muestra solo las cinco que le aplican (sincronizar cambios de inventario, importar artículos, importar pedidos, exportar categorías, exportar artículos); WooCommerce muestra la lista completa. Dos reglas importantes:

• No puedes habilitar a la vez Importar artículos a PHP POS y Exportar artículos a comercio electrónico — el POS lo bloquea, porque cada lado sobrescribiría al otro. Decide qué sistema es el catálogo maestro y habilita solo esa dirección.
• Cuando la Sincronización en tiempo real está activa, la tarea programada no corre en absoluto, y una sincronización manual se salta Sincronizar cambios de inventario, porque el tiempo real ya empuja cada cambio de existencias en el momento en que ocurre.

Tiempo real frente a sincronización programada

Hay dos mecanismos de entrega:

• Sincronización en tiempo real (el interruptor Sincronización en tiempo real, que se activa automáticamente al completar la conexión guiada) — los webhooks de la plataforma empujan al POS cada evento de producto o pedido en el momento en que sucede, y el POS empuja a la plataforma cada ajuste de inventario y cada guardado de artículo. En Shopify, los eventos grandes, como un producto con muchas variantes, se procesan como trabajos en segundo plano para que nada se congele; los webhooks de WooCommerce se procesan conforme llegan.
• Sincronización programada — una tarea con horario que corre la lista completa de operaciones. Solo corre mientras la Sincronización en tiempo real está desactivada; una vez activo el tiempo real (la conexión guiada lo activa), la tarea programada termina sin hacer nada, y las importaciones y exportaciones que los webhooks no cubren — etiquetas, categorías, atributos, clases de impuestos y de envío, pedidos antiguos, exportaciones masivas de artículos — solo ocurren cuando haces clic en Sincronizar en Configuración.

También puedes correr la lista a mano en cualquier momento — ver "Ejecutar una sincronización manual" abajo.

Cómo se vinculan los artículos entre sistemas

La sincronización conecta un artículo del POS con un producto web guardando el ID del producto de la plataforma en el artículo (y los IDs de variación de la plataforma en cada variación). Los vínculos nuevos se crean emparejando SKUs:

• Campo SKU para sincronizar decide contra qué campo del POS se compara el SKU de la tienda web: UPC/EAN/ISBN (el valor por defecto), Product ID o Item Id. Elige el campo que tus SKUs en línea ya usan.
• En artículos con variaciones, el SKU de cada variación web se compara contra el número de artículo de la variación en el POS.

Cuando no se puede emparejar con seguridad, la sincronización lo reporta en el registro en lugar de adivinar:

• Conflicto — el mismo SKU coincide con más de un artículo o variación activos del POS. El registro nombra a los candidatos y ese producto se omite. Corrige el SKU duplicado y sincroniza de nuevo.
• Bloqueado — el SKU solo coincide con artículos eliminados u ocultos del POS. Recupera el artículo (la lista de artículos ofrece Recuperar, y existe la acción de recuperar el artículo del lado del ecommerce) o limpia el SKU obsoleto.

Referencia de ajustes compartidos

Estos ajustes aparecen bajo Plataforma de comercio electrónico para ambas plataformas:

• Seleccionar plataforma — Ninguna (por defecto), Woocommerce o Shopify.
• Sincronización en tiempo real — activa tras una conexión guiada; los webhooks mantienen ambos lados al día, y la sincronización programada queda desactivada mientras está activa.
• Campo SKU para sincronizar — UPC/EAN/ISBN (por defecto), Product ID o Item Id.
• NO cargar imágenes a E-Commerce — desactivado por defecto. Al marcarlo, las imágenes de los artículos se quedan en el POS y nunca se envían a la tienda web. Las imágenes ya subidas permanecen en línea y hay que quitarlas allá a mano.
• Usar la imagen principal como imagen predeterminada en el comercio electrónico — desactivado por defecto. Envía solo la imagen principal de cada artículo en lugar del juego completo.
• Solo sincronizar pedidos de comercio electrónico completados — desactivado por defecto. Al marcarlo, un pedido solo se importa cuando la plataforma lo marca como completado.
• Importar pedidos de comercio electrónico como suspendidos — desactivado por defecto. Importa cada pedido web como una venta suspendida bajo el tipo de venta Comercio electrónico, para que un empleado la revise y la complete en caja. Una vez creada la importación suspendida, las sincronizaciones posteriores no la sobrescriben, así que las ediciones en tienda están a salvo.
• Artículos nuevos son de comercio electrónico por defecto — activado por defecto. Cada artículo nuevo se crea con Artículo es de comercio electrónico marcado; desactívalo si prefieres incluir artículos uno por uno.
• Localización de la tienda — la tienda donde se registran los pedidos web importados y donde se aplican las existencias importadas y las correcciones de inventario.
• Sincronizar inventario desde ubicación [nombre] — una casilla por tienda. La cantidad que se muestra en línea es la suma de las existencias de todas las tiendas marcadas (la primera tienda si ninguna está marcada), y con el tiempo real activo un cambio de existencias en cualquier tienda marcada empuja la actualización a la plataforma.
• Nivel de precio en línea — aparece cuando existe al menos un nivel de precios. Vende en línea al precio del nivel en lugar del precio de venta normal del artículo.

Por artículo, la casilla Artículo es de comercio electrónico en el formulario del artículo decide si ese artículo se sincroniza — desmárcala para mantener un artículo solo en tienda.

Ejecutar una sincronización manual

1. Abre Configuración y busca ecommerce.
2. Marca las operaciones que quieras en Operaciones de sincronización de comercio electrónico y haz clic en Guardar si cambiaste algo.
3. Junto a Fecha última sincronización, haz clic en Sincronizar y confirma.
4. La barra de Progreso de sincronización muestra el porcentaje completado y la operación en curso. Mientras corre aparece un botón Cancelar; cancelar detiene la sincronización en el siguiente punto seguro.

Solo puede correr una sincronización a la vez — iniciar una segunda devuelve el mensaje de que ya hay una en ejecución. La primera sincronización completa de un catálogo grande puede tardar mucho; sigue corriendo en segundo plano aunque salgas de la página, y puedes revisar su estado en Configuración.

Leer los registros de sincronización

Dos registros cuentan qué hizo una sincronización:

• Los Registros de sincronización de comercio electrónico en Configuración listan un archivo de registro descargable por cada corrida reciente — haz clic en una fecha para abrirlo en una pestaña nueva. Los archivos se conservan 72 horas, así que descarga lo que quieras guardar.
• El Registro de sincronización de comercio electrónico de cada artículo, visible en su formulario de edición cuando Artículo es de comercio electrónico está marcado, lista los últimos cinco resultados de ese artículo con fecha, estado (exitoso/fallido) y mensajes — muy útil cuando un solo producto no deja de desajustarse.

Pedidos desde la web

Los pedidos importados se vuelven ventas en el POS marcadas como ventas en línea, así que puedes aislarlas en los informes de ventas con el filtro Fuente de venta → Ventas en línea; los pedidos importados como ventas suspendidas usan además el tipo de venta Comercio electrónico en la lista de ventas suspendidas. El ID y el estado del pedido en la plataforma se guardan en la venta. Los pedidos de WooCommerce cancelados se marcan como eliminados en el POS: mediante el webhook en el momento, o en una sincronización que revisa las cancelaciones del último mes (los reembolsados nunca se eliminan); los pedidos de Shopify se marcan como eliminados cuando se reembolsan por completo o se eliminan en Shopify, mientras que una cancelación que no reembolsa el pago deja la venta del POS en su lugar. Los pedidos web que aún no se completan se vuelven a revisar en cada sincronización hasta que lo hagan.

Restablecer comercio electrónico

El botón Restablecer comercio electrónico (al final de los ajustes de ecommerce) corta todos los vínculos entre los dos sistemas: limpia los IDs guardados de productos, variaciones, imágenes, categorías, etiquetas, atributos y clases de impuestos del lado del POS. No elimina productos, artículos ni existencias en ningún lado — los sistemas simplemente dejan de reconocer los registros del otro. Úsalo solo cuando vayas a cambiar a otra tienda web u otra plataforma y quieras empezar los vínculos desde cero. Si tienes dudas, contacta a soporte antes de restablecer.

Preguntas frecuentes

¿Por qué mi sincronización no cambió ninguna existencia? Si la Sincronización en tiempo real está activa, una sincronización manual se salta a propósito la operación de inventario (y la programada no corre) — los cambios ya se empujaron uno por uno al ocurrir. Revisa el Registro de sincronización de comercio electrónico del artículo para confirmar que los envíos individuales pasan.

¿Por qué se duplicaron artículos tras mi primera sincronización? Los SKUs no coincidieron, así que la importación creó artículos nuevos en lugar de vincular los existentes. Asegúrate de que el SKU de la tienda web coincida con el campo elegido en Campo SKU para sincronizar (UPC/EAN/ISBN por defecto), corrige los duplicados y sincroniza de nuevo.

¿Por qué un producto nunca se actualiza en línea? Abre el artículo y revisa dos cosas: que Artículo es de comercio electrónico esté marcado, y el Registro de sincronización de comercio electrónico del formulario, que muestra el error exacto de los últimos cinco intentos — un conflicto de SKU duplicado o un producto eliminado del otro lado suele aparecer nombrado ahí.

¿Pueden los artículos fluir en ambas direcciones a la vez? No. Importar artículos a PHP POS y Exportar artículos a comercio electrónico no pueden estar habilitados al mismo tiempo — un sistema debe ser dueño del catálogo. El inventario y los pedidos sí pueden fluir mientras cualquiera de los dos esté activo.

La sincronización dice que ya está corriendo. ¿Cómo la detengo? Espera a que termine, o haz clic en Cancelar junto a la barra de progreso. La cancelación surte efecto en el siguiente punto seguro de la corrida.

¿Restablecer comercio electrónico borra mis productos? No. Solo limpia los vínculos entre registros del POS y de la web. Ambos catálogos quedan exactamente igual; solo dejan de sincronizarse hasta que reconectes y vuelvas a vincular.

¿De qué tienda sale el inventario de mi sitio web? De la suma de existencias de las tiendas marcadas en Sincronizar inventario desde ubicación dentro de los ajustes de ecommerce (tu primera tienda si ninguna está marcada). Localización de la tienda solo decide dónde se registran los pedidos web importados y las cantidades importadas.