Conexión a la tienda

Solo escritorio y móvil

Esta pantalla solo se muestra en las aplicaciones de escritorio y móvil. Los usuarios web acceden al POS directamente en yourdomain.com/pos e inician sesión con sus credenciales de WordPress.

Descripción general de la pantalla de conexión

Al abrir la aplicación de escritorio o móvil de WCPOS, se muestra la pantalla de conexión. Aquí se gestionan las conexiones a la tienda y los inicios de sesión de los usuarios.

Agregar una nueva tienda

1. Introducir la URL de la tienda WooCommerce en el campo de texto (por ejemplo, https://mystore.com)
2. Hacer clic en Conectar
3. Se le redirigirá para iniciar sesión con sus credenciales de WordPress
4. Después de iniciar sesión correctamente, volverá a la aplicación

Múltiples tiendas

Es posible conectarse a tantas tiendas WooCommerce como sea necesario. Cada tienda aparece como una tarjeta independiente en la pantalla de conexión, mostrando:

• Nombre de la tienda y favicon
• URL de la tienda
• Usuarios conectados en esa tienda

Esto es útil para gestionar múltiples ubicaciones o negocios.

Múltiples usuarios por tienda

Cada tienda puede tener múltiples usuarios conectados simultáneamente. Esto es útil para:

• Cambios de turno - El nuevo cajero puede iniciar sesión antes de que el anterior cierre la suya
• Configuraciones con múltiples cajas - Diferentes cajeros en diferentes dispositivos
• Cambio rápido - Permite cambiar fácilmente entre cuentas de usuario

Agregar un usuario

Hacer clic en el botón junto a "Usuarios conectados" para agregar otro usuario a esa tienda.

Cambiar de usuario

Hacer clic en la insignia de un usuario (por ejemplo, "Brenda") para abrir el POS como ese usuario.

Eliminar un usuario

Hacer clic en la × de la insignia de un usuario para cerrar la sesión de ese usuario en la tienda.

Eliminar una tienda

Hacer clic en el botón rojo × de la tarjeta de la tienda para eliminarla de la lista. Esto cierra la sesión de todos los usuarios y elimina la conexión de la tienda en la aplicación.

Tienda de demostración

En la parte inferior de la pantalla, es posible que aparezca un enlace "Entrar a la tienda de demostración". Este enlace conecta con una tienda WooCommerce de demostración para probar las funciones de WCPOS sin afectar los datos de la tienda propia.

Solución de problemas

Lo primero que se debe verificar: X-Frame-Options

Las aplicaciones de escritorio y móviles utilizan iframes para el inicio de sesión, los pagos y los recibos. Cualquier encabezado de servidor o plugin que envíe X-Frame-Options: DENY o SAMEORIGIN impedirá el inicio de sesión. Esta es la causa más común de fallos de inicio de sesión en la aplicación — se deben verificar los encabezados de respuesta de la página de inicio de sesión (herramientas de desarrollo del navegador, o curl -I https://yourstore.com/wp-login.php) antes que cualquier otra cosa.

¿No es posible conectarse a la tienda?

• Asegurarse de que el plugin WCPOS esté instalado y activado en el sitio WordPress
• Verificar que se esté utilizando la URL correcta (incluir https:// — la API REST de WooCommerce requiere SSL)
• Intentar abrir yourdomain.com/pos en un navegador web primero para confirmar que el plugin funciona
• Verificar que la API REST de WooCommerce sea accesible
• Comprobar que la cuenta de usuario tenga permisos de acceso a POS

El inicio de sesión falla en la aplicación de escritorio o móvil

La mayoría de los fallos de inicio de sesión en la aplicación son causados por un plugin de seguridad o caché que bloquea el iframe de inicio de sesión:

• Los encabezados X-Frame-Options (establecidos por un plugin de seguridad o el servidor) bloquean el iframe de inicio de sesión — consulte la nota anterior. Desactive temporalmente el plugin de seguridad, inicie sesión y vuelva a activarlo (la sesión dura aproximadamente una semana).
• Plugins de seguridad — Wordfence, Really Simple Security, WPS Hide Login, iThemes/Solid Security y Defender Pro son los más habituales. Consulte la lista completa y las soluciones en Conflictos de plugins.
• Wordfence 2FA — el campo del código 2FA no se muestra en el iframe de inicio de sesión. Por ahora, desactive la 2FA para los usuarios de POS.
• URL de inicio de sesión personalizada (p. ej., WPS Hide Login) — la aplicación no puede encontrar la página de inicio de sesión. Utilice la URL estándar /wp-admin/.
• Los plugins de caché pueden seguir mostrando el formulario de inicio de sesión bloqueado incluso después de desactivar el plugin problemático — limpie la caché, o limpie la caché de la aplicación / reinstale la aplicación de escritorio.

"La API REST requiere autenticación" o un error de plugin de seguridad en la pantalla de conexión

Un plugin (p. ej., Force Login o un plugin de autenticación JWT) está exigiendo autenticación para todas las solicitudes a la API REST, por lo que la aplicación no puede leer la información pública del sitio. Ahora la aplicación muestra el mensaje real del servidor (p. ej., "Solo los usuarios autenticados pueden acceder a la API REST") en lugar de informar erróneamente sobre el tipo de sitio.

Solución: configure el plugin de seguridad para permitir el acceso sin autenticación a /wp-json/wcpos/ y /wp-json/wc/v3/, o desactívelo el tiempo necesario para completar la primera conexión.

"No parece ser un sitio WordPress" (aplicación de escritorio)

La aplicación de escritorio descubre la API REST a través del encabezado HTTP Link. Si un plugin (habitualmente Image Prioritizer u otros plugins de rendimiento) satura o trunca ese encabezado, el descubrimiento falla. Solución: desactive los plugins de optimización de imágenes o de modificación de encabezados y vuelva a intentarlo.

La aplicación indica que necesita una actualización / se bloquea después de una actualización

Verifique si hay una incompatibilidad de versiones entre la aplicación y el plugin del servidor — la tienda de aplicaciones puede haber publicado una actualización de la aplicación mientras el plugin WCPOS aún necesita actualizarse (o viceversa). Asegúrese de que la aplicación y el plugin WCPOS estén en la misma versión principal. Las aplicaciones WCPOS v1.9.0+ requieren que el plugin WCPOS sea v1.8.0 o superior.

Error "Cannot create fast store database"

Se trata de una condición de carrera en el primer inicio de sesión. Cerrar la aplicación completamente e intentar de nuevo — generalmente funciona en el segundo intento.

La pantalla de selección de usuario no avanza (aplicación de escritorio)

Después de iniciar sesión se muestra el nombre de usuario pero no hay una forma evidente de continuar. Hacer clic en el nombre de usuario para acceder al POS — el propio nombre es el botón.

¿La conexión sigue fallando?

• Intentar acceder a yourdomain.com/pos en un navegador web primero para verificar que el plugin está funcionando
• Revisar los registros de errores del sitio en busca de posibles problemas
• Confirmar que el proveedor de hosting no está bloqueando la REST API — consultar Notas específicas de hosting
• Asegurarse de que el servidor cumple con los requisitos mínimos