Addenda Merza para CFDI 4.0: cómo generarla
Manual completo: qué datos pide la addenda de Merza, cómo agregarla a tu factura en TimbraMX paso a paso, con capturas del sistema, errores comunes y preguntas frecuentes.
Resumen rápido
- Qué es
- Datos extra que Merza pide dentro del XML (no es requisito del SAT)
- Cuándo se agrega
- Después de timbrar la factura
- Costo
- $750 MXN al año, activación inmediata
- Datos a capturar
- 20 datos (+ 1 automáticos)
¿Qué es la addenda de Merza?
Es un bloque de información adicional que Merza puede exigir dentro del XML de las facturas que le emites. No es un requisito del SAT: lo pide la empresa receptora para identificar tu compra en su sistema (por ejemplo, una orden de compra o un número de proveedor). Si no la incluyes, Merza puede rechazar tu factura.
TimbraMX ya trae la plantilla de Merza lista, así que no necesitas escribir XML ni configurar nada técnico. Confirma con tu contacto en Merza si te la exigen: la necesitas únicamente si les facturas como proveedor.
Antes de empezar
- Tener la addenda de Merza activa en tu cuenta (cuesta $750 MXN al año).
- Tener la factura ya timbrada: la addenda se agrega después, sobre el XML sellado por el SAT.
- Tener a la mano estos datos que te pide Merza: Tipo de documento, Id factura, Numero de nota de entrega, Numero de proveedor, GLN del comprador, GLN del vendedor, GLN de entrega (shipTo), Nombre de entrega, Calle de entrega, Ciudad de entrega, Codigo postal de entrega y Moneda de precio (opcional) y 8 más (están en la tabla de abajo). Si no los tienes, pídelos a tu contacto de compras o de cuentas por pagar en Merza.
Cómo agregar la addenda de Merza paso a paso
Activa la addenda en tu cuenta
Genera y timbra tu CFDI 4.0 como siempre
Abre el menú ⋮ de la factura y elige «Agregar addenda»
Elige la plantilla de Merza y llena los datos
Presiona «Generar addenda»
Descarga el XML y envíalo a Merza
Datos que pide la addenda de Merza
Esta plantilla te pide capturar 20 datos y toma 1 directamente de tu factura. Captúralos exactamente como los espera Merza; la columna «Ayuda» reproduce las indicaciones que muestra el sistema.
| Dato | Formato o valores | Ayuda |
|---|---|---|
| General | ||
| Tipo de documento | Se elige de una lista: Factura (INVOICE), Nota de credito (CREDIT_NOTE), Nota de debito (DEBIT_NOTE). | — |
| Id factura | Texto libre. | — |
| Numero de nota de entrega | Texto libre. | — |
| Comprador, vendedor y entrega | ||
| Numero de proveedor | Texto libre. | — |
| GLN del comprador | Texto libre. | — |
| GLN del vendedor | Texto libre. | — |
| GLN de entrega (shipTo) | Texto libre. | — |
| Nombre de entrega | Texto libre. | — |
| Calle de entrega | Texto libre. | — |
| Ciudad de entrega | Texto libre. | — |
| Codigo postal de entrega | Texto libre. | — |
| Moneda | ||
| Moneda de precio (opcional) | Texto libre. | — |
| Tipo de cambio de precio | Texto libre. | — |
| Moneda de pago (opcional) | Texto libre. | — |
| Tipo de cambio de pago | Texto libre. | — |
| Pago e impuestos | ||
| Dias de credito | Texto libre. | — |
| Porcentaje de IVA (transferido) | Texto libre. | — |
| Porcentaje de retencion | Texto libre. | — |
| Monto de retencion | Texto libre. | — |
| Monto a pagar (payableAmount) | Texto libre. | — |
Instrucciones especiales (filas repetibles)
Puedes agregar tantas filas como necesites con el botón «Agregar fila». Cada fila lleva:
| Dato | Formato o valores | Ayuda |
|---|---|---|
| Codigo (ej. PUR) | Texto libre. | — |
| Texto | Texto libre. | — |
Ordenes de compra (filas repetibles)
Puedes agregar tantas filas como necesites con el botón «Agregar fila». Cada fila lleva:
| Dato | Formato o valores | Ayuda |
|---|---|---|
| Numero de orden de compra | Texto libre. | — |
Informacion adicional (filas repetibles)
Puedes agregar tantas filas como necesites con el botón «Agregar fila». Cada fila lleva:
| Dato | Formato o valores | Ayuda |
|---|---|---|
| Tipo (ej. AAE, ACE, AWR) | Texto libre. | — |
| Valor | Texto libre. | — |
Cargos y descuentos (documento) (filas repetibles)
Puedes agregar tantas filas como necesites con el botón «Agregar fila». Cada fila lleva:
| Dato | Formato o valores | Ayuda |
|---|---|---|
| Tipo | Se elige de una lista: Descuento (ALLOWANCE_GLOBAL), Cargo (CHARGE_GLOBAL). | — |
| Forma de liquidacion | Se elige de una lista: BILL_BACK, OFF_INVOICE. | — |
| Codigo de servicio especial (ej. FC, FI, CAC) | Texto libre. | — |
| Porcentaje | Número. | — |
Qué datos toma TimbraMX de tu factura
No tienes que capturar: Moneda (automatico). Salen de tu CFDI ya timbrado, así que coinciden siempre con el comprobante. Además, esta plantilla incluye una tabla con los conceptos de tu factura: puedes ajustar descripción, unidad o importe de cada línea solo para la addenda, sin retimbrar.
Por cada concepto también puedes capturar: Cantidad adicional (unidades de consumo), Tipo de cargo/descuento (linea), Forma de liquidacion (linea), Codigo de servicio especial (linea), Porcentaje por unidad (linea) y Monto por unidad (linea).
Errores comunes y cómo corregirlos
Merza rechazó mi factura con addenda
Casi siempre es un dato capturado distinto al que espera su sistema (una orden de compra o un número de proveedor con otro formato). Revisa cada dato contra el que te dio Merza, corrígelo con «Modificar addenda» y vuelve a descargar el XML. Si sigue el rechazo, nuestro equipo de soporte lo revisa contigo sin costo adicional.
No veo la plantilla de Merza en el campo «Plantilla»
El selector solo muestra las addendas contratadas para tu cuenta. Revisa que la addenda esté activa y vigente (se paga por año) y que estés en la empresa correcta. Si ya pagaste y no aparece, escríbenos por el chat de soporte.
El sistema no me deja generar la addenda
TimbraMX valida los datos antes de generarla. En esta plantilla:
- Porcentaje: número.
Ya había agregado la addenda y quiero cambiarla
En el menú ⋮ de la factura la opción ahora dice Modificar addenda. Corrige los datos y genera la addenda otra vez; el CFDI timbrado sigue intacto.
Preguntas frecuentes
¿Qué datos debo capturar en la addenda de Merza?
La plantilla de Merza te pide capturar 20 datos: Tipo de documento, Id factura, Numero de nota de entrega, Numero de proveedor, GLN del comprador, GLN del vendedor, GLN de entrega (shipTo), Nombre de entrega, Calle de entrega y Ciudad de entrega y 10 más. Los demás los toma TimbraMX de tu factura. Captúralos exactamente como los espera Merza: un dato distinto es la causa más común de rechazo.
¿Aplicar la addenda de Merza consume un timbre?
No consume un timbre adicional. En TimbraMX la addenda se agrega después de timbrar: tu CFDI ya está timbrado y la addenda se anexa a una copia del XML, sin tocar el comprobante timbrado.
¿Cuánto cuesta la addenda de Merza y cuánto tarda en activarse?
La addenda de Merza cuesta $750 MXN al año. La activación es inmediata en cuanto se confirma el pago y puedes emitir tu primera factura con addenda al momento.
¿Puedo agregar la addenda a una factura que ya timbré hace días?
Sí. La addenda se agrega siempre sobre una factura ya timbrada. Abre el menú ⋮ de esa factura en Facturas, elige «Agregar addenda», selecciona la plantilla de Merza, llena los datos y genera la addenda.
¿La addenda modifica mi CFDI timbrado?
No. El CFDI original nunca se toca: TimbraMX genera una copia aparte del XML con la addenda anexada. Al descargar el XML de la factura, esa copia ya incluye la addenda.
¿Qué hago si me equivoqué en un dato de la addenda?
Abre otra vez el menú ⋮ de la factura: la opción ahora dice «Modificar addenda». Corrige el dato y genera la addenda de nuevo. También puedes quitarla desde el detalle de la factura.
¿Qué pasa si Merza rechaza la factura?
Nuestro equipo de soporte revisa el motivo del rechazo (casi siempre un dato capturado distinto al que espera el sistema de Merza) y te ayuda a corregirlo sin costo adicional.
¿La addenda de Merza funciona para notas de crédito?
Sí, la addenda se puede anexar a cualquier CFDI que emitas hacia el mismo receptor, incluidas las notas de crédito.