Variables para plantillas: ofertas y propuestas

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.

Cómo se elige la plantilla

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:

  1. 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.
  2. Si la oferta no tiene plantilla, la «Plantilla de oferta» del tipo de oferta, siempre que sea de la misma empresa que la oferta.
  3. 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.
  4. Si no hay ninguna de las anteriores, la plantilla marcada por defecto con «Aplica a» = Ofertas de la empresa que emite la oferta.
  5. 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

VariableQué contieneFormato 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

VariableQué contieneFormato 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.

VariableQué contieneFormato 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.Texto. No es el propietario de la oferta.
{agentownername}Nombre de pila del responsable del cliente.Texto.
{agentownertelf}, {agentownermob}, {agentowneremail}Teléfono, móvil y correo del responsable del cliente.Texto.

Importes y totales

VariableQué contieneFormato 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

VariableQué contieneFormato 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.
{timetopay_lamb}Plazo de pago, traducido: «Contado», «30 días», «30-60-90 días», «Por adelantado»…Texto. {timetopay} trae lo mismo.
{timetopay_en}Código del plazo de pago.El número de días; «Por adelantado» llega como _now.
{bankAccount}Cuenta bancaria por defecto de tu empresa (la que emite la oferta).Texto seguido, sin espacios.
{bankAccountFormat}La misma cuenta, en grupos de cuatro.«ES12 3456 7890 …».
{bankAccountToPayFormat}IBAN del «Banco receptor» elegido en la oferta.En grupos de cuatro. Vacía si la oferta no tiene banco receptor.
{bankNameToPay}Nombre de la entidad de ese banco receptor.Texto.

Envío y entrega

VariableQué contieneFormato y notas
{shipping_company}Compañía de transporte.Texto.
{shipping_service}Servicio de transporte.Texto.
{shipmentType}Portes: «Pagados» si el envío es por «Mis medios»; «Debidos» si es por «Sus medios».Texto.
{expected_delivery_date}Fecha estimada de entrega.aaaa-mm-dd.
{expected_delivery_date_format}Fecha estimada de entrega.«13 de noviembre de 2026», en español. Si la oferta no tiene fecha de entrega, sale la de hoy.
{timetodeliver}Días que hay entre la fecha de la oferta y la fecha estimada de entrega.Entero. Vacía si no hay fecha de entrega o es anterior a la de la oferta.
{timetodeliver_week}Lo mismo, en semanas completas.Entero. Sale 0 si faltan menos de siete días.
{timetodeliver_en}Días entre las dos fechas, sin más comprobaciones.Entero. Puede salir negativo.

Tu empresa

Son los datos de la empresa que emite la oferta, tal como están en su ficha de cliente. Si tu empresa no tiene ficha de cliente, salen vacías.

VariableQué contieneFormato y notas
{SOCIALNAME_PRIMECONTRACTOR}Razón social.Texto.
{NAME_PRIMECONTRACTOR}Nombre comercial.Texto.
{CIF_PRIMECONTRACTOR}NIF.Texto.
{ADDRESS_PRIMECONTRACTOR}Dirección.Texto. Si la ficha tiene varias direcciones, puede salir una que no sea la fiscal.
{CP_PRIMECONTRACTOR}, {LOC_PRIMECONTRACTOR}, {PROVINCE_PRIMECONTRACTOR}, {COUNTRY_PRIMECONTRACTOR}Código postal, localidad, provincia y país de esa dirección.Texto.
{TELS_PRIMECONTRACTOR}, {FAXS_PRIMECONTRACTOR}, {URL_PRIMECONTRACTOR}Teléfono, fax y página web.Texto.
{footer}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

VariableQué contieneFormato 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).

VariableQué contieneFormato 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

VariableQué contieneFormato 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.

Oferta

