# Addenda Koblenz para CFDI 4.0: cómo generarla

> Guía de la addenda de Koblenz (formato AMECE 7.1): identificación, orden, comprador, vendedor, moneda, líneas y totales.

Fuente: https://fiscalcloud.mx/ayuda/addenda-koblenz · Actualizado: 2026-10-09
La addenda de **Koblenz** usa el formato estándar AMECE 7.1. Contiene los datos comerciales de la factura: orden de compra, comprador, vendedor, moneda, el detalle de cada artículo y los totales. Se aplica desde la factura timbrada: menú de acciones (⋮) → **Aplicar addenda** → **Koblenz** (más detalles en [Addendas](https://fiscalcloud.mx/ayuda/addendas); también ve [Addenda AMECE 7.1](https://fiscalcloud.mx/ayuda/addenda-amece71)).

![Formulario de la addenda Koblenz](https://fiscalcloud.mx/ayuda/_r/img/ayuda/addendas/koblenz.png)

Varios campos vienen **precargados** con los valores fijos que pide Koblenz (por ejemplo `INVOICE`, `ZZZ`, `ON`, `ATZ`); déjalos como están.

## Identificación de la factura

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **Tipo (type)** | Valor fijo `SimpleInvoiceType`. | Máx. 35 caracteres. |
| **Versión de contenido** | Valor fijo `1.3.1`. | Máx. 5 caracteres. |
| **Versión de estructura** | Valor fijo `AMC7.1`. | Obligatorio. Máx. 6 caracteres. |
| **Estado del documento** | `ORIGINAL`. | Obligatorio. |
| **Fecha de creación (deliveryDate)** | Fecha de creación de la factura. | Opcional. |
| **Tipo de entidad** | Valor fijo **INVOICE = Factura**. | Obligatorio. |
| **Serie y folio (uniqueCreatorId)** | Serie y folio de la factura. | Obligatorio. Máx. 17 caracteres. |

## Instrucción especial

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **Código de instrucción especial** | Valor fijo **ZZZ**. | Obligatorio. Máx. 3 caracteres. |
| **Importe con letra (text)** | El importe total de la factura con letra. | Obligatorio. Máx. 255 caracteres. |

## Orden de compra e información adicional

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **Tipo de referencia de orden** | Valor fijo **ON**. | Obligatorio. Máx. 3 caracteres. |
| **N° de orden de compra (0 si no hay)** | Número de la orden de compra. Si no cuentas con él, escribe `0`. | Obligatorio. Máx. 35 caracteres. |
| **Fecha del pedido** | Fecha del pedido de la referencia. | Opcional. |
| **Calificador de referencia** | Valor fijo **ATZ** (N° de aprobación). | Obligatorio. Máx. 3 caracteres. |
| **Número de aprobación** | Referencia alfanumérica; valor fijo `0`. | Obligatorio. Máx. 35 caracteres. |
| **Folio RC (Almacén-Folio)** | Folio de la Recepción de Compra, formato `999-999999999` (Almacén-Folio). Corresponde a la nota de entrega. | Opcional. Máx. 35 caracteres. |

## Comprador y vendedor

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **GLN del comprador** | Código GLN del comprador. | Obligatorio en el formulario (precargado con `0000000000000`). Máx. 13 caracteres. |
| **Contacto de compras** | Nombre del comprador. | Opcional. Máx. 35 caracteres. |
| **GLN del proveedor** | Tu número global de localización (GLN). Si no lo tienes, `0000000000000`. | Obligatorio. Máx. 13 caracteres. |
| **Tipo de identificación del proveedor** | Valor fijo `SELLER_ASSIGNED_IDENTIFIER_FOR_A_PARTY`. | Obligatorio. |
| **Número interno del proveedor** | Tu número de proveedor (numérico). | Obligatorio en el formulario. Máx. 35 caracteres. |

## Destino de envío (opcional)

| Campo | Qué poner | Restricciones |
|---|---|---|
| **GLN del destino de envío** | GLN del lugar de entrega; si no lo tienes, `0000000000000`. | Máx. 13 caracteres. |
| **Nombre del destino** | Razón social de la empresa a donde se embarca. | Máx. 35 caracteres. |
| **Dirección del destino** | Domicilio de entrega. | Máx. 35 caracteres. |
| **Ciudad del destino** | Ciudad del domicilio de entrega. | Máx. 35 caracteres. |
| **Código postal del destino** | Código postal del lugar. | Máx. 15 caracteres. |

## Moneda

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **Moneda (ISO)** | MXN, USD o XEU (euro). | Obligatorio. |
| **Función de moneda** | Valor fijo `BILLING_CURRENCY`. | Obligatorio. Máx. 35 caracteres. |
| **Tipo de cambio** | Tasa de cambio de la moneda elegida. | El manual la marca obligatoria. |

## Líneas (artículos)

Es una lista de renglones: usa **＋ Agregar** para cada artículo de la factura.

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **Número de línea** | Número de secuencia de la línea. | Obligatorio. |
| **Tipo de línea** | Valor fijo `SimpleInvoiceLineItemType`. | Obligatorio. Máx. 35 caracteres. |
| **Código EAN (gtin)** | Código EAN del artículo; si no cuentas con él, `0000000000000`. | Máx. 35 caracteres. |
| **Tipo de identificación del artículo** | Valor fijo `BUYER_ASSIGNED`. | Máx. 45 caracteres. |
| **Número de parte Koblenz** | Número de parte del producto. En facturas ligadas a RCs de servicios o no-productos sin número de parte, el número de la partida en la RC. | Máx. 35 caracteres. |
| **Idioma de la descripción** | ES (español) o EN (inglés). | Opcional. |
| **Descripción del artículo** | Descripción clara del artículo. | Máx. 255 caracteres. |
| **Unidad de medida** | Unidad de medida correspondiente. | Máx. 3 caracteres. |
| **Cantidad facturada** | Cantidad (numérico). | Opcional según el manual. |
| **Precio bruto** | Precio bruto de la mercancía (numérico). | Obligatorio según el manual. |
| **Precio neto** | Precio neto de la mercancía (numérico). | Obligatorio según el manual. |
| **Tipo de información adicional (línea)** | Valor fijo de referencia. | Según el manual, obligatorio. |

Más campos:

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **Identificación de referencia (línea)** | Número de identificación del impuesto asignado al comprador por una jurisdicción de impuesto (alfanumérico). | Opcional. |
| **Tipo de impuesto (línea)** | Tipo de impuesto: VAT (IVA), GST (IEPS), LAC (ISR), AAA, AAD, FRE (exento), LOC, STT u OTH. | Obligatorio según el manual. |
| **Porcentaje de impuesto (línea)** | Porcentaje del impuesto elegido. | Obligatorio según el manual. |
| **Monto de impuesto (línea)** | Monto del impuesto. | Obligatorio según el manual. |
| **Categoría de impuesto (línea)** | TRANSFERIDO o RETENIDO. | Opcional. |
| **Monto bruto de línea** | Importe bruto de la línea. | Obligatorio según el manual. |
| **Monto neto de línea** | Importe neto de la línea. | Obligatorio según el manual. |

## Totales

| Campo | Qué poner | Obligatorio / Restricciones |
|---|---|---|
| **Monto total** | Monto de la factura. | Obligatorio según el manual. |
| **Monto base (antes de impuestos)** | Monto base. | Opcional. |
| **Tipo de impuesto (global)** | Tipo de impuesto (mismas opciones que en la línea). | Opcional. |
| **Porcentaje de impuesto (global)** | Tasa del impuesto elegido. | Opcional. |
| **Monto de impuesto (global)** | Monto del impuesto. | Opcional. |
| **Categoría de impuesto (global)** | TRANSFERIDO o RETENIDO. | Opcional. |
| **Monto a pagar** | Monto total a pagar de la factura. | Obligatorio según el manual. |

> El formulario solo bloquea el guardado en los campos marcados como obligatorios arriba; los que dicen «según el manual» no se validan, pero Koblenz los espera.

## Preguntas frecuentes

### ¿Qué pongo si no tengo número de orden de compra?
Escribe `0` en **N° de orden de compra**.

### ¿Y si no conozco mi GLN o el EAN del artículo?
Usa `0000000000000` (13 ceros).

### ¿Los valores fijos se pueden cambiar?
No es necesario: vienen precargados con lo que Koblenz pide. Solo cámbialos si Koblenz te lo indica.
