Variables para plantillas: pedidos de venta

Este artículo lista las variables y bloques que puedes usar en la plantilla del pedido de venta. La misma plantilla sirve para la previsualización del pedido (botón «Previsualizar» de su ficha), para el PDF que se genera desde ahí o que se adjunta al enviar el pedido, para la descarga del pedido desde la tienda web, para la impresión de varios pedidos a la vez y para el ticket que imprime el TPV al cobrar. Qué documentos se envían o imprimen con cada pedido está en Pedidos: documentos a enviar e imprimir. 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 pedido se da de alta en el gestor de plantillas con «Aplica a» = Pedidos. Una plantilla con «Aplica a» = Propuestas no se usa nunca para un pedido: no sale en el desplegable de la ficha del pedido ni se elige como plantilla por defecto.

Hay tres tipos de plantilla que pintan el pedido, y los tres tienen exactamente las mismas variables y bloques:

«Aplica a»Para qué sirve
PedidosEl pedido de venta normal.
Pedidos alquilerLos pedidos cuyo tipo de pedido es de alquiler.
Pedidos TPVEl ticket que imprime el TPV al cobrar un pedido sin factura.

Cuando se imprime un pedido, se usa la primera plantilla que encuentra en este orden:

  1. Si se imprime desde el TPV al cobrar un pedido sin factura: el campo «Plantilla de pedido - ticket» de la ficha del TPV (solo ofrece plantillas con «Aplica a» = Pedidos TPV). Si el TPV no tiene plantilla de ticket, se sigue con el punto 2.
  2. El campo «Plantilla» de la ficha del pedido. Este campo se rellena solo al crear el pedido, con la primera que encuentre de estas: la plantilla de la oferta de la que viene el pedido, la «Plantilla de pedido» de los datos logísticos de la ficha del cliente y la «Plantilla de pedido» del tipo de pedido. Si después cambias la plantilla del cliente o la del tipo, los pedidos ya creados siguen con la que tenían; para cambiarla en uno de ellos, elige otra en su campo «Plantilla».
  3. La «Plantilla de pedido» del tipo de pedido, tal como está en el momento de imprimir.
  4. La plantilla marcada «Por defecto» = Sí. Si el tipo de pedido es de alquiler, busca primero la de «Aplica a» = Pedidos alquiler; si no hay ninguna, la de «Aplica a» = Pedidos. En los demás pedidos busca directamente la de «Aplica a» = Pedidos.
  5. Si ninguna de las anteriores tiene fichero subido: la plantilla estándar del producto.

En los pedidos de alquiler, el desplegable «Plantilla» de la ficha ofrece las plantillas de «Pedidos» y las de «Pedidos alquiler». Las plantillas marcadas como «Antigua» no salen en los desplegables de la ficha del pedido ni del TPV.

Opciones de la ficha de plantilla que afectan al pedido

CampoEfecto
Fichero de plantillaEl fichero .tpl que se pinta. Si está vacío, se pasa al siguiente punto de la lista de arriba.
Imagen de cabeceraLlega en {order_logo}.
Imagen de margenLlega en {proposal_margin}.
Imagen de pieLlega en {proposal_bottom}.
Mostrar artículos ocultosCon «No» (el valor por defecto), las líneas del pedido que tienen «Mostrar en pedido» = No no salen en el bloque de líneas ni suman en los totales de la plantilla. Con «Sí» salen todas.

El Excel que se adjunta al correo del pedido cuando el cliente, el tipo de pedido o el pedido tienen marcado «Enviar Excel» no usa esta plantilla: siempre sale con el formato fijo del producto.

Variables generales

Escribe cada variable entre llaves y con las mayúsculas y minúsculas exactas: {WAY_TO_PAY} y {waytopay} son variables distintas.

En las tablas, «formateado» quiere decir que el número sale con los decimales y separadores de la configuración de la plataforma (en España, 1.234,56), y «formato fijo» que sale siempre como 1.234,56, sin mirar la configuración. Ningún importe lleva el símbolo de moneda: escríbelo tú en la plantilla (€, por ejemplo).

Documento

