Variables para plantillas: órdenes de compra

La orden de compra es el documento que envías al proveedor para pedirle material o servicios. Se imprime desde la propia orden de compra: la vista previa y el PDF usan la misma plantilla y las mismas variables. Aquí tienes todas las variables y bloques que puedes usar en una plantilla de orden de compra. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Muchas variables solo tienen valor en las plataformas de venta al por menor (retail). En las tablas llevan la nota Solo retail; en el resto de plataformas salen vacías.

Cómo se elige la plantilla

Las plantillas se dan de alta en el Gestor de plantillas con «Aplica a: Órdenes de compra». Cada una lleva su fichero de plantilla y, si quieres, tres imágenes: la de cabecera o logo, la de margen y la de pie.

Al abrir la vista previa o generar el PDF, Yunbit busca la plantilla en este orden:

  1. La plantilla elegida en la propia orden de compra: campo «Plantilla» de la sección «Plantilla Orden de compra» de la ficha. Ese campo solo lo ve quien tiene permiso para generar el PDF de las órdenes de compra. El desplegable ofrece las plantillas de la misma empresa con «Aplica a: Órdenes de compra» que no están marcadas como «Antigua». Solo se usa si la plantilla tiene fichero subido.
  2. Si la orden no tiene plantilla, o la suya no tiene fichero: la plantilla de la misma empresa con «Aplica a: Órdenes de compra» y «Por defecto: Sí». Aquí da igual que esté marcada como «Antigua». Si hay varias por defecto, se usa una cualquiera de ellas, así que deja solo una.
  3. Si tampoco hay ninguna: la plantilla de serie de Yunbit.

No hay plantilla por proveedor, por tipo de orden ni por almacén.

Las tres imágenes se eligen cada una por separado. Si la plantilla de la orden tiene esa imagen, sale la suya; si no, la de la plantilla por defecto de la empresa. Así, una orden puede usar el fichero de su plantilla y el logo de la plantilla por defecto.

Si la plantilla elegida apunta a un fichero que ya no está en el servidor, la vista previa avisa «No se encuentra la plantilla» y no pasa a la siguiente. Vuelve a subir el fichero en el Gestor de plantillas.

Variables generales

Puedes usarlas en cualquier parte de la plantilla. Ningún importe lleva el símbolo de moneda: escríbelo tú o usa {symbol}. Los totales salen con dos decimales; otros importes salen con los decimales y separadores configurados en tu plataforma (en España, normalmente 1.234,56). En las tablas, esto último aparece como «formato de la plataforma».

Documento

VariableQué contieneFormato y notas
{documentNumber}Número de la orden de compraTexto
{purchaseordertitle}«Descripción del gasto» de la ordenTexto
{purchaseorderdpto}Departamento de la ordenTexto
{observations}«Observaciones públicas» de la ordenSe pinta tal cual: si lleva HTML, el navegador lo interpreta. Los saltos de línea no se ven salvo con white-space: pre-line
{warranty}Campo «Garantía»Texto
{currency}Moneda de la orden, en código ISO (EUR, USD…)Texto
{symbol}Símbolo de la moneda (€, $…)Texto
{norder}Número del pedido de venta enlazado a la ordenSolo retail. Si hay varios pedidos enlazados, sale uno
{id}Identificador interno de la ordenSolo hace falta para el formulario de petición de oferta
{lang}Idioma de quien abre la vista previa o genera el PDF (es, en, ca…)Texto

Fechas

VariableQué contieneFormato y notas
{date}Fecha de la orden («Fecha de compra»)Fecha larga, siempre en español: «13 de noviembre de 2026»
{initDate}Lo mismo que {date}Fecha larga en español
{date_en}Fecha de la orden, en inglés«November 13th, 2026»
{endDate}Fecha de cierre de la ordenFecha larga en español. Vacía si la orden no la tiene
{delivery_date}«Fecha entrega prevista» de la orden. Si está vacía, la fecha de entrega más tardía de sus líneasFecha larga en español. Tiene en cuenta también las líneas ocultas
{delivery_date_en}Lo mismo que {delivery_date}, en inglés«November 13th, 2026»
{validtime}«Fecha fin validez de oferta»dd/mm/aaaa
{previewDate}Fecha de hoy: el día en que se abre la vista previa o se genera el PDFFecha larga en el idioma del usuario. Solo en español e inglés: con otro idioma sale vacía

Proveedor y contacto

El nombre, la dirección y el resto de datos del proveedor están en el bloque description.

VariableQué contieneFormato y notas
{cif}NIF del proveedorTexto
{telf}Teléfono o teléfonos de la ficha del proveedorTexto
{contact}Nombre y apellidos del «Contacto proveedor» de la ordenFuera de retail, el campo de la orden se llama «Contacto de envío de factura»
{email}Correo de ese contactoTexto
{contacttelf}Teléfono de ese contacto; si no tiene, el de la ficha del proveedorTexto

