Variables para plantillas: tarifas

Es el listado imprimible de una tarifa: su nombre, sus dos descripciones y todas sus excepciones (precio especial por artículo, categoría, fabricante…), agrupadas por bloque de tarifa. Se abre desde la ficha de la tarifa, en «Vista previa»: sale una ventana con botones para imprimir y para generar el PDF.

La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Antes de empezar

  • Las plantillas se dan de alta en el gestor de plantillas de documentos.
  • Solo se usa la plantilla marcada por defecto. No se puede elegir plantilla por cliente, por tipo ni en el propio documento.
  • La marca «Antigua» no cuenta aquí. Una plantilla antigua que siga marcada como «¿Es la plantilla por defecto para el metagrupo?» = Sí se sigue usando. Para dejar de usarla, quítale la marca de por defecto.
  • De las imágenes de la ficha de la plantilla solo se usa la de logo o cabecera, en {LOGO}. La de margen y la de pie no se usan.

Cómo se elige la plantilla

Se da de alta con «Aplica a» = Tarifas. Yunbit usa la primera que encuentra:

  1. La plantilla por defecto de tu empresa: «Aplica a» = Tarifas y «¿Es la plantilla por defecto para el metagrupo?» = Sí, dada de alta en el mismo metagrupo desde el que abres la tarifa. Una plantilla de otro metagrupo no sirve.
  2. Un diseño propio de tu empresa, si Yunbit lo ha preparado.
  3. La plantilla estándar de Yunbit.

Variables

VariableQué contieneFormato y notas
{LOGO}La imagen de logo o cabecera subida en la ficha de la plantillaDirección de la imagen, para <img src="{LOGO}">. Vacía si la plantilla no tiene imagen de cabecera o si se usa la plantilla estándar
{RATENAME}Nombre de la tarifaVacío si la tarifa no tiene excepciones
{DESCRIPTION1}Descripción 1 de la tarifaTrae HTML (el campo se edita con formato). Vacía si la tarifa no tiene excepciones
{DESCRIPTION2}Descripción 2 de la tarifaTrae HTML. Vacía si la tarifa no tiene excepciones

Textos traducidos en Tarifas

Aquí funcionan las dos formas de escribir un texto del diccionario:

  • {ydic_clave} y {ydics_clave}, como en todas las plantillas (lo explica la portada). Es la forma recomendada.
  • {dic_clave}, que solo existe en Tarifas. Saca el texto en el idioma con el que se abre la vista previa. Para el plural se añade una s al nombre: {dic_claves}.

La plantilla estándar no usa ninguna de las dos: «TARIFAS», «Artículo», «Tipo de recargo», «Recargo/Importe neto», «Fecha desde», «Fecha hasta», «Cantidad desde» y «Cantidad hasta» están escritos en castellano.

Bloques

BLOCKS: un bloque de tarifa

BLOCKS se repite una vez por cada bloque de la tarifa, en el orden de los bloques. Las excepciones que no tienen bloque van juntas en un grupo sin nombre. Dentro va el bloque RATES, con las excepciones de ese bloque:

<!-- BEGIN BLOCKS -->
  <h3>{BLOCKS.NAME}</h3>
  <table>
  <!-- BEGIN RATES -->
    <tr>
      <td>{BLOCKS.RATES.OBJECTNAME}</td>
      <td>{BLOCKS.RATES.RECHARGO_TYPE}</td>
      <td>{BLOCKS.RATES.RECHARGO}</td>
    </tr>
  <!-- END RATES -->
  </table>
<!-- END BLOCKS -->

Los nombres de estos dos bloques van en mayúsculas. Dentro de RATES también puedes escribir los campos con el nombre corto: {RATES.OBJECTNAME}.

VariableQué contieneFormato y notas
{BLOCKS.NAME}Nombre del bloque de tarifaVacío en el grupo de excepciones sin bloque. Una excepción hija sin bloque propio va en el bloque de su madre

BLOCKS.RATES: una excepción de la tarifa

RATES se repite una vez por cada excepción del bloque. Las excepciones hijas van justo después de su madre (solo un nivel: las hijas de una hija no salen).

