Variables para plantillas: albaranes, packing list y justificantes de entrega

El albarán es el documento que acompaña a la mercancía de una expedición. Se imprime al terminar la preparación, desde *Documentos del pedido* y desde la web o el portal del cliente, y es también el que se adjunta en PDF a los correos. Con la misma plantilla salen el albarán sin precios, el packing list, el albarán personalizado y el packing list de contenidos. Este artículo explica además las plantillas de los albaranes de transferencia de stock y de los justificantes de entrega, que son distintas. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Qué documentos se imprimen o se envían con cada pedido se elige en el pedido, en el cliente o en el tipo de pedido: lo explica Pedidos: documentos a enviar e imprimir.

Cómo se elige la plantilla

La plantilla se da de alta en el gestor de *Plantillas* con «Aplica a» = Albaranes. Puede llevar un fichero de plantilla y, si quieres, tres imágenes: cabecera, margen y pie. Al imprimir, Yunbit busca la plantilla en este orden y usa la primera que encuentra:

  1. La «Plantilla de albarán» de la ficha del cliente del pedido.
  2. La «Plantilla de albarán» del «Cliente relacionado» del pedido.
  3. La «Plantilla de albarán» del tipo de pedido.
  4. La plantilla con «Por defecto» = Sí y «Aplica a» = Albaranes. Marca solo una: si hay varias, sale cualquiera de ellas.
  5. La plantilla estándar de Yunbit.

Detalles que conviene saber:

  • Si la plantilla de los pasos 1 a 3 no es de tipo «Albaranes», no se pasa al paso 4: sale directamente la plantilla estándar.
  • Si el registro de plantilla elegido no tiene fichero pero sí imágenes, sale la plantilla estándar con esas imágenes. Es la forma de poner tu logotipo sin maquetar nada.
  • Si la plantilla elegida tiene marcado «Mostrar artículos ocultos», salen también las líneas que no deberían salir en el albarán (por ejemplo, las que tienen «Mostrar en el albarán» = No).
  • Cuando una expedición lleva pedidos de varios clientes, la plantilla se elige con el primer pedido.

Las variantes y cómo distinguirlas

Al preparar una expedición, Yunbit guarda en *Documentos del pedido* varios documentos con el mismo número. Todos los que se ven en esta tabla usan la misma plantilla y las mismas variables; la plantilla sabe cuál está pintando por la variable {TYPE}:

Valor de {TYPE}Documento
0Albarán
1Albarán sin precios
2Packing list
4Albarán personalizado
5Packing list de contenidos

Yunbit calcula los precios, el IVA y los totales en todas las variantes. Quien los oculta es la plantilla. Si tu plantilla no pregunta por {TYPE}, el albarán sin precios y el packing list salen con precios.

Este ejemplo oculta los precios solo en el albarán sin precios:

<!-- IF TYPE == '1' -->
  <td></td>
<!-- ELSE -->
  <td>{blocks.PRODUCTS.UNIT_PRICE}</td>
<!-- ENDIF -->

Funciona en el albarán sin precios, pero el packing list (2), el albarán personalizado (4) y el packing list de contenidos (5) caen en el ELSE y enseñan el precio. Lo seguro es lo contrario: pintar los precios solo en el albarán (0), y así cualquier otra variante sale sin ellos.

<tr>
  <th>Referencia</th><th>Artículo</th><th>Unidades</th>
  <!-- IF TYPE == '0' --><th>Precio</th><th>Dto. %</th><th>Importe</th><!-- ENDIF -->
</tr>
...
<!-- IF TYPE == '0' -->
  <p>Base: {TOTAL_WITH_GLOBALDISCOUNT} · IVA: {TAXES} · Total: {TOTAL_IVA}</p>
<!-- ENDIF -->

Para el título del documento:

<!-- IF TYPE == '2' -->PACKING LIST<!-- ELSEIF TYPE == '5' -->PACKING LIST DE CONTENIDOS<!-- ELSE -->ALBARÁN<!-- ENDIF -->

Qué hace la plantilla estándar, por si quieres imitarla: precios y totales solo con TYPE == '0'; el logotipo se oculta en el packing list (TYPE != '2'), que se pensó como documento neutro; los artículos contenidos en cada línea solo salen en el packing list de contenidos (TYPE == '5'); el total de unidades sale en todas las variantes menos en el albarán.

El albarán personalizado

«Albarán personalizado» es una opción del campo «Documentos a imprimir en el packing» (en el pedido, el cliente o el tipo de pedido). Con esa opción, al terminar la preparación se imprime la misma plantilla de albarán con {TYPE} = 4. Solo es distinto de los demás si tu plantilla tiene una parte propia dentro de <!-- IF TYPE == '4' -->; si no, sale como el albarán sin precios.

En *Documentos del pedido*, el documento «Justificante de entrega» no abre el albarán: abre el justificante, que tiene su propia plantilla (ver Justificantes de entrega).

Variables generales

Formatos que se repiten en las tablas:

  • Importe: número con dos decimales, coma decimal y punto de millares (1.234,56), sin símbolo de moneda.
  • Número sin formato: tal como está guardado, con punto decimal (2.5, 21.00).
  • Fecha: dd/mm/aaaa.

Si la expedición lleva varios pedidos, el número de pedido y el de albarán salen como lista separada por comas; el resto de datos del pedido salen de uno de ellos.

Documento

VariableQué contieneFormato y notas
{TYPE}Variante del documento0 albarán, 1 sin precios, 2 packing list, 4 personalizado, 5 packing list de contenidos
{DELIVERY_NOTE_NUM}Número del albaránTodas las variantes llevan el mismo número
{DELIVERY_NOTE_DATE}Fecha del albarándd/mm/aaaa
{EXP_NUM}Número de la expediciónTexto
{timetodeliver}Días entre la fecha del pedido y la del albaránNúmero entero

Pedido