VariableQué contieneFormato y notas
{description.N_OFFER}Número de la oferta.Texto.
{description.TITLE}Nombre de oportunidad.Texto.
{description.CREATED}Fecha de alta de la oferta.aaaa-mm-dd hh:mm:ss.
{description.OFFER_DATE}Fecha de la oferta.aaaa-mm-dd hh:mm:ss.
{description.OBS}, {description.OBS_CLIENT}Observaciones y observaciones al cliente.Texto.
{description.OFFER_DISCOUNT}Porcentaje de descuento global.Sin formato.
{description.TOTAL_AMOUNT}Base imponible, con el transporte dentro.Sin formato. Sin IVA.
{description.TOTAL_TAX}Cuota de IVA.Sin formato.
{description.TOTAL_PVP}, {description.TOTAL_PVP_WITH_DISCOUNT}Total de las líneas sin descuentos y con descuentos.Sin formato. Sin IVA.
{description.DISCOUNT_AMOUNT}Importe del descuento global.Sin formato. Sin IVA.
{description.PAYMENT_METHOD}Código de la forma de pago.Igual que {way_to_pay_val}.
{description.TIME_TO_PAY}Código del plazo de pago.«Por adelantado» llega como _now.
{description.ACCOUNT_TITLE_TO_PAY}Nombre de la cuenta del banco receptor.Texto.
{description.ACCOUNT_IBAN_TO_PAY}IBAN del banco receptor.Seguido, sin espacios.
{description.BANKNAME}Nombre de la entidad del banco receptor.Igual que {bankNameToPay}.
{description.SHIPMENT_PRICE}Gastos de transporte.Sin formato. Sin IVA.
{description.SHIPPING_AND_TRACKING}Quién pone el transporte.0 = Mis medios; 1 = Sus medios.
{description.SHIPPING_COMPANY}, {description.SHIPPING_SERVICE}Compañía y servicio de transporte.Texto.
{description.EXPECTED_DELIVERY_DATE}Fecha estimada de entrega.aaaa-mm-dd.
{description.SYMBOL}Símbolo de moneda.Igual que {symbol}.
{description.PLATE_NUMBER}Matrícula del vehículo de cambio.Igual que {plate_number}.

Cliente y contacto

VariableQué contieneFormato y notas
{description.SOCIALNAME}Razón social del cliente.Texto.
{description.CIF}NIF del cliente.Texto.
{description.CLIENT_REF}«Referencia cliente» de la oferta.Texto.
{description.CLIENT_FAX}Fax del cliente.Texto.
{description.applyEquivSurcharge}Si el cliente lleva recargo de equivalencia.1 = sí; 0 = no.
{description.NAME}Nombre y apellidos del contacto.Texto.
{description.EMAIL}Correo del contacto.Texto.
{description.TELS}Teléfono del contacto o, si no tiene, el del cliente.Texto.

Comercial

VariableQué contieneFormato y notas
{description.AGENT}, {description.AGENT_NAME}Propietario de la oferta: nombre completo y nombre de pila.Igual que {agent} y {agentname}.
{description.AGENT_TEL}, {description.AGENT_MOB}, {description.AGENT_EMAIL}Teléfono, móvil y correo del propietario de la oferta.Texto.
{description.OFFER_OWNER_BARCODE}Código de barras del propietario de la oferta.Texto.
{description.AGENT_OWNER}, {description.AGENT_OWNER_NAME}Responsable de la ficha del cliente: nombre completo y nombre de pila.Igual que {agentowner} y {agentownername}.
{description.AGENT_OWNER_TEL}, {description.AGENT_OWNER_MOB}, {description.AGENT_OWNER_EMAIL}Teléfono, móvil y correo del responsable del cliente.Texto.

Dirección fiscal del cliente

VariableQué contieneFormato y notas
{description.ADDRESS_FISCAL}Dirección fiscal.Texto. Si el cliente tiene varias direcciones fiscales, sale una de ellas.
{description.CP_FISCAL}Código postal fiscal.Texto.
{description.LOCALIDAD_FISCAL}, {description.PROVINCE_FISCAL}Localidad y provincia fiscales.Con la primera letra de cada palabra en mayúscula.
{description.COUNTRY_FISCAL}País fiscal.Texto.

Dirección de entrega

