Elige WooCommerce en Configuración → Plataforma de comercio electrónico, ingresa la URL de tu tienda y aprueba la conexión en tu admin de WordPress — las claves de API se copian solas y los webhooks en tiempo real se activan. Luego define el campo SKU, la tienda de sincronización, el nivel de precios y las opciones de importación de pedidos, y corre tu primera sincronización.

Si vendes en línea con WooCommerce, conectarlo con PHP Point Of Sale le da a tu caja y a tu tienda web un solo catálogo y un solo conteo de existencias. Vendes una camisa en el mostrador y la cantidad del sitio baja; un pedido web entra al POS como una venta lista para surtir. WooCommerce es la integración de ecommerce más completa del POS — puede sincronizar artículos, categorías, etiquetas, atributos, clases de impuestos, clases de envío, pedidos y existencias en ambas direcciones.

Toda la conexión vive en Configuración: ábrela en el menú izquierdo, busca ecommerce y trabaja en las secciones Plataforma de comercio electrónico y Ajustes de WooCommerce. Necesitas el permiso del módulo Configuración (ver permisos y plantillas). Antes de empezar, lee cómo funciona la sincronización de ecommerce — el orden de operaciones, las reglas de vínculos y los registros descritos ahí aplican a todo lo de abajo.

Antes de conectar

• Necesitas un sitio WordPress funcionando con el plugin de WooCommerce instalado. Mantén ambos actualizados — importa para la seguridad y para la API con la que habla el POS.
• En Ajustes de WooCommerce, el menú Versión WooCommerce ofrece 3.0.0 o más reciente (el valor por defecto y el correcto para casi cualquier tienda) y 2.6.0 a 2.6.14 para tiendas heredadas.
• Sirve tu sitio WordPress por HTTPS — protege las claves de API y el tráfico de webhooks entre los dos sistemas. Los webhooks en tiempo real se registran contra la URL de tu PHP Point Of Sale, que siempre es HTTPS.

Conecta tu tienda