VariableQué contieneFormato y notas
{order_num}Número del pedidoTexto.
{ORDER_NUMBER_BARCODE}Código de barras del número de pedidoLlega como etiqueta HTML <img> completa: escríbela tal cual, no dentro de un src.
{date_simple}Fecha del pedidodd/mm/aaaa.
{date}Fecha del pedido en letra«13 de noviembre de 2026», siempre en castellano.
{date_en}Fecha del pedido en inglés«November 13th, 2026».
{preparation_date}Fecha de preparacióndd/mm/aaaa. Si el pedido no la tiene, sale 01/01/1970 (ver «Cuidado con»).
{expected_shipment_date}Fecha prevista de envíodd/mm/aaaa. Vacía si no hay.
{expected_delivery_date}Fecha prevista de entregaEn letra, en castellano. Si no hay fecha, sale «0 de de 0» (ver «Cuidado con»).
{delivery_date}Fecha de entregaIgual que la anterior.
{timetodeliver}Días entre la fecha del pedido y la fecha prevista de entregaNúmero entero. 0 si no hay fecha prevista o si es anterior a la del pedido. {timetodeliver_en} vale lo mismo.
{timetodeliver_week}Lo mismo, en semanasNúmero entero.
{offer_number}Número de la oferta de la que viene el pedidoVacía si el pedido no viene de una oferta.
{idinvoice}Números de las facturas hechas desde el pedidoSi hay varias, van separadas por una barra vertical. Vacía si no hay facturas.
{clientReference}«Referencia del cliente» del pedidoTexto.
{clientReference2}«Referencia del cliente 2» del pedidoTexto.
{orderTotalWeight}Peso total del pedidoNúmero con punto decimal y sin ceros a la derecha (12.5).
{orderTotalVolume}Volumen total del pedidoIgual que el peso.
{totalunits}Suma de las unidades de todas las líneasNúmero sin formatear.
{STORETITLE}Almacén de la primera línea del pedidoTexto.
{project_code}Código del proyecto del pedidoTexto. Vacía si el pedido no tiene proyecto.
{project_name}Nombre del proyecto del pedidoTexto. Vacía si el pedido no tiene proyecto.
{observations}«Observaciones» del pedidoTexto. Los saltos de línea no se convierten en <br> (ver «Cuidado con»).
{shippingObservations}«Observaciones de envío» del pedidoIgual que la anterior.
{observations_client}Observaciones para el cliente de la oferta de la que viene el pedidoNo son las observaciones del pedido.
{private_observations}Observaciones privadas de la oferta de la que viene el pedidoNo la pongas en un documento que vaya al cliente.
{regalo}1 en la copia de «Ticket regalo» del TPV; vacía en todos los demás casosVer «Ticket del TPV y ticket regalo».

Cliente y contacto

VariableQué contieneFormato y notas
{cif}NIF del clienteTexto.
{contact}Nombre y apellidos del contacto del pedido (campo «Contacto»)Texto.
{contacttelf}Móvil del contacto; si no tiene, su teléfono; si tampoco, el teléfono del clienteTexto.
{contactemail}Correo del contacto de recepción; si no hay, el de la dirección de entrega; si no, el del contacto del pedido; y si no, el del clienteNo siempre es el correo de la persona de {contact}.

La razón social, el nombre comercial y las direcciones del cliente no son variables generales: están en el bloque description.

Comercial

VariableQué contieneFormato y notas
{agent}Propietario de la oferta de la que viene el pedidoEn la ficha del pedido sale como «Propietario de la oferta». Vacía si el pedido no viene de una oferta.
{agenttelf}Teléfono de ese usuarioTexto.
{agentemail}Correo de ese usuarioTexto.
{agentBarcode}Código de barras de ese usuarioTexto (el código, no una imagen).
{orderCreator}Usuario del campo «Creador del pedido»Texto. En los pedidos cobrados en el TPV es el usuario que cobró. No hay variables con su teléfono ni su correo.

Importes y totales

Ningún importe lleva símbolo de moneda.

VariableQué contieneFormato y notas
{grosstotal}Suma de los importes de las líneas (unidades × precio con los descuentos de cliente y de línea)Formateado, sin IVA, sin portes y antes del descuento global del pedido.
{grosstotalNoDiscount}Suma de unidades × precio con el descuento de cliente, antes del descuento de líneaFormateado, sin IVA, sin portes.
{grosstotalwithdiscount}{grosstotal} menos el descuento global y las promocionesFormateado, sin IVA, sin portes.
{total}Base imponible: importe de las líneas, menos el descuento global, más los portesFormateado, sin IVA. Es el total que usa la plantilla estándar.
{totalneto}Lo mismo que {total}Formateado, sin IVA.
{iva}Importe total del IVA (de las líneas y de los portes, ya descontado el descuento global)Formateado.
{iva_perc}Porcentaje medio de IVA: IVA guardado en el pedido dividido entre la base guardada, por 100Formateado, sin el signo %. Si el pedido tiene varios tipos de IVA, es una media; para el desglose usa el bloque iva_por_tipos.
{tipo_iva}Porcentaje de IVA del pedido21,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.
{TOTAL_SURCHARGE}Recargo de equivalenciaFormato fijo. 0,00 si no se aplica.
{totalivairpf}Total a pagar: base imponible + IVA + recargo de equivalenciaFormateado, con IVA. A pesar del nombre, no resta IRPF.
{shipping_cost}Portes del pedidoFormato fijo, sin IVA. El IVA de los portes va dentro de {iva}.
{offerdiscount}Porcentaje de descuento global del pedidoFormateado, sin el signo %.
{amountDiscount}Importe del descuento globalFormateado, sin IVA.
{totaldisc}Importe del descuento global más el de las promocionesFormateado, sin IVA, en positivo. Es el «Descuento» de la plantilla estándar.
{totaldiscPrice}Todos los descuentos juntos: los de línea, el global y las promocionesFormateado, sin IVA, en negativo.
{balanceduebyreceiptstatus}Lo que queda por cobrar de los recibos de las facturas del pedidoFormateado. 0 si el pedido aún no tiene facturas.
{client_amount}Importe que entregó el cliente al cobrar en el TPVFormateado.
{return_amount}Cambio que se devolvió: importe entregado menos el total del pedidoFormateado. 0 si no hay cambio.

