Solución de problemas técnicos: Resolver errores de conexión

La mayoría de los errores de conexión entre Lexiik y su tienda de comercio electrónico provienen de problemas de autenticación, permisos o configuración del servidor. Esta guía le ayuda a diagnosticar y resolver los problemas más frecuentes.

Los 5 errores más frecuentes

Estos son los errores que encontramos con más frecuencia al conectar una tienda. Cada error tiene una solución sencilla.

Error 403: Acceso denegado (Forbidden)

Causa principal: La clave API no tiene los permisos necesarios para leer o escribir datos de productos.

Soluciones según la plataforma

Shopify

1. Shopify Admin > Configuración > Apps y canales de venta
2. Encuentre "Lexiik" y haga clic en "Gestionar"
3. Verifique que los permisos incluyan: read_products, write_products, read_files, write_files
4. Si los permisos son incorrectos, desinstale y reinstale la aplicación

WooCommerce

1. WordPress Admin > WooCommerce > Configuración > Avanzado > Claves REST API
2. Encuentre la clave utilizada por Lexiik
3. Verifique que los permisos sean: Lectura/Escritura (no solo "Lectura")
4. Si es necesario, genere una nueva clave con los permisos correctos

PrestaShop

1. Back-office PrestaShop > Parámetros avanzados > Webservice
2. Edite la clave API utilizada por Lexiik
3. Active todos los permisos para: products, categories, images, stock_availables
4. Guarde y vuelva a probar

Error 500: Error interno del servidor

Causa principal: Problema en el servidor de su tienda (PHP, base de datos, memoria insuficiente).

Diagnóstico paso a paso

1. Revise los registros de errores PHP
   • WooCommerce: wp-content/debug.log
   • PrestaShop: var/logs/
2. Revise la configuración PHP
   • memory_limit: mínimo 256M (recomendado: 512M)
   • max_execution_time: mínimo 300 segundos
   • upload_max_filesize: mínimo 64M
3. Pruebe la API manualmente — Use una herramienta como Postman o curl para probar directamente el endpoint API de su tienda
4. Revise la conexión a la base de datos — Una base de datos saturada o desconectada puede causar errores 500 intermitentes

Error 401: No autorizado (Unauthorized)

Causa principal: La clave API es incorrecta, ha caducado o tiene un formato incorrecto.

Lista de verificación

• Verifique que no haya espacios antes o después de la clave API (error frecuente al copiar y pegar)
• Asegúrese de usar la última clave generada (si ha creado varias, solo la más reciente es válida)
• Verifique que la clave no haya sido revocada en la configuración de su tienda
• Para PrestaShop, compruebe que el webservice esté activado (Parámetros avanzados > Webservice > Sí)
• Pruebe la clave API con una llamada curl para validar su funcionamiento

Error de timeout (tiempo de espera agotado)

Causa principal: Su servidor es demasiado lento o está sobrecargado para procesar las solicitudes API en el tiempo asignado.

Soluciones

• 1. Optimice la base de datos — Un catálogo de 50 000+ productos con tablas sin índices puede causar timeouts. Limpie los registros y optimice las tablas MySQL.
• 2. Desactive temporalmente los plugins pesados — En WooCommerce, algunos plugins de caché o seguridad (Wordfence, All In One Security) pueden ralentizar las solicitudes API. Pruebe desactivándolos temporalmente.
• 3. Migre al Lexiik Bridge — El Lexiik Bridge usa webhooks asíncronos que nunca causan timeouts, a diferencia de la API estándar.
• 4. Mejore su hosting — Un VPS o hosting dedicado ofrecerá mejor rendimiento que un hosting compartido básico.

Error SSL/TLS (certificado inválido)

Causa principal: Su tienda no tiene un certificado SSL válido o ha caducado.

Resolución

