Addenda Koblenz: cómo llenarla

Q: ¿Qué pongo si no tengo número de orden de compra?

Escribe 0 en N° de orden de compra.

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; también ve Addenda AMECE 7.1).

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.