Solución de problemas
Esta sección describe los errores más comunes que pueden ocurrir durante la operación de Keygin ERP Sync Pro y sus respectivas soluciones.
⚠️ IMPORTANTE
Antes de realizar cambios técnicos, asegúrese de contar con un respaldo actualizado de la base de datos.
Antes de realizar cambios técnicos, asegúrese de contar con un respaldo actualizado de la base de datos.
Error 1: No se puede conectar con la API de Contifico
Síntomas
- Mensaje: “Error de conexión”
- Estado: “API no responde”
- No se puede verificar credenciales
Posibles causas
- API Key incorrecta
- Servidor sin acceso a internet
- Firewall bloqueando conexiones salientes
- Problemas temporales del ERP
Solución
- Verifique que la API Key sea válida.
- Confirme que el servidor permita conexiones HTTPS salientes (puerto 443).
- Revise reglas de firewall.
- Pruebe la conectividad desde el servidor mediante
curl.
Error 2: Los productos no se sincronizan
Síntomas
- Nuevos productos no aparecen en WooCommerce
- Cambios en ERP no se reflejan
Posibles causas
- Sincronización deshabilitada
- Cron de WordPress no ejecutándose
- Filtros activos en ERP
Solución
- Verifique que la sincronización esté habilitada.
- Compruebe que WP-Cron esté funcionando.
- Revise los logs del plugin.
- Ejecute una sincronización manual.
Error 3: El stock no se actualiza correctamente
Síntomas
- Diferencias entre stock ERP y WooCommerce
- Inventario inconsistente
Posibles causas
- Bodega incorrecta seleccionada
- Productos duplicados
- SKU no coincidente
Solución
- Verifique la bodega principal configurada.
- Confirme que los SKUs coincidan exactamente.
- Revise si existen productos duplicados.
- Fuerce una resincronización completa.
Error 4: Error 403 en el panel de administración
Síntomas
- Stock no se actualiza en Contifico despues de completar una orden en WooCommerce.
- Pérdida de trazabilidad.
Causa probable
- El documento electrónico enviado desde tiene campos vacíos o mal redactados.
Solución
- Diríjase a Documentos Fallidos
- Verifique el documento fallido basnadose en el número de Orden de WooCommerce.
- Corrija manualmente los campos estrictamente necesarios, para error 403 debe corregir los campos que el formulario pide corregir en el mensaje de error.
- Envíe el documento y verifique.
Error 5: Error 409 en el panel de administración
Síntomas
- Stock no se actualiza en Contifico despues de completar una orden en WooCommerce.
- Pérdida de trazabilidad.
Causa probable
- El documento electrónico enviado desde WordPress esta duplicado.
Solución
- Diríjase a Documentos Fallidos
- Verifique el documento fallido basnadose en el número de Orden de WooCommerce.
- Corrija manualmente los campos estrictamente necesarios, para error 409 debe corregir el numero de documento ej. {001-001-000000001}. El número desde ser el inmediato superior al registrado en Contifico.
- Envíe el documento y verifique.
Error 6: Error 500 en el panel de administración
Síntomas
- Pantalla en blanco
- Error interno del servidor
- Mensaje “500 Internal Server Error”
Posibles causas
- Conflicto con otro plugin
- Límite de memoria PHP insuficiente
- Versión de PHP incompatible
Solución
- Aumente
memory_limiten PHP. - Desactive otros plugins temporalmente.
- Verifique que PHP sea 7.4 o superior.
- Revise los logs del servidor (
error_log).
Error 7: Licencia inválida o expirada
Síntomas
- Mensaje: “Licencia inválida”
- Funciones bloqueadas
- Sincronización deshabilitada
Posibles causas
- Dominio no autorizado
- Licencia vencida
- Error de validación remota
Solución
- Verifique que el dominio coincida con la licencia adquirida.
- Confirme la fecha de expiración.
- Revise conectividad hacia el servidor de validación.
- Contacte soporte si el problema persiste.
Recomendación general
Para un diagnóstico más preciso:
- Active el modo debug del plugin.
- Revise los logs internos de Keygin Sync.
- Consulte los logs del servidor web.
- Documente el mensaje exacto del error antes de contactar soporte.