Pago

VariableQué contieneFormato y notas
{WAY_TO_PAY}Forma de pago del pedido, en el idioma de la pantallaTexto. Es la que usa la plantilla estándar. Con unas pocas formas de pago (por ejemplo, tarjeta regalo) sale vacía.
{way_to_pay}Lo mismo que {WAY_TO_PAY}Texto.
{WAY_TO_PAY_ES}, {WAY_TO_PAY_EN}, {WAY_TO_PAY_FR}, {WAY_TO_PAY_CA}Forma de pago del pedido en castellano, inglés, francés o catalán, sea cual sea el idioma de la pantallaTexto. También existen en minúsculas: {way_to_pay_es}, {way_to_pay_en}, {way_to_pay_fr}, {way_to_pay_ca}.
{waytopay_full}Forma de pago del pedido en el idioma de la pantalla, sacada del mismo texto que {WAY_TO_PAY_ES} y compañíaTexto. Con un idioma fijo: {waytopay_full_es}, _en, _fr, _ca.
{waytopay_lamb}Lo mismo que {waytopay_full}Texto. Con un idioma fijo: {waytopay_lamb_es}, _en, _fr, _ca.
{timetopay}Plazo de pago del pedido en texto: «30 días», «30-60-90 días», «Por adelantado»…Texto en el idioma de la pantalla. Vacía si el plazo no es uno de los de la lista estándar. Con un idioma fijo: {timetopay_es}, {timetopay_en}, {timetopay_fr}, {timetopay_ca}.
{timetopay_lamb}Plazo de pago del pedido; si no es uno de la lista estándar, «N días»Texto. La tilde de «días» llega escrita como entidad HTML (&iacute;).
{client_timetopay}Plazo de pago de la ficha del cliente (no el del pedido)Texto.
{dics_day}La palabra «días», en el idioma de la pantalla y en minúsculasTexto.

Envío

VariableQué contieneFormato y notas
{shipping_company}Agencia de transporte del pedidoTexto. {shipping_company_en} vale lo mismo.
{shipping_service}Servicio de la agenciaTexto. {shipping_service_en} vale lo mismo.
{shipmentType}«Pagados» o «Debidos», según el campo «Envío» del pedidoTexto traducido al idioma de la pantalla. Si el campo está vacío, sale «Debidos».
{shipping_cost}PortesVer «Importes y totales».

La dirección de entrega está en el bloque description, en los campos que empiezan por DELIVERY_.

Tu empresa

Salen de la ficha de cliente que representa a tu propia empresa y de una de sus direcciones.

VariableQué contiene
{SENDER_SOCIALNAME}Razón social
{SENDER_CIF}NIF
{SENDER_ADDRESS}Dirección
{SENDER_CP}Código postal
{SENDER_LOCALIDAD}Localidad, en el idioma de la pantalla
{SENDER_COUNTRY}País, en el idioma de la pantalla
{SENDER_TELS}Teléfono de la dirección
{SENDER_FAX}Fax de la dirección
{SENDER_EMAIL}Correo de la ficha

La provincia y la web de tu empresa no son variables generales: están en el bloque description como {description.SENDER_PROVINCIA} y {description.SENDER_URL}.

Imágenes de la plantilla

VariableQué contieneFormato y notas
{order_logo}Dirección completa de la imagen de cabecera de la plantilla. Si la plantilla no tiene, la del logo de la web (logo.svg o logo.png)Empieza siempre por http:// y el servidor. Nunca está vacía (ver «Cuidado con»).
{proposal_margin}Ruta de la imagen de margen de la plantillaRuta sin servidor (/EPORTAL_IMGS/…). Vacía si la plantilla no tiene.
{proposal_bottom}Ruta de la imagen de pie de la plantillaIgual que la anterior.

La imagen de cada artículo está en el bloque de líneas: {blocks.concepts.IMAGE}.

Otros

VariableQué contieneFormato y notas
{inside}1 cuando se está generando el PDF; vacía en la previsualización del navegadorSirve para enseñar algo solo en el PDF o solo en pantalla: <!-- IF inside == '1' -->.
{pdf_puppeteer}1 si la plataforma genera los PDF con PuppeteerLa plantilla estándar la usa para cargar las hojas de estilo que repiten la cabecera y el pie en cada página.
{blocks_num}Número de bloques (capítulos) de líneasLas líneas que no están en ningún bloque cuentan como un bloque más.

Bloques

Los bloques repiten un trozo de la plantilla. En todos tienes además S_ROW_COUNT (número de vuelta, empieza en 0) y S_NUM_ROWS (número total de vueltas), como explica la portada de la serie.

Bloque description: datos del pedido, del cliente y de las direcciones

Da una sola vuelta con todos los datos del pedido. Tienes que abrirlo para poder usar {description.CAMPO}. Los valores llegan sin formatear, tal como están guardados: los números con punto decimal y cuatro decimales (123.4500) y las fechas como aaaa-mm-dd o aaaa-mm-dd hh:mm:ss.

