Variables para plantillas: facturas

Este artículo recoge las variables y los bloques que puedes usar en la plantilla de las facturas emitidas a clientes. La plantilla se usa al ver la factura en pantalla, al generar su PDF, al enviarla por correo y en la vista de facturas que tiene el cliente. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Cómo se elige la plantilla

La plantilla de factura no se da de alta en el gestor de Plantillas de documentos. Se da de alta en el Administrador de finanzas, en Ingresos > Elementos de factura > Plantillas de factura. Allí cada plantilla tiene su fichero, sus imágenes y su versión proforma. El paso a paso está en Configurar plantillas de factura.

Plantilla normal y proforma

Cada plantilla de factura tiene dos ficheros:

  • «Fichero de plantilla»: el de la factura normal.
  • «Fichero de plantilla para las proformas/prefacturas»: el de la factura proforma.

La factura usa el fichero de proforma mientras no está emitida (estados «No emitida» y «Emitir»). En ese momento todavía no tiene número, y {idinvoice} muestra el texto Prefactura. En cuanto la factura se emite, y en todos los estados posteriores («Emitida», «Cancelada», «Reclamar cobro», «Cobrado», «En proceso de cobro»), usa el fichero normal.

Si marcas «Utilizar plantilla de factura para las proformas», la factura sin emitir usa también el fichero normal y no necesitas subir otro. Las variables son las mismas en los dos ficheros: para distinguirlos dentro de una sola plantilla puedes usar {status} (ver Documento).

Las tres imágenes («Imagen de logo/cabecera», «Imagen de margen» e «Imagen de pie») funcionan igual: cada una tiene su versión para proformas y su casilla para usar la misma de la factura normal.

Qué plantilla usa cada factura

  1. La plantilla de la propia factura: el campo «Plantilla» de la ficha de la factura. Se rellena al crear la factura y puedes cambiarla después.
  2. Si la factura no tiene plantilla, o su plantilla no tiene fichero para ese estado (por ejemplo, una proforma sin «Fichero de plantilla para las proformas/prefacturas» y sin la casilla «Utilizar plantilla de factura para las proformas»), se usa la plantilla marcada «¿Es la plantilla por defecto?».
  3. Al imprimir varias facturas juntas, si la plataforma tiene activada la impresión múltiple, se usa la plantilla marcada «Múltiple», por encima de lo anterior.
  4. Si nada de lo anterior da un fichero, se usa la plantilla estándar de Yunbit.

Qué plantilla recibe la factura al crearse

  • Factura dada de alta a mano desde el gestor de facturas: la plantilla marcada «¿Es la plantilla por defecto?» o, si es rectificativa, la marcada «¿Es la plantilla por defecto de facturas rectificativas?».
  • Factura generada para un cliente (desde propuestas, pedidos o servicios): la «Plantilla de factura por defecto» de la ficha del cliente, en la pestaña «Info. financiera». Si el cliente no la tiene, la plantilla por defecto.
  • Factura de un pedido cuya oferta es de un tipo con «Plantilla de factura» rellena: la plantilla de ese tipo.

Las imágenes y el pie de página

Las imágenes siguen el mismo orden que el fichero, pero cada una por separado. Si la factura tiene plantilla, las imágenes salen solo de esa plantilla: aunque una imagen esté vacía, no se coge la de la plantilla por defecto.

El texto del pie de página no depende de la plantilla. Es el «Pie de página» elegido en la ficha de la factura, y sale en {footer}. Los pies se configuran como se explica en Configurar pies de factura/membretes.

Variables generales

Van en cualquier parte de la plantilla, fuera de los bloques.

Los importes salen formateados con los separadores y decimales de tu plataforma (normalmente 1.234,56) y sin símbolo de moneda; si quieres el símbolo, añade {symbol} detrás. Cuando una variable dice «Con pedidos», solo tiene valor en plataformas que facturan desde pedidos (venta al por menor o viajes); en las demás sale vacía.

Documento

VariableQué contieneFormato y notas
{idinvoice}Número de facturaPrefactura si aún no está emitida
{status}Estado de la facturaNúmero: 0 No emitida, 1 Emitir, 2 Emitida, 3 Cancelada, 4 Reclamar cobro, 5 Cobrado, 6 En proceso de cobro
{date}Fecha de la facturaEn español: «5 de marzo de 2026»
{date_en}Fecha de la facturaEn inglés: «March 5th, 2026»
{date_cat}Fecha de la facturaEn catalán: «5 de març de 2026»
{date_dmy}Fecha de la facturaSiempre 05/03/2026
{datetoapply}, {datetoapply_en}, {datetoapply_cat}«Fecha contable»Como {date}, {date_en} y {date_cat}
{project}Campo «Proyecto/Servicio» de la facturaTexto escrito a mano. No es el proyecto asociado: para ese, las dos siguientes
{project_code}Código del proyecto de la facturaTexto. Si la factura no tiene proyecto pero viene de un pedido, sale el del pedido. Vacía si no hay ninguno
{project_name}Nombre de ese proyectoTexto. Igual que la anterior
{observations}«Anotación sobre la factura de ingreso»Texto. Los saltos de línea no se convierten en <br>
{other_observations}«Observaciones» de la facturaTexto. Igual que la anterior
{order}«Orden de compra» del clienteTexto
{cost_center}«Centro de coste»Texto
{incoterm}IncotermTexto
{currency}MonedaCódigo, p. ej. EUR
{symbol}Símbolo de la moneda€

Cliente y contactos

El nombre y las direcciones del cliente no están aquí: están en el bloque description.

VariableQué contieneFormato y notas
{cif}CIF/NIF del clienteTexto
{clientReference}Referencia del cliente (de su ficha)Texto
{clientTels}Teléfonos del clienteTexto
{contact}Contacto de la factura: nombre y apellidoTexto
{contactemail}, {contacttelf}Correo y teléfono del contacto de la facturaTexto
{nationality}Nacionalidad del contacto de la facturaTexto
{contactreception}, {contactemailreception}, {contacttelfreception}Contacto de recepción del pedido: nombre, correo y móvilEs un usuario de la plataforma, no un contacto del cliente
{facturae_accounting_office}, {facturae_managing_body}, {facturae_processing_unit}Códigos DIR3: oficina contable, órgano gestor y unidad tramitadoraPara facturas a administraciones públicas
{clientDescription}Observaciones al cliente del pedido (o de la oferta)Con pedidos
{orderclient}, {orderclient2}«Referencia del cliente» y «Referencia del cliente 2» del pedidoCon pedidos
{ordercontact}Contacto que hizo el pedidoCon pedidos

