Ir al contenido principal
Versión: 1.x

AUTH311: Falta la ruta REST

Qué significa esto

La ruta de la tienda de WCPOS no está disponible.

Pida al administrador del sitio que compruebe si un plugin de seguridad o de proxy está eliminando las cabeceras de solicitud de WCPOS.

Qué hacer

Es necesario un cambio de configuración para que esto funcione. Reinténtelo después de realizar el cambio anterior; reintentarlo sin hacerlo fallará de la misma forma.

Sus datos

No se ve afectado ningún dato de pedidos ni de productos. Si esto persiste, consulte a la persona que gestiona su sitio de WordPress.

Resolución de problemas

  1. Confirme que WCPOS está activo en el sitio: WP Admin → Plugins.
  2. Pruebe en un navegador las dos formas REST admitidas: la dirección /wp-json/ de su tienda y /index.php?rest_route=/. Diagnostique un bloqueo de REST solo si ninguna de las dos direcciones devuelve JSON.
  3. Si no funciona ninguna de las dos formas REST, pregunte al administrador del sitio si un plugin de seguridad, un proxy o una CDN está eliminando las cabeceras de solicitud de WCPOS o bloqueando las solicitudes REST — las reglas de cortafuegos y las opciones de refuerzo que desactivan la API REST son los culpables habituales.
  4. En algunos proveedores de alojamiento, volver a guardar los enlaces permanentes (Ajustes → Enlaces permanentes → Guardar) restaura las rutas REST que faltan.

Dónde buscar

Cuando WCPOS puede guardar este error, queda registrado en el dispositivo que lo generó. Abra Estado de la tienda → Registros (el icono de latido situado al final del cajón de navegación), busque la entrada marcada con este código y expándala: la fila expandida muestra el motivo en lenguaje sencillo y el contexto capturado en el momento del fallo. En el caso de una solicitud a la tienda, ese contexto puede incluir el código de error propio del servidor (serverCode), el status HTTP o el endpoint; los campos mostrados dependen de dónde se haya producido el fallo. Al informar de un problema, utilice Copiar información de depuración en la parte superior de la pantalla de Registros (Compartir información de depuración en teléfonos y tabletas) en lugar de capturas de pantalla: agrupa la versión de la aplicación, el estado de la conexión y los errores más recientes. Los registros se conservan un máximo de 30 días, así que recójalos mientras el problema esté reciente. Copie también cualquier error de la consola del navegador que haya aparecido antes de que el POS pudiera escribir su propia entrada de registro.

Más allá del registro dentro de la aplicación, este fallo puede dejar rastro en:

  • Inspector de red (web y escritorio): abra las herramientas de desarrollo —pulse F12 en el navegador, o Avanzado → Alternar herramientas para desarrolladores en el menú de la aplicación de escritorio— y seleccione la pestaña Red. Siga primero las indicaciones de reintento de esta página; reproduzca la acción solo cuando esos pasos indiquen que es seguro. Una solicitud fallida muestra el estado HTTP y el cuerpo de la respuesta sin procesar, incluidas las páginas de error que nunca llegan al registro del POS.
  • WooCommerce → Estado → Registros: en el sitio de WordPress, revise el archivo fatal-errors-*.log más reciente en busca de errores fatales de PHP, además de cualquier fuente de registro que lleve el nombre de un plugin implicado en el fallo. Un error de clase 500 procedente de la tienda casi siempre deja aquí su causa.

Detalles

  • Código: AUTH311 (REST_ROUTE_MISSING)
  • Gravedad: error
  • Introducido en: WCPOS 1.10.0