VariableQué contieneFormato y notas
{BLOCKS.RATES.OBJECTNAME}A qué se aplica la excepción: nombre del artículo, familia, característica, categoría, fabricante, compañía de transporte o servicio de transporteVacío en las excepciones de otro tipo (cliente, condición, almacén…)
{BLOCKS.RATES.RECHARGO_TYPE}Tipo de recargoTexto fijo en castellano: Porcentual, Directo o Importe neto
{BLOCKS.RATES.RECHARGO}Valor del recargo o importe, con su símbolo pegado detrásSin formatear, con punto decimal y cuatro decimales: 10.0000%. Lleva € solo con «Importe neto»; con «Porcentual» y «Directo» lleva %. Es el valor tal como se grabó en la excepción, sin añadir ni quitar IVA
{BLOCKS.RATES.FROM_DATE}Fecha desdedd-mm-aaaa. Vacía si no tiene
{BLOCKS.RATES.TO_DATE}Fecha hastadd-mm-aaaa. Vacía si no tiene
{BLOCKS.RATES.FROM_QTY}Cantidad desdeNúmero sin formatear, con punto decimal
{BLOCKS.RATES.TO_QTY}Cantidad hastaNúmero sin formatear, con punto decimal
{BLOCKS.RATES.FROM_AGE}Edad desdeNúmero. Para las tarifas por edad (viajes)
{BLOCKS.RATES.TO_AGE}Edad hastaNúmero
{BLOCKS.RATES.UM}Unidad de medidaEn una excepción de artículo, la unidad del artículo. En una de categoría, la unidad más usada por sus artículos, o UDS. En las demás, vacía
{BLOCKS.RATES.LOGISTICS}Embalajes logísticos del artículo o de los artículos de la categoríaTexto como Caja: 12 UDS - Palé: 480 UDS. Solo en excepciones de artículo o de categoría
{BLOCKS.RATES.TYPE}Tipo de excepción, en número0 artículo, 1 fabricante, 2 categoría, 3 condición, 4 familia, 5 compañía de transporte, 6 servicio de transporte, 7 entrada, 8 RMA, 9 recogida, 10 almacén, 11 ubicación, 12 tramo de servicio de transporte, -1 cliente o proveedor, -2 sector. Sirve para condiciones: <!-- IF RATES.TYPE == '0' -->
{BLOCKS.RATES.FK_PARENT_EXCEPTION}Si la excepción es hija, la referencia interna de su madreVacía en las excepciones de primer nivel. Úsala en una condición para sangrar las hijas: <!-- IF RATES.FK_PARENT_EXCEPTION != '' -->
{BLOCKS.RATES.BLOCKNAME}Nombre del bloqueLo mismo que {BLOCKS.NAME}
{BLOCKS.RATES.RATENAME}Nombre de la tarifaIgual en todas las filas
{BLOCKS.RATES.DESCRIPTION1}Descripción 1 de la tarifaTrae HTML. Igual en todas las filas
{BLOCKS.RATES.DESCRIPTION2}Descripción 2 de la tarifaTrae HTML. Igual en todas las filas

Cuidado con

  • La plantilla tiene que estar en el metagrupo desde el que trabajas. Si la creas en otro, la vista previa sale con la plantilla estándar.
  • Sube siempre el fichero de plantilla. Si la plantilla por defecto no tiene fichero (por ejemplo, solo le subiste el logo), Yunbit no pasa a la plantilla estándar y la vista previa no sale bien.
  • La plantilla estándar oculta las filas con OBJECTNAME vacío (<!-- IF RATES.OBJECTNAME != '' -->). Por eso no salen las excepciones por cliente, condición, almacén y demás tipos sin nombre. Si quieres verlas, quita esa condición y usa {RATES.TYPE} para escribir de qué tipo son.
  • Con dos o más embalajes, {RATES.LOGISTICS} termina con un - de sobra: Caja: 12 UDS - Palé: 480 UDS - . Con un solo embalaje sale bien.
  • Si usas recargos de tipo «Directo», el valor sale con % detrás. Pon al lado la columna {RATES.RECHARGO_TYPE} para que se entienda.
  • {RATENAME}, {DESCRIPTION1} y {DESCRIPTION2} salen vacíos si la tarifa no tiene ninguna excepción.
  • Las descripciones traen HTML: ponlas en un <div>, no dentro de un <p> ni de un atributo.

Preguntas frecuentes

¿Puedo tener una plantilla distinta para cada cliente?

No. Solo se usa la plantilla marcada por defecto.

¿Puedo poner importes, forma de pago, vencimiento, IVA, comercial o proyecto?

No. El único importe es el de cada excepción, {RATES.RECHARGO}, tal como se grabó y sin añadir ni quitar IVA.

¿Cómo pongo el logo de mi empresa?

Sube la imagen como logo o cabecera en la ficha de la plantilla y usa <img src="{LOGO}">.

¿Puedo traducir los textos de la plantilla?

Sí, con {ydic_clave} o con {dic_clave}.

Nombres que no debes usar

Estos nombres salen en la plantilla estándar o parecen lógicos, pero salen vacíos o con otro valor:

No usesUsaPor qué
{proposal_bottom}El pie escrito directamente en la plantillaSale siempre vacía: la imagen de pie de la ficha de la plantilla no se usa

La serie «Variables para plantillas»

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