Los demás contactos de la orden están en los bloques de otros contactos.

Comprador

Es la persona de tu empresa que gestiona la compra.

VariableQué contieneFormato y notas
{agent}Nombre del usuario del campo «Gestión interna de», el responsable de la compraTexto
{agentname}Nombre de pila de ese usuarioTexto
{approver}Nombre del usuario que aprobó la ordenTexto

No hay variable con el correo ni con el teléfono del responsable.

Importes y totales

VariableQué contieneFormato y notas
{total}Base imponible: suma del importe de las líneas que se imprimen (las que no están ocultas)Dos decimales, sin IVA, con los descuentos de línea ya aplicados
{iva}Cuota de IVA de la orden («Importe IVA»)Dos decimales. Puede salir 0 si el proveedor tiene un IVA por defecto del 0 %
{tipo_iva}Porcentaje medio de IVA de las líneas que se imprimen: la cuota de IVA dividida entre la base, redondeado a un número enteroDos decimales: «21,00». Con proveedores que tienen un IVA por defecto del 0 %, y con algunos tipos de proveedor, sale «0,00»
{irpf}Retención de IRPF de la orden («Importe IRPF»)Dos decimales
{totalivairpf}Total a pagar («Total» de la orden)Dos decimales, con IVA y con la retención de IRPF ya restada
{totalneto}Total menos el IVA; en retail, también menos los portesDos decimales. Lleva la retención de IRPF restada: solo coincide con la base imponible si la orden no tiene IRPF
{totalnetowithshippingcost}Total menos el IVA, con los portesDos decimales. También lleva la retención de IRPF restada
{grosstotal}Importe bruto: suma de precio unitario antes del descuento por unidades, de las líneas que se imprimenFormato de la plataforma, sin IVA
{totalfulldisc}Descuento total en dinero: suma de descuento por unidad por unidadesFormato de la plataforma, sin IVA. Es la que debes usar en la fila «Descuento»
{totalWithoutDiscount}Pese al nombre, el importe con el descuento ya aplicado: suma de precio con descuento por unidadesSin IVA. Dos decimales si no hay descuentos; si los hay, formato de la plataforma. Para el importe sin descontar, usa {grosstotal}
{shipmentCost}Portes («Gastos de envío»)Dos decimales, sin IVA. Solo retail: en el resto de plataformas sale «0,00»

Forma y plazo de pago

VariableQué contieneFormato y notas
{wayToPay}Forma de pago, en el idioma del usuarioSolo trae texto con efectivo, transferencia, domiciliación, tarjeta, pagaré, talón y confirming. Con otras formas de pago (carta de crédito, cheque, CESCE, PayPal, Bizum…) sale vacía
{wayToPay_es}, {wayToPay_en}, {wayToPay_fr}, {wayToPay_ca}Forma de pago en español, inglés, francés o catalánLas mismas formas de pago que {wayToPay}. No hay versión en portugués ni en otros idiomas
{timeToPay}Plazo de pago, en el idioma del usuarioTrae texto con todos los plazos de la ficha
{timeToPay_es}, {timeToPay_en}Plazo de pago en español o en inglésSolo trae texto con contado, 30, 45, 60, 70, 90, 120, 127 y 180 días y con 30-60-90 días. Con el resto (por adelantado, 15 días, 30-60 días…) sale vacía. No hay versión en francés ni en catalán

Envío y transporte

Todas son solo retail. La dirección de destino y la del almacén están en el bloque description.

VariableQué contieneFormato y notas
{shipmentTypeText}Campo «Medios»: «Mis medios» o «Sus medios»Texto fijo en español
{shipmentType}Campo «Medios», como código: 0 (mis medios) o 1 (sus medios)Útil en condiciones. Para imprimirlo, usa {shipmentTypeText}
{shipping_company}«Compañía de transporte»Texto
{shipping_service}«Servicio de transporte»Texto

Tu empresa

La única variable general con los datos de tu empresa es {footer}. El resto están en el bloque description: son las que acaban en _PRIMECONTRACTOR.

VariableQué contieneFormato y notas
{footer}Una línea con la razón social, la dirección, el teléfono, el fax, el CIF y la web de tu empresa, separados por guionesNo lleva código postal ni provincia. Si falta un dato, quedan los textos fijos («- Fax - CIF …»). Para un pie a tu medida, usa las variables del bloque description que acaban en _PRIMECONTRACTOR

Imágenes de la plantilla

VariableQué contieneFormato y notas
{proposal_logo}Imagen de cabecera o logo de la plantillaDirección de la imagen, para <img src="{proposal_logo}">. Vacía si ninguna plantilla tiene esa imagen
{proposal_margin}Imagen de margen de la plantillaIgual que la anterior
{proposal_bottom}Imagen de pie de la plantillaIgual que la anterior

Vista previa y PDF

