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
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.
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?».
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.
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
Variable
Qué contiene
Formato y notas
{idinvoice}
Número de factura
Prefactura si aún no está emitida
{status}
Estado de la factura
Número: 0 No emitida, 1 Emitir, 2 Emitida, 3 Cancelada, 4 Reclamar cobro, 5 Cobrado, 6 En proceso de cobro
{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).
05/03/2026. Si el recibo no está cobrado, sale 01/01/1970
{receipts.WAY_TO_PAY}
Forma de cobro del recibo
Texto
{receipts.COST_FORMAT}
Importe del recibo
Formateado. Con IVA
{receipts.COST}
El mismo
Sin formato. El descuadre por redondeo se suma al recibo mayor
{receipts.PORC}
Porcentaje del recibo sobre el total
Con punto decimal: 33.33
{receipts.CALC_TOT}
Total del recibo
Sin formato
{receipts.STATUS_TXT}
Estado del recibo
Texto: «Cobrado», «En proceso de cobro»…
{receipts.STATUS}
Estado del recibo
Número, como {status}
{receipts.TOTAL_CONCILIATED}
Importe conciliado con el banco
Sin formato
{receipts.ORDER_AMOUNT}
Importe entregado en TPV
Sin 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:
Variable
Qué contiene
Formato y notas
{existsCompensations}
1 si la factura tiene compensaciones
1 o 0
{totalbrutoespecie}
Suma de las líneas compensadas sin descuento
Formateado. Sin IVA
{totalCostWithDiscountCompensation}
Total compensado: suma de las líneas con IVA y menos IRPF
Formateado. 0,00 si no hay compensaciones
{averageDiscountCompensation}
Descuento medio de las líneas compensadas
Porcentaje formateado
{finalAmountToPay}
Lo que queda por pagar: total de la factura menos lo compensado
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:
Variable
Qué contiene
Formato y notas
{rebuConcepts.IDINVOICE}
Número de la factura de compra
Texto
{rebuConcepts.DATETOAPPLY}
Fecha contable de la factura de compra
Sin formato: 2026-03-05
Variables generales del REBU:
Variable
Qué contiene
Formato y notas
{isRebu}
1 si la factura es REBU y tiene líneas de compra enlazadas
1 o vacía
{totalbrutoespecieRebu}
Suma de las compras sin descuento
Formateado. Sin IVA
{totalCostWithDiscountRebu}
Suma de las compras con IVA y menos IRPF
Formateado
{finalAmountToPayRebu}
Margen REBU: total de la factura menos esa suma
Formateado
<!-- 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 uses
Usa
Por 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_tipos
Siempre 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.
Utilizamos cookies para optimizar nuestro sitio web y nuestro servicio.
Técnicas o necesarias / preferencias
Siempre activo
El almacenamiento o acceso técnico es estrictamente necesario para el propósito legítimo de permitir el uso de un servicio específico explícitamente solicitado por el abonado o usuario, o con el único propósito de llevar a cabo la transmisión de una comunicación a través de una red de comunicaciones electrónicas.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Análisis o medición
The technical storage or access that is used exclusively for statistical purposes.El almacenamiento o acceso técnico que se utiliza exclusivamente con fines estadísticos anónimos. Sin un requerimiento, el cumplimiento voluntario por parte de tu Proveedor de servicios de Internet, o los registros adicionales de un tercero, la información almacenada o recuperada sólo para este propósito no se puede utilizar para identificarte.
Publicidad comportamental
El almacenamiento o acceso técnico es necesario para crear perfiles de usuario para enviar publicidad, o para rastrear al usuario en una web o en varias web con fines de marketing similares.