Comercial y responsable

VariableQué contieneFormato y notas
{seller}Nombre completo del usuario que creó la facturaNo es el comercial del cliente
{seller_name}Nombre de pila de ese usuarioTexto
{agent}, {agenttelf}, {agentemail}Responsable de la oferta del pedido facturado: nombre, teléfono y correoCon pedidos, y solo si la factura es de un único pedido

Pedido, albarán y envío

Todas son «Con pedidos».

VariableQué contieneFormato y notas
{order_number}Número del pedido de la facturaVacío si la factura junta varios pedidos
{order_number_grouped}Números de todos los pedidos de las líneasSeparados por comas. Útil en facturas que agrupan pedidos
{offer_number_grouped}Números de las ofertas de esos pedidosSeparados por comas
{N_OFFER}Número de la oferta del pedidoTexto
{ORDEN_NUMBER}«Nº de Orden» del expediente del pedidoTexto
{expedition_number}Número de expediciónTexto
{pic}, {DELIVERY_NOTE}Número de albaránLas dos traen lo mismo. Si la factura tiene varios albaranes, usa {PIC} o {PICWITHDATE}
{PIC}Albaranes del primer pedido de las líneasSeparados por comas. Ojo: es distinta de {pic}
{ALB_DATE}Fechas de esos albaranes05/03/2026, separadas por comas
{PICWITHDATE}Albaranes con su fechaA123 (05/03/2026), A124 (06/03/2026)
{invoice_order_obs}«Observaciones de factura» del pedidoTexto
{shipping_company}, {shipping_service}Agencia y servicio de transporte del pedidoTexto
{shipmentType}Campo «Envío» del pedidoCódigo
{shipmentTypeName}El mismo en textoMis medios o Sus medios
{direccionEntrega}, {cpEntrega}Dirección y código postal de entregaDirección de envío de la factura o, si no tiene, la del pedido
{localidadEntrega}, {provinciaEntrega}Localidad y provincia de entregaTexto
{productProducersRecord}Número de registro de productores de producto (envases)Solo si tu empresa lo tiene y el peso de plástico no es 0
{plasticWeight}Peso total de plástico de la factura4 decimales. Misma condición que la anterior
{client_amount}, {return_amount}Importe entregado y cambio devuelto en una venta de TPVSolo en plataformas de venta al por menor (retail)

Importes y totales

Todos salen formateados y sin símbolo de moneda.

VariableQué contieneFormato y notas
{totalneto}Base imponible: suma de los importes de las líneasSin IVA
{total}Lo mismo que {totalneto}Sin IVA. No es el total de la factura
{iva}Cuota total de IVA0,00 si no hay IVA
{totalivairpf}Total de la factura: base + IVA + recargo − IRPFCon IVA. Es lo que paga el cliente
{totalbruto}Suma de precio × unidades antes de los descuentos de líneaSin IVA. No resta el descuento global
{totaldisc}Total de los descuentos de las líneasSin IVA
{globaldiscount}Importe del descuento global, en positivoSin IVA
{globaldiscountpercent}Porcentaje del descuento globalNúmero
{shippingcost}Portes: suma de las líneas marcadas como portesSin IVA. Suma el precio unitario con descuento de cada línea de portes (no lo multiplica por las unidades). Sale 0, sin decimales, si no hay portes
{totalCostWithDiscount}Importe de las líneas con descuento, con portes y sin el descuento globalSin IVA
{totalCostWithDiscountWithoutTransportFees}Importe de las líneas con descuento, sin el descuento global y sin portesSin IVA
{averageDiscount}Descuento medio de las líneasPorcentaje formateado (12,50). 0,00 si no hay descuentos

IVA

VariableQué contieneFormato y notas
{tipo_iva}Porcentaje de IVA21,00. Solo tiene valor si todas las líneas con IVA llevan el mismo tipo. Vacía si hay varios tipos o si todo va al 0 %: usa el bloque iva_por_tipos
{ivacoment}Textos de exención o comentarios de IVA de las líneasUno por tipo, separados por espacios: 21,00 % texto, o solo el texto si el tipo es 0
{qr}Código QR de Veri*factu, como imagendata:image/png;base64,…. Úsalo así: <img src="{qr}">. Solo tiene valor si Veri*factu está activo en tu empresa

Recargo de equivalencia

VariableQué contieneFormato y notas
{appliedSurcharge}1 si la factura aplica recargo de equivalencia1 o 0. Hace falta que la plataforma tenga activado el recargo y que la factura tenga marcada la casilla «Recargo equivalencia»
{surcharge}Importe del recargoFormateado. 0,00 si no se aplica
{tipo_recargo}Porcentaje de recargo5,20. Vacío si hay varios tipos

No hay desglose del recargo por tipos.

<!-- IF appliedSurcharge == 1 -->
  <tr><td>Recargo de equivalencia {tipo_recargo} %</td><td>{surcharge} {symbol}</td></tr>
<!-- ENDIF -->

IRPF

VariableQué contieneFormato y notas
{totirpf}Importe del IRPF, en negativo-150,00. 0,00 si no hay IRPF
{percentirpf}Porcentaje de IRPF de las líneas15,00. Sale 0, sin decimales, si no hay IRPF
<!-- IF totirpf != '0,00' -->
  <tr><td>Retención IRPF {percentirpf} %</td><td>{totirpf} {symbol}</td></tr>
<!-- ENDIF -->

Forma de cobro y vencimiento

VariableQué contieneFormato y notas
{way_to_pay}«Forma de cobro» de la facturaTexto: «Transferencia bancaria», «Domiciliado», «En efectivo»…
{way_to_pay_val}La mismaCódigo
{day_to_pay}Plazo de cobro, escrito (no es una fecha)Siempre en español: «30 días fecha factura», «Al contado», «Por adelantado»
{day_to_pay_en}El mismo plazo en inglés«30 days from invoice date»
{day_to_pay_cat}El mismo plazo en catalánTexto
{description_to_pay}«Comentario Plazo de Cobro» de la facturaTexto
{datetopay_es}, {datetopay_en}, {datetopay_cat}«Fecha pactada de cobro» (vencimiento de la factura)Como {date}. Vacía si la factura no la tiene
{datepay}«Fecha prevista / real cobro»Como {date}, en español

