v0.1.8
Solución de Problemas
Esta guía te ayudará a resolver los problemas más comunes que pueden surgir con el Conector NewBytes. Está organizada por síntomas para que puedas encontrar rápidamente la solución que necesitas.
🔍 Diagnóstico Rápido
Antes de Empezar
Cuando tengas un problema, siempre verifica primero:
- ¿El plugin está activo? Ve a Plugins → Plugins instalados
- ¿Hay mensajes de error visibles? Revisa el panel de WordPress
- ¿Cuándo ocurrió por última vez? Revisa los logs recientes
- ¿Cambió algo recientemente? Actualizaciones, nuevos plugins, etc.
Información Básica para Diagnóstico
Antes de contactar soporte, ten a mano:
- Versión de WordPress: Ve a Panel → Actualizaciones
- Versión de WooCommerce: Ve a Plugins → Plugins instalados
- Versión del plugin: Ve a Plugins → Plugins instalados
- Logs recientes: Ve a Herramientas → NewBytes Logs
🚨 Problemas de Conexión
"No se puede conectar con NewBytes"
Síntomas:
- Indicador de conexión en rojo
- Error "Timeout de conexión"
- "API no disponible"
Causas Posibles:
- Credenciales incorrectas
- Problemas de red
- Firewall bloqueando conexiones
- API de NewBytes temporalmente no disponible
Soluciones:
1. Verificar Credenciales
✅ Pasos:
1. Ve a Ajustes → Conector NB
2. Verifica usuario y contraseña
3. Asegúrate de no tener espacios extra
4. Prueba iniciar sesión en NewBytes directamente✅ Pasos:
1. Ve a Ajustes → Conector NB
2. Verifica usuario y contraseña
3. Asegúrate de no tener espacios extra
4. Prueba iniciar sesión en NewBytes directamente2. Probar Conexión de Red
✅ Pasos:
1. Abre una nueva pestaña del navegador
2. Ve a https://api.nb.com.ar
3. Si no carga, hay problemas de red
4. Contacta a tu proveedor de internet✅ Pasos:
1. Abre una nueva pestaña del navegador
2. Ve a https://api.nb.com.ar
3. Si no carga, hay problemas de red
4. Contacta a tu proveedor de internet3. Verificar con Hosting
✅ Pasos:
1. Contacta a tu proveedor de hosting
2. Pregunta sobre restricciones de firewall
3. Solicita permitir conexiones a api.nb.com.ar
4. Verifica que curl esté habilitado en PHP✅ Pasos:
1. Contacta a tu proveedor de hosting
2. Pregunta sobre restricciones de firewall
3. Solicita permitir conexiones a api.nb.com.ar
4. Verifica que curl esté habilitado en PHP"Credenciales inválidas"
Síntomas:
- Error específico de credenciales
- No se puede autenticar
- Token no válido
Soluciones:
1. Verificar Datos de Acceso
- Confirma tu usuario de NewBytes
- Verifica que la contraseña sea correcta
- Prueba iniciar sesión en el sitio web de NewBytes
2. Resetear Credenciales
- Cambia tu contraseña en NewBytes
- Actualiza la contraseña en el plugin
- Guarda y prueba la conexión
3. Contactar a NewBytes
- Si los datos son correctos pero no funcionan
- Puede haber un problema con tu cuenta
- Soporte puede verificar el estado de tu cuenta
🔄 Problemas de Sincronización
"La sincronización no se ejecuta automáticamente"
Síntomas:
- No hay logs nuevos automáticos
- Los productos no se actualizan
- Solo funciona la sincronización manual
Causas Posibles:
- Cron jobs de WordPress deshabilitados
- Problemas con el hosting
- Plugin desactivado temporalmente
Soluciones:
1. Verificar Cron Jobs
✅ Pasos:
1. Instala el plugin "WP Crontrol" (gratuito)
2. Ve a Herramientas → Cron Events
3. Busca "nb_cron_sync_event"
4. Si no aparece, hay un problema con cron✅ Pasos:
1. Instala el plugin "WP Crontrol" (gratuito)
2. Ve a Herramientas → Cron Events
3. Busca "nb_cron_sync_event"
4. Si no aparece, hay un problema con cron2. Contactar al Hosting
✅ Preguntas para tu hosting:
- ¿Están habilitados los cron jobs de WordPress?
- ¿Hay restricciones en tareas programadas?
- ¿Pueden verificar los logs del servidor?✅ Preguntas para tu hosting:
- ¿Están habilitados los cron jobs de WordPress?
- ¿Hay restricciones en tareas programadas?
- ¿Pueden verificar los logs del servidor?3. Solución Temporal
✅ Mientras se resuelve:
1. Usa sincronización manual regularmente
2. Configura recordatorios para sincronizar
3. Considera cambiar de hosting si persiste✅ Mientras se resuelve:
1. Usa sincronización manual regularmente
2. Configura recordatorios para sincronizar
3. Considera cambiar de hosting si persiste"Algunos productos no se sincronizan"
Síntomas:
- La sincronización es exitosa pero faltan productos
- Algunos productos no se actualizan
- Números no coinciden con NewBytes
Soluciones:
1. Verificar Stock en NewBytes
- Productos sin stock pueden no sincronizarse
- Verifica disponibilidad en el catálogo NewBytes
- Contacta a NewBytes sobre productos específicos
2. Revisar Logs Detallados
- Ve a Herramientas → NewBytes Logs
- Busca advertencias sobre productos específicos
- Identifica patrones en productos problemáticos
3. Verificar Límites del Servidor
- Sincronizaciones muy grandes pueden fallar
- Contacta al hosting sobre límites de memoria
- Considera intervalos más largos
"La sincronización es muy lenta"
Síntomas:
- Sincronizaciones que toman más de 10 minutos
- Timeouts frecuentes
- Servidor lento durante sincronización
Soluciones:
1. Optimizar Configuración
✅ Ajustes recomendados:
- Aumenta el intervalo de sincronización
- Usa horarios de menor tráfico
- Considera sincronización nocturna✅ Ajustes recomendados:
- Aumenta el intervalo de sincronización
- Usa horarios de menor tráfico
- Considera sincronización nocturna2. Mejorar Recursos del Servidor
✅ Contacta al hosting para:
- Aumentar memoria PHP (mínimo 256MB)
- Aumentar tiempo de ejecución (300+ segundos)
- Verificar velocidad de conexión✅ Contacta al hosting para:
- Aumentar memoria PHP (mínimo 256MB)
- Aumentar tiempo de ejecución (300+ segundos)
- Verificar velocidad de conexión3. Dividir la Sincronización
- Para catálogos muy grandes
- Contacta a NewBytes sobre opciones
- Puede ser posible sincronizar por categorías
🖼️ Problemas con Imágenes
"Las imágenes no aparecen en los productos"
Síntomas:
- Productos sin imagen destacada
- Imágenes rotas o no cargan
- Solo algunos productos tienen imágenes
Soluciones:
1. Verificar Plugin FIFU
✅ Pasos:
1. Ve a Plugins → Plugins instalados
2. Verifica que FIFU esté activo
3. Ve a Ajustes → Featured Image from URL
4. Activa "Enable Featured Image from URL"✅ Pasos:
1. Ve a Plugins → Plugins instalados
2. Verifica que FIFU esté activo
3. Ve a Ajustes → Featured Image from URL
4. Activa "Enable Featured Image from URL"2. Probar URLs de Imágenes
✅ Pasos:
1. Ve a un producto sin imagen
2. Edita el producto en WooCommerce
3. Busca el campo de URL de imagen
4. Copia la URL y ábrela en el navegador✅ Pasos:
1. Ve a un producto sin imagen
2. Edita el producto en WooCommerce
3. Busca el campo de URL de imagen
4. Copia la URL y ábrela en el navegador3. Configurar FIFU Correctamente
✅ Configuración recomendada:
- Enable Featured Image from URL: ✓
- Auto Set First Image as Featured: ✓
- Save the First Image as Attachment: ✗✅ Configuración recomendada:
- Enable Featured Image from URL: ✓
- Auto Set First Image as Featured: ✓
- Save the First Image as Attachment: ✗"Las imágenes se cargan muy lento"
Síntomas:
- Imágenes tardan en aparecer
- Sitio web lento al cargar productos
- Timeouts al mostrar catálogo
Soluciones:
1. Optimizar Imágenes
- Las imágenes de NewBytes pueden ser grandes
- Considera usar un plugin de optimización
- Contacta a NewBytes sobre tamaños de imagen
2. Usar CDN
- Configura un CDN para imágenes
- Mejora la velocidad de carga global
- Consulta con tu hosting sobre opciones
💾 Problemas de Base de Datos
"Error al guardar configuración"
Síntomas:
- Los cambios no se guardan
- Error al hacer clic en "Guardar"
- Configuración se resetea
Soluciones:
1. Verificar Permisos
✅ Pasos:
1. Verifica que tengas rol de Administrador
2. Intenta desde otro navegador
3. Limpia caché del navegador✅ Pasos:
1. Verifica que tengas rol de Administrador
2. Intenta desde otro navegador
3. Limpia caché del navegador2. Problemas de Base de Datos
✅ Pasos:
1. Contacta al hosting sobre errores de BD
2. Verifica espacio disponible en disco
3. Puede necesitar reparación de BD✅ Pasos:
1. Contacta al hosting sobre errores de BD
2. Verifica espacio disponible en disco
3. Puede necesitar reparación de BD"Productos duplicados"
Síntomas:
- Mismo producto aparece múltiples veces
- SKUs duplicados
- Inventario inconsistente
Soluciones:
1. Limpiar Productos Duplicados
✅ Pasos:
1. Ve a Productos en WooCommerce
2. Busca productos con el mismo SKU
3. Elimina manualmente los duplicados
4. Ejecuta una nueva sincronización✅ Pasos:
1. Ve a Productos en WooCommerce
2. Busca productos con el mismo SKU
3. Elimina manualmente los duplicados
4. Ejecuta una nueva sincronización2. Verificar Prefijo SKU
✅ Pasos:
1. Ve a Ajustes → Conector NB
2. Verifica que el prefijo SKU sea único
3. No uses prefijos que ya existan✅ Pasos:
1. Ve a Ajustes → Conector NB
2. Verifica que el prefijo SKU sea único
3. No uses prefijos que ya existan🔧 Problemas de Rendimiento
"El sitio web está lento después de instalar el plugin"
Síntomas:
- Sitio web más lento en general
- Panel de WordPress lento
- Timeouts frecuentes
Soluciones:
1. Optimizar Intervalo de Sincronización
✅ Cambios recomendados:
- Aumenta el intervalo a 6-12 horas
- Evitar horarios de alto tráfico
- Usar sincronización nocturna✅ Cambios recomendados:
- Aumenta el intervalo a 6-12 horas
- Evitar horarios de alto tráfico
- Usar sincronización nocturna2. Verificar Recursos del Servidor
✅ Contacta al hosting:
- Verificar uso de CPU durante sincronización
- Aumentar límites de memoria
- Considerar plan de hosting superior✅ Contacta al hosting:
- Verificar uso de CPU durante sincronización
- Aumentar límites de memoria
- Considerar plan de hosting superior3. Optimizar Base de Datos
✅ Pasos:
1. Limpia logs antiguos regularmente
2. Optimiza tablas de WordPress
3. Considera plugin de optimización de BD✅ Pasos:
1. Limpia logs antiguos regularmente
2. Optimiza tablas de WordPress
3. Considera plugin de optimización de BD📞 Cuándo Contactar Soporte
Contacta a NewBytes cuando:
- ✅ Problemas de autenticación persistentes
- ✅ Errores de API o conectividad
- ✅ Productos específicos no se sincronizan
- ✅ Necesitas configuraciones personalizadas
Contacta a tu Hosting cuando:
- ✅ Problemas de cron jobs
- ✅ Límites de memoria o tiempo
- ✅ Errores de base de datos
- ✅ Problemas de conectividad externa
Información para Incluir al Contactar Soporte
Para NewBytes:
📋 Información necesaria:
- Usuario de NewBytes
- URL de tu sitio web
- Versión del plugin
- Logs de las últimas 24 horas
- Descripción detallada del problema📋 Información necesaria:
- Usuario de NewBytes
- URL de tu sitio web
- Versión del plugin
- Logs de las últimas 24 horas
- Descripción detallada del problemaPara Hosting:
📋 Información necesaria:
- Descripción del problema
- Horarios cuando ocurre
- Mensajes de error específicos
- Versión de PHP y WordPress
- Plugins activos📋 Información necesaria:
- Descripción del problema
- Horarios cuando ocurre
- Mensajes de error específicos
- Versión de PHP y WordPress
- Plugins activos🛠️ Herramientas de Diagnóstico
Plugins Útiles para Diagnóstico
- WP Crontrol - Verificar cron jobs
- Query Monitor - Monitorear rendimiento
- Health Check - Verificar salud del sitio
- WP-CLI - Herramientas de línea de comandos
Comandos Útiles (para técnicos)
bash
# Verificar cron jobs
wp cron event list
# Ejecutar sincronización manual
wp cron event run nb_cron_sync_event
# Verificar estado del plugin
wp plugin status woocommerce-newbytes# Verificar cron jobs
wp cron event list
# Ejecutar sincronización manual
wp cron event run nb_cron_sync_event
# Verificar estado del plugin
wp plugin status woocommerce-newbytes💡 Consejo de Prevención
La mayoría de problemas se pueden prevenir con:
- Mantener WordPress y plugins actualizados
- Hacer backups regulares
- Monitorear logs semanalmente
- Usar hosting confiable con recursos adecuados
⚠️ Antes de Hacer Cambios Importantes
Siempre haz una copia de seguridad antes de:
- Actualizar plugins
- Cambiar configuraciones importantes
- Limpiar productos masivamente
- Modificar la base de datos
ℹ️ ¿No Encuentras tu Problema?
Si tu problema no está listado aquí:
- Revisa las Preguntas Frecuentes
- Busca en los logs información específica
- Contacta al soporte con información detallada
- Considera la documentación técnica para problemas avanzados