<!-- BEGIN description -->
  <p>{description.SOCIALNAME}<br>{description.ADDRESS}<br>{description.PROVINCE}</p>
  <p>Entregar en: {description.DELIVERY_ADDRESS}, {description.DELIVERY_CP} {description.DELIVERY_LOC}</p>
<!-- END description -->

Cliente

VariableQué contieneFormato y notas
{description.SOCIALNAME}Razón social del clienteTexto.
{description.CLIENT_NAME}Nombre comercial del clienteTexto.
{description.CIF}NIF del clienteTexto.
{description.NAME}Nombre y apellidos del contacto del pedidoTexto.
{description.TELS}Móvil del contacto del pedido; si no, su teléfono; si no, el del clienteTexto.
{description.EMAIL}El mismo correo que {contactemail}Texto.
{description.CLIENT_FAX}Fax del clienteTexto.
{description.ADDR_TELS}Teléfono de la dirección de facturación del clienteTexto.
{description.CLIENT_VAT}Porcentaje de IVA por defecto del clienteNúmero sin formatear.
{description.applyEquivSurcharge}1 si el cliente lleva recargo de equivalencia0 o 1.
{description.CLIENT_TIME_TO_PAY}Plazo de pago de la ficha del cliente, en díasNúmero sin formatear. Para el texto usa {client_timetopay}.

Dirección fiscal del cliente

Es la dirección de facturación por defecto del cliente; si no tiene, una de tipo fiscal; y si tampoco, cualquiera de las suyas.

VariableQué contieneFormato y notas
{description.ADDRESS}DirecciónLlega con HTML: los saltos de línea ya vienen como <br>.
{description.CODIGO_POSTAL}Código postalTexto.
{description.LOCALIDAD}LocalidadTexto, en castellano.
{description.PROVINCIA}ProvinciaTexto, en castellano.
{description.COUNTRY}PaísTexto, en castellano, con mayúscula al principio de cada palabra.
{description.PROVINCE}Línea ya montada con «Localidad CP Provincia»Texto. Si la localidad y la provincia se llaman igual, sale solo «CP Provincia».

Dirección de entrega del pedido

VariableQué contieneFormato y notas
{description.DELIVERY_CLIENT}Descripción de la dirección de entrega; si no tiene, el nombre del clienteTexto.
{description.DELIVERY_CONTACT}Contacto de recepción; si no hay, el título de la dirección; si tampoco, el contacto del pedidoTexto.
{description.DELIVERY_ADDRESS}DirecciónTexto. Los saltos de línea no se convierten en <br>.
{description.DELIVERY_CP}Código postalTexto.
{description.DELIVERY_LOC}LocalidadTexto.
{description.DELIVERY_PROVINCE}ProvinciaTexto.
{description.DELIVERY_COUNTRY}PaísTexto, en castellano.
{description.COUNTRY_CODE}Código del país de entregaCódigo.
{description.DELIVERY_TELS}Teléfono del contacto de recepción; si no, el de la dirección; si no, el del contacto del pedido; y si no, el del clienteTexto.
{description.DELIVERY_FAXS}Fax del contacto de recepción o de la direcciónTexto.

Pedido

VariableQué contieneFormato y notas
{description.ORDER_NUMBER}Número del pedidoTexto.
{description.ORDER_DATE}Fecha del pedidoFecha sin formatear.
{description.PREPARATION_DATE}Fecha de preparaciónFecha sin formatear. Vacía si no hay.
{description.EXPECTED_SHIPMENT_DATE}Fecha prevista de envíoFecha sin formatear. Vacía si no hay.
{description.EXPECTED_DELIVERY_DATE}Fecha prevista de entregaFecha sin formatear. Vacía si no hay.
{description.DELIVERY_DATE}Fecha de entregaFecha sin formatear. Vacía si no hay.
{description.CLIENT_REF}, {description.CLIENT_REF2}Referencias del clienteTexto.
{description.PAYMENT_METHOD}Forma de pago, como código: 0 contado, 1 transferencia, 2 domiciliación, 3 tarjeta…Código. Útil para condiciones; para el texto usa {WAY_TO_PAY}.
{description.TIME_TO_PAY}Plazo de pago del pedido, en díasNúmero sin formatear. Para el texto usa {timetopay}.
{description.OBS}Observaciones del pedidoTexto. Saltos de línea sin convertir.
{description.INVOICE_OBS}Observaciones de factura del pedidoIgual que la anterior.
{description.SHIPPING_OBS}Observaciones de envío del pedidoIgual que la anterior.
{description.ORDER_DISCOUNT}Porcentaje de descuento globalNúmero sin formatear.
{description.SHIPPING_COST}PortesNúmero sin formatear, sin IVA. {description.SHIPMENT_PRICE} vale lo mismo.
{description.ORDER_BASE_PRICE}Base imponible guardada en el pedidoNúmero sin formatear, sin IVA.
{description.ORDER_TOTAL_TAX}IVA guardado en el pedidoNúmero sin formatear.
{description.ORDER_TOTAL_PRICE}Total guardado en el pedidoNúmero sin formatear, con IVA.
{description.surcharge}Recargo de equivalencia guardado en el pedido (en minúsculas)Número sin formatear.
{description.ORDER_TOTAL_WEIGHT}, {description.ORDER_TOTAL_VOLUME}Peso y volumen del pedidoNúmero sin formatear.
{description.SHIPPING_AND_TRACKING}Campo «Envío»: 0 portes pagados; cualquier otro valor, debidosCódigo. Para el texto usa {shipmentType}.
{description.SHIPPING_COMPANY}, {description.SHIPPING_SERVICE}Agencia de transporte y servicioTexto.
{description.CLIENT_AMOUNT}Importe que entregó el cliente en el TPVNúmero sin formatear.
{description.TPV_REFERENCE}Referencia de la venta en el TPVTexto. Vacía en los pedidos que no vienen del TPV.
{description.PROMOTION_TITLE}Nombre de la promoción aplicada al pedidoTexto.
{description.PROMOTION_TYPE}Tipo de la promoción: 0 porcentajeCódigo.
{description.PROMOTION_DISCOUNT}Valor de la promociónNúmero sin formatear.

