WooSyncFS 3.2: por que no conecta con tu WooCommerce, y como arreglarlo

Los seis motivos por los que WooSyncFS "no conecta"

Pegas la direccion de la tienda, pegas la clave y el secreto, pulsas probar conexion y sale un error que no dice nada util. Ese es el momento en el que se abandona el plugin.

La 3.2 trae un boton Diagnosticar conexion que comprueba la cadena entera de fuera hacia dentro y te dice en cual de los seis pasos se atasca y que hacer exactamente. Aqui van los seis, por si prefieres mirarlo tu antes.

1. La direccion de la tienda esta mal escrita

El mas tonto y el mas frecuente. La documentacion de WooCommerce ensena la direccion completa de la API:

https://mitienda.com/wp-json/wc/v3

asi que es lo que mucha gente pega en el campo. Y hasta la 3.1 el plugin le anadia otro /wp-json/wc/v3 detras, con lo que acababa pidiendo https://mitienda.com/wp-json/wc/v3/wp-json/wc/v3/orders. Resultado: 404.

En la 3.2 se recorta sola. Da igual lo que pegues: la direccion completa de la API, con barra al final, sin https://, con la tienda en una subcarpeta. Se limpia al guardar y tambien al usarla, asi que si tu instalacion ya la tenia mal, se arregla sola al actualizar.

En el campo solo hace falta el dominio: https://mitienda.com. Si WordPress esta en una subcarpeta, el dominio y la subcarpeta: https://mitienda.com/tienda.

2. La API REST de WordPress devuelve 404

Este es el gordo, y casi nadie lo relaciona. Si al abrir https://mitienda.com/wp-json/ en el navegador ves un 404 en vez de un texto lleno de llaves, son los enlaces permanentes.

WordPress solo sirve la API REST en esa direccion si los enlaces permanentes NO estan en modo "Simple". Arreglo:

1. En WordPress, Ajustes > Enlaces permanentes.
2. Elige cualquier opcion que no sea "Simple" (por ejemplo "Nombre de la entrada").
3. Guardar.

Treinta segundos, y no hay que tocar nada mas. El diagnostico lo detecta y te dice esto mismo.

3. Algo bloquea la API REST

Si /wp-json/ responde 401 o 403 en vez de 404, no es WordPress: hay algo delante. Por orden de probabilidad: un plugin de seguridad (Wordfence, iThemes Security) con la opcion de bloquear la REST API activada, el WAF de Cloudflare, o una regla del hosting.

En todos ellos busca la opcion de "desactivar / restringir REST API" y permite al menos las rutas de WooCommerce.

4. WooCommerce no esta, o su API no es la v3

Menos comun, pero pasa cuando se apunta a un WordPress que no es la tienda. El diagnostico comprueba que existe la ruta wc/v3. Hace falta WooCommerce 3.5 o superior.

5. La clave no vale para leer

Un 401 al pedir los pedidos. Tres causas, por orden de lo que nos encontramos:

1. La clave o el secreto llevan un espacio delante o detras, pegado al copiar. Es el numero uno con diferencia.
2. La clave se creo para un usuario que no es administrador de la tienda.
3. La tienda va por HTTP y el servidor borra la cabecera de autenticacion por el camino.

Lo mas rapido casi siempre es borrar la clave en WooCommerce y crear otra: WooCommerce > Ajustes > Avanzado > API REST > Anadir clave, permisos Lectura/Escritura. Ojo: el secreto (cs_...) solo se ve una vez. Si cierras esa pantalla sin copiarlo, hay que crear otra clave.

6. La clave es de solo lectura y estas enviando stock

Este falla en silencio: los pedidos entran perfectamente y el stock nunca sube a la tienda, sin que nada avise. Pasa cuando la clave se creo con permisos de "Lectura".

El diagnostico lo comprueba solo si tienes activado el envio de stock, y la comprobacion es inofensiva: pide modificar un producto que no existe, asi que la tienda contesta si la clave puede escribir o no, sin tocar nada.

Si sale en rojo tienes dos salidas: crear una clave nueva con permisos de Lectura/Escritura, o desactivar "Enviar stock a la tienda" y quedarte solo con la importacion de pedidos.

Como actualizar

Desde Panel de control > Plugins, actualiza WooSyncFS a la 3.2. No cambia nada de lo que ya funcionaba: los pedidos importados, la configuracion y el cron siguen igual. Lo unico que se toca de tus datos es la direccion de la tienda, que se limpia si hacia falta.

Despues, entra en el panel de WooSyncFS y pulsa Diagnosticar conexion aunque te vaya bien: son cinco segundos y te dice si la clave puede escribir, que es lo que muchos descubren tres semanas tarde.