VariableQué contieneFormato y notas
{inside}1 al generar el PDF; vacía en la vista previaPara mostrar algo solo en el PDF o solo en la pantalla: <!-- IF inside == '1' -->
{pdf_puppeteer}, {pdf_docraptor}1 si tu plataforma genera los PDF con ese servicioPara poner un CSS de impresión distinto según el servicio
{charset}Juego de caracteres de la plataforma (UTF-8)Para <meta charset="{charset}">

Bloques

Las variables de un bloque solo tienen valor entre su <!-- BEGIN … --> y su <!-- END … -->; fuera de él salen vacías. En la orden de compra los bloques no van dentro de blocks: se abren directamente.

description: datos de la orden, del proveedor y de tu empresa

Da una sola vuelta, con todos los datos de la orden. Puedes abrirlo varias veces en la misma plantilla, por ejemplo una en la cabecera y otra en el pie.

<!-- BEGIN description -->
  <p><strong>{description.SOCIALNAME}</strong><br>
  {description.ADDRESS}<br>
  {description.PROVINCE}<br>
  NIF: {description.CIF}</p>
<!-- END description -->

Orden de compra

VariableQué contieneFormato y notas
{description.documentNumber}Número de la ordenTexto
{description.poname}Descripción del gasto (lo mismo que {purchaseordertitle})Texto
{description.status}Estado de la ordenEl número interno del estado, no su nombre. No hay variable con el nombre del estado
{description.dateOfPurchase}Fecha de la ordenaaaa-mm-dd, sin formatear
{description.dateToClose}Fecha de cierreaaaa-mm-dd
{description.DELIVERY_DATE}Fecha de entrega previstaaaaa-mm-dd, sin formatear. Puede llevar la hora
{description.EXPECTED_DELIVERY_DATE}Fecha de entrega esperadaSin formatear
{description.validTime}Fin de validez de la ofertaaaaa-mm-dd
{description.deliveryPeriod}Plazo de entregaTexto
{description.warranty}GarantíaTexto
{description.publicObs}Observaciones públicas (lo mismo que {observations})Texto tal cual
{description.TIT_DEPARTMENT}DepartamentoTexto
{description.wayToPay}Forma de pago, como códigoNúmero. Sirve para condiciones; para el texto, usa {wayToPay}
{description.timeToPay}Plazo de pago, como código (los días)Número. Para el texto, usa {timeToPay}
{description.AGENT}Responsable de la compra: nombre completoTexto
{description.AGENT_NAME}Responsable de la compra: nombre de pilaTexto
{description.Approver}Quién aprobó la ordenTexto
{description.CURRENCY}Moneda, en código ISOTexto
{description.SYMBOL}Símbolo de la monedaTexto
{description.totalExternalCostAmount}Base imponible (en retail, «Importe bruto»)Sin formatear (1234.560000), sin IVA
{description.totalExternalCostVATAmount}Cuota de IVASin formatear. Sale 0 en los mismos casos que {iva}
{description.totalExternalCostTAXAmount}Retención de IRPFSin formatear
{description.totalExternalCostNetAmount}TotalSin formatear, con IVA
{description.PORC}Porcentaje de IVA por defecto del proveedor; si no tiene, el de la plataformaNúmero sin formatear
{description.DEFAULT_VAT_PORC}Porcentaje de IVA por defecto de la plataformaNúmero sin formatear
{description.SHIPMENT_METHOD}Campo «Medios», como código: 0 o 1Solo retail
{description.SHIPMENT_METHOD_TEXT}«Mis medios» o «Sus medios»Solo retail
{description.SHIPPING_COMPANY}Compañía de transporteSolo retail
{description.SHIPPING_SERVICE}Servicio de transporteSolo retail
{description.SHIPPING_COST}PortesSolo retail. Sin formatear
{description.NORDER}Número del pedido de venta enlazadoSolo retail

Proveedor

VariableQué contieneFormato y notas
{description.SOCIALNAME}Razón social del proveedor para compras (la «razón social de proveedor» de su ficha); si está vacía, la razón social generalTexto
{description.COMPANY_NAME}Razón social general del proveedorTexto
{description.CIF}NIF del proveedorTexto
{description.CLIENT_REF}Código o referencia del proveedor en su fichaTexto
{description.URL}Web del proveedorTexto
{description.TELF}Teléfono o teléfonos del proveedorTexto
{description.FAXS}Fax del proveedorTexto
{description.CONTACTNAME}Nombre del contacto de la ordenTexto
{description.EMAIL}Correo del contacto de la ordenTexto
{description.TELS}Teléfono del contacto de la orden; si no tiene, el del proveedorTexto

Dirección del proveedor elegida en la orden

Es la dirección del campo «Dir. de envío de factura» de la orden. En retail, si ese campo está vacío, la «Dirección de origen».

