TL;DR — Resumen Rápido

CFDI error de validación en addenda: soluciona errores de XML, namespace incorrecto y rechazo del PAC al generar facturas con addenda en Aspel SAE.

Al enviar una factura electrónica a Walmart, Liverpool o Volkswagen de México, el sistema devuelve “Error de validación en la addenda” o el portal del proveedor rechaza el CFDI indicando que la addenda no cumple el esquema esperado. Este error es frecuente cuando se configura por primera vez la addenda de un cliente nuevo o cuando el cliente actualiza sus requisitos. En este artículo explicamos qué son las addendas, por qué fallan y cómo resolverlo paso a paso en Aspel SAE y otros sistemas de facturación.

El Error

Los mensajes de error relacionados con addendas aparecen en diferentes momentos del proceso de facturación:

  • “Error de validación en la addenda” — mensaje genérico en Aspel SAE al intentar generar el CFDI
  • “Namespace no declarado” o “Prefix not bound” — el XML de la addenda referencia un namespace no definido en el encabezado del CFDI
  • “El elemento ‘Addenda’ no es válido según su DTD/Schema” — la estructura del XML no corresponde al XSD esperado por el cliente
  • “CFDI rechazado por el portal — addenda no reconocida” — el CFDI timbra correctamente con el PAC pero el portal del cliente lo rechaza en su propia validación
  • “Campo requerido ausente en addenda” — falta un elemento obligatorio definido en el XSD del cliente (por ejemplo, el número de orden de compra en la addenda de Walmart)
  • “Versión de addenda no soportada” — el cliente actualizó su XSD y tu sistema sigue generando la versión anterior

Estos errores aparecen al generar facturas desde Facturación > Facturas cuando el cliente tiene configurada la addenda, o al cargar el XML en el portal de proveedores del cliente después del timbrado.

Causa del Problema

Las addendas son extensiones XML opcionales que los grandes compradores corporativos exigen a sus proveedores para incluir información adicional no contemplada en el estándar del SAT: número de orden de compra, número de proveedor, departamento de compras, información logística, entre otros. El SAT permite su inclusión dentro del elemento <cfdi:Addenda>, pero no las valida; la responsabilidad de su correcta estructura recae en el proveedor.

Namespace incorrecto o no declarado. Cada addenda corporativa tiene su propio namespace XML (una URI que identifica el esquema). Si el namespace en tu XML no coincide exactamente con el definido en el XSD del cliente, la validación falla. Incluso una barra al final o una versión diferente en la URL lo invalida.

XSD desactualizado. Los clientes actualizan periódicamente sus requerimientos de addenda. Si tu plantilla en Aspel SAE o tu sistema fue configurado con la versión anterior del XSD, los campos nuevos obligatorios no estarán presentes y la validación fallará.

Campos requeridos ausentes o con formato incorrecto. Cada cliente define sus propios campos obligatorios. Walmart México exige el número de proveedor a 10 dígitos y el número de pedido a 10 caracteres alfanuméricos. Liverpool requiere el número de departamento. Volkswagen exige el material Audi/VW en formato específico. Si algún campo falta o tiene un formato distinto al esperado, el XSD lo rechaza.

Posición incorrecta de la addenda en el XML. La addenda debe ser el último elemento dentro de <cfdi:Comprobante>, después de todos los complementos. Algunos sistemas de facturación la insertan en la posición incorrecta, lo que invalida el XML completo.

Incompatibilidad de versión de CFDI con la addenda. Cuando se migró de CFDI 3.3 a CFDI 4.0, algunos XSD de addenda debieron actualizarse para compatibilidad. Si el cliente no actualizó su XSD o tú no actualizaste la plantilla, habrá conflictos de versión.

Solución Paso a Paso

1. Obtener el XSD y documentación vigente del cliente

Antes de cualquier configuración, ingresa al portal de proveedores de tu cliente y descarga:

  • El XSD oficial de la addenda (puede haber uno por cada tipo de documento: factura, nota de crédito, etc.)
  • La documentación de campos requeridos y sus formatos
  • Un CFDI de ejemplo con addenda correctamente formada

Si no tienes acceso al portal, contacta al equipo de cuentas por pagar de tu cliente para que te proporcionen los materiales actualizados. Nunca configures una addenda basándote en documentos de terceros no oficiales.

2. Configurar la addenda en Aspel SAE

En Aspel SAE, ve a Configuración > Facturación Electrónica > Addendas:

  1. Verifica si tu cliente aparece en la lista de addendas predefinidas
  2. Si aparece, selecciónala y completa los campos solicitados
  3. Si no aparece, usa Addenda personalizada e importa la plantilla XML del cliente
  4. Asegúrate de que los campos mapeados correspondan a los datos correctos de tus documentos

Para addendas no soportadas nativamente por Aspel SAE, muchos proveedores del cliente (o el propio cliente) ofrecen plantillas preconfiguradas o complementos que puedes instalar en SAE.

3. Validar el XML generado contra el XSD

Genera una factura de prueba y localiza el archivo XML generado (normalmente en la carpeta de comprobantes de SAE). Valídalo con estas herramientas:

Usando xmllint (línea de comandos):

xmllint --schema addenda_cliente.xsd mi_cfdi_con_addenda.xml --noout

Usando Notepad++ con XML Tools:

  1. Abre el XML en Notepad++
  2. Ve a Plugins > XML Tools > Validate Now
  3. Selecciona el XSD del cliente cuando lo solicite