Oferta de origen y comercial

Estos campos solo tienen valor si el pedido viene de una oferta, salvo AGENT_O.

VariableQué contieneFormato y notas
{description.N_OFFER}Número de la ofertaTexto.
{description.OFFER_DATE}Fecha de la ofertaFecha sin formatear.
{description.EXPECTED_DELIVERY_DATE_OFFER}Fecha prevista de entrega de la ofertaFecha sin formatear.
{description.CLIENT_OBSERVATIONS}Observaciones para el cliente de la ofertaTexto.
{description.PRIVOBS}Observaciones privadas de la ofertaNo la pongas en un documento que vaya al cliente.
{description.AGENT}, {description.AGENT_EMAIL}, {description.AGENT_TEL}, {description.AGENT_BARCODE}Propietario de la oferta, su correo, su teléfono y su código de barrasLo mismo que {agent}, {agentemail}, {agenttelf} y {agentBarcode}.
{description.AGENT_O}Creador del pedidoLo mismo que {orderCreator}.

Tu empresa

VariableQué contiene
{description.SENDER_SOCIALNAME}, {description.SENDER_CIF}, {description.SENDER_ADDRESS}, {description.SENDER_CP}, {description.SENDER_LOCALIDAD}, {description.SENDER_COUNTRY}, {description.SENDER_TELS}, {description.SENDER_FAX}, {description.SENDER_EMAIL}Lo mismo que las variables generales {SENDER_…}
{description.SENDER_PROVINCIA}Provincia de tu empresa (solo está aquí)
{description.SENDER_URL}Web de tu empresa (solo está aquí)

Bloque blocks: bloques (capítulos) de líneas

Da una vuelta por cada bloque de líneas de la oferta de la que viene el pedido. Las líneas que no están en ningún bloque van juntas en un bloque sin nombre. Si el pedido no tiene bloques, da una sola vuelta. Dentro va el bloque concepts, con las líneas.

VariableQué contieneFormato y notas
{blocks.NAME}Nombre del bloqueTexto. Vacío para las líneas sin bloque.
{blocks.TOTAL}Suma de los importes de las líneas del bloqueFormateado, sin IVA, antes del descuento global.

Bloque blocks.concepts: líneas del pedido

Da una vuelta por cada línea del pedido, en el orden de la ficha. Dentro de blocks, el BEGIN y el END llevan solo el nombre corto (concepts) y las variables, el camino completo:

<!-- 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 -->
<!-- END blocks -->

Todos los importes son sin IVA, salvo los que digan lo contrario.

Precios e importes de la línea