Cobros y recibos

VariableQué contieneFormato y notas
{have_receipts}1 si la factura tiene recibos1 o 0
{partial_payment}1 si tiene más de un recibo (cobro fraccionado)1 o 0
{receipts_num}, {numReceipts}Número de recibosEntero. Las dos traen lo mismo
{n_notpaid}Número de recibos pendientesEntero
{paid}Cobrado: total de la factura menos lo pendiente según la conciliación bancariaFormateado
{balancedue}Pendiente de cobro: suma de los recibos menos {paid}Formateado. Nunca negativo
{paidbyreceiptstatus}Cobrado, contando los recibos conciliados o en estado «Cobrado» o «En proceso de cobro»Formateado
{balanceduebyreceiptstatus}Suma de los recibos menos {paidbyreceiptstatus}Formateado. Puede salir negativo
{lastReceiptDayToPay}Plazo de cobro del único recibo pendiente; si hay ninguno o varios, el de la facturaTexto: «30 días», sin «fecha factura»
{lastReceiptWayToPay}Forma de cobro del único recibo pendiente; si no, la de la facturaTexto

Cuentas bancarias

VariableQué contieneFormato y notas
{bankAccountToPayFormat}IBAN del «Banco receptor» de la factura: la cuenta de tu empresa donde el cliente debe pagarEn grupos de 4 cifras
{bankNameToPay}Nombre de ese bancoTexto
{invoiceBankAccountFormat}Cuenta bancaria de la facturaEn grupos de 4 cifras. Con pedidos
{invoiceBankAccountWithAsterisk}La misma cuenta con las 4 últimas cifras cambiadas por *Con pedidos. Vacía si no hay cuenta
{bankAccountFormat}Cuenta de tu empresa elegida en la factura o, si no, la de la empresa por defectoEn grupos de 4 cifras. Con pedidos
{accountTitle}, {invoiceAccountTitle}Nombre de esas cuentasCon pedidos

Tu empresa

Los datos salen de la ficha de tu empresa en el directorio.

VariableQué contieneFormato y notas
{SENDER_SOCIALNAME}, {SENDER_CIF}Razón social y CIFTexto
{SENDER_ADDRESS}DirecciónLos saltos de línea no se convierten en <br>. Dentro del bloque description sí
{SENDER_CP}, {SENDER_LOCALIDAD}, {SENDER_COUNTRY}Código postal, localidad y paísTexto
{SENDER_TELS}, {SENDER_FAX}, {SENDER_EMAIL}Teléfono, fax y correoTexto
{footer2}Una línea con razón social, dirección, código postal, teléfono, fax, CIF y web, separados por guionesNo incluye la provincia. Los saltos de línea de la dirección no se convierten en <br>

La provincia y la web de tu empresa solo están en el bloque description.

Imágenes de la plantilla y pie de página

VariableQué contieneFormato y notas
{invoice_logo}Dirección de la «Imagen de logo/cabecera»Dirección completa, empieza por http://. Nunca está vacía, aunque no haya imagen
{invoice_margin}Ruta de la «Imagen de margen»Vacía si no hay
{invoice_bottom}Ruta de la «Imagen de pie»Vacía si no hay
{footer}Texto del «Pie de página» elegido en la facturaLos saltos de línea no se convierten en <br>

Las imágenes salen de la versión proforma o de la normal según el estado de la factura, como el fichero.

Otros

VariableQué contieneFormato y notas
{inside}1 al generar el PDF; vacía al ver la factura en el navegadorSirve para ocultar en el PDF lo que solo quieres en pantalla
{regalo}1 cuando la factura se imprime como factura regaloÚsala para ocultar los precios
{charset}Juego de caracteresUTF-8 o ISO-8859-1. Para <meta charset="{charset}">
{pdf_puppeteer}, {pdf_docraptor}1 según el servicio de PDF que use tu plataformaSirve para la numeración de páginas (ver Cuidado con)
{ydic_clave}Texto del diccionarioEn el idioma del contacto de la factura. Ver Cuidado con

Bloques

Dentro de un bloque anidado, el BEGIN y el END llevan solo el nombre corto del bloque, y las variables llevan el camino completo.

Bloque description: cabecera de la factura

Tiene una sola fila con los datos de la cabecera. Aquí están el nombre del cliente y sus direcciones, que no existen fuera del bloque.

<!-- BEGIN description -->
  <strong>{description.SOCIALNAME}</strong><br>
  CIF: {description.CIF}<br>
  {description.ADDRESS_INVOICE}<br>
  {description.PROVINCE_INVOICE}<br>
  {description.COUNTRY_INVOICE}
<!-- END description -->

Cliente y contactos

VariableQué contieneFormato y notas
{description.SOCIALNAME}Razón social del cliente (o su nombre si no tiene razón social)Texto
{description.CIF}CIF/NIF del clienteTexto
{description.CLIENT_TELS}, {description.CLIENT_REF}Teléfonos y referencia del clienteTexto
{description.ACCOUNTING_OFFICE}, {description.MANAGING_BODY}, {description.PROCESSING_UNIT}Códigos DIR3Texto
{description.NAME}, {description.TELS}, {description.EMAIL}, {description.NATIONALITY}Contacto de la factura: nombre, teléfonos, correo y nacionalidadTexto
{description.NAME_RECEPTION}, {description.TELS_RECEPTION}, {description.EMAIL_RECEPTION}Contacto de recepción del pedidoEs un usuario de la plataforma

Direcciones del cliente

El cliente tiene tres direcciones en la factura. Elige la que quieras pintar:

