Este artículo recoge todas las variables que puedes usar en las plantillas de ofertas, de ofertas de alquiler y de propuestas. La oferta y la oferta de alquiler se imprimen desde la ficha de la oferta, con el botón de vista previa o al generar el PDF, y comparten las mismas variables. La propuesta es otro documento, que se imprime desde la ficha de Propuestas, y tiene variables propias: están en el apartado Propuestas. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.
Las plantillas de oferta se dan de alta en el gestor de Plantillas, como explica Gestor de plantillas de documentos, con «Aplica a» = Ofertas. No uses «Propuestas» para una plantilla de oferta: esas solo valen para el documento Propuesta.
Cuando imprimes una oferta, Yunbit usa la primera plantilla que encuentra en este orden:
La del campo «Plantilla» de la propia oferta. Al crear la oferta y elegir el cliente, este campo se rellena solo: con la «Plantilla de oferta» de la ficha del cliente o, si el cliente no tiene, con la «Plantilla de oferta» del tipo de oferta. La plantilla queda guardada en la oferta: si después cambias la del cliente o la del tipo, la oferta conserva la suya.
Si la oferta no tiene plantilla, la «Plantilla de oferta» del tipo de oferta, siempre que sea de la misma empresa que la oferta.
Si el tipo tampoco tiene: en un tipo de alquiler, la plantilla marcada por defecto con «Aplica a» = Ofertas alquiler; en un tipo de intervenciones, la marcada por defecto con «Aplica a» = Intervenciones.
Si no hay ninguna de las anteriores, la plantilla marcada por defecto con «Aplica a» = Ofertas de la empresa que emite la oferta.
Si tampoco hay, la plantilla estándar de Yunbit.
Más detalles:
En la ficha del cliente y en la del tipo de oferta solo puedes elegir plantillas «Ofertas».
En el campo «Plantilla» de la oferta salen las plantillas «Ofertas» de la misma empresa. Al modificar una oferta de un tipo de alquiler salen también las «Ofertas alquiler». Las plantillas marcadas como «Antigua» dejan de salir al modificar.
No hay una plantilla por defecto para cada cliente. Para que un cliente tenga la suya, ponla en el campo «Plantilla de oferta» de su ficha.
Imágenes. La «Imagen de logo/cabecera», la «Imagen de margen» y la «Imagen de pie» se buscan por separado del fichero. Si la plantilla de la oferta no tiene logo, se usa el de la plantilla por defecto. Para que no salga ningún logo, quítalo también de la plantilla por defecto o no uses {proposal_logo}.
Mostrar artículos ocultos. Si la plantilla de la oferta tiene esta opción a «Sí», salen también las líneas con «Mostrar en oferta» = «No». Si la oferta no tiene plantilla, se mira la opción de la plantilla por defecto.
Ofertas de alquiler
Una plantilla «Ofertas alquiler» tiene las mismas variables y bloques que una de oferta. Solo cambia cuándo se usa:
Se usa por defecto cuando la oferta no tiene plantilla, su tipo no tiene «Plantilla de oferta» y el tipo es de alquiler (paso 3).
Si no hay ninguna plantilla «Ofertas alquiler» marcada por defecto, se usa la de «Ofertas» marcada por defecto.
No se puede poner en la ficha del cliente ni en la del tipo de oferta. En la oferta solo se puede elegir al modificarla.
No hay una plantilla estándar de alquiler: si no encuentra ninguna, sale la estándar de oferta.
En las líneas de alquiler te interesan sobre todo {blocks.concepts.ENTRY_DATE} y {blocks.concepts.DEPARTURE_DATE} (inicio y fin del alquiler) y {blocks.concepts.SERIALNUMBER} (la unidad alquilada).
Variables generales
Estas variables se pueden usar en cualquier parte de la plantilla, dentro o fuera de los bloques.
Formatos de los números en las tablas:
Número: con el formato numérico de tu instalación (normalmente dos decimales, coma decimal y punto de miles: 1.234,50).
Número con coma: siempre con coma decimal y punto de miles, sea cual sea la configuración.
Sin formato: el valor tal cual está guardado, con punto decimal y sin separador de miles (1234.5). Es el que sirve para comparar en un <!-- IF … -->.
Ningún importe lleva el símbolo de moneda: escribe € o {symbol} detrás.
Documento
Variable
Qué contiene
Formato y notas
{offer_num}
Número de la oferta.
Texto.
{proposaltitle}
«Nombre de oportunidad» de la oferta.
Texto. No es el número de oferta.
{date}
Fecha de la oferta.
«13 de noviembre de 2026», siempre en español. Si la oferta no tiene fecha, sale la de hoy.
{date_simple}
Fecha de la oferta.
dd/mm/aaaa.
{date_en}
Fecha de la oferta en inglés.
«November 13th, 2026».
{observations}
«Observaciones» de la oferta.
Texto.
{observations_client}
«Observaciones al cliente».
Texto.
{private_observations}
«Observaciones internas».
Texto. No la pongas en un documento que vaya a ver el cliente.
{project_code}
Código del proyecto de la oferta.
Texto. Vacía si la oferta no tiene proyecto.
{project_name}
Nombre del proyecto de la oferta.
Texto. Vacía si la oferta no tiene proyecto.
Cliente y contacto
Variable
Qué contiene
Formato y notas
{clientSocialName}
Razón social del cliente.
Texto.
{cif}
NIF del cliente.
Texto.
{clientReference}
«Referencia cliente» de la oferta.
Texto.
{clientFax}
Fax del cliente.
Texto.
{contact}
Nombre y apellidos del contacto de la oferta.
Texto.
{contacttelf}
Teléfono del contacto.
Si el contacto no tiene, sale el del cliente.
{contactemail}
Correo electrónico del contacto.
Texto.
Las direcciones del cliente (fiscal y de entrega) están en el bloque description.
Comercial
En la oferta hay dos personas distintas: el propietario de la oferta (campo «Propietario») y el responsable de la ficha del cliente.
Variable
Qué contiene
Formato y notas
{agent}
Nombre y apellidos del propietario de la oferta.
Texto.
{agentname}
Nombre de pila del propietario de la oferta.
Texto.
{agenttelf}, {agentmob}, {agentemail}
Teléfono, móvil y correo del propietario de la oferta.
Texto.
{offerOwnerBarcode}
Código de barras del usuario propietario de la oferta.
Texto (el código, no la imagen).
{agentowner}
Nombre y apellidos del responsable de la ficha del cliente.
Teléfono, móvil y correo del responsable del cliente.
Texto.
Importes y totales
Variable
Qué contiene
Formato y notas
{grosstotal}
Suma de cantidad × precio de venta de todas las líneas, sin ningún descuento.
Número. Sin IVA y sin transporte. {grosstotalNoDiscount} trae lo mismo.
{grosstotalwithdiscount}
Suma de los importes de línea con el descuento de cada línea, antes del descuento global.
Número. Sin IVA y sin transporte. Si la oferta tiene guardado el total con descuento, sale ese.
{grossTotalWithDiscountWithoutGlobalDiscount}
Lo mismo que la anterior, pero siempre sumando línea a línea.
Número. Sin IVA y sin transporte.
{offerdiscount}
Porcentaje de descuento global de la oferta.
Número (10,00). Es un porcentaje: escribe % detrás, no €.
{offerDiscount}
Porcentaje de descuento global.
Sin formato (10.00). Fíjate en la «D» mayúscula.
{amountDiscount}
Importe del descuento global.
Número. Sin IVA.
{TOT_DISCOUNT_CONCEPTS}
Suma de los descuentos de línea, en importe.
Número con dos decimales. Sin IVA.
{totaldisc}
Descuentos de línea más descuento global, en importe.
Número positivo. Sin IVA.
{totaldiscPrice}
Lo mismo que {totaldisc}, en negativo.
Número negativo. Sin IVA.
{shipping_cost}
Gastos de transporte.
Número con coma, dos decimales. Sin IVA.
{totalnetowithoutshipping}
Base imponible sin el transporte: líneas menos el descuento global.
Número. Sin IVA.
{totalneto}
Base imponible de la oferta, con el transporte dentro.
Número. Sin IVA. Es la que usa la plantilla estándar.
{total}
Base imponible, con el transporte dentro.
Número. Sin IVA. Normalmente igual que {totalneto}.
{iva}
Cuota total de IVA, incluido el IVA del transporte.
Número.
{iva_perc}
Porcentaje medio de IVA: cuota de IVA dividida entre la base.
Número.
{tipo_iva}
Porcentaje de IVA de la oferta.
21,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 %: entonces usa el bloque iva_por_tipos.
{totalivairpf}
Total a pagar: base imponible + IVA + recargo de equivalencia si lo hay.
Número. Con IVA. Aunque el nombre diga IRPF, la oferta no resta IRPF.
{totalivairpfwithoutsurcharge}
Total a pagar sin el recargo de equivalencia.
Número. Con IVA.
{TOTAL_SURCHARGE}
Recargo de equivalencia total.
Número con dos decimales. Sale 0,00 si el cliente no lleva recargo.
{totalunits}
Suma de las cantidades de todas las líneas.
Sin formato.
{blocks_num}
Número de bloques (agrupaciones) de la oferta.
Entero. Las líneas que no están en ningún bloque cuentan como un bloque más.
El desglose del IVA por tipos está en el bloque iva_por_tipos.
Pago
Variable
Qué contiene
Formato y notas
{waytopay_lamb}
Forma de pago de la oferta, traducida.
Texto. Sale para Efectivo, Transferencia, Domiciliado, Por tarjeta, Pagaré, Talón, Confirming, Carta de crédito, Cheque, Leasing, Renting y PayPal. Para otras formas (CESCE, American Express, Vale, Contrarreembolso, Financiación, Bizum, Bono…) sale vacía: escribe el texto con una condición sobre {way_to_pay_val}.
{way_to_pay_val}
Código de la forma de pago.
Código corto (un número o una letra). Sirve para las condiciones.
Pie con los datos de tu empresa en una línea: razón social, dirección, código postal, localidad, provincia, teléfono, fax, NIF y web, separados por guiones.
Texto.
El correo de tu empresa solo está dentro del bloque description: {description.MAIL_PRIMECONTRACTOR}.
Imágenes de la plantilla
Variable
Qué contiene
Formato y notas
{proposal_logo}
Dirección de la «Imagen de logo/cabecera» de la plantilla.
Vacía si no hay imagen.
{proposal_margin}
Dirección de la «Imagen de margen».
Vacía si no hay imagen.
{proposal_bottom}
Dirección de la «Imagen de pie».
Vacía si no hay imagen.
Estas variables traen solo la dirección de la imagen: escribe tú la etiqueta <img>.
<!-- IF proposal_logo != '' --><img src="{proposal_logo}" alt="Logo"><!-- ENDIF -->
Cualquier otra imagen tiene que ir con su dirección web completa o incrustada en la plantilla (data:).
Venta de vehículos
Para ofertas de venta de vehículos que se pagan en parte con un vehículo de cambio (enlazado a la oferta con un pedido de compra).
Variable
Qué contiene
Formato y notas
{plate_number}
Matrícula del vehículo de cambio.
Texto.
{vehiclePVPPrice}
Suma del precio de tarifa unitario con IVA de las líneas que no son de artículos genéricos.
Número con coma. Con IVA. No multiplica por la cantidad. {totalPrice} trae lo mismo.
{vehiclePVPRate}
Suma del precio de venta unitario con IVA de las líneas que no son de artículos genéricos.
Número con coma. Con IVA. No multiplica por la cantidad.
Otros
Variable
Qué contiene
Formato y notas
{symbol}
Símbolo de moneda configurado en tu instalación.
Texto. Es siempre el mismo, sea cual sea la moneda de la oferta.
{charset}
Juego de caracteres del documento.
UTF-8. Para <meta charset="{charset}">.
{inside}
Vale 1 al generar el PDF y sale vacía en la vista previa.
Sirve para que algo salga solo en el PDF.
{pdf_puppeteer}, {pdf_docraptor}
Programa con el que tu instalación genera los PDF.
1 en el que se usa y vacía en el otro. Sirve para cargar una hoja de estilos u otra.
{dics_day}
La palabra «días».
Texto en minúsculas, en el idioma del usuario.
Bloques
La oferta tiene cuatro bloques:
description una vuelta: los datos de la oferta
blocks una vuelta por cada bloque (agrupación) de la oferta
└─ concepts una vuelta por cada línea del bloque
iva_por_tipos una vuelta por cada tipo de IVA
Datos de la oferta (description)
Una sola vuelta con los datos de la oferta, del cliente y de las direcciones. Las variables de este bloque solo funcionan dentro de<!-- BEGIN description --> … <!-- END description -->. Fuera salen vacías.
<!-- BEGIN description -->
<p>{description.SOCIALNAME}<br>
{description.ADDRESS_FISCAL}<br>
{description.CP_FISCAL} {description.LOCALIDAD_FISCAL} ({description.PROVINCE_FISCAL})</p>
<!-- END description -->
Los valores salen tal como están guardados, sin formato, salvo donde se indica.
blocks da una vuelta por cada bloque (agrupación de líneas) de la oferta. Las líneas que no están en ningún bloque van juntas en un bloque sin nombre. Dentro de cada bloque, concepts da una vuelta por cada línea. Los bloques salen en el orden de la oferta y, dentro de cada bloque, las líneas también.
<table>
<!-- BEGIN blocks -->
<!-- IF blocks.NAME != '' -->
<tr><th colspan="4">{blocks.NAME}</th></tr>
<!-- ENDIF -->
<!-- BEGIN concepts -->
<tr>
<td>{blocks.concepts.PART_NUMBER}</td>
<td>{blocks.concepts.TITLE}</td>
<td>{blocks.concepts.UNITS}</td>
<td>{blocks.concepts.COSTUNITWVAT} €</td>
<td>{blocks.concepts.COST} €</td>
</tr>
<!-- END concepts -->
<tr><td colspan="4">Subtotal</td><td>{blocks.TOTAL} €</td></tr>
<!-- END blocks -->
</table>
Variables del bloque
Variable
Qué contiene
Formato y notas
{blocks.NAME}
Nombre del bloque.
Texto. Vacío en el bloque de las líneas sueltas.
{blocks.TOTAL}
Subtotal del bloque: suma de los importes de sus líneas con el descuento de línea.
Número. Sin IVA y sin el descuento global.
Qué líneas salen
Solo salen las líneas con «Mostrar en oferta» = «Sí», salvo que la plantilla tenga «Mostrar artículos ocultos» = «Sí».
Una línea de la que solo hay stock para una parte puede salir en dos filas: una con la cantidad que hay en stock y otra con la que falta. Pasa cuando las dos partes tienen distinto precio o distinto plazo de entrega. {blocks.concepts.NO_STOCK} te dice cuál es cada fila.
Precios e importes de la línea
Variable
Qué contiene
Formato y notas
{blocks.concepts.COSTUNITWVAT}
Precio unitario con el descuento de línea.
Número con coma, dos decimales. Sin IVA, aunque el nombre parezca decir lo contrario. Es el «Precio» de la plantilla estándar.
Una vuelta por cada tipo de IVA de la oferta. Las bases se reparten para que su suma sea exactamente la base imponible de la oferta, y el transporte va dentro de la base de su tipo.
<table>
<!-- BEGIN iva_por_tipos -->
<tr>
<td>{iva_por_tipos.TIPO} %</td>
<td>{iva_por_tipos.BASE} €</td>
<td>{iva_por_tipos.IMPORTE} €</td>
</tr>
<!-- END iva_por_tipos -->
</table>
Variable
Qué contiene
Formato y notas
{iva_por_tipos.TIPO}
Porcentaje de IVA.
Número (21,00).
{iva_por_tipos.BASE}
Base imponible de ese tipo.
Número. Sin IVA.
{iva_por_tipos.IMPORTE}
Cuota de IVA de ese tipo.
Número.
{iva_por_tipos.TOTAL}
Base más cuota de ese tipo.
Número. Con IVA.
Preguntas frecuentes
¿Cómo pongo la forma de pago?
Con {waytopay_lamb}, en minúsculas: es la forma de pago de la oferta, traducida. Si tu forma de pago no está en la lista de la tabla Pago, escribe el texto con una condición sobre el código: <!-- IF way_to_pay_val == 'X' -->Mi forma de pago<!-- ENDIF -->, cambiando X por el código. El plazo de pago es {timetopay_lamb}.
¿Hay una variable para la fecha de vencimiento?
No. La oferta no calcula vencimientos ni pagos. Lo más parecido es el plazo de pago, {timetopay_lamb}.
¿Y para la validez de la oferta?
No hay ninguna que salga de la oferta. Escribe la validez como texto fijo en la plantilla.
¿Cómo pongo el tipo de IVA?
Con {tipo_iva}, que trae el porcentaje (21,00) cuando todas las líneas llevan el mismo tipo. Si hay varios tipos sale vacía: usa el bloque iva_por_tipos, que da una fila por tipo. En cada línea, {blocks.concepts.IVA}.
¿Qué importes llevan IVA y cuáles no?
Precio unitario sin IVA: {blocks.concepts.COSTUNITWVAT} (con el descuento de línea) o {blocks.concepts.COSTUNIT_WITHOUTVAT_FORMAT_2DECS} (sin descuento).
Precio unitario con IVA: {blocks.concepts.UNITCOSTWITHVAT}, solo si la línea no tiene descuento.
Importe de la línea: {blocks.concepts.COST} sin IVA, {blocks.concepts.COSTWITHVAT} con IVA y {blocks.concepts.COSTVAT} la cuota.
Base imponible: {totalneto}, sin IVA y con el transporte dentro.
Cuota de IVA: {iva}. Total a pagar: {totalivairpf}.
Transporte: {shipping_cost}, sin IVA.
¿Qué variable es la del comercial?
{agent}, {agentname}, {agentemail}, {agenttelf} y {agentmob} son del propietario de la oferta. Las que empiezan por {agentowner…} son del responsable de la ficha del cliente, que puede ser otra persona. La plantilla estándar usa las del responsable del cliente.
¿Puedo poner el proyecto de la oferta?
Sí: {project_code} es el código del proyecto y {project_name} su nombre. Salen vacías si la oferta no tiene proyecto.
¿Cómo saco la descripción larga de cada línea?
{blocks.concepts.CUSTOM_LONG_DESC} es la escrita en la línea de la oferta y {blocks.concepts.LONG_DESCRIPTION} la de la ficha del artículo. Para sacar la de la línea y, si está vacía, la del artículo:
Para la descripción corta, lo mismo con CUSTOM_DESC y SHORT_DESCRIPTION.
¿Dónde están la dirección del cliente y su nombre comercial?
Las direcciones fiscal y de entrega están en el bloque description. El nombre comercial del cliente no llega a la plantilla; usa la razón social, {clientSocialName}.
¿Cómo pongo el número de página?
No hay variable. La plantilla estándar lo resuelve con los estilos de impresión: si partes de ella, conserva esa parte.
Propuestas
La propuesta es otro documento, que se imprime desde la ficha de Propuestas. Sus plantillas se dan de alta con «Aplica a» = Propuestas y tienen variables propias. Algunas se llaman igual que en la oferta, pero muchas de la oferta no existen en la propuesta.
Cómo se elige la plantilla de una propuesta
La del campo «Plantilla» de la propuesta. Solo salen las plantillas «Propuestas» de la misma empresa.
Si la propuesta no tiene plantilla, cualquier plantilla de la empresa marcada por defecto, sea del tipo que sea. Si la empresa tiene marcada por defecto una plantilla de ofertas, de pedidos o de etiquetas, la propuesta puede salir con ella. Por eso conviene poner siempre la plantilla en la propuesta.
Si no hay ninguna, la plantilla estándar de propuestas.
Las imágenes de la plantilla llegan igual que en la oferta: {proposal_logo}, {proposal_margin} y {proposal_bottom}. La opción «Mostrar artículos ocultos» no hace nada en las propuestas.
Variables generales de la propuesta
Documento
Variable
Qué contiene
Formato y notas
{idproposal}
Código de la propuesta.
Texto.
{proposaltitle}
Título de la propuesta.
Texto.
{date}
Fecha de alta de la propuesta.
«05 de marzo de 2026», en español.
{date_simple}, {date_en}
Fecha de alta.
dd/mm/aaaa / en inglés.
{date_sale}
«Fecha de venta» de la propuesta.
«05 de marzo de 2026», en español.
{date_sale_simple}, {date_sale_en}
«Fecha de venta».
dd/mm/aaaa / en inglés.
{observations}
Observaciones.
Texto.
{conditionspay}
«Condiciones de pago».
Texto.
{requirements_client}
«Necesidades por cuenta del cliente».
Texto.
{validtime}
«Validez de la oferta» escrita en la propuesta.
Entero, sin unidad. {validtime_en} trae lo mismo.
{timetodeliver}
«Plazo de entrega» de la propuesta.
Entero, sin unidad. {timetodeliver_en} trae lo mismo.
{warranty}
«Garantía» de la propuesta.
Entero, sin unidad. {warranty_en} trae lo mismo.
Cliente, contacto y comerciales
Variable
Qué contiene
Formato y notas
{cif}
NIF del cliente.
Texto.
{contact}
Nombre y apellidos del contacto de la propuesta.
Texto.
{contactname}
Solo el nombre del contacto.
Texto.
{contacttelf}
Teléfono del contacto o, si no tiene, el del cliente.
Texto.
{contactemail}
Correo del contacto.
Texto.
{agent}, {agenttelf}, {agentemail}
Usuario que creó la propuesta («Creado por»): nombre completo, teléfono y correo.
Texto.
{sales}, {salestelf}, {salesemail}
«Comercial» de la propuesta: nombre completo, teléfono y correo.
Texto.
La razón social del cliente y las direcciones están en el bloque description de la propuesta.
Pago
Variable
Qué contiene
Formato y notas
{waytopay}
Forma de pago de la propuesta, traducida.
Texto. En la propuesta sí funciona. Sale para las mismas formas de pago que {waytopay_lamb} en la oferta.
description una vuelta: los datos de la propuesta
concepts una vuelta por cada concepto (no va dentro de otro bloque)
deliverables una vuelta por cada entregable
description de la propuesta
Una sola vuelta. Las variables solo funcionan dentro de <!-- BEGIN description --> … <!-- END description --> y salen tal como están guardadas, sin formato.
<!-- BEGIN description -->
<p>{description.SOCIALNAME}<br>
{description.ADDRESS}<br>
{description.PROVINCE}</p>
<!-- END description -->
La propuesta no trae la dirección fiscal del cliente.
concepts de la propuesta
Una vuelta por cada concepto con «Mostrar campo» = «Sí», en el orden de la propuesta. En la propuesta concepts es un bloque suelto: el BEGIN no va dentro de blocks y las variables se escriben {concepts.CAMPO}.
<table>
<!-- BEGIN concepts -->
<tr>
<td>{concepts.TITLE}<br>{concepts.DESCRIPTION}</td>
<td>{concepts.UNITS}</td>
<td>
<!-- IF concepts.TEXT_COST != '' -->{concepts.TEXT_COST}<!-- ELSE -->{concepts.COST} €<!-- ENDIF -->
</td>
</tr>
<!-- END concepts -->
</table>
Variable
Qué contiene
Formato y notas
{concepts.TITLE}
Título del concepto hasta el primer guion bajo (_).
Texto. Si no hay guion bajo, el título entero.
{concepts.TITLE2}
Lo que va detrás del primer guion bajo del título.
Texto.
{concepts.DESCRIPTION}
Descripción del concepto.
Con HTML: los saltos de línea llegan como <br>.
{concepts.UNITS}
Unidades.
Sin formato. Si está vacío, 1.
{concepts.COSTUNIT}
Precio unitario.
Número. Sin IVA. {concepts.UNITCOST} trae lo mismo.
{concepts.DISCOUNT}
Porcentaje de descuento.
Número.
{concepts.COST}
Importe del concepto.
Número. Sin IVA, con el descuento.
{concepts.COSTWITHOUTDISCOUNT}
Precio × unidades, sin descuento.
Número. Sin IVA. {concepts.NODISCOUNTCOST} trae lo mismo.
{concepts.AMOUNTDISCOUNT}
Importe del descuento.
Número. Sin IVA.
{concepts.IVA}
Porcentaje de IVA.
Número.
{concepts.COSTVAT}
Cuota de IVA del concepto.
Número. {concepts.INGRESO_IVA} trae lo mismo.
{concepts.TOTAL_IVA}
Importe del concepto con IVA.
Número. Con IVA.
{concepts.TEXT_COST}
«Texto importe»: el texto que se escribe en lugar del importe.
Texto. Vacío si el concepto no lo tiene.
deliverables de la propuesta
Una vuelta por cada entregable de la propuesta.
<!-- IF exist_deliverables > 0 -->
<table>
<tr><th>{deliverable}</th><th>{initdate}</th><th>{enddate}</th><th>{percentage}</th><th>{amount}</th></tr>
<!-- BEGIN deliverables -->
<tr>
<td>{deliverables.TITLE}</td>
<td>{deliverables.CREATED}</td>
<td>{deliverables.DATETOFINISH}</td>
<td>{deliverables.PORC_AMOUNT} %</td>
<td>{deliverables.AMOUNT} €</td>
</tr>
<!-- END deliverables -->
</table>
<!-- ENDIF -->
Variable
Qué contiene
Formato y notas
{deliverables.TITLE}
Nombre del entregable.
Texto.
{deliverables.CREATED}
Fecha de alta del entregable.
dd/mm/aaaa.
{deliverables.DATETOFINISH}
Fecha de fin.
dd/mm/aaaa.
{deliverables.PORC_AMOUNT}
Porcentaje del total que corresponde al entregable.
Sin formato.
{deliverables.AMOUNT}
Importe del entregable: ese porcentaje aplicado a {total}.
Número. Sin IVA.
Lo que hay que vigilar en las propuestas
Pon siempre la plantilla en la propuesta. Si no, puede salir con cualquier plantilla marcada por defecto, aunque sea de otro tipo de documento.
{date} es la fecha de alta de la propuesta, no la de venta: para esa usa {date_sale}.
Un concepto con «Texto importe» no suma en {total}, pero su importe y su IVA sí suman en {iva} y en {totalivairpf}. En ese caso, base más IVA no coincide con el total con IVA.
No existen en la propuesta: {offer_num}, {waytopay_lamb}, {timetopay_lamb}, {agentname}, las {agentowner…}, {clientReference}, {clientSocialName}, {footer}, las de transporte, cuentas bancarias, descuentos y recargo, y los bloques blocks e iva_por_tipos.
Nombres que no debes usar
No uses
Usa
Por qué
{WAY_TO_PAY}
{waytopay_lamb}
Es un texto fijo en español, con entidades HTML (Domiciliación), que solo sale para algunas formas de pago y no se traduce.
{way_to_pay}
{waytopay_lamb}
Escribe siempre el texto «Forma de Pago», no la forma de pago de la oferta.
{waytopay} (en la oferta)
{waytopay_lamb}
En la oferta sale siempre vacía. En la propuesta sí funciona.
{validtime}, {validtime_en} (en la oferta)
Un texto fijo en la plantilla
En la oferta valen siempre 30, sea cual sea la validez. En la propuesta sí salen de la ficha.
{warranty}, {warranty_en} (en la oferta)
—
En la oferta valen siempre 0. En la propuesta sí salen de la ficha.
{agentowner}, {agentowneremail} para el comercial de la oferta
{agent}, {agentemail}
Son del responsable de la ficha del cliente, no del propietario de la oferta.
{blocks.NAME} para el subtotal
{blocks.TOTAL}
{blocks.NAME} es el nombre del bloque.
{blocks.concepts.SALE_STOCK_PRICE} para el precio
{blocks.concepts.COSTUNITWVAT}
Sale sin formato y es solo el precio guardado para la parte con stock.
{footer}, {totirpf} (en la propuesta)
{description.…_PRIMECONTRACTOR} y {totalivairpf}
En la propuesta salen vacías, aunque las use la plantilla estándar de propuestas.
Cuidado con
Si copias la plantilla estándar de oferta como base, revisa tres textos: pone «Nº de oferta» con {proposaltitle}, que es el nombre (el número es {offer_num}); pone «Agente» con {agentowner}, que es el responsable del cliente (el propietario de la oferta es {agent}); y pone «Descuento: {offerdiscount} €», que es un porcentaje.
Los importes de línea no restan el descuento global.COST, COSTWITHVAT, COSTVAT y {blocks.TOTAL} no lo llevan: si la oferta tiene descuento global, la suma de las líneas no coincide con la base imponible.
Las líneas con stock parcial pueden salir en dos filas. Si la plantilla numera las líneas con S_ROW_COUNT, una línea partida cuenta dos veces.
Fechas vacías.{date} y {expected_delivery_date_format} sacan la fecha de hoy si la oferta no tiene fecha. Para no pintar una fecha de entrega que no existe, usa una condición sobre {expected_delivery_date}, que sí sale vacía.
Idiomas. Las fechas largas ({date}, {expected_delivery_date_format}) salen siempre en español. Las formas y plazos de pago traducidos y los textos {ydic_…} salen en el idioma del usuario que genera el documento, no en el del cliente.
Variables con HTML.{description.ADDRESS}, CUSTOM_DESC, CUSTOM_LONG_DESC, SHORT_DESCRIPTION y la descripción de los conceptos de la propuesta traen etiquetas HTML. No las pongas dentro de un atributo (title="…", alt="…") ni en <title>.
Comparar importes. Los importes con formato son texto (1.234,56). Para comparar con > o < en un <!-- IF … -->, usa las variables sin formato (COST_NO_FORMAT, {description.TOTAL_AMOUNT}…).
Mayúsculas.{offerdiscount} y {offerDiscount} son variables distintas, igual que {WAY_TO_PAY} y {way_to_pay}.
Observaciones internas.{private_observations} trae las observaciones internas. No la pongas en un documento para el cliente.
Varias ofertas en un solo PDF. Si seleccionas varias ofertas y las imprimes juntas, algunos totales no salen bien: el desglose de IVA acumula los tipos de todas, {totalneto} y el transporte salen de la primera, y el total con IVA suma todas las ofertas. Si la plantilla usa totales, imprime cada oferta por separado.
Plantillas a medida. Si tu instalación tiene una oferta o una propuesta hecha a medida, sus variables pueden ser otras. Pregunta a Yunbit.
Las llaves en CSS y JavaScript, las condiciones y los bloques vacíos se explican en 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.