← Odoo ERP Guía técnica · Cluster CFDI

¿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.

Odoo 19 SaaS 19.3 México Roadmap Odoo 20
¿Cómo resolver errores de PAC y complementos de pago en Odoo Enterprise?

Contexto oficial

Lo que sí está documentado y lo que debe validarse

La documentación de Odoo 19 dedica una sección específica a las credenciales del proveedor autorizado de certificación dentro de la configuración de facturación electrónica mexicana.
El módulo l10n_mx_edi es responsable de enviar facturas y complementos de pago al PAC según la documentación técnica del SAT, por lo que cualquier cambio en esa documentación puede afectar el timbrado si el módulo no está actualizado.
El SAT valida CFDI 4.0 con reglas más estrictas sobre datos del receptor que las versiones anteriores, lo que explica que instancias migradas sin revisión de datos maestros empiecen a fallar justo después de una actualización.
Un complemento de pago (REP) es, en términos del propio esquema, un CFDI adicional y depende de que la factura original ya esté timbrada y relacionada correctamente.
La localización mexicana también depende del catálogo de productos y servicios del SAT, que se actualiza periódicamente; una clave vigente hoy puede quedar obsoleta si el negocio no revisa el catálogo con cierta regularidad.

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.

¿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