DirecciónVariablesFormato y notas
Dirección de envío de la factura{description.ADDRESS}, {description.CODIGO_POSTAL}, {description.LOCALIDAD}, {description.PROVINCIA}, {description.PROVINCE}, {description.COUNTRY}, {description.TADDRESS}, {description.POSTALTYPE}Es la que usa la plantilla estándar de Yunbit
Dirección de factura{description.ADDRESS_INVOICE}, {description.CODIGO_POSTAL_INVOICE}, {description.LOCALIDAD_INVOICE}, {description.PROVINCIA_INVOICE}, {description.PROVINCE_INVOICE}, {description.COUNTRY_INVOICE}, {description.POSTALTYPE_INVOICE}Los nombres de localidad, provincia y país salen siempre en español
Dirección fiscal (la dirección del cliente cuyo tipo contiene «Fiscal»){description.ADDRESS_FISCAL}, {description.CODIGO_POSTAL_FISCAL}, {description.CP_FISCAL}, {description.LOCALIDAD_FISCAL}, {description.PROVINCE_FISCAL}, {description.COUNTRY_FISCAL}CP_FISCAL es el código postal seguido de un espacio

En los tres grupos:

  • ADDRESS… ya trae los saltos de línea convertidos en <br>.
  • PROVINCE… junta código postal, localidad y provincia: «28001 Madrid - Madrid», sin repetir la provincia si coincide con la localidad.
  • COUNTRY… sale en MAYÚSCULAS.
  • TADDRESS es el tipo de dirección y POSTALTYPE… el tipo postal.

Factura

VariableQué contieneFormato y notas
{description.IDINVOICE}, {description.TITLE}Número de factura y «Proyecto/Servicio»Como {idinvoice} y {project}
{description.STATUS}EstadoComo {status}
{description.IS_RECTIFICATIVE}1 si es una factura rectificativa1 o 0
{description.applyEquivSurcharge}Casilla «Recargo equivalencia»1 o 0
{description.isRebu}Casilla «Factura REBU (Régimen Especial Bienes Usados)»1 o 0
{description.CREATED}, {description.DATETOAPPLY}, {description.DATETOPAY}, {description.DATEPAY}Fecha de factura, fecha contable, fecha pactada de cobro y fecha prevista / real de cobroSin formato: 2026-03-05. Para pintarlas, usa las fechas generales
{description.ORDER_TO_BUY}, {description.COSTCENTER}, {description.INCOTERM}Orden de compra, centro de coste e incotermTexto
{description.TIME_TO_PAYDESCRIPTION}Comentario del plazo de cobroTexto
{description.INVOICE_OBSERVATIONS}, {description.DESCRIPTION}Observaciones y anotación de la facturaTexto
{description.CALC_TOT}Total de la facturaSin formato (1234.5600), con IVA
{description.CALC_IRPF}Importe del IRPFSin formato
{description.CURRENCY}, {description.SYMBOL}Moneda de la facturaTexto
{description.CASH_CURRENCY}, {description.CASH_SYMBOL}Moneda de cajaTexto. En plataformas con varias monedas, {currency} y {symbol} traen estas
{description.FOOTER}Texto del pie de páginaComo {footer}
{description.SELLER}, {description.SELLER_NAME}Usuario que creó la facturaComo {seller} y {seller_name}
{description.ACCOUNT_TITLE_TO_PAY}, {description.ACCOUNT_IBAN_TO_PAY}Nombre e IBAN del «Banco receptor»El IBAN sale sin espacios

Tu empresa