VariableQué contieneFormato y notas
{description.ADDRESS}CalleLos saltos de línea salen como <br>
{description.CODIGO_POSTAL}Código postalTexto
{description.LOCALIDAD}LocalidadTexto
{description.PROVINCIA}ProvinciaTexto
{description.STATE_PROV}Estado o provincia escrito a mano, para direcciones extranjerasTexto
{description.COUNTRY}PaísEn mayúsculas
{description.PROVINCE}Localidad, código postal y provincia en una línea: «Localidad CP Provincia». Si la localidad y la provincia son iguales, «CP Provincia»Texto
{description.TADDRESS}Tipo de dirección (Fiscal, Envío…)Texto

Dirección fiscal del proveedor

Si el proveedor tiene una sola dirección, sale esa. Si tiene varias, puede salir cualquiera de ellas, aunque no sea la fiscal. Para imprimir siempre la misma, usa la dirección elegida en la orden ({description.ADDRESS} y las de su tabla).

VariableQué contieneFormato y notas
{description.ADDRESS_FISCAL}CalleLos saltos de línea no se convierten en <br>
{description.CP_FISCAL}Código postalTexto
{description.LOCALIDAD_FISCAL}LocalidadTexto
{description.PROVINCE_FISCAL}ProvinciaTexto
{description.COUNTRY_FISCAL}PaísTexto

Dirección de destino

Todas son solo retail. Es la dirección del campo «Dirección destino» de la orden.

VariableQué contieneFormato y notas
{description.ADDRESS_DELIVERY}CalleLos saltos de línea salen como <br>
{description.CP_DELIVERY}Código postalTexto
{description.LOCALIDAD_DELIVERY}LocalidadEn mayúsculas
{description.PROVINCE_DELIVERY}Localidad, código postal y provincia en una línea: «LOCALIDAD CP PROVINCIA». Si la localidad y la provincia son iguales, «CP PROVINCIA»En mayúsculas
{description.COUNTRY_DELIVERY}PaísEn mayúsculas
{description.FULL_ADDRESS_DELIVERY}Toda la dirección en una línea: «Calle - LOCALIDAD CP PROVINCIA - PAÍS»Vacía si la dirección no tiene calle

Almacén

Todas son solo retail. Es el almacén de la orden.

VariableQué contieneFormato y notas
{description.STORE_TITLE}Nombre del almacénTexto
{description.STORE_ADDRESS}CalleLos saltos de línea no se convierten en <br>
{description.STORE_CP}Código postalTexto
{description.STORE_LOC}LocalidadTexto
{description.STORE_PROV}ProvinciaTexto
{description.STORE_COUNTRY}PaísTexto

Tu empresa

Son los datos de la ficha de tu empresa, la que corresponde a la empresa de la orden. Si esa ficha tiene varias direcciones, puede salir cualquiera de ellas.

VariableQué contieneFormato y notas
{description.SOCIALNAME_PRIMECONTRACTOR}Razón socialTexto
{description.NAME_PRIMECONTRACTOR}Nombre comercialTexto
{description.CIF_PRIMECONTRACTOR}NIFTexto
{description.TELS_PRIMECONTRACTOR}Teléfono o teléfonosTexto
{description.FAXS_PRIMECONTRACTOR}FaxTexto
{description.URL_PRIMECONTRACTOR}WebTexto
{description.ADDRESS_PRIMECONTRACTOR}CalleLos saltos de línea no se convierten en <br>
{description.CODIGO_POSTAL_PRIMECONTRACTOR}Código postalTexto
{description.LOCALIDAD_PRIMECONTRACTOR}LocalidadTexto
{description.PROVINCIA_PRIMECONTRACTOR}ProvinciaTexto
{description.COUNTRY_PRIMECONTRACTOR}PaísTexto

concepts: líneas de la orden

Da una vuelta por cada línea de la orden, en el orden de su posición. Las líneas ocultas no salen, y la opción «Mostrar artículos ocultos» de la plantilla no cambia eso en las órdenes de compra.

<table>
  <!-- BEGIN concepts -->
  <tr>
    <td>{concepts.ARTICLE_PART_NUMBER}</td>
    <td>{concepts.NAME}</td>
    <td>{concepts.units2Decimals}</td>
    <td>{concepts.amount}</td>
  </tr>
  <!-- END concepts -->
</table>

Datos de la línea

