Los 10 Errores Más Comunes al Integrar SUNAT con Odoo (y cómo resolverlos)

Después de implementar Odoo en decenas de empresas peruanas, hemos visto los mismos errores repetirse. Esta guía documenta los 10 problemas más comunes al integrar Odoo con SUNAT y cómo resolverlos rápidamente.

Error 1: "El número de RUC no existe" (Código 2335)

Causa: El RUC del cliente o proveedor no está activo en SUNAT o tiene formato incorrecto.
Solución: Consultar en el portal de SUNAT antes de emitir. En Odoo, activar la validación automática de RUC desde Contabilidad → Configuración → Ajustes.

Error 2: Certificado Digital Rechazado

Causa: El archivo PFX está vencido, tiene contraseña incorrecta, o el certificado no corresponde al RUC de la empresa.
Solución: Verificar fecha de expiración del certificado. Renovar con RENIEC u otra entidad certificadora autorizada por SUNAT.

Error 3: "Serie y correlativo ya usados" (Código 1033)

Causa: Intento de emitir un comprobante con número ya registrado en SUNAT (ocurre al restaurar backups o migrar datos).
Solución: En Odoo, ir al diario y avanzar manualmente la secuencia de numeración hasta el siguiente número no usado.

Error 4: XML Rechazado por Ubigeo Inválido

Causa: La dirección de la empresa tiene un código de ubigeo que no corresponde al catálogo oficial INEI/SUNAT.
Solución: En Contactos → Empresa, usar el campo Estado/Provincia con los valores del catálogo SUNAT. Odoo l10n_pe incluye estos catálogos.

Error 5: Timeout al Conectar con el PSE

Causa: El servidor Odoo no puede alcanzar la API del PSE (firewall corporativo, proxy, o IPs bloqueadas).
Solución: Verificar que el servidor Odoo tenga acceso a internet en el puerto 443. Whitelist de IPs de Nubefact/Efact en el firewall.

Error 6: IGV Calculado Incorrectamente

Causa: Los impuestos del producto no están configurados con el código SUNAT correcto (1000 para IGV, 9996 para exonerado).
Solución: Revisar los grupos de impuestos en Contabilidad → Configuración → Impuestos y asignar el código SUNAT correcto.

Error 7: "Proveedor no Autorizado" en el XML

Causa: El PSE configurado no tiene autorización SUNAT vigente, o se está usando un token de pruebas en producción.
Solución: En el panel del PSE, verificar que el RUC esté en modo producción (no beta/pruebas).

Error 8: Boletas sin CDR

Causa: Las boletas de venta con importe menor a S/ 700 no requieren envío inmediato a SUNAT, pero Odoo puede quedar en estado "pendiente" si no se configura el resumen diario.
Solución: Configurar el envío automático del "Resumen de Boletas" diario desde Contabilidad → Configuración → EDI Perú.

Error 9: Nota de Crédito no Vinculada

Causa: La nota de crédito no referencia correctamente la factura original en el XML.
Solución: Siempre generar notas de crédito desde el botón "Crear Nota de Crédito" dentro de la factura original en Odoo, nunca manualmente.

Error 10: "Hash de Firma Inválido"

Causa: Problema con la librería de firma digital en el servidor (xmlsec o lxml desactualizados).
Solución: Actualizar las dependencias Python del entorno virtual de Odoo: pip install --upgrade xmlsec lxml y reiniciar el servicio.

Prevención: Checklist antes de ir a producción

• RUC de empresa activo y habilitado como emisor electrónico en SUNAT
• Certificado PFX vigente y contraseña correcta
• PSE en modo producción con token correcto
• Plan de cuentas SUNAT instalado (l10n_pe)
• Ubigeo de empresa configurado
• Impuestos con códigos SUNAT asignados
• Acceso a internet desde el servidor Odoo

¿Sigues con problemas?

En Todoo ofrecemos soporte técnico especializado en Odoo para empresas peruanas. Escríbenos y te ayudamos a resolver cualquier problema de integración con SUNAT.