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
Pedidos
El pedido de venta normal.
Pedidos alquiler
Los pedidos cuyo tipo de pedido es de alquiler.
Pedidos TPV
El 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:
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.
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».
La «Plantilla de pedido» del tipo de pedido, tal como está en el momento de imprimir.
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.
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
Campo
Efecto
Fichero de plantilla
El fichero .tpl que se pinta. Si está vacío, se pasa al siguiente punto de la lista de arriba.
Imagen de cabecera
Llega en {order_logo}.
Imagen de margen
Llega en {proposal_margin}.
Imagen de pie
Llega en {proposal_bottom}.
Mostrar artículos ocultos
Con «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
Variable
Qué contiene
Formato y notas
{order_num}
Número del pedido
Texto.
{ORDER_NUMBER_BARCODE}
Código de barras del número de pedido
Llega como etiqueta HTML <img> completa: escríbela tal cual, no dentro de un src.
{date_simple}
Fecha del pedido
dd/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ón
dd/mm/aaaa. Si el pedido no la tiene, sale 01/01/1970 (ver «Cuidado con»).
{expected_shipment_date}
Fecha prevista de envío
dd/mm/aaaa. Vacía si no hay.
{expected_delivery_date}
Fecha prevista de entrega
En letra, en castellano. Si no hay fecha, sale «0 de de 0» (ver «Cuidado con»).
{delivery_date}
Fecha de entrega
Igual que la anterior.
{timetodeliver}
Días entre la fecha del pedido y la fecha prevista de entrega
Nú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 semanas
Número entero.
{offer_number}
Número de la oferta de la que viene el pedido
Vacía si el pedido no viene de una oferta.
{idinvoice}
Números de las facturas hechas desde el pedido
Si hay varias, van separadas por una barra vertical. Vacía si no hay facturas.
{clientReference}
«Referencia del cliente» del pedido
Texto.
{clientReference2}
«Referencia del cliente 2» del pedido
Texto.
{orderTotalWeight}
Peso total del pedido
Número con punto decimal y sin ceros a la derecha (12.5).
{orderTotalVolume}
Volumen total del pedido
Igual que el peso.
{totalunits}
Suma de las unidades de todas las líneas
Número sin formatear.
{STORETITLE}
Almacén de la primera línea del pedido
Texto.
{project_code}
Código del proyecto del pedido
Texto. Vacía si el pedido no tiene proyecto.
{project_name}
Nombre del proyecto del pedido
Texto. Vacía si el pedido no tiene proyecto.
{observations}
«Observaciones» del pedido
Texto. Los saltos de línea no se convierten en <br> (ver «Cuidado con»).
{shippingObservations}
«Observaciones de envío» del pedido
Igual que la anterior.
{observations_client}
Observaciones para el cliente de la oferta de la que viene el pedido
No son las observaciones del pedido.
{private_observations}
Observaciones privadas de la oferta de la que viene el pedido
No 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 casos
Ver «Ticket del TPV y ticket regalo».
Cliente y contacto
Variable
Qué contiene
Formato y notas
{cif}
NIF del cliente
Texto.
{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 cliente
Texto.
{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 cliente
No 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
Variable
Qué contiene
Formato y notas
{agent}
Propietario de la oferta de la que viene el pedido
En 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 usuario
Texto.
{agentemail}
Correo de ese usuario
Texto.
{agentBarcode}
Código de barras de ese usuario
Texto (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.
Variable
Qué contiene
Formato 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ínea
Formateado, sin IVA, sin portes.
{grosstotalwithdiscount}
{grosstotal} menos el descuento global y las promociones
Formateado, sin IVA, sin portes.
{total}
Base imponible: importe de las líneas, menos el descuento global, más los portes
Formateado, 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 100
Formateado, 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 pedido
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.
{TOTAL_SURCHARGE}
Recargo de equivalencia
Formato fijo. 0,00 si no se aplica.
{totalivairpf}
Total a pagar: base imponible + IVA + recargo de equivalencia
Formateado, con IVA. A pesar del nombre, no resta IRPF.
{shipping_cost}
Portes del pedido
Formato fijo, sin IVA. El IVA de los portes va dentro de {iva}.
{offerdiscount}
Porcentaje de descuento global del pedido
Formateado, sin el signo %.
{amountDiscount}
Importe del descuento global
Formateado, sin IVA.
{totaldisc}
Importe del descuento global más el de las promociones
Formateado, 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 promociones
Formateado, sin IVA, en negativo.
{balanceduebyreceiptstatus}
Lo que queda por cobrar de los recibos de las facturas del pedido
Formateado. 0 si el pedido aún no tiene facturas.
{client_amount}
Importe que entregó el cliente al cobrar en el TPV
Formateado.
{return_amount}
Cambio que se devolvió: importe entregado menos el total del pedido
Formateado. 0 si no hay cambio.
Pago
Variable
Qué contiene
Formato y notas
{WAY_TO_PAY}
Forma de pago del pedido, en el idioma de la pantalla
Texto. Es la que usa la plantilla estándar. Con unas pocas formas de pago (por ejemplo, tarjeta regalo) sale vacía.
Forma de pago del pedido en castellano, inglés, francés o catalán, sea cual sea el idioma de la pantalla
Texto. 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ñía
Texto. 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 (í).
{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úsculas
Texto.
Envío
Variable
Qué contiene
Formato y notas
{shipping_company}
Agencia de transporte del pedido
Texto. {shipping_company_en} vale lo mismo.
{shipping_service}
Servicio de la agencia
Texto. {shipping_service_en} vale lo mismo.
{shipmentType}
«Pagados» o «Debidos», según el campo «Envío» del pedido
Texto traducido al idioma de la pantalla. Si el campo está vacío, sale «Debidos».
{shipping_cost}
Portes
Ver «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.
Variable
Qué 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
Variable
Qué contiene
Formato 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 plantilla
Ruta sin servidor (/EPORTAL_IMGS/…). Vacía si la plantilla no tiene.
{proposal_bottom}
Ruta de la imagen de pie de la plantilla
Igual que la anterior.
La imagen de cada artículo está en el bloque de líneas: {blocks.concepts.IMAGE}.
Otros
Variable
Qué contiene
Formato y notas
{inside}
1 cuando se está generando el PDF; vacía en la previsualización del navegador
Sirve 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 Puppeteer
La 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íneas
Las 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
Variable
Qué contiene
Formato y notas
{description.SOCIALNAME}
Razón social del cliente
Texto.
{description.CLIENT_NAME}
Nombre comercial del cliente
Texto.
{description.CIF}
NIF del cliente
Texto.
{description.NAME}
Nombre y apellidos del contacto del pedido
Texto.
{description.TELS}
Móvil del contacto del pedido; si no, su teléfono; si no, el del cliente
Texto.
{description.EMAIL}
El mismo correo que {contactemail}
Texto.
{description.CLIENT_FAX}
Fax del cliente
Texto.
{description.ADDR_TELS}
Teléfono de la dirección de facturación del cliente
Texto.
{description.CLIENT_VAT}
Porcentaje de IVA por defecto del cliente
Número sin formatear.
{description.applyEquivSurcharge}
1 si el cliente lleva recargo de equivalencia
0 o 1.
{description.CLIENT_TIME_TO_PAY}
Plazo de pago de la ficha del cliente, en días
Nú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.
Variable
Qué contiene
Formato y notas
{description.ADDRESS}
Dirección
Llega con HTML: los saltos de línea ya vienen como <br>.
{description.CODIGO_POSTAL}
Código postal
Texto.
{description.LOCALIDAD}
Localidad
Texto, en castellano.
{description.PROVINCIA}
Provincia
Texto, en castellano.
{description.COUNTRY}
País
Texto, 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
Variable
Qué contiene
Formato y notas
{description.DELIVERY_CLIENT}
Descripción de la dirección de entrega; si no tiene, el nombre del cliente
Texto.
{description.DELIVERY_CONTACT}
Contacto de recepción; si no hay, el título de la dirección; si tampoco, el contacto del pedido
Texto.
{description.DELIVERY_ADDRESS}
Dirección
Texto. Los saltos de línea no se convierten en <br>.
{description.DELIVERY_CP}
Código postal
Texto.
{description.DELIVERY_LOC}
Localidad
Texto.
{description.DELIVERY_PROVINCE}
Provincia
Texto.
{description.DELIVERY_COUNTRY}
País
Texto, en castellano.
{description.COUNTRY_CODE}
Código del país de entrega
Có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 cliente
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.
Variable
Qué contiene
Formato y notas
{blocks.NAME}
Nombre del bloque
Texto. Vacío para las líneas sin bloque.
{blocks.TOTAL}
Suma de los importes de las líneas del bloque
Formateado, 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
Variable
Qué contiene
Formato y notas
{blocks.concepts.UNITS}
Unidades
Formateado 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 tarifa
Formato fijo, sin IVA.
{blocks.concepts.COSTUNIT}
El mismo precio de partida
Formateado, sin IVA.
{blocks.concepts.COSTUNITCLIENT}
Precio por unidad con el descuento de cliente
Formato fijo, sin IVA.
{blocks.concepts.COSTUNITWVAT}
Precio neto por unidad: con el descuento de cliente y el de línea
Formato 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ínea
Formateado con 4 decimales.
{blocks.concepts.COSTWITHVAT}
Importe de la línea con IVA: importe de la línea más su IVA
Formateado, antes del descuento global.
{blocks.concepts.IVA}
Porcentaje de IVA de la línea
Formateado (21,00), sin el signo %.
{blocks.concepts.CLIENT_DISCOUNT}
Porcentaje de descuento de cliente
Formato fijo.
{blocks.concepts.DISCOUNT}
Porcentaje de descuento de la línea
Número sin formatear, con punto decimal (5, 12.5).
{blocks.concepts.DISCOUNTFROMRATE}
Porcentaje de descuento del precio frente al precio bruto de tarifa
Formateado.
{blocks.concepts.DISCOUNTWITHDISCOUNTFROMRATE}
Porcentaje de descuento total: el de tarifa más el de línea
Formateado.
{blocks.concepts.GROSS_STOCK_UNIT_PRICE}
Precio bruto de tarifa; si el precio aplicado es mayor, ese precio
Formateado, sin IVA.
{blocks.concepts.PVPR}
Precio de venta recomendado del artículo
Formato fijo.
{blocks.concepts.PROMO_DISCOUNT}
Importe del descuento de promoción de la línea
Nú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 pedido
Número sin formatear, sin IVA.
{blocks.concepts.OA_VAT_AMOUNT}
IVA de la línea guardado en el pedido
Número sin formatear.
Artículo y textos de la línea
Variable
Qué contiene
Formato y notas
{blocks.concepts.PART_NUMBER}
Código del artículo
Texto. PROMO en las líneas de promoción.
{blocks.concepts.TITLE}
Nombre escrito en la línea; si no hay, el nombre del artículo
Texto.
{blocks.concepts.CUSTOM_DESC}
Descripción corta escrita en la línea
Puede traer HTML (el campo tiene editor HTML).
{blocks.concepts.CUSTOM_LONG_DESC}
Descripción larga escrita en la línea
Puede traer HTML. Los saltos de línea no se convierten en <br>.
{blocks.concepts.LONG_DESCRIPTION}
Descripción larga de la ficha del artículo
Texto. Los saltos de línea no se convierten en <br>.
{blocks.concepts.BARCODE}
Código de barras del artículo
Texto (el código, no una imagen).
{blocks.concepts.IMAGE}
Ruta de la imagen del artículo
Ruta 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ículo
Número sin formatear.
{blocks.concepts.UMREFERENCE}
Unidad de medida
Texto.
{blocks.concepts.STORE}
Almacén de la línea
Texto.
{blocks.concepts.CATEGORYNAME_LEVEL0}
Categoría de primer nivel del artículo
Texto.
{blocks.concepts.BLOCK_NAME}
Nombre del bloque de la línea
Texto.
{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 -->
Variable
Qué contiene
Formato y notas
{iva_por_tipos.TIPO}
Porcentaje de IVA
Formateado con 2 decimales (21,00), sin el signo %.
{iva_por_tipos.BASE}
Base imponible de ese porcentaje
Formateado, sin IVA.
{iva_por_tipos.IMPORTE}
Cuota de IVA de ese porcentaje
Formateado.
{iva_por_tipos.TOTAL}
Base más cuota
Formateado, 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:
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} €</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.
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.
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.