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:
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.
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.
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
Variable
Qué contiene
Formato y notas
{documentNumber}
Número de la orden de compra
Texto
{purchaseordertitle}
«Descripción del gasto» de la orden
Texto
{purchaseorderdpto}
Departamento de la orden
Texto
{observations}
«Observaciones públicas» de la orden
Se 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 orden
Solo retail. Si hay varios pedidos enlazados, sale uno
{id}
Identificador interno de la orden
Solo 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
Variable
Qué contiene
Formato 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 orden
Fecha 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íneas
Fecha 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 PDF
Fecha 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.
Variable
Qué contiene
Formato y notas
{cif}
NIF del proveedor
Texto
{telf}
Teléfono o teléfonos de la ficha del proveedor
Texto
{contact}
Nombre y apellidos del «Contacto proveedor» de la orden
Fuera de retail, el campo de la orden se llama «Contacto de envío de factura»
{email}
Correo de ese contacto
Texto
{contacttelf}
Teléfono de ese contacto; si no tiene, el de la ficha del proveedor
Texto
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.
Variable
Qué contiene
Formato y notas
{agent}
Nombre del usuario del campo «Gestión interna de», el responsable de la compra
Texto
{agentname}
Nombre de pila de ese usuario
Texto
{approver}
Nombre del usuario que aprobó la orden
Texto
No hay variable con el correo ni con el teléfono del responsable.
Importes y totales
Variable
Qué contiene
Formato 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 entero
Dos 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 portes
Dos 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 portes
Dos 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 imprimen
Formato de la plataforma, sin IVA
{totalfulldisc}
Descuento total en dinero: suma de descuento por unidad por unidades
Formato 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 unidades
Sin 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
Variable
Qué contiene
Formato y notas
{wayToPay}
Forma de pago, en el idioma del usuario
Solo 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
Forma de pago en español, inglés, francés o catalán
Las 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 usuario
Trae texto con todos los plazos de la ficha
{timeToPay_es}, {timeToPay_en}
Plazo de pago en español o en inglés
Solo 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.
Variable
Qué contiene
Formato 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.
Variable
Qué contiene
Formato 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 guiones
No 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
Variable
Qué contiene
Formato y notas
{proposal_logo}
Imagen de cabecera o logo de la plantilla
Dirección de la imagen, para <img src="{proposal_logo}">. Vacía si ninguna plantilla tiene esa imagen
{proposal_margin}
Imagen de margen de la plantilla
Igual que la anterior
{proposal_bottom}
Imagen de pie de la plantilla
Igual que la anterior
Vista previa y PDF
Variable
Qué contiene
Formato y notas
{inside}
1 al generar el PDF; vacía en la vista previa
Para 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 servicio
Para 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
Variable
Qué contiene
Formato y notas
{description.documentNumber}
Número de la orden
Texto
{description.poname}
Descripción del gasto (lo mismo que {purchaseordertitle})
Texto
{description.status}
Estado de la orden
El número interno del estado, no su nombre. No hay variable con el nombre del estado
{description.dateOfPurchase}
Fecha de la orden
aaaa-mm-dd, sin formatear
{description.dateToClose}
Fecha de cierre
aaaa-mm-dd
{description.DELIVERY_DATE}
Fecha de entrega prevista
aaaa-mm-dd, sin formatear. Puede llevar la hora
{description.EXPECTED_DELIVERY_DATE}
Fecha de entrega esperada
Sin formatear
{description.validTime}
Fin de validez de la oferta
aaaa-mm-dd
{description.deliveryPeriod}
Plazo de entrega
Texto
{description.warranty}
Garantía
Texto
{description.publicObs}
Observaciones públicas (lo mismo que {observations})
Texto tal cual
{description.TIT_DEPARTMENT}
Departamento
Texto
{description.wayToPay}
Forma de pago, como código
Nú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 completo
Texto
{description.AGENT_NAME}
Responsable de la compra: nombre de pila
Texto
{description.Approver}
Quién aprobó la orden
Texto
{description.CURRENCY}
Moneda, en código ISO
Texto
{description.SYMBOL}
Símbolo de la moneda
Texto
{description.totalExternalCostAmount}
Base imponible (en retail, «Importe bruto»)
Sin formatear (1234.560000), sin IVA
{description.totalExternalCostVATAmount}
Cuota de IVA
Sin formatear. Sale 0 en los mismos casos que {iva}
{description.totalExternalCostTAXAmount}
Retención de IRPF
Sin formatear
{description.totalExternalCostNetAmount}
Total
Sin formatear, con IVA
{description.PORC}
Porcentaje de IVA por defecto del proveedor; si no tiene, el de la plataforma
Número sin formatear
{description.DEFAULT_VAT_PORC}
Porcentaje de IVA por defecto de la plataforma
Número sin formatear
{description.SHIPMENT_METHOD}
Campo «Medios», como código: 0 o 1
Solo retail
{description.SHIPMENT_METHOD_TEXT}
«Mis medios» o «Sus medios»
Solo retail
{description.SHIPPING_COMPANY}
Compañía de transporte
Solo retail
{description.SHIPPING_SERVICE}
Servicio de transporte
Solo retail
{description.SHIPPING_COST}
Portes
Solo retail. Sin formatear
{description.NORDER}
Número del pedido de venta enlazado
Solo retail
Proveedor
Variable
Qué contiene
Formato 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 general
Texto
{description.COMPANY_NAME}
Razón social general del proveedor
Texto
{description.CIF}
NIF del proveedor
Texto
{description.CLIENT_REF}
Código o referencia del proveedor en su ficha
Texto
{description.URL}
Web del proveedor
Texto
{description.TELF}
Teléfono o teléfonos del proveedor
Texto
{description.FAXS}
Fax del proveedor
Texto
{description.CONTACTNAME}
Nombre del contacto de la orden
Texto
{description.EMAIL}
Correo del contacto de la orden
Texto
{description.TELS}
Teléfono del contacto de la orden; si no tiene, el del proveedor
Texto
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».
Variable
Qué contiene
Formato y notas
{description.ADDRESS}
Calle
Los saltos de línea salen como <br>
{description.CODIGO_POSTAL}
Código postal
Texto
{description.LOCALIDAD}
Localidad
Texto
{description.PROVINCIA}
Provincia
Texto
{description.STATE_PROV}
Estado o provincia escrito a mano, para direcciones extranjeras
Texto
{description.COUNTRY}
País
En 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).
Variable
Qué contiene
Formato y notas
{description.ADDRESS_FISCAL}
Calle
Los saltos de línea no se convierten en <br>
{description.CP_FISCAL}
Código postal
Texto
{description.LOCALIDAD_FISCAL}
Localidad
Texto
{description.PROVINCE_FISCAL}
Provincia
Texto
{description.COUNTRY_FISCAL}
País
Texto
Dirección de destino
Todas son solo retail. Es la dirección del campo «Dirección destino» de la orden.
Variable
Qué contiene
Formato y notas
{description.ADDRESS_DELIVERY}
Calle
Los saltos de línea salen como <br>
{description.CP_DELIVERY}
Código postal
Texto
{description.LOCALIDAD_DELIVERY}
Localidad
En 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ís
En 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.
Variable
Qué contiene
Formato y notas
{description.STORE_TITLE}
Nombre del almacén
Texto
{description.STORE_ADDRESS}
Calle
Los saltos de línea no se convierten en <br>
{description.STORE_CP}
Código postal
Texto
{description.STORE_LOC}
Localidad
Texto
{description.STORE_PROV}
Provincia
Texto
{description.STORE_COUNTRY}
País
Texto
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.
Variable
Qué contiene
Formato y notas
{description.SOCIALNAME_PRIMECONTRACTOR}
Razón social
Texto
{description.NAME_PRIMECONTRACTOR}
Nombre comercial
Texto
{description.CIF_PRIMECONTRACTOR}
NIF
Texto
{description.TELS_PRIMECONTRACTOR}
Teléfono o teléfonos
Texto
{description.FAXS_PRIMECONTRACTOR}
Fax
Texto
{description.URL_PRIMECONTRACTOR}
Web
Texto
{description.ADDRESS_PRIMECONTRACTOR}
Calle
Los saltos de línea no se convierten en <br>
{description.CODIGO_POSTAL_PRIMECONTRACTOR}
Código postal
Texto
{description.LOCALIDAD_PRIMECONTRACTOR}
Localidad
Texto
{description.PROVINCIA_PRIMECONTRACTOR}
Provincia
Texto
{description.COUNTRY_PRIMECONTRACTOR}
País
Texto
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
Variable
Qué contiene
Formato y notas
{concepts.NAME}
Nombre de la línea tal cual
Texto
{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ínea
Solo retail
{concepts.conceptname}
Nombre de la línea tal cual
Solo retail
{concepts.onlyname}
Nombre del artículo
Solo retail
{concepts.description}
Descripción de la línea
Los saltos de línea salen como <br>
{concepts.longDescription}
Descripción larga de la línea
Solo retail. Se pinta tal cual: si lleva HTML, el navegador lo interpreta
{concepts.position}
Posición de la línea
Número
{concepts.S_ROW_COUNT}
Número de vuelta
Empieza en 0
{concepts.S_NUM_ROWS}
Número de líneas que se imprimen
Número
{concepts.CAT}
Categoría de gasto
Texto. {concepts.idCat} trae lo mismo con los saltos de línea como <br>
{concepts.SUBCAT}
Subcategoría de gasto
Texto. {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 orden
Texto
{concepts.conceptDate}
Fecha de entrega de la línea
aaaa-mm-dd
{concepts.fechaEntrega}
Fecha de entrega de la línea
dd/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ínea
Número sin formatear
{concepts.pocId}
Identificador interno de la línea
Solo hace falta para el formulario de petición de oferta
Artículo
Variable
Qué contiene
Formato y notas
{concepts.articleName}
Nombre del artículo
Texto
{concepts.ARTICLE_PART_NUMBER}
Referencia del artículo
Texto. 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ículo
Texto
{concepts.PROVIDER_CODE}
Códigos equivalentes del artículo en ese proveedor, separados por comas
Solo retail
{concepts.REFERENCE}
Campo «Referencia» del artículo
Solo retail
{concepts.SAP_CODE}
Código de integración 1 del artículo
Texto
{concepts.CCS}
Campo CCS del artículo
Texto
{concepts.MANUFACTURER}
Fabricante del artículo
Solo retail
{concepts.articleLongDescription}
Descripción larga del artículo
Texto tal cual: los saltos de línea no se convierten en <br>
{concepts.articleObs}
Observaciones del artículo
Texto 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 blanco
Texto plano. Para ver los saltos de línea, usa white-space: pre-line
{concepts.isMainConcept}
1 si el artículo es concepto principal
Solo retail. 0 o 1
{concepts.IMAGE}
Primera imagen del artículo
Solo retail. Dirección de la imagen, para <img src="{concepts.IMAGE}">
{concepts.PLATE_NUMBER}
Matrícula pedida en la línea
Solo retail
{concepts.SERIAL_NUMBER}
Número de serie pedido en la línea
Solo retail
Unidades
Variable
Qué contiene
Formato y notas
{concepts.units}
Unidades
Sin formatear (2.000000). Mejor usa una de las siguientes
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ículo
Solo retail. Coma decimal, con los decimales justos
{concepts.unitsObs}
Observaciones de las unidades
Solo retail
Precios e importes de la línea
Ninguno lleva el símbolo de moneda.
Variable
Qué contiene
Formato 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 descuento
Sin formatear, sin IVA
{concepts.COSTUDWODISCOUNT}
Precio unitario antes del descuento
Sin formatear, sin IVA
{concepts.discount}
Porcentaje de descuento de la línea
Formato de la plataforma (10,00), sin el signo %
{concepts.amountDiscount}
Descuento por unidad, en dinero
Formato de la plataforma
{concepts.fullDiscountLine}
Descuento de la línea en dinero: descuento por unidad por unidades
Sin formatear
{concepts.amount}
Importe de la línea: precio con descuento por unidades
Formato de la plataforma, sin IVA
{concepts.vat}
Porcentaje de IVA de la línea
Formato de la plataforma
{concepts.amountVat}
Cuota de IVA de la línea
Formato de la plataforma
{concepts.tax}
Porcentaje de IRPF de la línea
Formato de la plataforma
{concepts.amountTax}
Retención de IRPF de la línea
Formato de la plataforma
{concepts.amountSubtotal}
Fuera de retail: importe más IVA menos IRPF, con IVA. En retail: importe menos IRPF, sin IVA
Formato 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 -->
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:
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}).
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.
Al pulsar «Imprimir» o «Generar PDF» en la ventana de la vista previa, Yunbit guarda primero lo escrito en el formulario.
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 uses
Usa
Por 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 sustituta
No 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 description
Fuera 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 tabla
Si 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 sustituta
Siempre 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.
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.