VariableQué contieneFormato y notas
{ORDER_NUMBER}Número del pedido de ventaLista separada por comas si hay varios
{ORDER_NUMBER_BARCODE}Código de barras de cada número de pedidoHTML: una imagen <img> dentro de un <div> por pedido
{ORDER_DATE}Fecha del pedidodd/mm/aaaa
{EXPECTED_DELIVERY_DATE}Fecha prevista de entregadd/mm/aaaa; vacía si no hay
{CLIENT_REF}Referencia que el cliente puso en su pedido («Su referencia»)No es el código del cliente: ese es {CLIENT_NUM}
{SU_REFERENCIA}Lo mismo que {CLIENT_REF}
{CLIENT_REF2}Segunda referencia del cliente en el pedidoTambién {SU_REFERENCIA2}
{OFFER_NUMBER}Número de la oferta de la que viene el pedidoVacío si no viene de una oferta
{CLIENT_OBSERVATIONS}Observaciones para el cliente de la ofertaVacío si no viene de una oferta
{DELIVERYNOTE_OBS}Observaciones del albarán (campo del pedido)Puede llevar saltos de línea (ver «Cuidado con»)
{SHIPPING_OBS}Observaciones de envío del pedidoTexto
{SHIPMENT_TYPE}Urgencia del envío: «Normal», «Urgente» o «Muy urgente» (la mayor de las líneas)Texto en castellano, no se traduce
{ORDER_DISCOUNT}Descuento global del pedido en %Número sin formato (5.00)
{RATENAME}Tarifa del clienteTexto

Cliente

VariableQué contieneFormato y notas
{CLIENT_NAME}Razón social del clienteTambién {SOCIALNAME}
{CLIENT_NUM}Código del cliente en YunbitTexto
{CLIENT_CIF}NIF del clienteTambién {DELIVERY_CIF}, que es el mismo NIF del cliente, no el de la dirección de entrega
{CLIENT_TELS}Teléfonos de la ficha del clienteTambién {TELS}
{applyEquivSurcharge}El cliente aplica recargo de equivalencia1 o 0

Dirección fiscal

VariableQué contieneFormato y notas
{ADDRESS_FISCAL}Dirección fiscal del clienteSi el cliente solo tiene una dirección, sale esa
{CP_FISCAL}Código postal fiscalTexto
{LOCALIDAD_FISCAL}Localidad fiscalEn el idioma de la plataforma
{PROVINCE_FISCAL}Provincia fiscalEn el idioma de la plataforma
{COUNTRY_FISCAL}País fiscalEn el idioma de la plataforma

Dirección de entrega

Es la dirección de la expedición si la tiene; si no, la del pedido.

VariableQué contieneFormato y notas
{DELIVERY_CLIENT}Nombre de empresa de la dirección; si no hay, su descripción; si no, la razón social del clienteTambién {DELIVERY_SOCIALNAME}
{DELIVERY_CLIENT_NAME}Igual, pero si la dirección no tiene nombre usa el nombre comercial del clienteTexto
{DELIVERY_ADDRESS}Dirección y númeroTexto
{DELIVERY_CP}Código postalTexto
{DELIVERY_LOC}LocalidadEn castellano
{DELIVERY_PROVINCE}ProvinciaEn castellano
{DELIVERY_PROVINCE_ID}Código de la provinciaNúmero (28, 35…)
{DELIVERY_COUNTRY}PaísEn castellano

Contactos y teléfonos

Hay tres sitios de donde salen los contactos: la dirección de entrega, el contacto del pedido (quien hace el pedido) y el contacto de recepción del pedido. Varias variables buscan en más de uno, en el orden de la tabla.

VariableQué contieneFormato y notas
{CLIENT_CONTACT}Persona de contacto de la dirección; si no hay, nombre y apellidos del contacto del pedidoTexto
{DELIVERY_CONTACT}Persona de contacto de la dirección; si no, el contacto de recepción; si no, el contacto del pedidoTexto
{CLIENT_CONTACT_EMAIL}Correo del contacto del pedidoTexto
{DELIVERY_CONTACT_EMAIL}Correo del contacto de recepción; si no, el de la dirección; si no, el del contacto del pedido; si no, el del clienteTexto
{DELIVERY_ADDRESS_EMAIL}Correo de la dirección; si no, el del contacto del pedidoTexto
{CLIENT_CONTACT_TELS}Teléfonos de la dirección; si no, móvil del contacto del pedido; si no, su teléfonoTexto
{DELIVERY_TELS}Teléfonos de la dirección; si no, los del contacto de recepción; si no, los del contacto del pedido; si no, los del clienteTexto
{DELIVERY_ADDRESS_TELS}Teléfonos de la dirección de entregaSolo de la dirección
{CONTACT_TELS}Teléfono del contacto del pedidoSolo de ese contacto
{CONTACT_CELLULAR}Móvil del contacto del pedidoSolo de ese contacto
{RECEPTION_CONTACT_TELS}Teléfono del contacto de recepciónSolo de ese contacto
{RECEPTION_CONTACT_CELLULAR}Móvil del contacto de recepciónSolo de ese contacto

Comercial, preparador y almacén

VariableQué contieneFormato y notas
{AGENT}Comercial: el propietario de la oferta de la que viene el pedidoVacío si el pedido no viene de una oferta. También {agent}, en minúsculas
{STORE_USER}Quien preparó la expedición (nombre completo)Texto
{STORE_USER_NAME}Quien preparó la expedición (solo el nombre de pila)Texto
{STORETITLE}Almacén de la primera líneaÚsalo solo si todo sale del mismo almacén; por línea está {blocks.PRODUCTS.STORETITLE}

Importes y totales

Todos los importes salen sin símbolo de moneda. Las líneas llevan IVA según el tipo de cliente; si la entrega es en Canarias (provincias 35 y 38), el IVA de las líneas es cero.