VariableQué contieneFormato y notas
{description.TADDRESS}Tipo de la dirección de entrega.Texto.
{description.ADDRESS}Dirección de entrega.Con HTML: los saltos de línea llegan como <br>.
{description.ADDRESSTELS}Teléfono de la dirección de entrega.Texto.
{description.CODIGO_POSTAL}Código postal de entrega.Texto.
{description.LOCALIDAD}, {description.PROVINCIA}, {description.COUNTRY}Localidad, provincia y país de entrega.Con la primera letra de cada palabra en mayúscula.
{description.PROVINCE}Localidad, código postal y provincia de entrega en una línea.«Localidad CP Provincia». Si la localidad y la provincia se llaman igual, solo «CP Provincia».

Tu empresa

VariableQué contieneFormato y notas
{description.SOCIALNAME_PRIMECONTRACTOR}, {description.NAME_PRIMECONTRACTOR}, {description.CIF_PRIMECONTRACTOR}Razón social, nombre comercial y NIF de tu empresa.Igual que las variables generales del mismo nombre.
{description.ADDRESS_PRIMECONTRACTOR}, {description.CP_PRIMECONTRACTOR}, {description.LOC_PRIMECONTRACTOR}, {description.PROVINCE_PRIMECONTRACTOR}, {description.COUNTRY_PRIMECONTRACTOR}Dirección de tu empresa.Igual que las variables generales.
{description.TELS_PRIMECONTRACTOR}, {description.FAXS_PRIMECONTRACTOR}, {description.URL_PRIMECONTRACTOR}Teléfono, fax y web de tu empresa.Texto.
{description.MAIL_PRIMECONTRACTOR}Correo de tu empresa.Texto. Solo existe aquí.

Bloques y líneas (blocks y concepts)

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

VariableQué contieneFormato 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

VariableQué contieneFormato 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.
{blocks.concepts.COSTUNIT_WITHOUTVAT_FORMAT_2DECS}Precio unitario de venta sin descuento.Número con coma, dos decimales. Sin IVA.
{blocks.concepts.COSTUNIT_WITHOUTVAT_FORMAT}Precio unitario de venta sin descuento.Número con coma, cuatro decimales. Sin IVA.
{blocks.concepts.COSTUNIT}Precio unitario de venta sin descuento.Sin formato (12.5). Sin IVA.
{blocks.concepts.INITIAL_COSTUNIT}Precio de tarifa (o el de la tarifa del cliente).Número con coma, dos decimales. Sin IVA.
{blocks.concepts.COST}Importe de la línea: cantidad × precio con el descuento de línea.Número. Sin IVA y sin el descuento global.
{blocks.concepts.COST_NO_FORMAT}Importe de la línea.Sin formato. Sin IVA.
{blocks.concepts.NODISCOUNTCOST}Cantidad × precio, sin descuento.Número. Sin IVA.
{blocks.concepts.TOTALCOSTUNITS}Precio × cantidad total de la línea, con el descuento de línea.Número. Sin IVA. Solo en algunas instalaciones; en las demás sale vacía.
{blocks.concepts.COSTVAT}Cuota de IVA de la línea.Número con cuatro decimales.
{blocks.concepts.COSTVAT_NO_FORMAT}Cuota de IVA de la línea.Sin formato.
{blocks.concepts.COSTWITHVAT}Importe de la línea con IVA.Número. Con IVA, sin el descuento global.
{blocks.concepts.ARTICLE_LINE_VAT_PRICE}Importe de la línea con IVA.Sin formato. Sale vacía en las líneas partidas en dos filas por el stock: en esas usa COSTWITHVAT.
{blocks.concepts.UNITCOSTWITHVAT}Precio unitario con IVA.Número. Solo es correcto en líneas sin descuento: si la línea tiene descuento, suma el precio sin descuento y el IVA del precio con descuento.
{blocks.concepts.FINAL_BASE_NO_FORMAT}Base de la línea, redondeada.Sin formato. Sin IVA.
{blocks.concepts.VATFinalPrice}Precio de tarifa unitario con IVA.Número con coma, dos decimales. Con IVA.
{blocks.concepts.rateFinalPrice}Precio de venta unitario con IVA guardado en la línea.Número con coma, dos decimales. Con IVA.
{blocks.concepts.STOCK_PRICE}, {blocks.concepts.NO_STOCK_PRICE}Precio guardado en la línea para la parte con stock y para la parte sin stock.Sin formato. Sin IVA.
{blocks.concepts.RATED_STOCK_PRICE}, {blocks.concepts.RATED_NO_STOCK_PRICE}Precio de tarifa guardado, con stock y sin stock.Sin formato. Sin IVA.
{blocks.concepts.SALE_STOCK_PRICE}, {blocks.concepts.SALE_NO_STOCK_PRICE}Precio de venta guardado, con stock y sin stock.Sin formato. Sin IVA.
{blocks.concepts.SALE_STOCK_PRICE_VAT}, {blocks.concepts.SALE_NO_STOCK_PRICE_VAT}Precio de venta con IVA guardado, con stock y sin stock.Sin formato. Con IVA.
{blocks.concepts.UNIT_PRICE}, {blocks.concepts.UNIT_PRICE_VAT}Precio de la ficha del artículo, sin IVA y con IVA.Sin formato.
{blocks.concepts.OA_VAT_AMOUNT}IVA de la línea guardado en la oferta.Sin formato.