{description.SENDER_SOCIALNAME}, {description.SENDER_CIF}, {description.SENDER_ADDRESS} (con <br>), {description.SENDER_CP}, {description.SENDER_LOCALIDAD}, {description.SENDER_PROVINCIA}, {description.SENDER_COUNTRY}, {description.SENDER_TELS}, {description.SENDER_FAX}, {description.SENDER_EMAIL}, {description.SENDER_URL} (web sin http://) y {description.SENDER_HREF} (web con http://, para un enlace).

Con pedidos

VariableQué contiene
{description.ORDER_NUMBER}, {description.ORDER_NUMBER_GROUPED}, {description.OFFER_NUMBER_GROUPED}Como {order_number}, {order_number_grouped} y {offer_number_grouped}
{description.N_OFFER}, {description.ORDEN_NUMBER}Número de oferta y «Nº de Orden» del expediente
{description.IDNUMBER}, {description.IDNUMBER2}«Referencia del cliente» y «Referencia del cliente 2» del pedido
{description.INVOICE_OBS}, {description.CLIENT_OBSERVATIONS}Observaciones de factura del pedido y observaciones al cliente
{description.EXP_NUM}, {description.PIC}Número de expedición y de albarán
{description.SHIPPING_COMPANY}, {description.SHIPPING_SERVICE}Agencia y servicio de transporte
{description.AGENT}, {description.AGENT_TEL}, {description.AGENT_EMAIL}Responsable de la oferta
{description.ORDERCONTACT}Contacto que hizo el pedido
{description.CLIENT_AMOUNT}Importe entregado en TPV (solo venta al por menor)

Bloque concepts: líneas de la factura

Repite una fila por cada línea de la factura, en el orden de las líneas (con pedidos, por albarán y posición). No incluye las líneas de ajuste de IVA.

<table>
<!-- BEGIN concepts -->
  <tr>
    <td>{concepts.TITLE}<!-- IF concepts.DESCRIPTION != '' --><br>{concepts.DESCRIPTION}<!-- ENDIF --></td>
    <td>{concepts.UNITS2Decimals}</td>
    <td>{concepts.COST_UNIT}</td>
    <td><!-- IF concepts.DISCOUNT > 0 -->{concepts.DISCOUNT_FORMAT} %<!-- ENDIF --></td>
    <td>{concepts.IVAF}</td>
    <td>{concepts.COST}</td>
  </tr>
<!-- END concepts -->
</table>

Concepto y descripciones

VariableQué contieneFormato y notas
{concepts.POS}Número de línea1, 2, 3…
{concepts.TITLE}ConceptoLos saltos de línea ya son <br>. Si el concepto lleva #_#, solo lo de delante
{concepts.TITLE2}Lo que va detrás de #_# en el conceptoTexto
{concepts.TIT1}, {concepts.TIT2}El concepto partido por el primer « - »: lo de delante y lo de detrásTIT2 vacía si el concepto no lleva « - »
{concepts.DESCRIPTION}Descripción larga de la línea. Con pedidos, si la línea no tiene, la del artículoLos saltos ya son <br>. Si la factura tiene marcada «La descripción de los conceptos es HTML», sale el HTML tal cual. Vacía si es igual al concepto
{concepts.CONCEPTDESCRIPTION}Descripción propia de la línea, sin la del artículoCon <br>. Con pedidos
{concepts.CUSTOM_DESC}Descripción personalizada del artículo en la ofertaCon pedidos
{concepts.OBSERVATIONS}Observaciones de la líneaTexto
{concepts.CONTACTCONCEPT_NAME}, {concepts.CONTACTCONCEPT_SURNAME}, {concepts.CONTACTCONCEPT_SURNAME2}Contacto asociado a la línea (por ejemplo, el asistente a un curso)Texto

Unidades, precios e importes

VariableQué contieneFormato y notas
{concepts.UNITS}UnidadesSin formato: 2.0000
{concepts.UNITS0Decimals}, {concepts.UNITS2Decimals}Unidades con 0 o 2 decimalesFormateado
{concepts.COST_UNIT}Precio unitario antes del descuentoFormateado. Sin IVA
{concepts.COST_UNIT_4Decimals}El mismo con 4 decimalesFormateado. Sin IVA
{concepts.SUBTOTAL_COST_UNIT_FORMAT}Precio unitario con descuentoFormateado. Sin IVA
{concepts.SUBTOTAL_COST_UNIT}El mismoSin formato. Sin IVA
{concepts.COST_UNIT_WITH_DISCOUNT}Importe de la línea entre las unidadesFormateado, 4 decimales. Sin IVA
{concepts.GROSS_COST_UNIT}Precio de tarifa (o el precio puesto a mano, si es mayor)Formateado. Sin IVA. En rectificativas, igual que COST_UNIT
{concepts.RATED_COST_UNIT}, {concepts.RATE_PERCENT}Precio de tarifa y porcentaje de tarifaSin formato. Sin IVA
{concepts.DISCOUNT_FORMAT}Porcentaje de descuento de la líneaFormateado
{concepts.DISCOUNT}El mismoSin formato: 10.00. Útil en condiciones: <!-- IF concepts.DISCOUNT > 0 -->
{concepts.DISCOUNTWITHDISCOUNTFROMRATE}Descuento total, sumando el de tarifa y el de la líneaFormateado
{concepts.COST}Importe de la línea: unidades × precio con descuentoFormateado. Sin IVA
{concepts.COST_WITHOUT_DISCOUNT}Unidades × precio sin descuentoSin formato. Sin IVA
{concepts.COST_WITH_VAT}Importe de la línea con IVA guardado en la líneaSin formato. Puede estar vacío
{concepts.COST_IVA}Importe de la línea con IVA, con el descuento de líneaFormateado
{concepts.UNIT_COST_IVA}Precio unitario con IVAFormateado. Antes del descuento de línea
{concepts.IVA}Porcentaje de IVASin formato: 21.00
{concepts.IVAF}Porcentaje de IVA sin decimales y con símbolo21%
{concepts.IS_TRANSPORT_FEES}1 si es una línea de portes1 o 0
{concepts.IS_GLOBAL_DISCOUNT}, {concepts.GLOBAL_DISCOUNT_PERCENT}1 si es la línea de descuento global, y su porcentaje1 o 0; número

Artículo, pedido y albarán (con pedidos)

VariableQué contieneFormato y notas
{concepts.PART_NUMBER}, {concepts.ARTICLE_NAME}Referencia y nombre del artículoTexto
{concepts.PVPR}PVP recomendado del artículoSin formato
{concepts.MUREFERENCE}Unidad de medidaTexto
{concepts.WEIGHT}, {concepts.WEIGHTTOTAL}Peso del artículo multiplicado por 1000, y ese peso por las unidades de la líneaNúmero
{concepts.SERIALNUMBERS}Números de serieTexto
{concepts.ORDER_NUMBER}Número de pedidoEn todas las líneas
{concepts.ORDER_ID}Tiene valor solo en la primera línea de cada pedidoSirve para pintar una cabecera por pedido: <!-- IF concepts.ORDER_ID != '' -->
{concepts.ORDER_DATE}Fecha del pedidoSin formato: 2026-03-05
{concepts.N_OFFER}, {concepts.ORDEN_NUMBER}Número de oferta y «Nº de Orden» del expedienteTexto
{concepts.IDNUMBER}, {concepts.IDNUMBER2}Referencias del cliente del pedidoTexto
{concepts.EXP_NUM}Número de expediciónTexto
{concepts.DELIVERY_NOTE}Número de albaránEn todas las líneas
{concepts.PIC}Número de albarán, solo cuando cambia respecto a la línea anteriorVacía si es el mismo albarán
{concepts.ALB_DATE}Fecha del albaránSin formato
{concepts.ALB_ORDER_DATE}Fecha del albarán o, si no hay, la del pedido05/03/2026
{concepts.ADDRESS}, {concepts.CODIGO_POSTAL}, {concepts.LOCALIDAD}, {concepts.PROVINCIA}, {concepts.COUNTRY}Dirección de entrega de la líneaTexto
{concepts.BLOCK_NAME}Nombre del bloque de la ofertaTexto
{concepts.ROOM}, {concepts.ENTRY_DATE}, {concepts.DEPARTURE_DATE}Habitación, fecha de entrada y fecha de salidaSolo en plataformas de alojamiento. Fechas 05/03/2026

Bloque iva_por_tipos: desglose de IVA

Repite una fila por cada tipo de IVA de la factura, ordenadas por tipo. Los tipos con base 0 no salen.

<!-- BEGIN iva_por_tipos -->
  <tr>
    <td>{iva_por_tipos.BASE}</td>
    <td>{iva_por_tipos.TIPO_SIN_DECIMALES} %</td>
    <td>{iva_por_tipos.IMPORTE}</td>
    <td>{iva_por_tipos.TOTAL}</td>
  </tr>
<!-- END iva_por_tipos -->
VariableQué contieneFormato y notas
{iva_por_tipos.TIPO}Porcentaje de IVAFormateado, 2 decimales: 21,00
{iva_por_tipos.TIPO_SIN_DECIMALES}Porcentaje de IVAFormateado, sin decimales: 21
{iva_por_tipos.BASE}Base imponible de ese tipoFormateado. Sin IVA
{iva_por_tipos.IMPORTE}Cuota de IVA de ese tipoFormateado
{iva_por_tipos.TOTAL}Base + cuota de ese tipoFormateado. Con IVA, sin recargo ni IRPF

Bloque receipts: recibos

Repite una fila por cada recibo de la factura, ordenados por fecha de vencimiento.

<!-- IF partial_payment == 1 -->
<table>
<!-- BEGIN receipts -->
  <tr>
    <td>{receipts.REAL_NUMBER}</td>
    <td>{receipts.DATETOPAY}</td>
    <td>{receipts.WAY_TO_PAY}</td>
    <td>{receipts.COST_FORMAT}</td>
    <td>{receipts.STATUS_TXT}</td>
  </tr>
<!-- END receipts -->
</table>
<!-- ENDIF -->
VariableQué contieneFormato y notas
{receipts.REAL_NUMBER}Número del recibo, empezando por 1Entero
{receipts.NUMBER}Número del recibo, empezando por 0Entero
{receipts.TITLE}, {receipts.titleReceipt}Título del reciboTexto
{receipts.IDINVOICE}Número del reciboPrefactura si la factura no está emitida
{receipts.DATETOPAY}Fecha de vencimiento05/03/2026
{receipts.DATETOPAY_es}, {receipts.DATETOPAY_en}, {receipts.DATETOPAY_cat}La misma fecha en textoComo {date}, {date_en} y {date_cat}
{receipts.DATEPAY}Fecha de cobro05/03/2026. Si el recibo no está cobrado, sale 01/01/1970
{receipts.WAY_TO_PAY}Forma de cobro del reciboTexto
{receipts.COST_FORMAT}Importe del reciboFormateado. Con IVA
{receipts.COST}El mismoSin formato. El descuadre por redondeo se suma al recibo mayor
{receipts.PORC}Porcentaje del recibo sobre el totalCon punto decimal: 33.33
{receipts.CALC_TOT}Total del reciboSin formato
{receipts.STATUS_TXT}Estado del reciboTexto: «Cobrado», «En proceso de cobro»…
{receipts.STATUS}Estado del reciboNúmero, como {status}
{receipts.TOTAL_CONCILIATED}Importe conciliado con el bancoSin formato
{receipts.ORDER_AMOUNT}Importe entregado en TPVSin formato. Solo en plataformas de venta al por menor (retail)

Bloque notpaid: recibos pendientes

Tiene las mismas variables que receipts ({notpaid.DATETOPAY}, {notpaid.COST_FORMAT}…), pero solo con los recibos pendientes: los que no tienen nada conciliado y no están en estado «Cobrado» ni «En proceso de cobro». {n_notpaid} dice cuántos hay.

<!-- IF n_notpaid > 0 -->
  Vencimientos pendientes:
  <!-- BEGIN notpaid -->
    {notpaid.DATETOPAY}: {notpaid.COST_FORMAT} {symbol}<br>
  <!-- END notpaid -->
<!-- ENDIF -->

Bloque blocks: líneas agrupadas por bloque de la oferta

Repite un grupo por cada bloque de la oferta de origen y, dentro, sus líneas. Sin pedidos hay un solo grupo, sin nombre, con todas las líneas.

<!-- BEGIN blocks -->
  <tr><th colspan="3">{blocks.name}</th></tr>
  <!-- BEGIN blocks_concepts -->
    <tr>
      <td>{blocks.blocks_concepts.TITLE}</td>
      <td>{blocks.blocks_concepts.UNITS2Decimals}</td>
      <td>{blocks.blocks_concepts.COST}</td>
    </tr>
  <!-- END blocks_concepts -->
<!-- END blocks -->
  • {blocks.name}: nombre del bloque de la oferta.
  • {blocks.blocks_concepts.…}: las mismas variables que el bloque concepts. Diferencia: aquí sí salen las líneas de ajuste de IVA.

Bloque blocksByPic: líneas agrupadas por albarán

Repite un grupo por cada albarán y, dentro, las líneas servidas en él. Solo tiene sentido con pedidos.

<!-- BEGIN blocksByPic -->
  <tr><th colspan="3">
    <!-- IF blocksByPic.pic != '' -->Albarán {blocksByPic.pic} ({blocksByPic.alb_date})<!-- ELSE -->Pendiente de servir<!-- ENDIF -->
  </th></tr>
  <!-- BEGIN blocks_concepts -->
    <tr>
      <td>{blocksByPic.blocks_concepts.TITLE}</td>
      <td>{blocksByPic.blocks_concepts.UNITS}</td>
      <td>{blocksByPic.blocks_concepts.COST}</td>
    </tr>
  <!-- END blocks_concepts -->
<!-- END blocksByPic -->
  • {blocksByPic.pic}: números de albarán del grupo, separados por comas. Vacía en el último grupo, el de las líneas que todavía no tienen albarán.
  • {blocksByPic.alb_date}: fecha del albarán, 05/03/2026.
  • {blocksByPic.blocks_concepts.…}: las mismas variables que el bloque concepts. Una línea servida en varios albaranes sale en cada uno con sus unidades. Aquí UNITS sale sin formato y COST es la parte del importe que corresponde a ese albarán.

Bloque compensationConcepts: compensación con facturas de compra

Si la factura se paga en parte con facturas de un proveedor (pago en especie), este bloque repite las líneas de esas facturas de compra.

<!-- IF existsCompensations == 1 -->
  <!-- BEGIN compensationConcepts -->
    <tr><td>{compensationConcepts.TITLE}</td><td>{compensationConcepts.COST_IVA}</td></tr>
  <!-- END compensationConcepts -->
  <tr><td>Total compensado</td><td>{totalCostWithDiscountCompensation}</td></tr>
  <tr><td>A pagar</td><td>{finalAmountToPay}</td></tr>
<!-- ENDIF -->

Variables generales de las compensaciones:

VariableQué contieneFormato y notas
{existsCompensations}1 si la factura tiene compensaciones1 o 0
{totalbrutoespecie}Suma de las líneas compensadas sin descuentoFormateado. Sin IVA
{totalCostWithDiscountCompensation}Total compensado: suma de las líneas con IVA y menos IRPFFormateado. 0,00 si no hay compensaciones
{averageDiscountCompensation}Descuento medio de las líneas compensadasPorcentaje formateado
{finalAmountToPay}Lo que queda por pagar: total de la factura menos lo compensadoFormateado

Variables de cada línea:

VariableQué contieneFormato y notas
{compensationConcepts.POS}, {compensationConcepts.TITLE}, {compensationConcepts.TITLE2}, {compensationConcepts.TIT1}, {compensationConcepts.TIT2}Número de línea y conceptoComo en concepts
{compensationConcepts.DESCRIPTION}Descripción larga del artículoCon pedidos
{compensationConcepts.UNITS}, {compensationConcepts.UNITS0Decimals}, {compensationConcepts.UNITS2Decimals}UnidadesUNITS sin formato (1 si está vacía); las otras, formateadas
{compensationConcepts.COST_UNIT}, {compensationConcepts.COST_UNIT_4Decimals}, {compensationConcepts.COST_UNIT_WITH_DISCOUNT}Precios unitariosFormateado. Sin IVA
{compensationConcepts.DISCOUNT_FORMAT}, {compensationConcepts.DISCOUNT}DescuentoFormateado / sin formato
{compensationConcepts.COST}Importe de la líneaFormateado. Sin IVA
{compensationConcepts.COST_WITHOUT_DISCOUNT}Importe sin descuentoSin formato. Sin IVA
{compensationConcepts.COST_IVA}Importe con IVA y menos IRPFFormateado
{compensationConcepts.UNIT_COST_IVA}Precio unitario con IVA y menos IRPFFormateado
{compensationConcepts.IVA}, {compensationConcepts.IVAF}Porcentaje de IVA21.00 / 21%
{compensationConcepts.IRPF}, {compensationConcepts.IRPFF}Porcentaje de IRPF15.00 / 15%
{compensationConcepts.PART_NUMBER}, {compensationConcepts.ARTICLE_NAME}, {compensationConcepts.PVPR}, {compensationConcepts.MUREFERENCE}, {compensationConcepts.WEIGHT}, {compensationConcepts.WEIGHTTOTAL}Datos del artículoCon pedidos. Como en concepts

Bloque rebuConcepts: régimen especial de bienes usados (REBU)

Solo tiene filas si la factura tiene marcada «Factura REBU (Régimen Especial Bienes Usados)» y tiene líneas de compra enlazadas. Repite esas líneas de compra.

Tiene las mismas variables que compensationConcepts ({rebuConcepts.TITLE}, {rebuConcepts.COST_IVA}…) y además:

VariableQué contieneFormato y notas
{rebuConcepts.IDINVOICE}Número de la factura de compraTexto
{rebuConcepts.DATETOAPPLY}Fecha contable de la factura de compraSin formato: 2026-03-05

Variables generales del REBU:

VariableQué contieneFormato y notas
{isRebu}1 si la factura es REBU y tiene líneas de compra enlazadas1 o vacía
{totalbrutoespecieRebu}Suma de las compras sin descuentoFormateado. Sin IVA
{totalCostWithDiscountRebu}Suma de las compras con IVA y menos IRPFFormateado
{finalAmountToPayRebu}Margen REBU: total de la factura menos esa sumaFormateado
<!-- IF isRebu == 1 -->
  <!-- BEGIN rebuConcepts -->
    <tr><td>{rebuConcepts.IDINVOICE}</td><td>{rebuConcepts.TITLE}</td><td>{rebuConcepts.COST_IVA}</td></tr>
  <!-- END rebuConcepts -->
  <tr><td>Margen</td><td>{finalAmountToPayRebu}</td></tr>
<!-- ENDIF -->

Preguntas frecuentes

¿Cómo pongo la forma de pago y el vencimiento?

{way_to_pay} es la forma de cobro («Transferencia bancaria», «Domiciliado»…). {day_to_pay} es el plazo escrito («30 días fecha factura»), no una fecha. La fecha de vencimiento de la factura es {datetopay_es} («5 de abril de 2026»). Si la factura tiene varios recibos, pinta cada vencimiento con {receipts.DATETOPAY} dentro del bloque receipts, o solo los pendientes con el bloque notpaid.

¿Cómo pongo el número de cuenta donde tiene que pagar el cliente?

Con {bankAccountToPayFormat} y {bankNameToPay}: son la cuenta y el nombre del «Banco receptor» de la factura.

¿Cómo pongo el tipo de IVA?

{tipo_iva} trae el porcentaje solo si todas las líneas llevan el mismo tipo. Si hay varios tipos, o la factura está exenta, sale vacía: usa el bloque iva_por_tipos. En cada línea, {concepts.IVAF} (21%).

¿Qué importes llevan IVA y cuáles no?

  • Sin IVA: {totalneto}, {total}, {totalbruto}, {totaldisc}, {shippingcost} y, en las líneas, COST_UNIT, SUBTOTAL_COST_UNIT_FORMAT, COST_UNIT_WITH_DISCOUNT, GROSS_COST_UNIT y COST.
  • Con IVA: {totalivairpf} (total de la factura), {iva_por_tipos.TOTAL} y, en las líneas, COST_IVA (importe de la línea) y UNIT_COST_IVA (precio unitario, antes del descuento).
  • Solo el IVA: {iva} e {iva_por_tipos.IMPORTE}.

¿Cómo pongo el importe de cada línea con IVA?

Con {concepts.COST_IVA}, dentro del bloque concepts: es el importe de la línea con el descuento de línea y con su IVA, ya formateado (1.210,00). El mismo importe sin IVA es {concepts.COST}.

¿Puedo poner lo que ya ha pagado el cliente y lo que le queda?

Sí. {paid} es lo cobrado según la conciliación bancaria y {balancedue} lo pendiente. Si prefieres contarlo por el estado de los recibos, usa {paidbyreceiptstatus} y {balanceduebyreceiptstatus}. El detalle de cada recibo está en los bloques receipts (con STATUS_TXT y DATEPAY) y notpaid.

¿Hay una variable con el comercial del cliente?

No. {seller} es el usuario que creó la factura. Con pedidos, {agent}, {agenttelf} y {agentemail} son el responsable de la oferta del pedido, si la factura es de un solo pedido.

¿Y con el proyecto?

Sí: {project_code} es el código del proyecto de la factura y {project_name} su nombre. Si la factura no tiene proyecto pero viene de un pedido, salen los del pedido. No confundir con {project}, que es el texto del campo «Proyecto/Servicio».

¿Cómo pinto la descripción larga de cada línea?

Con {concepts.DESCRIPTION}. Con pedidos, si la línea no tiene descripción, trae la descripción larga del artículo. Sale vacía cuando es igual al concepto, así que no se repite.

¿Puedo poner el pedido y el albarán de cada línea?

Solo con pedidos: {concepts.ORDER_NUMBER}, {concepts.DELIVERY_NOTE}, {concepts.ALB_ORDER_DATE} y {concepts.IDNUMBER}. Para una cabecera por pedido, usa <!-- IF concepts.ORDER_ID != '' -->. Para agrupar por albarán, el bloque blocksByPic. Sin pedidos, las líneas no tienen datos de pedido ni de albarán.

¿Cómo pongo el nombre y la dirección del cliente?

Dentro del bloque description: {description.SOCIALNAME} y la dirección que quieras (de envío, de factura o fiscal). Fuera del bloque no existen.

¿Cómo pongo el código QR de Veri*factu?

Con <img src="{qr}">. Solo tiene valor si Veri*factu está activo en tu empresa; envuélvelo en <!-- IF qr != '' --> para no dejar una imagen rota.

Nombres que no debes usar

No usesUsaPor qué
{receipts.DATE_TO_PAY}, {receipts.DATE_PAY}{receipts.DATETOPAY} (vencimiento) y {receipts.DATEPAY} (cobro)Con guiones bajos no existen y salen vacías
{datetopay}{datetopay_es}, {datetopay_en} o {datetopay_cat}Sin el idioma detrás no existe
{description_to_pay_en}{description_to_pay}No existe
{totalCostWithDiscount} como total compensado{totalCostWithDiscountCompensation}Es el importe de las líneas de la factura
{defaultiva}{tipo_iva} o el bloque iva_por_tiposSiempre vale 16
{shipping_cost}{shippingcost}Siempre sale 0,00
{ivacoment_en}{ivacoment}Siempre sale vacía
{agentfax}{agenttelf}Siempre sale vacía
{dic_clave}, {dics_clave}, {lang}{ydic_clave}, {ydics_clave}En la factura no funcionan: salen vacías

Cuidado con

  • Textos traducidos. En la factura solo funcionan los textos {ydic_…}: {ydic_invoicedate}, {ydic_invoicedate:u} en mayúsculas. Las {dic_…} salen vacías. Los textos, los países y las formas de cobro salen en el idioma del contacto de la factura: en inglés si su idioma es inglés y en español con cualquier otro. Si el contacto no tiene idioma, en el de quien imprime. Si necesitas una factura siempre en inglés, usa las variables _en (fechas y plazo) y escribe los textos fijos en la plantilla.
  • Condiciones con importes. Los importes son texto con coma decimal (1.234,56, 0,00), y > 0 no funciona bien con ellos: 0,00 cuenta como mayor que 0 y -150,00 no. Para saber si hay importe, compara con el texto: <!-- IF iva != '0,00' -->, <!-- IF totirpf != '0,00' -->. Si partes de la plantilla estándar de Yunbit, cambia así sus condiciones de IVA e IRPF. Las variables sin formato (concepts.DISCOUNT, concepts.IVA) sí admiten > 0.
  • **{total} no es el total.** Es la base imponible, igual que {totalneto}. El total de la factura es {totalivairpf}.
  • Saltos de línea. {footer}, {observations}, {other_observations}, {footer2} y {SENDER_ADDRESS} traen los saltos de línea sin convertir en <br>. Ponles el estilo white-space: pre-line. En cambio, concepts.TITLE, concepts.DESCRIPTION, concepts.CONCEPTDESCRIPTION y las direcciones del bloque description ya traen <br> (o HTML, si la factura tiene marcada «La descripción de los conceptos es HTML»).
  • Logo. {invoice_logo} siempre empieza por http://, aunque no haya imagen, así que <!-- IF invoice_logo != '' --> siempre es verdadero. Si tu plataforma va por https, algunos navegadores bloquean esa imagen en la vista en pantalla.
  • Recibos sin cobrar. {receipts.DATEPAY} sale 01/01/1970. Píntala solo si el recibo está cobrado: <!-- IF receipts.STATUS == 5 -->.
  • Fechas. Si tu plataforma tiene configuradas las fechas cortas en las facturas, {date} y las demás fechas en texto salen como 5/3/2026. Si quieres un formato fijo, usa {date_dmy} o {receipts.DATETOPAY}.
  • Varias facturas en un documento. Al imprimir varias facturas juntas, de la segunda en adelante se quita todo lo que hay antes de <body> y después de </body>. Pon los estilos y los scripts en el <head>.
  • Numeración de páginas en el PDF. Si {pdf_puppeteer} vale 1, usa <span class="nPage"></span> y <span class="nPages"></span>. Si {pdf_docraptor} vale 1, el contador de CSS counter(page).
  • Llaves en CSS y JavaScript. El motor borra cualquier {palabra} que no sea una variable. Lo explica la portada de la serie.

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Última actualización: 16 de noviembre del 2026, 09:19h
« Volver atrás Sugerencias Imprimir

    Sugerencias

    Envíenos sus sugerencias para esta sección, ya sean mejoras en su funcionalidad, usabilidad o contenido. Valoraremos su opinión y comentarios e intentaremos mejorar en la medida de lo posible. Gracias por utilizar nuestros servicios.

    Nota: Todos los campos son obligatorios.

    Información básica sobre protección de datos

    La entidad responsable del tratamiento es YUNBIT, S.L. La finalidad para la cual se recaban los datos es recabar información para mejorar esta wiki. La legitimación para captar la información es el propio consentimiento del interesado al enviar la sugerencia. Los datos no serán cedidos a terceros, salvo obligación legal. Los usuarios disponen del derecho a acceder, rectificar y suprimir los datos, así como otros derechos, como se explica en la información adicional. Puede consultar la información adicional y detallada sobre Protección de Datos aquí: Política de privacidad

    Otros artículos de la categoría Configurar plantillas

    Out1