1. Verifique su certificado SSL — Use SSL Labs para comprobar la validez de su certificado
2. Instale un certificado gratuito — Let's Encrypt ofrece certificados SSL gratuitos y renovables automáticamente. La mayoría de los proveedores de hosting (cPanel, Plesk) ofrecen instalación con un clic.
3. Fuerce HTTPS en su CMS
   • Shopify: Automático (gestionado por Shopify)
   • WooCommerce: Configuración > General > Dirección de WordPress y Dirección del sitio (use https://)
   • PrestaShop: Tienda > Configuración de la tienda > Activar SSL (Sí)

Gestión de claves API

Las claves API son las "contraseñas" que permiten a Lexiik acceder a su tienda. Aquí están las mejores prácticas de gestión.

Generar una nueva clave API

Shopify

1. Shopify Admin > Configuración > Apps y canales de venta
2. Haga clic en "Desarrollar apps" (en la parte inferior)
3. Cree una app privada con los scopes: read_products, write_products, read_files, write_files
4. Copie el Admin API access token

WooCommerce

1. WordPress Admin > WooCommerce > Configuración > Avanzado > Claves REST API
2. Haga clic en "Añadir clave"
3. Descripción: "Lexiik Bridge"
4. Usuario: Su cuenta de administrador
5. Permisos: Lectura/Escritura
6. Genere la clave y copie la Consumer key y el Consumer secret

PrestaShop

1. Back-office PrestaShop > Parámetros avanzados > Webservice
2. Active el webservice si aún no lo ha hecho
3. Haga clic en "Añadir nueva clave"
4. Descripción de la clave: "Lexiik Bridge"
5. Active todos los permisos (o como mínimo: products, categories, images, stock_availables)
6. Haga clic en "Guardar" y copie la clave generada

Proteger sus claves API

• Nunca comparta sus claves API públicamente (GitHub, foros, capturas de pantalla)
• Renueve sus claves cada 6 meses como medida de seguridad
• Elimine las claves no utilizadas para reducir la superficie de ataque
• Cree una clave dedicada por servicio (una para Lexiik, otra para otra herramienta, etc.)
• Documente el uso de cada clave con una descripción clara

Problemas de permisos de escritura

Algunos errores ocurren cuando Lexiik no tiene permisos de escritura en ciertos archivos o carpetas de su servidor.

Error al subir imágenes

Causa: La carpeta de subida no tiene los permisos de escritura correctos.

Solución (mediante SSH o FTP)

chmod -R 755 /path/to/wordpress/wp-content/uploads/

chmod -R 755 /path/to/prestashop/img/

Verificación de permisos

Estos son los permisos recomendados para cada plataforma:

Herramientas de diagnóstico

Lexiik ofrece varias herramientas integradas para diagnosticar problemas de conexión.

Prueba de conexión integrada

En el panel de Lexiik, vaya a Conexiones > Probar la conexión. Esta herramienta realiza una serie de verificaciones automáticas:

• Validez de la clave API
• Permisos de lectura/escritura
• Tiempo de respuesta del servidor
• Certificado SSL
• Compatibilidad de la versión de la plataforma

Registros de sincronización

Cada intento de sincronización queda registrado en los logs. Para acceder a ellos:

1. Panel de Lexiik > Conexiones
2. Haga clic en los 3 puntos junto a su tienda
3. Seleccione "Ver registros"

Los registros indican:

• Fecha y hora de cada sincronización
• Estado (éxito o fallo)
• Duración de la sincronización
• Número de productos procesados
• Mensajes de error detallados en caso de fallo

Modo debug

Para desarrolladores, el Lexiik Bridge ofrece un modo debug que registra todos los detalles técnicos.

Activar el modo debug

En el módulo Lexiik Bridge de su tienda:

1. Abra la configuración del módulo
2. Active la opción "Modo debug"
3. Realice una sincronización
4. Consulte el archivo de log generado (ubicación indicada en la configuración)

Casos particulares y hostings específicos

Algunos proveedores de hosting o configuraciones de servidor requieren ajustes específicos.

Hosting compartido

Los hostings compartidos (OVH, O2Switch, Ionos, etc.) imponen a veces restricciones.

• Problema: Webhooks bloqueados por el firewall
  Solución: Añada las IPs de Lexiik a la lista blanca (disponibles en Configuración > Integraciones)
• Problema: Límite de solicitudes API por minuto
  Solución: El Lexiik Bridge gestiona automáticamente el rate limiting. Si usa la API estándar, migre al Bridge.
• Problema: PHP memory_limit demasiado bajo (128M)
  Solución: Contacte con su hosting para aumentarlo a 256M como mínimo. O añada en wp-config.php: define('WP_MEMORY_LIMIT', '256M');

Sitios detrás de Cloudflare

Si su tienda usa Cloudflare, algunas reglas de seguridad pueden bloquear los webhooks de Lexiik.

Configuración de Cloudflare recomendada

1. Cloudflare Dashboard > Firewall Rules
2. Cree una regla de excepción para las URLs: /wp-json/lexiik/* (WooCommerce) o /api/lexiik/* (PrestaShop)
3. Acción: Allow (permitir)
4. En Security Level, configure "Medium" en lugar de "High" para estas URLs

Web Application Firewall (WAF)

Los WAF como Sucuri, Wordfence o ModSecurity pueden bloquear las solicitudes API.

• Wordfence (WordPress): Vaya a Wordfence > Firewall > Rate Limiting > Añada la IP de Lexiik a la lista blanca
• Sucuri: Cree una regla de excepción para los endpoints /wp-json/lexiik/ o /api/lexiik/
• ModSecurity: Añada una regla de excepción en el archivo .htaccess o contacte con su proveedor de hosting

Obtener ayuda adicional

Si no encuentra una solución en esta guía, el equipo de soporte de Lexiik está aquí para ayudarle.

Contactar con el soporte

• Chat en vivo: Disponible 7 días a la semana en el panel de Lexiik (esquina inferior derecha)
• Email: [email protected] (respuesta en menos de 2 horas de media)
• Teléfono: Solo para planes Pro y Expert (número disponible en su área de cliente)
• Documentación técnica: docs.lexiik.com

Recursos complementarios

• Guía de conexión de tienda
• Comparativa Bridge vs API estándar
• Lanzar su primera auditoría SEO