1. Ve a Configuración, busca ecommerce y, en Plataforma de comercio electrónico, pon Seleccionar plataforma en Woocommerce. Haz clic en Guardar — aparece la pestaña Ajustes de WooCommerce.
2. En Ajustes de WooCommerce, elige tu Versión WooCommerce e ingresa la dirección de tu tienda en URL de API de WooCommerce (por ejemplo https://tutienda.com).
3. Haz clic en Conéctese a WooCommerce. Se abre una ventana en tu propio admin de WordPress pidiéndote aprobar acceso de lectura/escritura a la API para el POS.
4. Aprueba la conexión. WooCommerce genera su Consumer Key y Consumer Secret y se los entrega al POS automáticamente — nunca copias claves a mano.

Al llegar las claves, el POS activa la Sincronización en tiempo real y registra webhooks en tu WooCommerce para producto creado, producto actualizado, producto eliminado, pedido creado, pedido actualizado y pedido eliminado, cada uno firmado con un secreto compartido. Desde ese momento, una compra en tu sitio crea la venta en el POS en instantes, y una edición de artículo en el POS se publica directo en el sitio.

Los campos Clave de API WooCommerce y Secreto de API de WooCommerce solo aparecen cuando Conéctese a WooCommerce ya entregó una clave; úsalos después para ver o reemplazar la clave guardada. No es posible escribir un Consumer Key hecho a mano en una conexión nueva.

Elige cómo se sincronizan y emparejan los artículos

Repasa estos ajustes antes de la primera sincronización, para que ambos sistemas acuerden qué significa "producto coincidente":

• Campo SKU para sincronizar — el POS compara el campo SKU de WooCommerce contra tu elección de UPC/EAN/ISBN (por defecto), Product ID o Item Id. En artículos con variaciones, el SKU de cada variación de WooCommerce se compara con el número de artículo de la variación.
• Sincronizar únicamente las cantidades de inventario con WooCommerce — desactivado por defecto. Al activarlo, el POS es la fuente de verdad del inventario: las cantidades se empujan del POS a WooCommerce, las importaciones y sincronizaciones nunca aplican existencias de Woo a las tiendas del POS, y la sincronización nunca crea, actualiza ni elimina productos de tu catálogo Woo. Exportar artículos a comercio electrónico aún vincula artículos por SKU y luego envía las cantidades actuales del POS. Úsalo cuando tu catálogo web se administra por completo en WooCommerce y solo quieres cantidades correctas en línea.
• 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. Desmarca la casilla del artículo en lo que deba quedarse solo en tienda.
• NO cargar imágenes a E-Commerce — desactivado por defecto; márcalo para que las imágenes de artículos no lleguen a WooCommerce. Las ya subidas permanecen en línea hasta que las quites allá.
• 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.
• Habilitar HTML para descripciones — desactivado por defecto; conserva el formato de las descripciones de producto en lugar de quitar el HTML.
• NO tratar los artículos de servicio como productos virtuales en WooCommerce — desactivado por defecto. Normalmente un artículo de servicio se vuelve producto virtual en WooCommerce; márcalo para exportar los servicios como productos normales.
• Localización de la tienda — la tienda donde se registran los pedidos de WooCommerce en el POS y donde se aplican las cantidades importadas. La cantidad que se muestra en el sitio es la suma de las existencias de las tiendas marcadas en Sincronizar inventario desde ubicación (tu primera tienda si ninguna está marcada).
• Nivel de precio en línea — vende en línea al precio de un nivel de precios en lugar del precio de venta normal. El menú aparece cuando existe al menos un nivel.
• Clase de envío de comercio electrónico — tras importar las clases de envío, el formulario de cada artículo ofrece un menú para asignar la clase de envío correcta de WooCommerce por producto.

Elige cómo se importan los pedidos

Los pedidos web entran al POS como ventas marcadas como ventas en línea, así que puedes aislarlas en los informes con el filtro Fuente de venta → Ventas en línea; los pedidos importados como ventas suspendidas además llevan el tipo de venta Comercio electrónico en la lista de ventas suspendidas. Tres ajustes moldean ese flujo:

• Solo sincronizar pedidos de comercio electrónico completados — desactivado por defecto. Al activarlo, un pedido se importa solo cuando WooCommerce lo marca completed; la fecha de la venta es la fecha de completado.
• Importar pedidos de comercio electrónico como suspendidos — desactivado por defecto. Cada pedido entra como venta suspendida para que una persona lo revise y complete en caja. Tras la primera importación, las sincronizaciones posteriores no sobrescriben la venta suspendida, así que las ediciones en caja están a salvo.
• Importar TODAS las órdenes pasadas para WooCommerce — desactivado por defecto, y se apaga solo después de un uso. Márcalo una vez, corre una sincronización, y se importa todo tu historial de pedidos de WooCommerce. Las demás sincronizaciones solo miran ocho días hacia atrás desde la última sincronización (un traslape deliberado para no perder pedidos que tardan en completarse — importar dos veces el mismo pedido es inofensivo, solo actualiza la venta existente).

Dos comportamientos más ocurren solos: los pedidos aún abiertos se revisan en cada sincronización hasta que se completan, y los pedidos cancelados en WooCommerce durante el último mes marcan la venta correspondiente del POS como eliminada para que tus informes coincidan con la tienda web. Los pedidos reembolsados no se eliminan — la venta conserva su estado de reembolsado y las existencias no se reponen, así que registra una devolución en el POS si quieres que tus totales reflejen el reembolso.

Qué cubre la sincronización completa

La lista de WooCommerce en Operaciones de sincronización de comercio electrónico puede ejecutar todo esto, en este orden: sincronizar cambios de inventario; importar etiquetas, categorías, atributos, clases de impuestos, clases de envío, artículos y pedidos al POS; exportar etiquetas, categorías, atributos, clases de impuestos y artículos a WooCommerce. Todas vienen habilitadas por defecto; desmarca lo que no quieras. No puedes habilitar a la vez Importar artículos a PHP POS y Exportar artículos a comercio electrónico — elige qué sistema es dueño del catálogo. Ver cómo funciona la sincronización de ecommerce para el detalle de cada operación, el botón Sincronizar, la barra de progreso y los registros.

Tiempo real y sincronización programada

Con la Sincronización en tiempo real activa (se habilita sola al conectar), los webhooks de WooCommerce empujan cambios de productos y pedidos al POS conforme ocurren, y el POS devuelve por la misma vía los guardados de artículos y los ajustes de existencias. Mientras el tiempo real está activo, la sincronización programada no corre — todo lo demás de la lista (etiquetas, categorías, atributos, clases de impuestos y de envío, la revisión de pedidos de los últimos ocho días, las exportaciones masivas) solo se ejecuta cuando haces clic en Sincronizar en Configuración, y esa corrida manual se salta la operación de inventario porque esos cambios ya fluyeron. Desactiva la Sincronización en tiempo real si prefieres la sincronización completa programada en lugar de los webhooks. La primera sincronización de un catálogo grande puede tardar mucho; corre en segundo plano y puedes vigilar la barra de Progreso de sincronización en Configuración.

Preguntas frecuentes

¿Tengo que copiar claves de API desde WooCommerce? No. Conéctese a WooCommerce te lleva a tu propio admin de WordPress a aprobar el acceso, y el Consumer Key y el Secret se entregan solos. Los campos Clave de API WooCommerce / Secreto de API de WooCommerce aparecen después para que puedas ver o reemplazar la clave guardada.

¿Por qué la sincronización duplicó mis productos? El SKU de WooCommerce no coincidió con el campo del POS elegido en Campo SKU para sincronizar (UPC/EAN/ISBN por defecto), así que la importación los trató como productos nuevos. Alinea los SKUs, elimina los duplicados y sincroniza de nuevo.

¿Puedo seguir administrando mi catálogo en WooCommerce y sincronizar solo existencias? Sí — activa Sincronizar únicamente las cantidades de inventario con WooCommerce. El POS entonces empuja solo cantidades y nunca toca tus datos de producto en Woo.

¿Por qué un artículo nuevo no aparece en mi sitio? Verifica que Artículo es de comercio electrónico esté marcado en el artículo, que Exportar artículos a comercio electrónico esté habilitado en las operaciones, y lee el Registro de sincronización de comercio electrónico en el formulario del artículo — registra los últimos cinco intentos con el error exacto.

¿Por qué un pedido no apareció en el POS? Si Solo sincronizar pedidos de comercio electrónico completados está activo, el pedido debe marcarse primero como completado en WooCommerce. Confirma también que Importar pedidos en PHP POS esté marcado en las operaciones y que los webhooks se hayan registrado al conectar. Con la Sincronización en tiempo real activa no hay sincronización programada — los pedidos llegan por webhook o cuando haces clic en Sincronizar.

¿Cómo traigo los pedidos antiguos de antes de conectar? Marca Importar TODAS las órdenes pasadas para WooCommerce, guarda y corre una sincronización. Importa el historial completo una vez y luego se apaga solo.

¿Por qué el pedido web de un cliente aparece como venta suspendida? Importar pedidos de comercio electrónico como suspendidos está activo. Ese es el flujo de revisión: el pedido espera en la lista de ventas suspendidas bajo el tipo Comercio electrónico hasta que alguien lo completa en caja.

¿Qué pasa si reembolso o cancelo un pedido en WooCommerce? Cancelar marca la venta correspondiente del POS como eliminada: de inmediato mediante el webhook mientras la sincronización en tiempo real está activa y, si no, en la siguiente sincronización siempre que el pedido se haya cancelado en el último mes, que es hasta donde llega la revisión. Reembolsar no elimina la venta — registra una devolución en el POS si tus totales deben reflejarlo.