VariableQué contieneFormato y notas
{TOTAL}Suma de los importes de las líneas (con sus descuentos y promociones), antes del descuento global del pedidoImporte, sin IVA, sin portes
{AMOUNT_DISCOUNT}Importe del descuento global del pedidoImporte
{TOTAL_WITH_GLOBALDISCOUNT}{TOTAL} menos el descuento globalImporte, sin IVA, sin portes
{SHIPPING_COST}Portes del pedidoImporte, sin IVA; 0,00 si no hay
{BASE_PRICE}{TOTAL} más los portesImporte, sin IVA. No resta el descuento global: si el pedido lo tiene, no es la base imponible
{TAXES}Cuota de IVA de las líneas (ya con el descuento global) y de los portesImporte
{VAT_PERC}Porcentaje medio de IVA: {TAXES} entre {TOTAL_WITH_GLOBALDISCOUNT}Hasta dos decimales (21, 10,5). No es un tipo de IVA: con varios tipos o con portes no coincide con ninguno
{TOTAL_SURCHARGE}Recargo de equivalencia totalImporte; 0,00 salvo que la plataforma use recargo de equivalencia y el cliente lo aplique
{TOTAL_IVA}Total con IVA: {TOTAL_WITH_GLOBALDISCOUNT} + portes + {TAXES} + {TOTAL_SURCHARGE}Importe
{TOTAL_DISCOUNT}Suma de los descuentos de línea y de promocionesImporte; no incluye el descuento global
{TOTAL_QTY}Unidades totales del albaránNúmero sin formato
{TOTAL_QTY_WITHOUT_PACKAGING}Unidades totales sin contar los embalajesNúmero sin formato

Pago

VariableQué contieneFormato y notas
{WAY_TO_PAY}Forma de pago del pedido, en textoEn castellano, con entidades HTML (Domiciliaci&oacute;n). Solo trae transferencia, domiciliación, tarjeta, pagaré, talón, confirming y PayPal; para el resto sale vacía (ver «Preguntas frecuentes»)
{WAY_TO_PAY_VAL}Código de la forma de pago del pedidoTambién {PAYMENT_METHOD}. Úsalo con condiciones y textos traducidos
{TIME_TO_PAY}Plazo de pago por defecto del cliente (no el del pedido)Es un código: los días (30, 60) o un código especial (-1 por adelantado, 36 = 30-60-90, 38 = 60-90)

Envío y transporte

VariableQué contieneFormato y notas
{SHIPPING_COMPANY}Compañía de transporte de la expediciónVacía si la expedición no la tiene
{SHIPPING_SERVICE}Servicio de transporte de la expediciónTexto
{SHIPPING_ACCOUNT}Número de cuenta con el transportistaTexto
{SERVICE_PRICE}Precio del servicio de transporteNúmero sin formato
{SHIPMENT_METHOD}Quién transporta: 0 mis medios, 1 sus mediosTambién {SHIPPING_AND_TRACKING}
{MISMEDIOS_SUSMEDIOS}«Mis medios» o «Sus medios»Texto traducido
{PAGADOS_DEBIDOS}«Pagados» (mis medios) o «Debidos» (sus medios)Texto traducido
{TOTAL_WEIGHT}Peso total de la expediciónDos decimales con coma (12,50)
{TOTAL_VOLUMES}Volumen total de la expediciónDos decimales con coma, en m³
{NUM_PACKAGES}Número de bultos de la expediciónNúmero entero
{PACKAGE_LOCATIONS}Ubicaciones donde están los bultosLista separada por comas
{showOverweightAlert}Algún bulto pesa más de lo que admite su ubicación1 o vacía

Tu empresa

Salen de la ficha de cliente que corresponde a tu propia empresa. Si esa ficha no existe, salen vacías. Provincia y país salen en el idioma de la plataforma.

VariableQué contieneFormato y notas
{SOCIALNAME_PRIMECONTRACTOR}Razón socialTexto
{NAME_PRIMECONTRACTOR}Nombre comercialTexto
{CIF_PRIMECONTRACTOR}NIFTexto
{ADDRESS_PRIMECONTRACTOR}DirecciónTexto
{CP_PRIMECONTRACTOR}Código postalTexto
{PROVINCE_PRIMECONTRACTOR}ProvinciaTexto
{COUNTRY_PRIMECONTRACTOR}PaísTexto
{TELS_PRIMECONTRACTOR}TeléfonosTexto
{FAXS_PRIMECONTRACTOR}FaxTexto
{MAIL_PRIMECONTRACTOR}CorreoTexto
{URL_PRIMECONTRACTOR}WebTexto
{footer}Pie ya montado: razón social, dirección, teléfono, fax, NIF y webNunca está vacío, aunque falten datos: lleva siempre los textos fijos («Tel.», «Fax»…)

Imágenes de la plantilla

Son las imágenes del registro de plantilla elegido, aunque no tenga fichero.

VariableQué contieneFormato y notas
{ORDER_LOGO}Imagen de cabecera (logotipo)Dirección completa, con el servidor; vacía si no hay. Úsala en <img src="{ORDER_LOGO}">
{DELIVERY_MARGIN}Imagen del margenIgual
{DELIVERY_BOTTOM}Imagen del pieIgual

Otros

VariableQué contieneFormato y notas
{blocks_num}Número de grupos del bloque blocksSirve para poner subtotales solo si hay más de un grupo
{UNPREPARED_ARTICLES_QTY}Número de líneas del pedido que aún no están preparadas del todoNúmero entero
{UNPREPARED_ARTICLES_NO_PACKAGING_QTY}Lo mismo sin contar los embalajesNúmero entero
{DELIVERYNOTE_OR_PACKAGE}Cómo agrupa el albarán este cliente: 0 por bulto, 1 por albaránVer el bloque blocks
{pdf_puppeteer}, {pdf_docraptor}Valen 1 según el servicio que genera el PDFPara poner CSS distinto según el servicio, como hace la plantilla estándar

Bloques

Así se anidan los bloques del albarán:

blocks                            un grupo por capítulo de la oferta, por bulto o por albarán
  PRODUCTS                        líneas del grupo
    contained                     componentes de una línea que se prepara por componentes
  PACKAGES                        un subgrupo por bulto
    PRODUCTS                      líneas de ese bulto
      contained
UNPREPARED_ARTICLES               líneas del pedido que aún no están preparadas del todo
UNPREPARED_ARTICLES_NO_PACKAGING  lo mismo sin embalajes

blocks

Agrupa las líneas. Cómo se forman los grupos depende del campo «El documento de albarán agrupa por» de la ficha del cliente:

  • Por bulto (lo normal): un grupo por capítulo de la oferta, si las líneas vienen de capítulos. Si no, y la plataforma prepara con bultos automáticos, un grupo por bulto. Si no, un único grupo sin nombre.
  • Por albarán: un grupo por capítulo de la oferta o, si no hay capítulos, por número de albarán.
<!-- BEGIN blocks -->
  <h3>{blocks.NAME}</h3>
  <table>
    <!-- BEGIN PRODUCTS -->
      <tr><td>{blocks.PRODUCTS.PART_NUMBER}</td><td>{blocks.PRODUCTS.NAME}</td><td>{blocks.PRODUCTS.AMOUNT}</td></tr>
    <!-- END PRODUCTS -->
  </table>
<!-- END blocks -->
VariableQué contieneFormato y notas
{blocks.NAME}Nombre del capítulo, «Paquete N - número de bulto», «Albaran N» o vacío«Paquete» y «Albaran» van en castellano y sin traducir
{blocks.NAME_NO_PACKAGENUM}Como NAME, pero solo «Paquete N»Texto
{blocks.PACKAGE_NUMBER}Como NAME, pero «Paquete N - código del bulto»Texto
{blocks.TOTAL}Suma de los importes de las líneas del grupoSin IVA. Sale con los decimales y separadores que tenga configurados la plataforma, que pueden no ser los del resto de importes
{blocks.TOTAL_WEIGHT}Peso del bulto del grupoDos decimales con coma. Si no agrupas por bulto, usa {TOTAL_WEIGHT}
{blocks.TOTAL_QTY}Unidades del grupoNúmero sin formato
{blocks.TOTAL_QTY_WITHOUT_PACKAGING}Unidades del grupo sin contar embalajesNúmero sin formato
{blocks.HAS_OVERWEIGHT}El bulto pesa más de lo que admite su ubicación1 o 0

blocks.PRODUCTS

Una fila por cada línea del pedido que va en esta expedición. Una misma línea puede salir más de una vez: una por cada bulto o ubicación de la que se preparó. El ejemplo está en el bloque anterior. Los mismos campos están en blocks.PACKAGES.PRODUCTS.

Artículo y descripción

VariableQué contieneFormato y notas
{blocks.PRODUCTS.PART_NUMBER}Referencia del artículoPROMO en las líneas de promoción (ver más abajo)
{blocks.PRODUCTS.NAME}Nombre del artículo (el de la ficha)Texto
{blocks.PRODUCTS.CUSTOM_NAME}Nombre personalizado de la líneaTexto
{blocks.PRODUCTS.CUSTOM_DESC}Descripción corta de la líneaPuede llevar saltos de línea. La plantilla estándar la pone en lugar del nombre cuando está rellena
{blocks.PRODUCTS.CUSTOM_LONG_DESC}Descripción larga de la líneaPuede llevar saltos de línea (ver «Cuidado con»)
{blocks.PRODUCTS.MANUFACTURER}FabricanteTexto
{blocks.PRODUCTS.MODEL}ModeloTexto
{blocks.PRODUCTS.SIZE}Talla o tamañoTexto
{blocks.PRODUCTS.ART_COND}Condición del artículoTexto
{blocks.PRODUCTS.MEASUREMENT_UNIT}Unidad de medidaEn minúsculas
{blocks.PRODUCTS.MU_REFERENCE}Unidad de medidaTal como está escrita
{blocks.PRODUCTS.BLOCK_NAME}Capítulo de la ofertaTexto
{blocks.PRODUCTS.STORETITLE}Almacén de la líneaTexto
{blocks.PRODUCTS.POS}Posición de la línea en el pedidoNúmero

Cantidades

VariableQué contieneFormato y notas
{blocks.PRODUCTS.AMOUNT}Unidades que van en este albarán: es la que hay que pintarNúmero sin formato (2, 2.5)
{blocks.PRODUCTS.ORDER_QUANTITY}Unidades pedidas en la líneaNúmero sin formato
{blocks.PRODUCTS.PENDING}Unidades que quedan por servir después de este albaránNúmero
{blocks.PRODUCTS.PACKAGEQTY}Kits completos que van en el bultoSolo en artículos que se preparan por componentes
{blocks.PRODUCTS.CONTAINED_ARTICLES_NUM}Número de componentes del kit0 si no es un kit
{blocks.PRODUCTS.IS_PACKAGING}La línea es un embalaje1 o 0
{blocks.PRODUCTS.CHECK_STOCK}El artículo controla stock (0 = servicio)1 o 0

Precios e importes (sin IVA salvo que se diga otra cosa)