VariableQué contieneFormato y notas
{blocks.concepts.UNITS}UnidadesFormateado con los decimales de la unidad de medida.
{blocks.concepts.INITIAL_COSTUNIT}Precio por unidad antes de descuentos. Si el cliente tiene descuento, es el precio bruto de tarifaFormato fijo, sin IVA.
{blocks.concepts.COSTUNIT}El mismo precio de partidaFormateado, sin IVA.
{blocks.concepts.COSTUNITCLIENT}Precio por unidad con el descuento de clienteFormato fijo, sin IVA.
{blocks.concepts.COSTUNITWVAT}Precio neto por unidad: con el descuento de cliente y el de líneaFormato fijo, sin IVA aunque el nombre lleve «VAT». Es el «Precio» de la plantilla estándar.
{blocks.concepts.COST}Importe de la línea: unidades × {blocks.concepts.COSTUNITWVAT}Formateado, sin IVA, antes del descuento global.
{blocks.concepts.COSTVAT}Importe del IVA de la líneaFormateado con 4 decimales.
{blocks.concepts.COSTWITHVAT}Importe de la línea con IVA: importe de la línea más su IVAFormateado, antes del descuento global.
{blocks.concepts.IVA}Porcentaje de IVA de la líneaFormateado (21,00), sin el signo %.
{blocks.concepts.CLIENT_DISCOUNT}Porcentaje de descuento de clienteFormato fijo.
{blocks.concepts.DISCOUNT}Porcentaje de descuento de la líneaNúmero sin formatear, con punto decimal (5, 12.5).
{blocks.concepts.DISCOUNTFROMRATE}Porcentaje de descuento del precio frente al precio bruto de tarifaFormateado.
{blocks.concepts.DISCOUNTWITHDISCOUNTFROMRATE}Porcentaje de descuento total: el de tarifa más el de líneaFormateado.
{blocks.concepts.GROSS_STOCK_UNIT_PRICE}Precio bruto de tarifa; si el precio aplicado es mayor, ese precioFormateado, sin IVA.
{blocks.concepts.PVPR}Precio de venta recomendado del artículoFormato fijo.
{blocks.concepts.PROMO_DISCOUNT}Importe del descuento de promoción de la líneaNúmero sin formatear, en negativo. Solo en las líneas con promoción.
{blocks.concepts.SUBTOTAL_PRICE}Importe de la línea guardado en el pedidoNúmero sin formatear, sin IVA.
{blocks.concepts.OA_VAT_AMOUNT}IVA de la línea guardado en el pedidoNúmero sin formatear.

Artículo y textos de la línea

VariableQué contieneFormato y notas
{blocks.concepts.PART_NUMBER}Código del artículoTexto. PROMO en las líneas de promoción.
{blocks.concepts.TITLE}Nombre escrito en la línea; si no hay, el nombre del artículoTexto.
{blocks.concepts.CUSTOM_DESC}Descripción corta escrita en la líneaPuede traer HTML (el campo tiene editor HTML).
{blocks.concepts.CUSTOM_LONG_DESC}Descripción larga escrita en la líneaPuede traer HTML. Los saltos de línea no se convierten en <br>.
{blocks.concepts.LONG_DESCRIPTION}Descripción larga de la ficha del artículoTexto. Los saltos de línea no se convierten en <br>.
{blocks.concepts.BARCODE}Código de barras del artículoTexto (el código, no una imagen).
{blocks.concepts.IMAGE}Ruta de la imagen del artículoRuta sin servidor (/EPORTAL_IMGS/…). Vacía si no tiene. Si el artículo tiene varias imágenes, trae una de ellas.
{blocks.concepts.WEIGHT}Peso por unidad del artículoNúmero sin formatear.
{blocks.concepts.UMREFERENCE}Unidad de medidaTexto.
{blocks.concepts.STORE}Almacén de la líneaTexto.
{blocks.concepts.CATEGORYNAME_LEVEL0}Categoría de primer nivel del artículoTexto.
{blocks.concepts.BLOCK_NAME}Nombre del bloque de la líneaTexto.
{blocks.concepts.FINAL_ENTRY_DATE}«Fecha de entrada final» de la línea (pedidos de alquiler)aaaa/mm/dd hh:mm:ss. Vacía si no hay.
{blocks.concepts.FINAL_DEPARTURE_DATE}«Fecha de salida final» de la línea (pedidos de alquiler)Igual que la anterior.

Líneas especiales: stock parcial y promociones

  • Una línea con parte de las unidades en stock y parte sin stock, y con precio distinto para cada parte, sale dos veces: una por cada parte.
  • Cada promoción de artículo añade una línea más con {blocks.concepts.PART_NUMBER} = PROMO y {blocks.concepts.TITLE} = «Descuento promoción…». En esa línea solo tienen valor las unidades, los precios, los descuentos y el importe, en negativo. En los pedidos cobrados en el TPV no se añade.
  • Para no pintar la línea de promoción, rodea la fila con <!-- IF blocks.concepts.PART_NUMBER != 'PROMO' --> … <!-- ENDIF -->.

Bloque iva_por_tipos: desglose del IVA

Da una vuelta por cada porcentaje de IVA del pedido, ordenadas por porcentaje. Incluye los portes con su IVA y resta el descuento global.

<!-- BEGIN iva_por_tipos -->
  <tr>
    <td>IVA {iva_por_tipos.TIPO} %</td>
    <td>{iva_por_tipos.BASE}</td>
    <td>{iva_por_tipos.IMPORTE}</td>
  </tr>
<!-- END iva_por_tipos -->
VariableQué contieneFormato y notas
{iva_por_tipos.TIPO}Porcentaje de IVAFormateado con 2 decimales (21,00), sin el signo %.
{iva_por_tipos.BASE}Base imponible de ese porcentajeFormateado, sin IVA.
{iva_por_tipos.IMPORTE}Cuota de IVA de ese porcentajeFormateado.
{iva_por_tipos.TOTAL}Base más cuotaFormateado, con IVA.

Pedidos de alquiler

La plantilla «Pedidos alquiler» tiene las mismas variables que la de pedidos. Las únicas pensadas para el alquiler son las de cada línea {blocks.concepts.FINAL_ENTRY_DATE} y {blocks.concepts.FINAL_DEPARTURE_DATE}, que en un pedido normal salen vacías. Para mostrarlas solo cuando tienen valor:

<!-- IF blocks.concepts.FINAL_ENTRY_DATE != '' -->
  <td>{blocks.concepts.FINAL_ENTRY_DATE} - {blocks.concepts.FINAL_DEPARTURE_DATE}</td>
<!-- ENDIF -->

No hay variables para el resto de datos de alquiler de la línea: habitación, fechas de entrada y de salida previstas, cantidad de alquiler ni número de serie.

Ticket del TPV y ticket regalo

La plantilla «Pedidos TPV» también tiene las mismas variables que la de pedidos. Se usa al cobrar en el TPV un pedido sin factura; si el cobro pide factura, lo que se imprime es la factura. Las variables que más sentido tienen en el ticket son {client_amount} (importe entregado), {return_amount} (cambio), {description.TPV_REFERENCE} (referencia de la venta), {orderCreator} (usuario que cobró) y {WAY_TO_PAY} (forma de pago).

Si al cobrar se marca «Ticket regalo», el TPV imprime dos tickets con la misma plantilla: el normal y otro en el que {regalo} vale 1. Usa {regalo} para quitar los precios en el ticket regalo. La condición funciona también dentro de los bloques:

<!-- IF regalo == '1' --><p>Ticket regalo</p><!-- ENDIF -->
<!-- BEGIN blocks -->
  <!-- BEGIN concepts -->
    <tr>
      <td>{blocks.concepts.TITLE}</td>
      <td>{blocks.concepts.UNITS}</td>
      <!-- IF regalo != '1' --><td>{blocks.concepts.COST}</td><!-- ENDIF -->
    </tr>
  <!-- END concepts -->
<!-- END blocks -->
<!-- IF regalo != '1' --><p>Total: {totalivairpf} &euro;</p><!-- ENDIF -->

La plantilla de ticket no se guarda en el pedido. Si después imprimes el pedido desde su ficha, sale con la plantilla de pedido que le toque según el orden de arriba, no con la de ticket.

Preguntas frecuentes

¿Cómo pongo la forma de pago?

Con {WAY_TO_PAY}, en mayúsculas. Sale en el idioma de la pantalla; para un idioma fijo, {WAY_TO_PAY_ES}, {WAY_TO_PAY_EN}, {WAY_TO_PAY_FR} o {WAY_TO_PAY_CA}. No uses {waytopay} (todo junto y en minúsculas): sale siempre vacía.

¿Y el plazo de pago y la fecha de vencimiento?

El plazo de pago del pedido es {timetopay}; el de la ficha del cliente, {client_timetopay}. El pedido no tiene fecha de vencimiento: los vencimientos están en los recibos de la factura. Tampoco hay lista de pagos ni de recibos; solo {balanceduebyreceiptstatus}, que es lo que queda por cobrar de las facturas del pedido.

¿Hay una variable con el tipo de IVA?

Sí: {tipo_iva} trae el porcentaje (21,00) cuando todas las líneas llevan el mismo tipo. Si hay varios tipos sale vacía; entonces 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 por unidad {blocks.concepts.COSTUNITWVAT}: sin IVA, con los descuentos de cliente y de línea. La «VAT» del nombre no quiere decir que lleve IVA.
  • Importe de la línea {blocks.concepts.COST}: sin IVA. El IVA de la línea es {blocks.concepts.COSTVAT} y el importe con IVA, {blocks.concepts.COSTWITHVAT}.
  • Base imponible {total} (o {totalneto}): sin IVA, con los portes y ya restado el descuento global.
  • IVA total: {iva}.
  • Total a pagar {totalivairpf}: con IVA y, si lo hay, con recargo de equivalencia.
  • Portes {shipping_cost}: sin IVA.

No hay precio por unidad con IVA.

¿Cómo pongo el comercial?

{agent} es el propietario de la oferta de la que viene el pedido, con {agenttelf} y {agentemail}. Si el pedido no viene de una oferta, sale vacía. {orderCreator} es el usuario del campo «Creador del pedido». No hay variable para el responsable que tiene asignado el cliente en su ficha.

¿Puedo poner el proyecto del pedido?

Sí: {project_code} es el código del proyecto y {project_name} su nombre. Salen vacías si el pedido no tiene proyecto.

¿Dónde está la descripción larga de la línea?

Hay dos: {blocks.concepts.CUSTOM_LONG_DESC} es la que se escribe en la línea del pedido (puede traer HTML) y {blocks.concepts.LONG_DESCRIPTION} es la de la ficha del artículo. Ninguna convierte los saltos de línea en <br>: pon style="white-space: pre-line" en la celda. Para la descripción corta, la plantilla estándar usa {blocks.concepts.CUSTOM_DESC} y, si está vacía, {blocks.concepts.TITLE}:

<!-- IF blocks.concepts.CUSTOM_DESC != '' -->{blocks.concepts.CUSTOM_DESC}<!-- ELSE -->{blocks.concepts.TITLE}<!-- ENDIF -->

¿Por qué el total de la plantilla no coincide con el del pedido?

