Códigos de error
Cuando WCPOS encuentra un problema, muestra un código de error que ayuda a identificarlo. A partir de v1.10.0, los códigos siguen el formato dominio + tres dígitos; por ejemplo, SYNC131 o AUTH311. El dominio indica el área del POS; el número identifica la condición concreta. Cada código tiene su propia página, que explica qué significa, qué hacer y qué consecuencias tiene para sus datos.
En el POS, los códigos de error aparecen en Estado de la tienda → Registros: expanda una fila y use el enlace Ayuda para acceder directamente a la página del código en esta documentación.
Dominios de error (v1.10.0+)
| Dominio | Área |
|---|---|
AUTH | Inicio de sesión, sesiones y tokens |
CHECKOUT | Finalización de pedidos en caja |
CLIENT | La propia aplicación POS y el almacenamiento local |
DISPLAY | La pantalla del cliente |
HOST | Alojamiento y reglas del cortafuegos que bloquean el POS |
LICENSE | Activación y validación de la licencia Pro |
PAYMENT | Pasarelas de pago y terminales |
PRINT | Impresión de recibos |
PRODUCT | Datos de productos y operaciones del catálogo |
REGISTER | Cajón de efectivo, sesiones de caja y arqueos |
SYNC | Sincronización entre el POS y su tienda |
Localice su código a continuación o utilice la búsqueda.
Los códigos terminados en 999 agrupan las condiciones del dominio que aún no tienen un código específico.
Todos los códigos
AUTH: Inicio de sesión, sesiones y tokens
| Código | Qué significa |
|---|---|
| AUTH101 | Su sesión ha finalizado y debe volver a iniciarla. |
| AUTH111 | La tienda no ha aceptado las credenciales de inicio de sesión. |
| AUTH121 | La cuenta con la que se ha iniciado sesión en la tienda no coincide con el cajero de este terminal. |
| AUTH131 | La sesión guardada de la tienda estaba incompleta, por lo que WCPOS ha vuelto a la lista de tiendas. |
| AUTH201 | Su cuenta no tiene permiso para realizar esta acción. |
| AUTH301 | Otro plugin de autenticación impide que WCPOS se conecte. |
| AUTH311 | WCPOS no puede acceder a su punto de conexión en la tienda. |
| AUTH321 | WooCommerce no está activo en este sitio, por lo que WCPOS no puede conectarse. |
| AUTH331 | El plugin WCPOS de esta tienda es demasiado antiguo para esta versión de la aplicación. |
| AUTH341 | Esta tienda comunica la misma identidad que una tienda ya guardada en este dispositivo. |
| AUTH401 | No se ha podido verificar la confianza de la conexión segura con esta tienda. |
| AUTH411 | Falta la dirección de la tienda o no es una URL válida. |
| AUTH421 | El servidor de la tienda bloquea el token de inicio de sesión en todos los canales que esta aplicación puede utilizar. |
| AUTH431 | La API REST de la tienda no ha respondido en ninguno de los formatos de dirección que esta aplicación puede utilizar. |
| AUTH441 | El token de inicio de sesión supera el tamaño que admite este servidor. |
| AUTH999 | Se ha producido un problema inesperado al iniciar o mantener la sesión. |
CHECKOUT: Finalización de pedidos en caja
| Código | Qué significa |
|---|---|
| CHECKOUT101 | El proceso de pago no ha finalizado y el carrito se conserva para volver a intentarlo con seguridad. |
| CHECKOUT111 | No se ha podido aplicar este cambio al carrito, que permanece sin cambios. |
| CHECKOUT201 | WCPOS no ha podido confirmar si se ha completado el proceso de pago. |
| CHECKOUT211 | La tienda no ha devuelto ningún resultado del proceso de pago, por lo que se desconoce el estado del pedido. |
| CHECKOUT301 | El proceso de pago no puede continuar porque el SKU de un producto está duplicado o no es válido. |
| CHECKOUT401 | El total de este pedido en la tienda difiere del que mostraba el terminal. El pedido se ha guardado con el total de la tienda. |
| CHECKOUT411 | Una línea de este pedido contiene datos de precios que el POS no ha podido leer, por lo que su importe se ha obtenido de los totales guardados. |
| CHECKOUT421 | Este pedido hace referencia a un tipo impositivo que su tienda ya no tiene, por lo que el impuesto puede ser incorrecto. |
| CHECKOUT999 | Se ha producido un problema inesperado durante el proceso de pago. |
CLIENT: La propia aplicación POS y el almacenamiento local
| Código | Qué significa |
|---|---|
| CLIENT101 | WCPOS no ha podido terminar de iniciarse. |
| CLIENT111 | La sincronización está tardando más de lo esperado en iniciarse. |
| CLIENT121 | Este navegador solo permite que una pestaña envíe cambios a la vez. |
| CLIENT131 | WCPOS ha puesto demasiadas solicitudes en cola a la vez y ha descartado algunas. |
| CLIENT141 | La búsqueda ha mostrado resultados que no coinciden con sus productos, por lo que WCPOS los ha ocultado. |
| CLIENT142 | El índice de búsqueda no ha respondido a tiempo, por lo que WCPOS ha buscado directamente en el catálogo. |
| CLIENT143 | La búsqueda ha omitido un producto que debería haber encontrado. |
| CLIENT144 | No se ha podido reconstruir un índice de búsqueda, por lo que los resultados pueden estar incompletos mientras la aplicación vuelve a intentar la inicialización. |
| CLIENT151 | Una parte de la pantalla no se ha podido cargar y se ha sustituido por un mensaje de error. |
| CLIENT161 | Esta pestaña del navegador no controla actualmente la caja, por lo que no ha enviado una nueva solicitud de pago. |
| CLIENT171 | El reloj de este dispositivo y el de su tienda difieren en más de un minuto. |
| CLIENT181 | WCPOS no ha podido cambiar a esa tienda. |
| CLIENT201 | Este dispositivo se ha quedado sin memoria y es posible que la última acción no haya finalizado. |
| CLIENT211 | WCPOS se ha detenido debido a un fallo del dispositivo. |
| CLIENT999 | WCPOS ha encontrado un error inesperado. |
DISPLAY: La pantalla del cliente
| Código | Qué significa |
|---|---|
| DISPLAY101 | La pantalla del cliente no ha podido generar la instantánea del carrito y muestra la pantalla de espera hasta el siguiente cambio. |
HOST: Alojamiento y reglas del cortafuegos que bloquean el POS
| Código | Qué significa |
|---|---|
| HOST101 | El servidor bloquea la comprobación de permisos del navegador (solicitud preliminar CORS), por lo que la aplicación web no puede acceder a él. |
| HOST111 | La configuración de acceso entre orígenes (CORS) del servidor es incorrecta, por lo que el navegador rechaza sus respuestas. |
| HOST121 | Una página de protección contra bots está respondiendo en lugar de la API de la tienda. |
| HOST131 | Un proxy situado delante de la tienda rechaza las respuestas del servidor porque contienen demasiadas cabeceras. |
| HOST141 | El filtro de seguridad del proveedor de alojamiento bloquea las búsquedas de productos. |
| HOST151 | La caché de su proveedor de alojamiento puede entregar a una persona los datos de la tienda correspondientes a otra. |
| HOST161 | El proveedor de alojamiento limita la frecuencia de las solicitudes de los terminales de esta tienda. |
LICENSE: Activación y validación de la licencia Pro
| Código | Qué significa |
|---|---|
| LICENSE101 | Su licencia de WCPOS Pro no está activa para esta tienda o dispositivo. |
| LICENSE201 | WCPOS Pro está desactivado porque su versión no coincide con la de WCPOS. |
| LICENSE301 | El actualizador no está autorizado para descargar actualizaciones de WCPOS Pro. |
| LICENSE999 | Se ha producido un problema inesperado al comprobar la licencia. |
PAYMENT: Pasarelas de pago y terminales
| Código | Qué significa |
|---|---|
| PAYMENT101 | El pago se ha realizado correctamente, pero WCPOS no ha podido actualizar su estado después. |
| PAYMENT111 | La tienda ha registrado este pago, pero el terminal no ha podido guardar su propia copia. |
| PAYMENT113 | La tienda ha enviado o cancelado la factura, pero este terminal no ha podido guardar su copia del pedido. |
| PAYMENT121 | Se ha realizado el cargo en la tarjeta, pero el pedido no ha finalizado. |
| PAYMENT201 | WCPOS no ha podido confirmar si el terminal ha cobrado el pago. |
| PAYMENT211 | El terminal no ha cobrado este pago. |
| PAYMENT212 | La pasarela de pago no ha aceptado este pago. |
| PAYMENT213 | La tienda ha rechazado registrar este pago. No se ha cobrado nada. |
| PAYMENT221 | No se ha podido anular un pago, por lo que ese dinero sigue retenido. |
| PAYMENT301 | La pasarela de pago seleccionada no está disponible para esta tienda. |
| PAYMENT311 | WCPOS no ha podido confirmar si se ha realizado este reembolso. |
| PAYMENT401 | El terminal de pago no ha terminado de vincularse con WCPOS. |
| PAYMENT501 | El pedido ya se había pagado en línea, por lo que el pago cobrado en caja es un pago adicional. |
| PAYMENT511 | Se ha cobrado en caja un importe superior al que quedaba pendiente en el pedido. |
| PAYMENT999 | Se ha producido un problema inesperado al gestionar el pago. |
PRINT: Impresión de recibos
| Código | Qué significa |
|---|---|
| PRINT101 | La impresión automática no se ha iniciado para este recibo. |
| PRINT201 | WCPOS no ha podido confirmar que el trabajo de impresión haya finalizado. |
| PRINT301 | No se puede acceder a la impresora seleccionada. |
| PRINT311 | No se ha podido enviar este recibo por correo electrónico ni descargarlo. |
| PRINT999 | Se ha producido un problema inesperado al imprimir. Ninguna venta se ve afectada. |
PRODUCT: Datos de productos y operaciones del catálogo
| Código | Qué significa |
|---|---|
| PRODUCT101 | Este cambio del producto aún no ha llegado a su tienda. |
| PRODUCT111 | No se ha podido añadir esta variación al producto. |
| PRODUCT201 | Esta imagen del producto no está disponible, pero el producto se puede seguir vendiendo. |
| PRODUCT301 | Ningún producto coincide con la búsqueda y los filtros actuales. |
| PRODUCT321 | Más de un producto coincide con este código de barras. |
| PRODUCT401 | Las existencias mostradas pueden estar desactualizadas con respecto a las de la tienda. |
| PRODUCT411 | No se han podido cargar los ajustes de escaneo de códigos de barras, por lo que es posible que los códigos escaneados no coincidan con los productos. |
| PRODUCT421 | No se han podido leer los datos de precios de las variaciones de este producto, por lo que los precios mostrados pueden ser incorrectos o no aparecer. |
| PRODUCT999 | Se ha producido un problema inesperado al cargar o actualizar productos. |
REGISTER: Cajón de efectivo, sesiones de caja y arqueos
| Código | Qué significa |
|---|---|
| REGISTER101 | Su tienda ha rechazado una entrada de efectivo, una salida de efectivo o una apertura sin venta que el terminal ya ha registrado. |
| REGISTER111 | Su tienda ha rechazado anular un movimiento de efectivo, por lo que el movimiento original sigue contabilizándose. |
| REGISTER201 | Su tienda ha rechazado abrir esta sesión de caja, por lo que no se está contabilizando nada en ella. |
| REGISTER211 | Su tienda ha rechazado el arqueo de esta caja, por lo que la sesión sigue abierta en la tienda. |
| REGISTER212 | El traslado del cajón no se ha completado en este dispositivo. No se ha cambiado de tienda. |
| REGISTER221 | Otro dispositivo ya tenía esta caja abierta, por lo que este terminal se ha unido a esa sesión en lugar de iniciar una propia. |
| REGISTER231 | Esta cuenta no puede abrir la caja, realizar el arqueo ni cerrarla. |
| REGISTER301 | Su tienda ha rechazado la aprobación del gerente para este arqueo, por lo que la caja sigue abierta. |
SYNC: Sincronización entre el POS y su tienda
| Código | Qué significa |
|---|---|
| SYNC101 | WCPOS no ha podido escribir un cambio en el almacenamiento de este dispositivo. |
| SYNC111 | Algunos datos guardados en este dispositivo están dañados y no se pueden sincronizar. |
| SYNC121 | No se puede acceder a su tienda en este momento. |
| SYNC131 | Su tienda ha encontrado un error y no ha completado esta solicitud. |
| SYNC141 | Su tienda ha pedido a WCPOS que reduzca la frecuencia de las solicitudes por un momento. |
| SYNC151 | La respuesta de su tienda contenía texto ajeno a los datos que WCPOS ha intentado eliminar. |
| SYNC161 | El almacenamiento de este dispositivo ha dejado de responder, por lo que el guardado está en pausa. |
| SYNC171 | WCPOS no ha podido configurar o eliminar el almacenamiento en este dispositivo. |
| SYNC181 | El guardado o la carga en este dispositivo es muy lento y aún no se conoce el resultado. |
| SYNC191 | Este cambio aún se está enviando a su tienda. |
| SYNC201 | Su tienda ha rechazado este cambio, por lo que no ha llegado a la tienda. |
| SYNC202 | Su tienda ha rechazado este cambio, por lo que este dispositivo ha vuelto a la versión de la tienda. |
| SYNC203 | Su tienda ya no tiene este pedido, por lo que este dispositivo ha dado por resuelta su propia copia. |
| SYNC211 | Su tienda ha rechazado un valor que se le ha enviado. |
| SYNC221 | Un cambio en este dispositivo ha coincidido con una modificación más reciente en su tienda. No se ha perdido nada. |
| SYNC222 | Este dispositivo ha guardado su versión sobre una modificación más reciente realizada en su tienda. |
| SYNC231 | Su tienda ha recibido este cambio, pero este dispositivo no ha podido registrar que se ha enviado. |
| SYNC301 | La lista de cambios de su tienda ha cambiado de posición de forma inesperada, por lo que WCPOS la está comprobando de nuevo automáticamente. No se ha perdido nada. |
| SYNC311 | Los datos de este dispositivo se guardaron con otra versión de WCPOS y aún no se pueden abrir. |
| SYNC321 | Algunos datos no se han sincronizado esta vez. |
| SYNC331 | La copia de un registro en este dispositivo no coincide con la de su tienda. Nada de lo que ha introducido se ve afectado. |
| SYNC341 | Esta tienda requiere ahora una versión más reciente de la aplicación POS. |
| SYNC401 | Una tarea de sincronización en segundo plano se ha detenido inesperadamente antes de finalizar. |
| SYNC411 | Este dispositivo ha solicitado datos a la tienda con mucha más frecuencia de lo normal. |
| SYNC999 | Se ha producido un problema inesperado durante la sincronización. |
Códigos anteriores a v1.10.0
Los códigos como API04001 proceden de versiones anteriores a v1.10.0; esta versión nunca los genera. Es posible que aún encuentre alguno en una entrada del registro conservada desde antes de la actualización o en un hilo antiguo de soporte. Seleccione 1.x en el menú de versiones para consultarlos.
¿Necesita más ayuda?
Si sigue teniendo problemas después de seguir los pasos de resolución:
- Consulte la sección Solución de problemas para obtener guías más detalladas
- Únase a nuestra comunidad de Discord para recibir ayuda
- Informe de los problemas en GitHub