VariableQué contieneFormato y notas
{concepts.NAME}Nombre de la línea tal cualTexto
{concepts.name}Nombre de la línea. Si el nombre lleva #_#, solo la parte de delante. Si la línea tiene descripción, acaba en « -»Texto. En retail, si la línea no tiene nombre, sale «Referencia - Nombre del artículo»
{concepts.name2}Lo que va detrás de #_# en el nombre de la líneaSolo retail
{concepts.conceptname}Nombre de la línea tal cualSolo retail
{concepts.onlyname}Nombre del artículoSolo retail
{concepts.description}Descripción de la líneaLos saltos de línea salen como <br>
{concepts.longDescription}Descripción larga de la líneaSolo retail. Se pinta tal cual: si lleva HTML, el navegador lo interpreta
{concepts.position}Posición de la líneaNúmero
{concepts.S_ROW_COUNT}Número de vueltaEmpieza en 0
{concepts.S_NUM_ROWS}Número de líneas que se imprimenNúmero
{concepts.CAT}Categoría de gastoTexto. {concepts.idCat} trae lo mismo con los saltos de línea como <br>
{concepts.SUBCAT}Subcategoría de gastoTexto. {concepts.idSubcat} trae lo mismo con los saltos de línea como <br>
{concepts.workshop}Almacén: el del número de serie de la línea o, si no tiene, el de la ordenTexto
{concepts.conceptDate}Fecha de entrega de la líneaaaaa-mm-dd
{concepts.fechaEntrega}Fecha de entrega de la líneadd/mm/aaaa. Vacía si la línea no la tiene
{concepts.plazo}Días entre la fecha de la orden y la fecha de entrega de la líneaNúmero sin formatear
{concepts.pocId}Identificador interno de la líneaSolo hace falta para el formulario de petición de oferta

Artículo

VariableQué contieneFormato y notas
{concepts.articleName}Nombre del artículoTexto
{concepts.ARTICLE_PART_NUMBER}Referencia del artículoTexto. Trae valor en todas las plataformas
{concepts.PART_NUMBER}En retail, código del artículo en ese proveedor (código equivalente) y, si no hay, la referencia del artículo. En el resto de plataformas, la referencia del artículoTexto
{concepts.PROVIDER_CODE}Códigos equivalentes del artículo en ese proveedor, separados por comasSolo retail
{concepts.REFERENCE}Campo «Referencia» del artículoSolo retail
{concepts.SAP_CODE}Código de integración 1 del artículoTexto
{concepts.CCS}Campo CCS del artículoTexto
{concepts.MANUFACTURER}Fabricante del artículoSolo retail
{concepts.articleLongDescription}Descripción larga del artículoTexto tal cual: los saltos de línea no se convierten en <br>
{concepts.articleObs}Observaciones del artículoTexto tal cual: los saltos de línea no se convierten en <br>
{concepts.additionalData}Descripción larga y observaciones del artículo, seguidas del texto fijo <Indicar documentación de referencia si aplica>Pensada para un <textarea> del formulario de petición de oferta. Fuera de un <textarea>, el navegador toma ese texto final por una etiqueta y no lo muestra
{concepts.qualityText}Textos de los requisitos de calidad de la categoría de calidad del artículo que se aplican a las órdenes de compra, separados por una línea en blancoTexto plano. Para ver los saltos de línea, usa white-space: pre-line
{concepts.isMainConcept}1 si el artículo es concepto principalSolo retail. 0 o 1
{concepts.IMAGE}Primera imagen del artículoSolo retail. Dirección de la imagen, para <img src="{concepts.IMAGE}">
{concepts.PLATE_NUMBER}Matrícula pedida en la líneaSolo retail
{concepts.SERIAL_NUMBER}Número de serie pedido en la líneaSolo retail

Unidades

VariableQué contieneFormato y notas
{concepts.units}UnidadesSin formatear (2.000000). Mejor usa una de las siguientes
{concepts.units0Decimals}, {concepts.units2Decimals}, {concepts.units3Decimals}, {concepts.units4Decimals}Unidades con 0, 2, 3 o 4 decimalesSeparadores de la plataforma
{concepts.unitsNeededDecimals}Unidades con los decimales justos (hasta cinco)Punto decimal y sin separador de miles: 2.5
{concepts.units0CommaDecimals}, {concepts.units2CommaDecimals}, {concepts.units3CommaDecimals}, {concepts.units4CommaDecimals}Unidades con 0, 2, 3 o 4 decimalesSiempre coma decimal y punto de miles: 1.234,50
{concepts.unitsNeededCommaDecimals}Unidades con los decimales justosComa decimal: 2,5
{concepts.unitsUseDecimals}1 si la unidad de medida del artículo admite decimalesSolo retail. 0 o 1
{concepts.measurementUnit}Unidad de medida del artículo: su nombre o, si no tiene, su referencia en minúsculasSolo retail
{concepts.MU_REF}, {concepts.MU_TITLE}, {concepts.MU_USE_MULTIPLIER}Referencia y nombre de la unidad de medida del artículo, y si admite decimales (0 o 1)Solo retail
{concepts.unitsOtherMu}, {concepts.unitsOtherMu0Decimals}, {concepts.unitsOtherMu2Decimals}, {concepts.unitsOtherMu3Decimals}, {concepts.unitsOtherMu4Decimals}, {concepts.unitsOtherMuNeededDecimals}, {concepts.unitsOtherMu0CommaDecimals}, {concepts.unitsOtherMu2CommaDecimals}, {concepts.unitsOtherMu3CommaDecimals}, {concepts.unitsOtherMu4CommaDecimals}, {concepts.unitsOtherMuNeededCommaDecimals}Unidades en la unidad de compra alternativa de la líneaSolo retail. Los mismos formatos que las variables de units del mismo nombre
{concepts.MU_OTHER_REF}, {concepts.MU_OTHER_TITLE}, {concepts.MU_OTHER_USE_MULTIPLIER}Referencia y nombre de esa unidad alternativa, y si admite decimales (0 o 1)Solo retail
{concepts.conversionRatio}Factor de conversión de la unidad alternativa a la unidad del artículoSolo retail. Coma decimal, con los decimales justos
{concepts.unitsObs}Observaciones de las unidadesSolo retail