VariableQué contieneFormato y notas
{blocks.PRODUCTS.UNIT_PRICE}Precio unitario de la línea, ya con el descuento de clienteImporte
{blocks.PRODUCTS.CUSTOMER_DISCOUNT}Descuento de cliente en %Dos decimales con coma (10,00)
{blocks.PRODUCTS.DISCOUNT}Descuento adicional de la línea en %Número sin formato (5.00)
{blocks.PRODUCTS.WARRANTY_PERCENT}Extensión de garantía en %, que se suma al importeNúmero sin formato
{blocks.PRODUCTS.SUBTOTAL_PRICE}Importe de la línea: unidades × precio, con la garantía y el descuento adicionalImporte, sin IVA, sin el descuento global
{blocks.PRODUCTS.PROMO_DISCOUNT}Importe de la promoción aplicada a la líneaNúmero sin formato, negativo
{blocks.PRODUCTS.IVA}Tipo de IVA de la línea en %Número sin formato (21.00)
{blocks.PRODUCTS.PORC_SURCHARGE}Recargo de equivalencia en %Número sin formato
{blocks.PRODUCTS.SURCHARGE_PRICE}Importe del recargo de equivalencia de la líneaImporte; 0,00 salvo que la plataforma use recargo de equivalencia y el cliente lo aplique
{blocks.PRODUCTS.OA_UNIT_PRICE_VAT}Precio unitario de la línea con IVANúmero sin formato
{blocks.PRODUCTS.UNIT_PRICE_VAT}PVP con IVA de la ficha del artículo (no el de la línea)Número sin formato
{blocks.PRODUCTS.PVPR}Precio de venta recomendado de la fichaNúmero sin formato

Series, lotes, contenedores y bultos

VariableQué contieneFormato y notas
{blocks.PRODUCTS.SERIALNUMBER}Números de serie o lotes preparadosLista separada por comas; a veces separada por <br /> (HTML)
{blocks.PRODUCTS.BARCODE}Código de barras del número de serieTexto
{blocks.PRODUCTS.BATCHES_NUMS}Lotes de los contenedores de la líneaHTML: separados por <br />. Solo si usas contenedores y el artículo controla stock
{blocks.PRODUCTS.containerNum}Número del contenedor (palé, caja) del que salióVarios separados por <br> (HTML). Ojo a las minúsculas
{blocks.PRODUCTS.PACKAGE}Número de orden del bulto dentro de la expediciónNúmero
{blocks.PRODUCTS.PACKAGE_NUM}Número del bultoTexto
{blocks.PRODUCTS.PACKAGE_CODE}Código del bultoTexto
{blocks.PRODUCTS.PACKAGE_WEIGHT}Peso del bultoNúmero sin formato
{blocks.PRODUCTS.packageLocation}Código de la ubicación del bultoOjo a las minúsculas
{blocks.PRODUCTS.PIC}Número de albarán de la líneaSolo si el cliente agrupa por albarán
{blocks.PRODUCTS.WEIGHT}Peso unitario del artículoNúmero sin formato
{blocks.PRODUCTS.ROW_WEIGHT}Peso de la línea: peso unitario × unidadesDos decimales con coma (72,09)

Líneas de promoción. Si el pedido tiene una promoción de descuento sobre el carrito, detrás de la línea afectada sale otra fila con PART_NUMBER = PROMO, el nombre «Descuento promoción…» (en castellano), las unidades y el precio y el importe en negativo. Solo salen en blocks.PRODUCTS, no en blocks.PACKAGES.PRODUCTS. Para quitarlas del packing list:

<!-- IF blocks.PRODUCTS.PART_NUMBER != 'PROMO' --> ...fila... <!-- ENDIF -->

blocks.PRODUCTS.contained

Los componentes de una línea que se prepara por componentes (un kit), con lo que se ha preparado en esta expedición. En las demás líneas está vacío. La plantilla estándar lo pinta solo en el packing list de contenidos.

<!-- BEGIN blocks -->
  <!-- BEGIN PRODUCTS -->
    <tr><td>{blocks.PRODUCTS.PART_NUMBER}</td><td>{blocks.PRODUCTS.NAME}</td><td>{blocks.PRODUCTS.AMOUNT}</td></tr>
    <!-- IF TYPE == '5' -->
      <!-- BEGIN contained -->
        <tr><td></td><td>{blocks.PRODUCTS.contained.NAME}</td><td>{blocks.PRODUCTS.contained.QUANTITY}</td></tr>
      <!-- END contained -->
    <!-- ENDIF -->
  <!-- END PRODUCTS -->
<!-- END blocks -->
VariableQué contieneFormato y notas
{blocks.PRODUCTS.contained.PART_NUMBER}Referencia del componenteTexto
{blocks.PRODUCTS.contained.NAME}Nombre del componenteTexto
{blocks.PRODUCTS.contained.QUANTITY}UnidadesSin ceros sobrantes (2). En blocks.PACKAGES.PRODUCTS.contained sale sin formato (2.0000)
{blocks.PRODUCTS.contained.MEASUREMENT_UNIT}Unidad de medida en minúsculasSolo en blocks.PRODUCTS.contained
{blocks.PRODUCTS.contained.MU_REFERENCE}Unidad de medida tal como está escritaTexto
{blocks.PRODUCTS.contained.SERIALNUMBER}Número de serie o lote del componenteTexto
{blocks.PRODUCTS.contained.WEIGHT}Peso unitario del componenteNúmero sin formato

blocks.PACKAGES

Divide cada grupo en bultos. Úsalo si quieres pintar las líneas bulto a bulto; dentro, PRODUCTS y contained tienen los mismos campos que en blocks.PRODUCTS.

<!-- BEGIN blocks -->
  <!-- BEGIN PACKAGES -->
    <h4>{blocks.PACKAGES.NAME_NO_PACKAGENUM}</h4>
    <!-- BEGIN PRODUCTS -->
      <p>{blocks.PACKAGES.PRODUCTS.PART_NUMBER} · {blocks.PACKAGES.PRODUCTS.AMOUNT}</p>
    <!-- END PRODUCTS -->
  <!-- END PACKAGES -->
<!-- END blocks -->
VariableQué contieneFormato y notas
{blocks.PACKAGES.NAME}«Paquete N - número de bulto»Vacío si no hay bultos automáticos o si el cliente agrupa por albarán
{blocks.PACKAGES.NAME_NO_PACKAGENUM}«Paquete N»Texto
{blocks.PACKAGES.PACKAGE_NUMBER}«Paquete N - código del bulto»Texto

UNPREPARED_ARTICLES

