¿Cómo resolver errores de PAC y complementos de pago en Odoo Enterprise?
Un método para diagnosticar por qué el timbrado o el complemento de pago fallan en Odoo, separando el error real del síntoma que aparece en pantalla.
Contexto oficial
Lo que sí está documentado y lo que debe validarse
Guía práctica
¿Cómo diagnosticar antes de reintentar el timbrado?
Lee el mensaje de error completo, no solo el resumen: Odoo suele mostrar la respuesta técnica del PAC, que trae el motivo real del rechazo.
Identifica si el error ocurre al timbrar la factura original, al generar el complemento de pago o al cancelar; cada momento tiene causas distintas.
Revisa si el error es de un solo comprobante o de todos los documentos del día; un patrón general casi siempre apunta a certificado, credenciales o catálogo, no a un dato aislado.
Confirma la fecha del último cambio en la instancia (actualización de módulo, cambio de certificado, nuevo régimen fiscal) antes de asumir que es un problema nuevo sin causa.
Guía práctica
Errores más comunes del PAC y su causa real
Rechazo por RFC o régimen fiscal del receptor: casi siempre es un dato de contacto desactualizado, no un problema de Odoo ni del PAC.
Rechazo por clave de producto o unidad de medida SAT inválida: el catálogo del producto no coincide con el catálogo vigente del SAT.
Rechazo por sello o certificado inválido: el CSD está vencido, fue revocado, o la contraseña configurada en Odoo ya no corresponde al certificado activo.
Timeout o error de conexión con el PAC: puede ser saldo de timbres agotado, el servicio del PAC caído, o un firewall/proxy bloqueando la salida desde el servidor.
Documento "en proceso" indefinidamente: normalmente indica que la respuesta del PAC no llegó a Odoo; conviene consultar directamente en el portal del PAC antes de retimbrar.
Rechazo por relación entre comprobantes (nota de crédito, sustitución) mal referenciada: el UUID relacionado no corresponde al documento original o ya fue cancelado por otra vía.
Guía práctica
Complemento de pago (REP): ¿por qué falla más que la factura?
El REP depende de que la factura original ya tenga UUID válido; si la factura se canceló o se editó después de timbrarse, el complemento se rompe.
Un pago que cubre varias facturas necesita relacionarse correctamente con cada documento; agruparlo mal genera un complemento que no cuadra contra el estado real de cobranza.
La forma de pago y la fecha del pago deben coincidir con el movimiento bancario real; complementos generados por conciliación automática mal configurada suelen tener fechas o montos incorrectos.
Si una factura es PUE pero se está pagando en fecha posterior por error de captura, no debe llevar complemento de pago; forzarlo genera inconsistencia fiscal, no un problema técnico.
Cuando el pago se recibe en moneda distinta a la de la factura, el tipo de cambio capturado debe coincidir con el publicado por el Banco de México en la fecha correspondiente; una diferencia aquí también puede provocar rechazo.
Guía práctica
CSD, certificados y credenciales: la causa silenciosa
Revisa la vigencia del CSD directamente en el portal del SAT, no solo en la fecha que Odoo muestra; un certificado caducado puede seguir "viéndose bien" en la interfaz.
Verifica que las credenciales del PAC configuradas en Odoo correspondan al contrato vigente; una renovación de contrato con el PAC sin actualizar credenciales en Odoo produce rechazos.
Si el negocio tiene más de una empresa o sucursal en la misma instancia, confirma que cada una use su propio CSD y no un certificado compartido por error.
Después de renovar cualquier certificado, haz una prueba de timbrado controlada antes de operar el día completo con la nueva credencial.
Lleva un registro simple con fecha de vencimiento del CSD y de cada credencial del PAC; depender de la memoria del equipo para esto es una causa recurrente de interrupciones evitables.
Guía práctica
Checklist antes de escalar el problema
Guarda el mensaje de error completo, la fecha, el número de documento y si el error es aislado o generalizado.
Confirma vigencia de CSD, estatus de credenciales del PAC y saldo de timbres disponibles.
Verifica que el dato maestro del cliente y del producto involucrados en ese documento estén completos y vigentes.
Si el patrón es general y no se resuelve con lo anterior, es momento de un diagnóstico técnico sobre la instancia completa en lugar de seguir probando comprobante por comprobante.
Comparte este checklist con quien capture facturas a diario; entre más completo llegue el primer reporte del error, menos vueltas toma llegar a la causa real.
Guía práctica
Error de Odoo, error del PAC o error de datos: ¿cómo distinguirlos?
Es error de datos cuando el rechazo señala un campo específico (RFC, régimen, clave de producto); la corrección está en el dato maestro, no en el software.
Es error del PAC cuando el mensaje habla de saldo, servicio no disponible o timeout; ahí conviene revisar el portal del PAC directamente antes de tocar Odoo.
Es error de configuración de Odoo cuando el módulo de localización está desactualizado respecto a un cambio reciente del esquema SAT, algo poco frecuente pero real tras actualizaciones grandes de versión.
Es error de proceso, no técnico, cuando el documento se timbra correctamente pero el complemento de pago no corresponde a la realidad del cobro; ahí el ajuste es de flujo interno, no de sistema.
Mezclar estas categorías es la razón por la que muchos tickets de soporte se alargan: se ataca el síntoma en Odoo cuando la causa está en un dato, un contrato con el PAC o un proceso interno.
Guía práctica
¿Qué información reunir antes de escribirle a soporte técnico?
Número o folio del documento afectado, junto con la fecha y hora exacta del intento de timbrado.
Captura o copia del mensaje de error completo devuelto por el PAC, no solo la notificación resumida de Odoo.
Confirmación de si el error se repite en otros documentos del mismo día o es un caso aislado.
Estatus verificado de CSD y credenciales del PAC al momento del incidente, no de una revisión de semanas atrás.
Con esta información reunida desde el primer mensaje, un diagnóstico que normalmente toma varios correos de ida y vuelta puede resolverse en una sola revisión.
Evita describir el error solo como "no timbra"; la diferencia entre un rechazo de datos, un timeout del PAC y un certificado vencido cambia por completo el tiempo y la ruta de solución.
Un reporte claro, con evidencia y contexto, es la diferencia entre un diagnóstico de minutos y uno que se alarga días enteros por falta de información.
Guía práctica
¿Cuándo el error sí es responsabilidad del PAC (y qué hacer)?
Si el mensaje de rechazo referencia directamente un servicio caído, mantenimiento programado o error interno del proveedor, corresponde reportarlo al soporte del PAC, no seguir ajustando datos en Odoo.
Documenta el incidente con capturas y horarios exactos; los PAC suelen exigir esa evidencia para reconocer una falla de su servicio y, en algunos casos, extender saldo o dar seguimiento formal.
Si el patrón se repite con cierta regularidad y no hay causa de datos ni de certificado, vale la pena evaluar con tu proveedor de Odoo si conviene revisar la integración o incluso la relación contractual con ese PAC.
Aun cuando la causa sea del PAC, es responsabilidad de tu equipo interno confirmar qué documentos quedaron pendientes de timbrar y asegurarse de que ninguno se pierda en el proceso.
Si las fallas del PAC coinciden repetidamente con periodos de alta operación (cierre de mes, campañas de venta), documenta también esa correlación; ayuda a decidir si conviene un PAC secundario de respaldo.
Un PAC de respaldo no es una solución automática: requiere configuración previa en Odoo y, en algunos casos, contrato activo con el segundo proveedor antes de que ocurra la falla, no después.
Fuentes oficiales
Referencias usadas para esta guía
Siguiente lectura
Páginas relacionadas de QUADIT
¿Necesitas llevar esto a una implementación real?
Podemos revisar tu proceso, tu configuración actual o tu plan de migración antes de comprometer presupuesto.
Solicitar diagnóstico Solicitar diagnóstico de rescate