Precios e importes de la línea

Ninguno lleva el símbolo de moneda.

VariableQué contieneFormato y notas
{concepts.unitAmount}Precio unitario antes del descuento (en retail, «Precio compra»)Formato de la plataforma, sin IVA
{concepts.costUd}Precio unitario después del descuentoSin formatear, sin IVA
{concepts.COSTUDWODISCOUNT}Precio unitario antes del descuentoSin formatear, sin IVA
{concepts.discount}Porcentaje de descuento de la líneaFormato de la plataforma (10,00), sin el signo %
{concepts.amountDiscount}Descuento por unidad, en dineroFormato de la plataforma
{concepts.fullDiscountLine}Descuento de la línea en dinero: descuento por unidad por unidadesSin formatear
{concepts.amount}Importe de la línea: precio con descuento por unidadesFormato de la plataforma, sin IVA
{concepts.vat}Porcentaje de IVA de la líneaFormato de la plataforma
{concepts.amountVat}Cuota de IVA de la líneaFormato de la plataforma
{concepts.tax}Porcentaje de IRPF de la líneaFormato de la plataforma
{concepts.amountTax}Retención de IRPF de la líneaFormato de la plataforma
{concepts.amountSubtotal}Fuera de retail: importe más IVA menos IRPF, con IVA. En retail: importe menos IRPF, sin IVAFormato de la plataforma. Para el importe sin IVA en todas las plataformas, usa {concepts.amount}

Otros contactos

Hay dos bloques con los «Otros contactos» de la orden:

  • OTHER_CONTACTS_INFO: todos los «Otros contactos».
  • OTHER_CONTACTS_NO_CONTACTSEND_INFO: los mismos, menos el contacto principal de la orden. Si alguno de esos contactos ya no existe, en este bloque sale una vuelta vacía.
<!-- BEGIN OTHER_CONTACTS_INFO -->
  <p>{OTHER_CONTACTS_INFO.NAME} · {OTHER_CONTACTS_INFO.EMAIL} · {OTHER_CONTACTS_INFO.TELS}</p>
<!-- END OTHER_CONTACTS_INFO -->
VariableQué contieneFormato y notas
{OTHER_CONTACTS_INFO.NAME}, {OTHER_CONTACTS_NO_CONTACTSEND_INFO.NAME}Nombre y apellidos del contactoTexto
{OTHER_CONTACTS_INFO.EMAIL}, {OTHER_CONTACTS_NO_CONTACTSEND_INFO.EMAIL}Correo del contactoTexto
{OTHER_CONTACTS_INFO.TELS}, {OTHER_CONTACTS_NO_CONTACTSEND_INFO.TELS}Teléfono del contactoTexto

Formulario de petición de oferta

Una plantilla de orden de compra puede servir de petición de oferta al proveedor. En la vista previa, quien la abre escribe a mano datos de cada línea (precio ofrecido, plazo, documentación…) y Yunbit los guarda. A partir de ese momento, la vista previa y el PDF de esa orden muestran lo guardado en lugar de los datos de la línea.

Cómo se monta:

  1. Pon en la plantilla un formulario con id="rfq-form" y method="post". El id tiene que ser exactamente ese. La dirección del atributo action te la da el soporte de Yunbit; lleva el identificador de la orden ({id}) y el idioma ({lang}).
  2. Dentro del bloque concepts, pon un campo por cada dato que se pueda escribir. Su name es concepts[{concepts.pocId}][CAMPO], donde CAMPO es el nombre de la variable de línea que quieres sustituir. Vale una variable que ya existe, como unitAmount, o un nombre nuevo, como precioOfertado.
  3. Al pulsar «Imprimir» o «Generar PDF» en la ventana de la vista previa, Yunbit guarda primero lo escrito en el formulario.
  4. Desde ese momento, {concepts.CAMPO} muestra en esa línea lo que se guardó.
<form id="rfq-form" method="post" action="(dirección que te da Yunbit)">
<table>
  <!-- BEGIN concepts -->
  <tr>
    <td>{concepts.NAME}</td>
    <td>
      <!-- IF inside == '1' -->
        {concepts.precioOfertado}
      <!-- ELSE -->
        <input name="concepts[{concepts.pocId}][precioOfertado]" value="{concepts.precioOfertado}">
      <!-- ENDIF -->
    </td>
    <td><textarea name="concepts[{concepts.pocId}][additionalData]">{concepts.additionalData}</textarea></td>
  </tr>
  <!-- END concepts -->