Descuentos e IVA de la línea

VariableQué contieneFormato y notas
{blocks.concepts.DISCOUNT}Porcentaje de descuento de la línea.Sin formato (10.00).
{blocks.concepts.CLIENT_DISCOUNT}Porcentaje de «Descuento cliente».Número con coma, dos decimales.
{blocks.concepts.CLIENT_PERCENT}, {blocks.concepts.RATE_PERCENT}Porcentaje de descuento del cliente y porcentaje de su tarifa.Sin formato.
{blocks.concepts.REAL_DISCOUNT}Porcentaje de descuento real sobre el precio de tarifa.Número.
{blocks.concepts.REAL_DISCOUNT_STOCK}, {blocks.concepts.REAL_DISCOUNT_NO_STOCK}Descuento real guardado, con stock y sin stock.Sin formato.
{blocks.concepts.OFFER_DISCOUNT}Porcentaje de descuento global de la oferta.Sin formato.
{blocks.concepts.IVA}Porcentaje de IVA de la línea.Número (21,00).
{blocks.concepts.VAT_RATE_RAW}Porcentaje de IVA de la línea.Sin formato.
{blocks.concepts.PORC_SURCHARGE}Porcentaje de recargo de equivalencia de ese tipo de IVA.Sin formato.

Cantidades y entrega

VariableQué contieneFormato y notas
{blocks.concepts.UNITS}Cantidad de la fila.Número, con los decimales de la unidad de medida.
{blocks.concepts.QUANTITY}Cantidad total de la línea.Sin formato. En una línea partida en dos filas no coincide con UNITS.
{blocks.concepts.AVAILABLES}Cantidad disponible cuando se hizo la oferta.Sin formato.
{blocks.concepts.UMREFERENCE}Referencia de la unidad de medida.En minúsculas.
{blocks.concepts.TITLE_UMREFERENCE}Nombre de la unidad de medida.En minúsculas.
{blocks.concepts.NO_STOCK}Si la fila es la parte sin stock.0 = con stock; 1 = sin stock.
{blocks.concepts.TIME_TO_DELIVER}, {blocks.concepts.TIME_TO_DELIVER_NO_STOCK}Plazo de entrega de la línea, para la parte con stock y para la parte sin stock.El número tal como está en la línea, sin unidad.

Artículo y textos de la línea