Lo más probable es que el pedido tenga líneas con «Mostrar en pedido» = No y la plantilla tenga «Mostrar artículos ocultos» = No. Esas líneas no salen ni suman en {total}, {iva} ni {totalivairpf}. Los totales guardados en el pedido están en el bloque description: {description.ORDER_BASE_PRICE}, {description.ORDER_TOTAL_TAX} y {description.ORDER_TOTAL_PRICE}, sin formatear.

Nombres que no debes usar

No usesUsaPor qué
{waytopay}, {waytopay_es}, {waytopay_en}, {waytopay_fr}, {waytopay_ca}{WAY_TO_PAY} o {WAY_TO_PAY_ES}…En el pedido salen siempre vacías.
{blocks.concepts.CLIENTS_DISCOUNT}{blocks.concepts.CLIENT_DISCOUNT}No existe con la «S»; el artículo anterior de la wiki la escribía así.
{agentowner}, {agentowneremail}, {agentownertelf}, {agentownermob}, {agentownerfax}, {agentmob}, {agentfax}{agent}, {agentemail}, {agenttelf}En el pedido salen siempre vacías.
{description.ADDRESS_FISCAL}, {description.CP_FISCAL}, {description.LOCALIDAD_FISCAL}, {description.PROVINCE_FISCAL}{description.ADDRESS}, {description.CODIGO_POSTAL}, {description.LOCALIDAD}, {description.PROVINCIA}No existen en el pedido. En el pedido, la dirección fiscal está en los campos sin _FISCAL, y la de entrega en los DELIVERY_.
{proposaltitle}—El pedido no tiene título; sale siempre vacía.
{irpf}, {irpfdes}—Salen siempre vacías. {totalivairpf} no resta IRPF.
{currency}, {symbol}Escribe el símbolo en la plantilla (&euro;)Salen siempre vacías.
{description_to_pay}, {banckAccount}, {banckAccountFormat}—El pedido no tiene cuenta bancaria; salen siempre vacías.
{validtime}, {warranty}—No dependen del pedido: salen siempre 30 y 0.
{footer}Escribe el pie en la plantilla o usa la imagen de pie ({proposal_bottom})La plantilla estándar la incluye, pero sale siempre vacía.
{order}, {cost_center}—Salen siempre vacías.
{blocks.concepts.DESCRIPTION}{blocks.concepts.CUSTOM_DESC}Sale siempre vacía.
{dic_clave}{ydic_clave}En esta plantilla los textos traducidos se escriben con ydic_.

Cuidado con

  • Fechas vacías. Si el pedido no tiene fecha de preparación, {preparation_date} sale 01/01/1970; sin fecha prevista de entrega o de entrega, {expected_delivery_date} y {delivery_date} salen «0 de de 0». Para que no salgan, pregunta por la fecha sin formatear dentro del bloque description: <!-- IF description.EXPECTED_DELIVERY_DATE != '' -->{expected_delivery_date}<!-- ENDIF -->.
  • El logo nunca está vacío. {order_logo} siempre empieza por http:// y el servidor, aunque no haya imagen de cabecera ni logo en la web. Por eso <!-- IF order_logo != '' --> se cumple siempre y, sin imagen, sale un icono de imagen rota. Si no quieres logo, no pongas la variable.
  • Comparar importes con números. Los importes formateados son texto: {totaldisc} vale 0,00 y <!-- IF totaldisc > 0 --> se cumple aunque no haya descuento. Compara con el texto: <!-- IF totaldisc != '0,00' -->. El descuento de línea {blocks.concepts.DISCOUNT} es el único que llega como número.
  • El «IVA (21%)» de la plantilla estándar. La plantilla estándar escribe ese texto fijo. Si el pedido tiene otro porcentaje o varios, el texto no coincide; usa el bloque iva_por_tipos.
  • HTML dentro de las variables. {ORDER_NUMBER_BARCODE}, {description.ADDRESS}, {timetopay_lamb}, {blocks.concepts.CUSTOM_DESC} y {blocks.concepts.CUSTOM_LONG_DESC} pueden llegar con HTML. Ponlas donde el HTML tenga sentido (dentro de una celda o un párrafo), no dentro de un atributo.
  • Saltos de línea. Las observaciones, la dirección de entrega y las descripciones largas no convierten los saltos de línea en <br>. Pon style="white-space: pre-line" en el elemento que las contiene.
  • Observaciones privadas. {private_observations} y {description.PRIVOBS} son las observaciones privadas de la oferta. No las pongas en un documento que va al cliente.
  • Idioma de las direcciones. La localidad, la provincia y el país del cliente y de la dirección de entrega salen siempre en castellano, aunque la pantalla esté en otro idioma. Los de tu empresa ({SENDER_LOCALIDAD}, {SENDER_COUNTRY}) sí siguen el idioma de la pantalla.
  • Llaves en CSS y JavaScript. Las llaves vacías y las que encierran una sola palabra se toman como variables y desaparecen; lo explica la portada de la serie. Lo más seguro es llevar el CSS y el JavaScript a ficheros aparte.

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Última actualización: 16 de noviembre del 2026, 09:30h
« 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