</table>
</form>

En el ejemplo, la condición con {inside} pinta el valor guardado en el PDF y la casilla para escribirlo en la vista previa.

Ten en cuenta:

  • Lo guardado no cambia la orden de compra: las líneas de la orden siguen como estaban. Solo cambia lo que imprime la plantilla.
  • Se guarda un juego de datos por línea. Cada vez que se guarda, sustituye al anterior de esa línea.
  • Lo guardado se aplica a esa línea con cualquier plantilla de orden de compra, no solo con la que tiene el formulario.

Preguntas frecuentes

¿Cómo pongo la forma de pago?

Con {wayToPay}, que sale en el idioma del usuario, o con {wayToPay_es}, {wayToPay_en}, {wayToPay_fr} o {wayToPay_ca}. Solo traen texto con efectivo, transferencia, domiciliación, tarjeta, pagaré, talón y confirming; con el resto de formas de pago salen vacías y no hay otra variable con el texto. La plantilla de serie de Yunbit trae «Forma de pago: A convenir» escrito a mano: no sale de la orden, así que cámbialo por {wayToPay}.

¿Y el plazo de pago o los vencimientos?

El plazo de pago sale con {timeToPay}, que admite todos los plazos. La orden de compra no tiene vencimientos: no hay bloque de vencimientos ni de pagos.

¿Cómo saco el tipo de IVA?

En cada línea, con {concepts.vat} (porcentaje) y {concepts.amountVat} (cuota). Para toda la orden, {tipo_iva} da el porcentaje medio de las líneas. No hay bloque de desglose de IVA por tipos: si la orden mezcla tipos, muestra el IVA en cada línea. La plantilla de serie trae «IVA (21%)» escrito a mano.

¿Qué importes llevan IVA?

Sin IVA: {total}, {grosstotal}, {totalfulldisc}, {totalWithoutDiscount}, {totalneto}, {totalnetowithshippingcost}, {shipmentCost} y, en las líneas, {concepts.unitAmount}, {concepts.costUd} y {concepts.amount}. Con IVA: {totalivairpf} (el total a pagar) y, fuera de retail, {concepts.amountSubtotal}. El IVA solo: {iva} y {concepts.amountVat}.

¿Cómo pongo quién gestiona la compra?

Con {agent} (nombre completo del responsable, el del campo «Gestión interna de») o {agentname} (su nombre de pila). Quien aprobó la orden sale con {approver}. No hay variable con el correo ni con el teléfono del responsable.

¿Hay variable con el proyecto?

No. Sí hay variable con el departamento: {purchaseorderdpto}.

¿Cómo saco la descripción larga?

{concepts.description} trae la descripción de la línea. {concepts.longDescription} trae la descripción larga de la línea, solo en retail. {concepts.articleLongDescription} trae la descripción larga del artículo, en todas las plataformas.

¿Cómo pongo el código del artículo en el proveedor?

En retail, con {concepts.PART_NUMBER} (si no hay código del proveedor, sale tu referencia) o con {concepts.PROVIDER_CODE} (todos los códigos del proveedor, separados por comas). En el resto de plataformas no hay variable con el código del proveedor: {concepts.PART_NUMBER} y {concepts.ARTICLE_PART_NUMBER} traen tu referencia.

¿Cómo numero las líneas empezando por 1?

{concepts.S_ROW_COUNT} empieza en 0 y no hay variable que empiece en 1. Usa un contador de CSS, escrito con espacios y punto y coma: tr.linea { counter-increment: linea; } y td.num::before { content: counter(linea); }.

¿Cómo pongo la moneda?

Con {symbol} (€, $…) o {currency} (EUR, USD…). La plantilla de serie trae «Moneda: Euro (€)» escrito a mano: no sale de la orden.

Nombres que no debes usar