VariableQué contieneFormato y notas
{blocks.concepts.PART_NUMBER}Referencia del artículo.Texto.
{blocks.concepts.TITLE}Nombre del artículo, tal como está en su ficha.Texto.
{blocks.concepts.CUSTOM_NAME}«Nombre personalizado» de la línea.Texto. Solo en algunas instalaciones; en las demás sale vacía.
{blocks.concepts.CUSTOM_DESC}«Descripción corta personalizada» de la línea.Puede traer HTML.
{blocks.concepts.CUSTOM_LONG_DESC}«Descripción larga personalizada» de la línea.HTML.
{blocks.concepts.SHORT_DESCRIPTION}Descripción corta de la ficha del artículo.Puede traer HTML.
{blocks.concepts.LONG_DESCRIPTION}Descripción larga de la ficha del artículo.Texto.
{blocks.concepts.IMAGE}Dirección de la imagen principal del artículo.Vacía si no tiene. Uso: <img src="{blocks.concepts.IMAGE}">.
{blocks.concepts.GENERIC}Si el artículo es genérico.1 = sí; 0 = no.
{blocks.concepts.SERIALNUMBER}Número de serie de la línea. En alquiler, la unidad alquilada.Texto.
{blocks.concepts.STORE}Almacén de la línea.Texto.
{blocks.concepts.BLOCK_NAME}Nombre del bloque al que pertenece la línea.Texto.
{blocks.concepts.ENTRY_DATE}, {blocks.concepts.DEPARTURE_DATE}Inicio y fin del alquiler (o entrada y salida, en hoteles).aaaa/mm/dd hh:mm.
{blocks.concepts.ENTRY_DATE_WITHOUTHOUR}, {blocks.concepts.DEPARTURE_DATE_WITHOUTHOUR}Las mismas fechas, sin la hora.aaaa/mm/dd.
{blocks.concepts.ROOM}Habitación (hoteles).Texto.

Desglose de IVA (iva_por_tipos)

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>
VariableQué contieneFormato 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:

<!-- IF blocks.concepts.CUSTOM_LONG_DESC != '' -->
  {blocks.concepts.CUSTOM_LONG_DESC}
<!-- ELSE -->
  {blocks.concepts.LONG_DESCRIPTION}
<!-- ENDIF -->

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

  1. La del campo «Plantilla» de la propuesta. Solo salen las plantillas «Propuestas» de la misma empresa.
  2. 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.
  3. 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

VariableQué contieneFormato 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

VariableQué contieneFormato 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

VariableQué contieneFormato 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.
{timetopay}Plazo de pago, traducido.Texto. Para «Por adelantado» sale vacía.
{timetopay_en}Código del plazo de pago.El número de días; «Por adelantado» es -1.

Para que «Por adelantado» salga escrito:

<!-- IF timetopay_en == '-1' -->Por adelantado<!-- ELSE -->{timetopay}<!-- ENDIF -->

Importes

VariableQué contieneFormato y notas
{total}Suma de los importes de los conceptos que no tienen «Texto importe».Número. Sin IVA.
{iva}Suma del IVA de todos los conceptos.Número.
{iva_perc}Porcentaje medio de IVA.Número.
{totalivairpf}Suma del importe más el IVA de todos los conceptos.Número. Con IVA. No resta IRPF.
{totalwithoutdiscount}Suma de precio × unidades de los conceptos.Número. Sin IVA.
{totaldiscount}Suma de los descuentos de los conceptos, en importe.Número. Sin IVA.
{size}Número de conceptos.Entero.

Entregables y otros

VariableQué contieneFormato y notas
{exist_deliverables}Número de entregables de la propuesta.Entero. Sirve para no pintar la tabla si no hay.
{deliverable}, {initdate}, {enddate}, {percentage}, {amount}Títulos de columna para la tabla de entregables: «Entregable», «Fecha inicio», «Fecha fin», «Porcentaje» e «Importe».Texto, en el idioma del usuario.
{FIELD_…}Los datos de la propuesta, también fuera del bloque description: FIELD_ seguido del nombre del campo, como {FIELD_TITLE} o {FIELD_SOCIALNAME}.Sin formato. Solo existe en las propuestas.
{symbol}, {charset}, {inside}, {pdf_puppeteer}, {pdf_docraptor}, {dics_day}Igual que en la oferta.Ver Otros.
{proposal_logo}, {proposal_margin}, {proposal_bottom}Imágenes de la plantilla.Ver Imágenes de la plantilla.