Bloque de primer nivel con las líneas del pedido que tienen menos unidades preparadas (sumando todas sus expediciones) que pedidas. Sirve para avisar de lo que queda pendiente. UNPREPARED_ARTICLES_NO_PACKAGING tiene los mismos campos sin los embalajes.

<!-- IF UNPREPARED_ARTICLES_QTY > 0 -->
  <!-- BEGIN UNPREPARED_ARTICLES -->
    <tr><td>{UNPREPARED_ARTICLES.PART_NUMBER}</td><td>{UNPREPARED_ARTICLES.NAME}</td><td>{UNPREPARED_ARTICLES.UNPREPARED_QTY}</td></tr>
  <!-- END UNPREPARED_ARTICLES -->
<!-- ENDIF -->
VariableQué contieneFormato y notas
{UNPREPARED_ARTICLES.PART_NUMBER}ReferenciaTexto
{UNPREPARED_ARTICLES.NAME}Nombre del artículoTexto
{UNPREPARED_ARTICLES.QUANTITY}Unidades pedidasComa decimal; sin decimales si es entero
{UNPREPARED_ARTICLES.PREPARED_QTY}Unidades preparadasIgual
{UNPREPARED_ARTICLES.UNPREPARED_QTY}Unidades sin prepararIgual
{UNPREPARED_ARTICLES.IS_PACKAGING}Es un embalaje1 o 0

Albaranes de transferencia de stock

Es el albarán que acompaña a un traspaso de mercancía entre almacenes. Se imprime desde la preparación del traspaso y desde sus documentos. No tiene precios, cliente ni direcciones, y no tiene variantes: {TYPE} vale siempre 0.

Cómo se elige la plantilla

  1. La plantilla con «Por defecto» = Sí y «Aplica a» = Albaranes de transferencia de stock.
  2. Si no hay ninguna, la plantilla estándar de Yunbit.

La plantilla no tiene la opción «Mostrar artículos ocultos».

Variables generales

VariableQué contieneFormato y notas
{DELIVERY_NOTE_NUM}Número del albarán de traspasoTexto
{DELIVERY_NOTE_DATE}Fecha del documentodd/mm/aaaa
{EXP_NUM}Número de la expediciónTexto
{ORDER_NUMBER}Número de la preparación, no de un pedidoTexto
{ALMACEN_ORIGEN}Almacén de origenTexto
{ALMACEN_DESTINO}Almacén de destinoTexto
{SHIPPING_COMPANY}Compañía de transporte del traspasoTexto
{SHIPPING_SERVICE}Servicio de transporte del traspasoTexto
{STORE_USER}Quien preparó el traspasoTambién {agent}: aquí es el preparador, no un comercial
{blocks_num}Número de líneasNúmero entero
{ORDER_LOGO}, {DELIVERY_MARGIN}, {DELIVERY_BOTTOM}Imágenes de cabecera, margen y pie de la plantillaDirección desde la raíz, sin el servidor (/EPORTAL_IMGS/…)
{pdf_puppeteer}, {pdf_docraptor}Igual que en el albarán

Bloques

<!-- BEGIN blocks -->
  <h3>{blocks.NAME}</h3>
  <!-- BEGIN PRODUCTS -->
    <tr><td>{blocks.PRODUCTS.PART_NUMBER}</td><td>{blocks.PRODUCTS.NAME}</td><td>{blocks.PRODUCTS.SERIALNUMBER}</td><td>{blocks.PRODUCTS.AMOUNT}</td></tr>
  <!-- END PRODUCTS -->
<!-- END blocks -->

blocks tiene una sola fila:

VariableQué contieneFormato y notas
{blocks.NAME}El texto «TRASPASO DE STOCK»Fijo, en castellano
{blocks.TOTAL}Suma de las unidades (no es un importe)Formato inglés con cuatro decimales: 1,234.0000

blocks.PRODUCTS tiene una fila por artículo y número de serie preparado:

VariableQué contieneFormato y notas
{blocks.PRODUCTS.PART_NUMBER}ReferenciaTexto
{blocks.PRODUCTS.NAME}Nombre del artículoTambién ARTICLE_NAME
{blocks.PRODUCTS.MODEL}ModeloTexto
{blocks.PRODUCTS.SERIALNUMBER}Número de serie o lote preparadoTexto
{blocks.PRODUCTS.AMOUNT}Unidades preparadasNúmero sin formato
{blocks.PRODUCTS.NUM_OF_PACKAGE}Número de bultos de la preparaciónNúmero sin formato
{blocks.PRODUCTS.providerCode}Título del documentoSolo existe dentro del bloque
{blocks.PRODUCTS.DELIVERY_NOTE_DATE}Fecha del documentoSin formato (2026-11-13 10:20:00); fuera del bloque tienes {DELIVERY_NOTE_DATE} en dd/mm/aaaa

Dentro del bloque se repiten también DELIVERY_NOTE_NUM, EXP_NUM, ORDER_NUMBER, ALMACEN_ORIGEN, ALMACEN_DESTINO, SHIPPING_COMPANY, SHIPPING_SERVICE y STORE_USER, con el mismo valor que las variables generales.

Justificantes de entrega

El justificante de entrega es el documento que firma el transportista cuando recoge la mercancía. Recoge las expediciones de una recogida con sus bultos, pesos y destinatarios; no lleva artículos ni importes. Se abre desde *Documentos del pedido* («Justificante de entrega») y desde las recogidas, y se puede descargar en PDF.

Solo tiene datos si la expedición se ha recogido: una expedición sin recogida sale vacía.

Si el servicio de transporte tiene activado el DeCA (documento de control administrativo del transporte), en lugar del justificante se emite el DeCA, que tiene su propia plantilla. Sus variables están en DeCA: documento de control del transporte.

Cómo se elige la plantilla

  1. Si se abre desde el pedido, la «Plantilla de justificante de entrega» de la ficha del cliente del pedido.
  2. La plantilla con «Por defecto» = Sí y «Aplica a» = Justificantes de entrega.
  3. La plantilla estándar de Yunbit.