No usesUsaPor qué
{offerdiscount}{totalfulldisc}No existe en la orden de compra: sale vacía
{contactemail}{email}No existe: sale vacía
{contact_email}{email}No existe: sale vacía. Aparece en la plantilla de serie
{agentemail}No hay sustitutaNo existe: no hay variable con el correo del responsable. Aparece en la plantilla de serie
{TELS_PRIMECONTRACTOR} fuera del bloque{description.TELS_PRIMECONTRACTOR}, dentro del bloque descriptionFuera del bloque sale vacía. Aparece así en la plantilla de serie
{description.ADDR_TELS}{description.TELF} o {telf}No existe en la orden de compra: sale vacía
{description.DELIVERY_ADDRESS}{description.ADDRESS_DELIVERY}No existe: sale vacía
{description.DELIVERY_CP}{description.CP_DELIVERY}No existe: sale vacía
{description.DELIVERY_PROVINCE}{description.PROVINCE_DELIVERY}No existe: sale vacía
{concepts.IMAGES}{concepts.IMAGE} (solo retail)No existe: sale vacía
{totalWithoutDiscount} como total bruto{grosstotal}Pese al nombre, trae el importe con el descuento ya aplicado
{totaldisc} como descuento{totalfulldisc}Suma el descuento de una sola unidad de cada línea, sin multiplicar por las unidades: solo cuadra si todas las líneas tienen 1 unidad. La plantilla de serie la usa como «Descuento»
{totalneto} como base imponible{total}Lleva restada la retención de IRPF y, en retail, no lleva los portes
{concepts.amountSubtotal} como importe de la línea{concepts.amount}Fuera de retail lleva IVA; en retail, no
{concepts.units}{concepts.units2Decimals} o {concepts.unitsNeededCommaDecimals}Sale sin formatear: 2.000000
{timeToPay_es}, {timeToPay_en}{timeToPay}Solo traen texto con algunos plazos; con el resto salen vacías
{shipmentType} para imprimir el transporte{shipmentTypeText}Trae el código 0 o 1, no el texto. La plantilla de serie lo pinta como «Transporte»
{description.ADDRESS_FISCAL} y el resto de variables _FISCAL{description.ADDRESS} y las de su tablaSi el proveedor tiene varias direcciones, puede salir cualquiera de ellas
{norder} como número de la orden{documentNumber}{norder} es el número del pedido de venta enlazado, y solo en retail
{validtime_en}, {warranty_en}{validtime}, {warranty}No se traducen: traen lo mismo que la variable sin _en
{totirpf}, {percentirpf}{irpf}En la orden de compra siempre salen 0
{defaultiva}{description.PORC}Siempre sale vacía
{page}No hay sustitutaSiempre sale 1: no es el número de página

Cuidado con

  • Llaves en el CSS y el JavaScript. Una regla vacía como .clase{} o una función como function(){} pierden las llaves, y en JavaScript ${…} se vacía. Escribe siempre con espacios y punto y coma: .x { color: red; }. Lo tienes explicado en la portada de la serie.
  • Variables que traen HTML. {description.ADDRESS}, {description.ADDRESS_DELIVERY}, {concepts.description}, {concepts.idCat} y {concepts.idSubcat} llevan <br>. {observations}, {concepts.longDescription} y los textos del artículo se pintan tal cual: si alguien escribió HTML, el navegador lo interpreta. No las metas dentro de un atributo, como title="…".
  • Saltos de línea que no se ven. En {observations}, {concepts.articleLongDescription}, {concepts.articleObs} y {concepts.qualityText} los saltos de línea no se convierten en <br>. Para verlos, pon white-space: pre-line en el elemento que las contiene.
  • Formatos mezclados. Los totales salen con dos decimales; los importes de las líneas, con el formato de la plataforma. {concepts.units}, {concepts.costUd}, {concepts.COSTUDWODISCOUNT}, {concepts.fullDiscountLine}, {concepts.plazo} y los importes del bloque description salen sin formatear (1234.500000).
  • Líneas con descuento sin precio original. Si una línea tiene descuento pero no tiene relleno el precio antes del descuento (fuera de retail ese campo no aparece en la pantalla de la línea), Yunbit lo deduce a partir del precio con descuento y el resultado no coincide con el precio original. Afecta a {concepts.unitAmount}, {concepts.amountDiscount}, {concepts.fullDiscountLine}, {grosstotal} y {totalfulldisc}. En ese caso imprime el precio con descuento ({concepts.costUd}), el porcentaje ({concepts.discount}) y el importe ({concepts.amount}).
  • Fechas en un solo idioma. {date}, {endDate} y {delivery_date} salen siempre en español; para inglés tienes {date_en} y {delivery_date_en}. {previewDate} sale vacía si el usuario no tiene el idioma en español ni en inglés.
  • Textos traducidos. En la orden de compra funcionan {ydic_clave} y el resto de variables ydic que explica la portada. En cambio, {dic_…}, {dics_…} y {L_…} salen vacías.
  • Si partes de la plantilla de serie. Sus textos están escritos a mano en español («Forma de pago: A convenir», «Moneda: Euro (€)», «IVA (21%)», «Embalaje: Incluido») y no salen de la orden. Además usa varias variables de la tabla «Nombres que no debes usar»: cámbialas.
  • Fichas con varias direcciones. Si el proveedor o tu empresa tienen varias direcciones en la ficha, las variables _FISCAL y _PRIMECONTRACTOR pueden traer cualquiera de ellas. Para el proveedor, usa la dirección elegida en la orden.
  • El pie ya montado. {footer} no lleva código postal ni provincia y, si falta un dato, deja los textos fijos («- Fax - CIF …»). Monta el pie con las variables _PRIMECONTRACTOR del bloque description.
  • Rutas de imágenes y hojas de estilo. Escríbelas empezando por /, como las de {proposal_logo}. Una ruta relativa puede no encontrarse al generar el PDF.
  • Erratas. Una variable mal escrita no da error: sale vacía. Comprueba cada variable en la vista previa con una orden que tenga ese dato relleno.

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