Bloques de la propuesta

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 -->
VariableQué contieneFormato y notas
{description.IDPROPOSAL}, {description.TITLE}Código y título de la propuesta.Texto.
{description.CREATED}Fecha de alta.Sin formato.
{description.DATETOSALE}«Fecha de venta».Sin formato.
{description.OBS}Observaciones.Texto.
{description.NEEDS_CLIENT}«Necesidades por cuenta del cliente».Texto.
{description.CONDITIONS}«Condiciones de pago».Texto.
{description.DEF_WAY_TO_PAY}, {description.DEF_TIME_TO_PAY}Códigos de la forma y del plazo de pago.Sin traducir. Sirven para las condiciones.
{description.SYMBOL}Símbolo de moneda.Igual que {symbol}.
{description.SOCIALNAME}Razón social del cliente.Texto.
{description.CIF}NIF del cliente.Texto.
{description.NAME}, {description.ONLYNAME}Contacto: nombre y apellidos, y solo el nombre.Texto.
{description.EMAIL}, {description.TELS}Correo y teléfono del contacto (o el del cliente).Texto.
{description.AGENT}, {description.AGENT_TEL}, {description.AGENT_EMAIL}Usuario que creó la propuesta.Texto.
{description.SALES_CN}, {description.SALES_TEL}, {description.SALES_MAIL}Comercial de la propuesta.Texto.
{description.TADDRESS}Tipo de la dirección de envío.Texto.
{description.ADDRESS}Dirección de envío de la propuesta.Con HTML: los saltos de línea llegan como <br>.
{description.CODIGO_POSTAL}Código postal de envío.Texto.
{description.LOCALIDAD}, {description.PROVINCIA}, {description.COUNTRY}Localidad, provincia y país de envío.En mayúsculas.
{description.PROVINCE}Localidad, código postal y provincia en una línea.Igual que en la oferta.
{description.SOCIALNAME_PRIMECONTRACTOR}, {description.NAME_PRIMECONTRACTOR}, {description.CIF_PRIMECONTRACTOR}Razón social, nombre comercial y NIF de la empresa del campo «Venta asociada a».Texto.
{description.ADDRESS_PRIMECONTRACTOR}, {description.PROVINCE_PRIMECONTRACTOR}, {description.COUNTRY_PRIMECONTRACTOR}Dirección, provincia y país de esa empresa.Texto. No hay código postal ni localidad. Si la empresa tiene varias direcciones, puede salir una que no sea la fiscal.
{description.TELS_PRIMECONTRACTOR}, {description.FAXS_PRIMECONTRACTOR}, {description.MAIL_PRIMECONTRACTOR}, {description.URL_PRIMECONTRACTOR}Teléfono, fax, correo y web de esa empresa.Texto.

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>
VariableQué contieneFormato 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 -->
VariableQué contieneFormato 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 usesUsaPor qué
{WAY_TO_PAY}{waytopay_lamb}Es un texto fijo en español, con entidades HTML (Domiciliaci&oacute;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 plantillaEn 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.
{currency}, {description.CURRENCY}€ escrito en la plantilla o {symbol}Valen siempre «EURO», sea cual sea la moneda.
{PORC_SURCHARGE}{blocks.concepts.PORC_SURCHARGE}Sale siempre 0,00.
{order}, {cost_center}, {irpf}, {irpfdes}, {description_to_pay}, {agentfax}, {agentownerfax}—Salen siempre vacías.
{blocks.concepts.DESCRIPTION}{blocks.concepts.CUSTOM_DESC} o {blocks.concepts.SHORT_DESCRIPTION}En la oferta sale siempre vacía.
{invoice_order_obs}{observations} y {observations_client}Junta las tres observaciones, también las internas, sin separarlas.
{description.ACCOUNT_IBAN}, {description.ACCOUNT_OTHER}{bankAccountFormat}Llegan cifradas: no se pueden leer.
{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.

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Fecha de publicación: 13 de noviembre del 2026, 16:58h
« 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