En línea:

  • FreeFormatter.com > XML Validator — permite subir el XML y el XSD para validación inmediata

Corrige cada error reportado: elementos faltantes, tipos de dato inválidos (un campo numérico con letras, una fecha en formato incorrecto), atributos requeridos ausentes, o namespace mal definido.

4. Verificar la declaración del namespace

Abre el XML del CFDI con cualquier editor de texto y localiza el elemento <cfdi:Addenda>. La addenda debe declarar su namespace dentro del elemento raíz del CFDI (<cfdi:Comprobante) o en el propio elemento de la addenda:

<cfdi:Addenda>
  <wmm:WalmartMexico xmlns:wmm="http://www.walmart.com.mx/esquemas/..." version="1.0">
    <wmm:NumProveedor>1234567890</wmm:NumProveedor>
    <wmm:NumOrden>OC-2026-001</wmm:NumOrden>
  </wmm:WalmartMexico>
</cfdi:Addenda>

Compara la URI del namespace (http://www.walmart.com.mx/esquemas/...) con la que figura en el XSD descargado del cliente. Deben ser idénticas, carácter por carácter.

5. Probar en el sandbox del PAC

Antes de emitir el CFDI en producción, súbelo al ambiente de pruebas de tu PAC:

  • Finkok: portal de pruebas en sandbox.finkok.com
  • SW Sapien: ambiente demo disponible en su portal de desarrolladores
  • Edicom: sandbox disponible con tus credenciales de producción en modo prueba

El PAC validará el CFDI completo. Si la addenda causa que el XML esté mal formado, el PAC lo rechazará con un error 301 (XML mal formado). Si el PAC lo acepta pero el cliente lo rechaza, el problema es interno a la validación del portal del cliente (campos de negocio, no de estructura XML).

Solución Alternativa

Si no puedes modificar la configuración de Aspel SAE directamente, una alternativa es generar el CFDI sin addenda desde SAE y luego agregar la addenda programáticamente antes del timbrado usando un script o una herramienta de transformación XML (XSLT). Algunos integradores y despachos contables usan este flujo cuando la addenda del cliente es muy compleja o SAE no la soporta nativamente.

Otra alternativa es contratar directamente con el proveedor tecnológico autorizado del cliente. Por ejemplo, Walmart México trabaja con proveedores de EDI como GS1 México, Soltec y TCI Commerce que ofrecen soluciones de addenda ya validadas y actualizadas con los últimos requerimientos.

Prevención

  • Descarga el XSD actualizado cada vez que el cliente te notifique cambios. Los grandes compradores envían comunicados a sus proveedores cuando actualizan sus requerimientos; suscríbete a sus boletines de proveedores.
  • Valida el XML de cada nueva addenda antes de ponerla en producción. Nunca asumas que la configuración anterior funciona con una nueva versión del XSD.
  • Guarda una copia del XSD con el que fue configurada la addenda. Así puedes comparar versiones cuando el cliente reporta rechazos.
  • Prueba siempre en el sandbox del PAC antes de producción. Un CFDI con addenda mal formada rechazado en producción puede retrasar el pago de tu factura.
  • Mantén Aspel SAE actualizado. Aspel publica actualizaciones que incluyen nuevas versiones de addendas de clientes frecuentes como Walmart, Liverpool y OEMs automotrices.
  • Documenta los mapeos de campo. Registra qué campo de SAE corresponde a cada elemento de la addenda del cliente para facilitar actualizaciones futuras.

Problemas Relacionados

El CFDI timbra pero el portal del cliente lo rechaza. Este caso ocurre cuando la addenda es XML válido según el XSD pero los valores de los campos no pasan las reglas de negocio del cliente (por ejemplo, un número de pedido que no existe en su sistema ERP). Solución: verifica con el área de cuentas por pagar del cliente el error específico que muestra su sistema.

Aspel SAE no genera la addenda aunque está configurada. Verifica que en el documento (factura) el campo de “Addenda” o “Cliente con addenda” esté marcado. Algunos clientes deben estar configurados individualmente en el catálogo de clientes de SAE para que la addenda se genere automáticamente.

El PAC rechaza con error “301 - XML mal formado” solo cuando hay addenda. Esto indica que la addenda introduce caracteres inválidos en XML (como &, <, > sin escapar) o que el namespace no está correctamente declarado. Exporta el XML, ábrelo en un editor y verifica que el bloque <cfdi:Addenda> sea XML bien formado.

La addenda de VW o automotive OEM tiene campos desconocidos. Los OEMs automotrices (Volkswagen, General Motors, Stellantis) suelen requerir addendas con datos de orden de producción, materiales y plantas. Su documentación técnica es extensa; contacta directamente al área de cuentas por pagar del OEM o a su proveedor de EDI autorizado para obtener la especificación completa y ejemplos.

Resumen

  • Las addendas son extensiones XML que grandes clientes exigen en el CFDI para datos adicionales no cubiertos por el SAT
  • Los errores más comunes son: namespace incorrecto, campos requeridos ausentes, XSD desactualizado y posición incorrecta en el XML
  • Siempre descarga el XSD oficial del portal de proveedores del cliente antes de configurar la addenda
  • Valida el XML generado contra el XSD con xmllint, Notepad++ o un validador en línea antes de timbrar
  • Prueba en el sandbox del PAC antes de emitir en producción para evitar rechazos que retrasen el pago
  • Si Aspel SAE no soporta la addenda de tu cliente, considera el flujo de addenda externa o contacta al proveedor de EDI del cliente

Artículos Relacionados