Las imágenes de cabecera, margen y pie del registro de plantilla no llegan al justificante: pon el logotipo en el HTML con su dirección completa.

Variables generales

Ojo: aquí las variables CLIENT_… son tu empresa, que es quien envía, no el destinatario. El destinatario de cada expedición está en el bloque pages.packages.

VariableQué contieneFormato y notas
{CLIENT_NAME}Tu empresa (nombre comercial)Texto
{CLIENT_ADDRESS}Dirección de tu empresaEn MAYÚSCULAS
{CLIENT_CP}Código postal de tu empresaTexto
{CLIENT_LOC}Localidad de tu empresaEn castellano
{CLIENT_PROVINCE}Provincia de tu empresaEn castellano
{CLIENT_CIF}NIF de tu empresaTexto
{comment}Comentario de la recogidaTexto
{multiple_orders}Hay más de un pedido en las expediciones1 o 0
{packages_num}Bultos totalesNúmero entero
{weight_total}Peso total de los bultosDos decimales con coma
{volumes_total}Volumen totalDos decimales con coma, en m³
{downloadURL}Dirección para descargar el documento en PDFPara un botón «Descargar PDF» en pantalla
{pdf_puppeteer}, {pdf_docraptor}Igual que en el albarán

Bloques

<!-- BEGIN pages -->
  <p>Recogida {pages.PICKUP_NUM} · {pages.CREATED} · {pages.CARRIER}</p>
  <table>
    <!-- BEGIN packages -->
      <tr><td>{pages.packages.EXP_NUM}</td><td>{pages.packages.CLIENT_NAME}</td><td>{pages.packages.NUM_PACKAGES}</td><td>{pages.packages.WEIGHT}</td></tr>
    <!-- END packages -->
  </table>
<!-- END pages -->

pages tiene una sola fila, con los datos de la recogida y de la primera expedición:

VariableQué contieneFormato y notas
{pages.CREATED}Fecha y hora de la recogidadd/mm/aaaa hh:mm:ss
{pages.PICKUP_NUM}Número de la recogidaTexto
{pages.CARRIER}Transportista, tal como se escribió en la recogidaTexto
{pages.STORE_USER}Usuario que registró la recogidaTexto
{pages.SHIPPING_COMPANY}Compañía de transporte de la recogidaTexto
{pages.ORDER_NUMBER}Pedidos (o traspasos) de la primera expediciónLista separada por comas
{pages.DELIVERY_NOTE_NUM}Número de albarán de la primera expediciónTexto
{pages.EXP_TYPE}«Pagados» o «Debidos»Texto traducido
{pages.TOTAL_VOLUMES}Volumen de la primera expediciónEn m³, con seis decimales

pages.packages tiene una fila por expedición recogida:

VariableQué contieneFormato y notas
{pages.packages.EXP_NUM}Número de la expediciónTexto
{pages.packages.ORDER_NUMBER}Pedidos (o traspasos) de la expediciónLista separada por comas
{pages.packages.DELIVERY_NOTE_NUM}Número de albaránTexto
{pages.packages.CLIENT_NAME}Destinatario: nombre de empresa de la dirección; si no hay, nombre comercial del clienteEn MAYÚSCULAS; -- si no hay ninguno
{pages.packages.CONTACT_NAME}Persona de contacto de la dirección; si no hay, el contacto del pedido-- si no hay ninguno
{pages.packages.TEL}Teléfonos de la dirección; si no hay, móvil del contacto; si no, su teléfonoTexto
{pages.packages.ADDRESS}Dirección de entrega y númeroTexto
{pages.packages.CP}Código postal de entregaTexto
{pages.packages.LOC}Localidad de entregaTexto
{pages.packages.SHIPPING_SERVICE}Servicio de transporteTexto
{pages.packages.SHIPPING_COMPANY}Compañía de transporte de la recogidaTexto
{pages.packages.EXP_TYPE}«Pagados» o «Debidos»Texto traducido
{pages.packages.NUM_PACKAGES}Bultos de la expedición en esta recogidaNúmero entero
{pages.packages.WEIGHT}Peso de esos bultosDos decimales con coma
{pages.packages.VOLUMES}Volumen de esos bultosDos decimales con coma, en m³
{pages.packages.CATEGORIES}Categorías principales de los artículosLista separada por comas
{pages.packages.COMMENT}Comentario de la recogidaTexto

Preguntas frecuentes

¿Cómo hago que el packing list salga sin precios?

Pon las columnas de precio, descuento e importe y la tabla de totales dentro de <!-- IF TYPE == '0' -->. Así solo salen en el albarán. Mira el apartado Las variantes y cómo distinguirlas.

¿Cómo pongo la forma de pago?

{WAY_TO_PAY} solo trae el texto de algunas formas de pago, en castellano. Para que salgan todas y traducidas, usa el código {WAY_TO_PAY_VAL} con los textos del diccionario:

<!-- IF WAY_TO_PAY_VAL == '0' -->{ydic_waytopay0}<!-- ELSEIF WAY_TO_PAY_VAL == '7' -->{ydic_waytopay7}<!-- ELSEIF WAY_TO_PAY_VAL == '8' -->{ydic_waytopay8}<!-- ELSE -->{WAY_TO_PAY}<!-- ENDIF -->

Las claves del diccionario son waytopay0 a waytopay8, waytopay_cesce, waytopay_americanexpress, waytopay_voucher y waytopay_cashondelivery.

¿Y el plazo y el vencimiento?

{TIME_TO_PAY} es el plazo por defecto del cliente, no el del pedido, y sale como código: «30-60-90» sale como 36. Escrito con «días» detrás daría «36 días». Tradúcelo con condiciones: -1 → {ydic_timetopay_now}, 36 → {ydic_timetopay306090}, 38 → {ydic_timetopay6090}, y los días normales con {ydic_timetopay30}, {ydic_timetopay60}, etc. No hay variable de fecha de vencimiento.

