Addenda: qué es, para qué sirve y cómo se agrega al CFDI

Tu CFDI está timbrado, válido ante el SAT, y aun así Walmart no te paga. El portal de proveedores te devuelve la factura con un mensaje genérico de "documento incompleto" y nadie en el call center te sabe explicar por qué. El timbre está bien. El problema es que falta la addenda, y esa palabra no aparece en ninguna documentación del SAT porque la addenda no es asunto del SAT. Es un requisito de tu cliente.

Esto le pasa a casi todo proveedor de cadena comercial la primera vez. La factura es fiscalmente perfecta y comercialmente inservible. Este post explica qué es una addenda, por qué no es un complemento, y por qué a partir de cierto volumen no la puedes generar a mano.

Qué es una addenda

Una addenda es un bloque de información comercial que el receptor de un CFDI exige incluir dentro del XML para poder procesar el pago. No la define el SAT ni la valida el PAC: cada empresa publica su propio formato. Vive en el nodo <cfdi:Addenda>, fuera del sello digital, y solo le importa a quien te va a pagar.

Esa última frase es la clave. La addenda no tiene nada que ver con tu obligación fiscal. El SAT no la pide, no la revisa y no le interesa. Quien la pide es el área de cuentas por pagar de tu cliente, casi siempre una cadena comercial o una empresa grande, que necesita amarrar tu factura con su orden de compra para autorizar el pago en su sistema interno.

Addenda vs complemento del SAT: no son lo mismo

Aquí es donde casi todos se confunden, incluyendo equipos de desarrollo con experiencia. Un complemento (nómina, pagos, comercio exterior, carta porte) lo define el SAT, tiene un XSD publicado, lo valida el PAC al timbrar y forma parte del sello digital. Una addenda no cumple ninguna de esas cuatro cosas.

La consecuencia práctica de esa tabla: un complemento mal hecho lo detectas de inmediato porque el timbrado falla. Una addenda mal hecha la detectas días después, cuando el portal del cliente rechaza la factura o, peor, cuando el pago simplemente no llega y nadie te avisó. El error fiscal es ruidoso. El error de addenda es silencioso, y por eso es más caro.

Hay un detalle técnico que conviene fijar desde el principio. La addenda se agrega después del timbrado, no antes. El nodo <cfdi:Addenda> va al final del comprobante, después del TimbreFiscalDigital, precisamente porque no entra en la cadena original ni en el sello del SAT. Si lo metes antes de timbrar, algunos PACs lo ignoran y otros lo rechazan. El orden correcto del XML se ve así:

<cfdi:Comprobante Version="4.0" ...>
  <cfdi:Emisor .../>
  <cfdi:Receptor .../>
  <cfdi:Conceptos> ... </cfdi:Conceptos>
  <cfdi:Complemento>
    <tfd:TimbreFiscalDigital .../>   <!-- Lo agrega el PAC al timbrar -->
  </cfdi:Complemento>
  <cfdi:Addenda>
    <!-- Contenido libre, formato definido por el receptor.
         El SAT no valida nada de lo que va aquí dentro. -->
  </cfdi:Addenda>
</cfdi:Comprobante>

Lo que va dentro de <cfdi:Addenda> no tiene reglas del SAT. Tiene las reglas de tu cliente, y ese es el verdadero problema.

Qué retailers exigen addenda y por qué cada una es distinta

No existe "la addenda". Existen decenas de addendas, una por cada cadena que la pide, y entre ellas no se parecen. Walmart (que arrastra a Bodega Aurrerá y Sam's Club), Liverpool, Soriana, Chedraui, HEB, La Comer, Costco, Home Depot, Coppel y Cinépolis tienen cada una su propio esquema, su propio catálogo de campos obligatorios y su propio portal de recepción. Lo que Liverpool llama número de proveedor, Soriana lo llama de otra forma y lo coloca en otro nodo.

Los datos que casi todas piden giran alrededor de lo mismo: número de proveedor asignado por la cadena, número de orden de compra, número de entrega o remisión, y a veces el número de pedido del sistema EDI. Pero el formato exacto, los nombres de los campos, el namespace XML y las validaciones cambian por completo entre una cadena y otra. Una addenda de Walmart no sirve para Liverpool ni de chiste.

Esto importa para una decisión de arquitectura. Si le facturas a un solo cliente grande, puedes estudiar su especificación una vez y resolverlo. Si le facturas a quince cadenas distintas, mantener quince generadores de addenda sincronizados con los cambios que cada cadena publica sin avisar es un proyecto en sí mismo. La especificación de la addenda de cada retailer suele estar en su portal de proveedores, no en un estándar público, y cambia cuando a la cadena se le ocurre.

Cómo se agrega una addenda a un CFDI

El flujo correcto tiene un orden que no se puede alterar. Timbras primero, agregas la addenda después, y entregas el XML completo por el canal que el cliente exige (su portal, su EDI, o un correo a una dirección específica).

Visto de punta a punta, el ciclo de una factura con addenda se parece a esto:

El lazo de reintento entre el rechazo del portal y la corrección de la addenda es donde se va el tiempo. Cada cadena rechaza por motivos distintos y con mensajes distintos, y ese ciclo se repite por cada cliente nuevo que agregas.

Errores comunes al emitir una addenda

Cómo manejar las addendas programáticamente

A volumen bajo y un solo cliente, una addenda se resuelve estudiando su especificación y armando el XML a mano una vez. El problema aparece cuando facturas a varias cadenas: cada una con su esquema, su portal y sus cambios, y todas bloqueando pago si algo sale mal. Ahí mantener generadores propios deja de ser código y se vuelve un área de soporte permanente.

Fiscalapi resuelve la parte que no agrega valor a tu negocio: timbra el CFDI y permite inyectar la addenda con el formato de cada cadena sin que tengas que mantener un generador por cliente ni vigilar cuándo cada retailer cambia su especificación. La emisión del CFDI base, el manejo del nodo Addenda después del timbrado y los flujos de reenvío están documentados en la documentación de Fiscalapi, y los SDKs oficiales en C#, Node.js, Python, Java, PHP y Go exponen la emisión con addenda como un solo flujo. Los ejemplos en GitHub muestran el caso completo de timbrar y entregar a una cadena comercial. Si todavía estás resolviendo el timbrado base, el detalle está en la guía de timbrado de facturas.

Preguntas frecuentes sobre la addenda

Si estás por dar de alta a tu primer cliente de cadena comercial, asume que la primera factura va a rebotar y prueba con un monto pequeño antes del lote completo. La addenda es de esos requisitos que nadie te explica hasta que ya te frenaron un pago, y el proceso de timbrado es lo único de toda esta cadena que el SAT sí controla.