¿Qué tipo de IVA pongo en los totales?

El tipo está por línea: {blocks.PRODUCTS.IVA}. {VAT_PERC} es un porcentaje medio y no coincide con ningún tipo si hay varios o si hay portes. No hay desglose de bases por tipo de IVA. Si partes de la plantilla estándar, ten en cuenta que escribe «IVA (21%)» como texto fijo.

¿Qué importes llevan IVA?

Solo {TOTAL_IVA} (total) y {blocks.PRODUCTS.OA_UNIT_PRICE_VAT} (precio unitario, sin formato). Todos los demás importes son sin IVA. No hay importe de línea con IVA ni subtotal de grupo con IVA.

¿Hay variable para el comercial o el proyecto?

Comercial: {AGENT}, que es el propietario de la oferta; sale vacío si el pedido no viene de una oferta. No hay correo ni teléfono del comercial. Proyecto: no hay variable.

¿Cómo saco la descripción larga de cada línea?

{blocks.PRODUCTS.CUSTOM_LONG_DESC}. Ponla en una celda con style="white-space: pre-line" para que se vean los saltos de línea. También tienes CUSTOM_DESC (descripción corta) y CUSTOM_NAME (nombre personalizado).

¿Dónde están los lotes, números de serie y contenedores?

En cada línea: {blocks.PRODUCTS.SERIALNUMBER} (serie o lote preparado), {blocks.PRODUCTS.BATCHES_NUMS} (lotes de los contenedores) y {blocks.PRODUCTS.containerNum} (contenedor). Para los bultos, PACKAGE_NUM y PACKAGE_CODE en la línea, o recorre blocks.PACKAGES.

¿Cómo pongo la referencia del cliente y no su código?

{CLIENT_REF} (o {SU_REFERENCIA}) es la referencia que el cliente escribió en su pedido. El código del cliente en Yunbit es {CLIENT_NUM}.

¿Hay número de seguimiento del envío?

No. Tienes la expedición ({EXP_NUM}), la compañía y el servicio de transporte, los bultos, el peso y el volumen.

Nombres que no debes usar

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

No usesUsaPor qué
{CONTACT_NAME} (albarán y traspaso){CLIENT_CONTACT} o {DELIVERY_CONTACT}Sale siempre vacía
{SENDER_SOCIALNAME}{SOCIALNAME_PRIMECONTRACTOR}No existe
PagadosDebidos sin llaves{PAGADOS_DEBIDOS}Sin llaves sale el texto tal cual. Las copias antiguas de la plantilla estándar lo llevan así: revísalo si partiste de ella
{DELIVERY_NOTE_DATE} en el justificante{pages.CREATED} (fecha de la recogida)En el justificante no existe y sale vacía
{ORDER_DATE} en el traspaso{DELIVERY_NOTE_DATE}Un traspaso no tiene fecha de pedido: sale 01/01/1970
{providerCode} fuera del bloque en el traspaso{blocks.PRODUCTS.providerCode}Solo existe dentro del bloque
{NUM_PACKAGES}, {TOTAL_WEIGHT}, {CLIENT_REF}, {WAY_TO_PAY}, {TIME_TO_PAY}, {SHIPPING_OBS}, {DELIVERYNOTE_OBS} en el traspaso{blocks.PRODUCTS.NUM_OF_PACKAGE} para los bultos; el resto no tiene equivalenteSon del albarán y en el traspaso salen vacías
{CLIENT_NAME} en el justificante para el destinatario{pages.packages.CLIENT_NAME}En el justificante, {CLIENT_NAME} es tu empresa

Cuidado con

  • Precios en las variantes sin precio. Todas las variantes reciben los precios. Si la plantilla no los oculta con {TYPE}, salen.
  • Mayúsculas. {agent}, {footer}, {blocks_num}, {timetodeliver}, {showOverweightAlert}, {blocks.PRODUCTS.containerNum} y {blocks.PRODUCTS.packageLocation} van en minúsculas o mezcladas a propósito. Escríbelas tal cual.
  • Variables que traen HTML: {ORDER_NUMBER_BARCODE}, {WAY_TO_PAY}, {blocks.PRODUCTS.BATCHES_NUMS}, {blocks.PRODUCTS.containerNum} y a veces {blocks.PRODUCTS.SERIALNUMBER}. No las metas dentro de un atributo (title="…", alt="…").
  • Saltos de línea. Las observaciones y las descripciones no muestran sus saltos de línea en HTML. Pon white-space: pre-line en el elemento que las contiene.
  • Comparar importes en una condición. Los importes vienen con formato (1.234,56) y no se comparan bien como números. Compara con el texto (<!-- IF TOTAL != '0,00' -->) o con un campo sin formato.
  • **{footer} nunca está vacío**, así que <!-- IF footer != '' --> siempre se cumple.
  • Textos en castellano que no se traducen: {WAY_TO_PAY}, {SHIPMENT_TYPE}, «Paquete» y «Albaran» de {blocks.NAME}, el nombre de las líneas de promoción y «TRASPASO DE STOCK» del traspaso. Si la plantilla es para otro idioma, usa textos del diccionario.
  • Imágenes. En el albarán, {ORDER_LOGO}, {DELIVERY_MARGIN} y {DELIVERY_BOTTOM} traen la dirección completa. En el traspaso traen la dirección desde la raíz, sin el servidor, y en el justificante no llegan. Las hojas de estilo y las imágenes que pongas a mano, con dirección completa o desde la raíz, porque el PDF se genera pidiendo la página al servidor.
  • Formatos distintos dentro del mismo documento. {blocks.TOTAL} sigue la configuración de números de la plataforma; {blocks.TOTAL} del traspaso sale en formato inglés con cuatro decimales; {pages.TOTAL_VOLUMES} lleva seis decimales.
  • Llaves en el JavaScript y comentarios HTML. Lo explica la portada de la serie.

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