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:
La «Plantilla de albarán» de la ficha del cliente del pedido.
La «Plantilla de albarán» del «Cliente relacionado» del pedido.
La «Plantilla de albarán» del tipo de pedido.
La plantilla con «Por defecto» = Sí y «Aplica a» = Albaranes. Marca solo una: si hay varias, sale cualquiera de ellas.
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
0
Albarán
1
Albarán sin precios
2
Packing list
4
Albarán personalizado
5
Packing 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
Variable
Qué contiene
Formato y notas
{TYPE}
Variante del documento
0 albarán, 1 sin precios, 2 packing list, 4 personalizado, 5 packing list de contenidos
{DELIVERY_NOTE_NUM}
Número del albarán
Todas las variantes llevan el mismo número
{DELIVERY_NOTE_DATE}
Fecha del albarán
dd/mm/aaaa
{EXP_NUM}
Número de la expedición
Texto
{timetodeliver}
Días entre la fecha del pedido y la del albarán
Número entero
Pedido
Variable
Qué contiene
Formato y notas
{ORDER_NUMBER}
Número del pedido de venta
Lista separada por comas si hay varios
{ORDER_NUMBER_BARCODE}
Código de barras de cada número de pedido
HTML: una imagen <img> dentro de un <div> por pedido
{ORDER_DATE}
Fecha del pedido
dd/mm/aaaa
{EXPECTED_DELIVERY_DATE}
Fecha prevista de entrega
dd/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 pedido
También {SU_REFERENCIA2}
{OFFER_NUMBER}
Número de la oferta de la que viene el pedido
Vacío si no viene de una oferta
{CLIENT_OBSERVATIONS}
Observaciones para el cliente de la oferta
Vací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 pedido
Texto
{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 cliente
Texto
Cliente
Variable
Qué contiene
Formato y notas
{CLIENT_NAME}
Razón social del cliente
También {SOCIALNAME}
{CLIENT_NUM}
Código del cliente en Yunbit
Texto
{CLIENT_CIF}
NIF del cliente
Tambié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 cliente
También {TELS}
{applyEquivSurcharge}
El cliente aplica recargo de equivalencia
1 o 0
Dirección fiscal
Variable
Qué contiene
Formato y notas
{ADDRESS_FISCAL}
Dirección fiscal del cliente
Si el cliente solo tiene una dirección, sale esa
{CP_FISCAL}
Código postal fiscal
Texto
{LOCALIDAD_FISCAL}
Localidad fiscal
En el idioma de la plataforma
{PROVINCE_FISCAL}
Provincia fiscal
En el idioma de la plataforma
{COUNTRY_FISCAL}
País fiscal
En 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.
Variable
Qué contiene
Formato y notas
{DELIVERY_CLIENT}
Nombre de empresa de la dirección; si no hay, su descripción; si no, la razón social del cliente
También {DELIVERY_SOCIALNAME}
{DELIVERY_CLIENT_NAME}
Igual, pero si la dirección no tiene nombre usa el nombre comercial del cliente
Texto
{DELIVERY_ADDRESS}
Dirección y número
Texto
{DELIVERY_CP}
Código postal
Texto
{DELIVERY_LOC}
Localidad
En castellano
{DELIVERY_PROVINCE}
Provincia
En castellano
{DELIVERY_PROVINCE_ID}
Código de la provincia
Número (28, 35…)
{DELIVERY_COUNTRY}
País
En 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.
Variable
Qué contiene
Formato y notas
{CLIENT_CONTACT}
Persona de contacto de la dirección; si no hay, nombre y apellidos del contacto del pedido
Texto
{DELIVERY_CONTACT}
Persona de contacto de la dirección; si no, el contacto de recepción; si no, el contacto del pedido
Texto
{CLIENT_CONTACT_EMAIL}
Correo del contacto del pedido
Texto
{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 cliente
Texto
{DELIVERY_ADDRESS_EMAIL}
Correo de la dirección; si no, el del contacto del pedido
Texto
{CLIENT_CONTACT_TELS}
Teléfonos de la dirección; si no, móvil del contacto del pedido; si no, su teléfono
Texto
{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 cliente
Texto
{DELIVERY_ADDRESS_TELS}
Teléfonos de la dirección de entrega
Solo de la dirección
{CONTACT_TELS}
Teléfono del contacto del pedido
Solo de ese contacto
{CONTACT_CELLULAR}
Móvil del contacto del pedido
Solo de ese contacto
{RECEPTION_CONTACT_TELS}
Teléfono del contacto de recepción
Solo de ese contacto
{RECEPTION_CONTACT_CELLULAR}
Móvil del contacto de recepción
Solo de ese contacto
Comercial, preparador y almacén
Variable
Qué contiene
Formato y notas
{AGENT}
Comercial: el propietario de la oferta de la que viene el pedido
Vací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.
Variable
Qué contiene
Formato y notas
{TOTAL}
Suma de los importes de las líneas (con sus descuentos y promociones), antes del descuento global del pedido
Importe, sin IVA, sin portes
{AMOUNT_DISCOUNT}
Importe del descuento global del pedido
Importe
{TOTAL_WITH_GLOBALDISCOUNT}
{TOTAL} menos el descuento global
Importe, sin IVA, sin portes
{SHIPPING_COST}
Portes del pedido
Importe, sin IVA; 0,00 si no hay
{BASE_PRICE}
{TOTAL} más los portes
Importe, 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 portes
Importe
{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 total
Importe; 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 promociones
Importe; no incluye el descuento global
{TOTAL_QTY}
Unidades totales del albarán
Número sin formato
{TOTAL_QTY_WITHOUT_PACKAGING}
Unidades totales sin contar los embalajes
Número sin formato
Pago
Variable
Qué contiene
Formato y notas
{WAY_TO_PAY}
Forma de pago del pedido, en texto
En castellano, con entidades HTML (Domiciliació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 pedido
Tambié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
Variable
Qué contiene
Formato y notas
{SHIPPING_COMPANY}
Compañía de transporte de la expedición
Vacía si la expedición no la tiene
{SHIPPING_SERVICE}
Servicio de transporte de la expedición
Texto
{SHIPPING_ACCOUNT}
Número de cuenta con el transportista
Texto
{SERVICE_PRICE}
Precio del servicio de transporte
Número sin formato
{SHIPMENT_METHOD}
Quién transporta: 0 mis medios, 1 sus medios
Tambié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ón
Dos decimales con coma (12,50)
{TOTAL_VOLUMES}
Volumen total de la expedición
Dos decimales con coma, en m³
{NUM_PACKAGES}
Número de bultos de la expedición
Número entero
{PACKAGE_LOCATIONS}
Ubicaciones donde están los bultos
Lista separada por comas
{showOverweightAlert}
Algún bulto pesa más de lo que admite su ubicación
1 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.
Variable
Qué contiene
Formato y notas
{SOCIALNAME_PRIMECONTRACTOR}
Razón social
Texto
{NAME_PRIMECONTRACTOR}
Nombre comercial
Texto
{CIF_PRIMECONTRACTOR}
NIF
Texto
{ADDRESS_PRIMECONTRACTOR}
Dirección
Texto
{CP_PRIMECONTRACTOR}
Código postal
Texto
{PROVINCE_PRIMECONTRACTOR}
Provincia
Texto
{COUNTRY_PRIMECONTRACTOR}
País
Texto
{TELS_PRIMECONTRACTOR}
Teléfonos
Texto
{FAXS_PRIMECONTRACTOR}
Fax
Texto
{MAIL_PRIMECONTRACTOR}
Correo
Texto
{URL_PRIMECONTRACTOR}
Web
Texto
{footer}
Pie ya montado: razón social, dirección, teléfono, fax, NIF y web
Nunca 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.
Variable
Qué contiene
Formato 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 margen
Igual
{DELIVERY_BOTTOM}
Imagen del pie
Igual
Otros
Variable
Qué contiene
Formato y notas
{blocks_num}
Número de grupos del bloque blocks
Sirve 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 todo
Número entero
{UNPREPARED_ARTICLES_NO_PACKAGING_QTY}
Lo mismo sin contar los embalajes
Número entero
{DELIVERYNOTE_OR_PACKAGE}
Cómo agrupa el albarán este cliente: 0 por bulto, 1 por albarán
Ver el bloque blocks
{pdf_puppeteer}, {pdf_docraptor}
Valen 1 según el servicio que genera el PDF
Para 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 -->
Variable
Qué contiene
Formato 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 grupo
Sin 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 grupo
Dos decimales con coma. Si no agrupas por bulto, usa {TOTAL_WEIGHT}
{blocks.TOTAL_QTY}
Unidades del grupo
Número sin formato
{blocks.TOTAL_QTY_WITHOUT_PACKAGING}
Unidades del grupo sin contar embalajes
Número sin formato
{blocks.HAS_OVERWEIGHT}
El bulto pesa más de lo que admite su ubicación
1 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
Variable
Qué contiene
Formato y notas
{blocks.PRODUCTS.PART_NUMBER}
Referencia del artículo
PROMO 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ínea
Texto
{blocks.PRODUCTS.CUSTOM_DESC}
Descripción corta de la línea
Puede 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ínea
Puede llevar saltos de línea (ver «Cuidado con»)
{blocks.PRODUCTS.MANUFACTURER}
Fabricante
Texto
{blocks.PRODUCTS.MODEL}
Modelo
Texto
{blocks.PRODUCTS.SIZE}
Talla o tamaño
Texto
{blocks.PRODUCTS.ART_COND}
Condición del artículo
Texto
{blocks.PRODUCTS.MEASUREMENT_UNIT}
Unidad de medida
En minúsculas
{blocks.PRODUCTS.MU_REFERENCE}
Unidad de medida
Tal como está escrita
{blocks.PRODUCTS.BLOCK_NAME}
Capítulo de la oferta
Texto
{blocks.PRODUCTS.STORETITLE}
Almacén de la línea
Texto
{blocks.PRODUCTS.POS}
Posición de la línea en el pedido
Número
Cantidades
Variable
Qué contiene
Formato y notas
{blocks.PRODUCTS.AMOUNT}
Unidades que van en este albarán: es la que hay que pintar
Número sin formato (2, 2.5)
{blocks.PRODUCTS.ORDER_QUANTITY}
Unidades pedidas en la línea
Número sin formato
{blocks.PRODUCTS.PENDING}
Unidades que quedan por servir después de este albarán
Número
{blocks.PRODUCTS.PACKAGEQTY}
Kits completos que van en el bulto
Solo en artículos que se preparan por componentes
{blocks.PRODUCTS.CONTAINED_ARTICLES_NUM}
Número de componentes del kit
0 si no es un kit
{blocks.PRODUCTS.IS_PACKAGING}
La línea es un embalaje
1 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)
Variable
Qué contiene
Formato y notas
{blocks.PRODUCTS.UNIT_PRICE}
Precio unitario de la línea, ya con el descuento de cliente
Importe
{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 importe
Número sin formato
{blocks.PRODUCTS.SUBTOTAL_PRICE}
Importe de la línea: unidades × precio, con la garantía y el descuento adicional
Importe, sin IVA, sin el descuento global
{blocks.PRODUCTS.PROMO_DISCOUNT}
Importe de la promoción aplicada a la línea
Nú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ínea
Importe; 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 IVA
Nú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 ficha
Número sin formato
Series, lotes, contenedores y bultos
Variable
Qué contiene
Formato y notas
{blocks.PRODUCTS.SERIALNUMBER}
Números de serie o lotes preparados
Lista separada por comas; a veces separada por <br /> (HTML)
{blocks.PRODUCTS.BARCODE}
Código de barras del número de serie
Texto
{blocks.PRODUCTS.BATCHES_NUMS}
Lotes de los contenedores de la línea
HTML: 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ón
Número
{blocks.PRODUCTS.PACKAGE_NUM}
Número del bulto
Texto
{blocks.PRODUCTS.PACKAGE_CODE}
Código del bulto
Texto
{blocks.PRODUCTS.PACKAGE_WEIGHT}
Peso del bulto
Número sin formato
{blocks.PRODUCTS.packageLocation}
Código de la ubicación del bulto
Ojo a las minúsculas
{blocks.PRODUCTS.PIC}
Número de albarán de la línea
Solo si el cliente agrupa por albarán
{blocks.PRODUCTS.WEIGHT}
Peso unitario del artículo
Número sin formato
{blocks.PRODUCTS.ROW_WEIGHT}
Peso de la línea: peso unitario × unidades
Dos 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 -->
Variable
Qué contiene
Formato y notas
{blocks.PRODUCTS.contained.PART_NUMBER}
Referencia del componente
Texto
{blocks.PRODUCTS.contained.NAME}
Nombre del componente
Texto
{blocks.PRODUCTS.contained.QUANTITY}
Unidades
Sin ceros sobrantes (2). En blocks.PACKAGES.PRODUCTS.contained sale sin formato (2.0000)
{blocks.PRODUCTS.contained.MEASUREMENT_UNIT}
Unidad de medida en minúsculas
Solo en blocks.PRODUCTS.contained
{blocks.PRODUCTS.contained.MU_REFERENCE}
Unidad de medida tal como está escrita
Texto
{blocks.PRODUCTS.contained.SERIALNUMBER}
Número de serie o lote del componente
Texto
{blocks.PRODUCTS.contained.WEIGHT}
Peso unitario del componente
Nú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 -->
Variable
Qué contiene
Formato 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 -->
Variable
Qué contiene
Formato y notas
{UNPREPARED_ARTICLES.PART_NUMBER}
Referencia
Texto
{UNPREPARED_ARTICLES.NAME}
Nombre del artículo
Texto
{UNPREPARED_ARTICLES.QUANTITY}
Unidades pedidas
Coma decimal; sin decimales si es entero
{UNPREPARED_ARTICLES.PREPARED_QTY}
Unidades preparadas
Igual
{UNPREPARED_ARTICLES.UNPREPARED_QTY}
Unidades sin preparar
Igual
{UNPREPARED_ARTICLES.IS_PACKAGING}
Es un embalaje
1 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
La plantilla con «Por defecto» = Sí y «Aplica a» = Albaranes de transferencia de stock.
Si no hay ninguna, la plantilla estándar de Yunbit.
La plantilla no tiene la opción «Mostrar artículos ocultos».
Variables generales
Variable
Qué contiene
Formato y notas
{DELIVERY_NOTE_NUM}
Número del albarán de traspaso
Texto
{DELIVERY_NOTE_DATE}
Fecha del documento
dd/mm/aaaa
{EXP_NUM}
Número de la expedición
Texto
{ORDER_NUMBER}
Número de la preparación, no de un pedido
Texto
{ALMACEN_ORIGEN}
Almacén de origen
Texto
{ALMACEN_DESTINO}
Almacén de destino
Texto
{SHIPPING_COMPANY}
Compañía de transporte del traspaso
Texto
{SHIPPING_SERVICE}
Servicio de transporte del traspaso
Texto
{STORE_USER}
Quien preparó el traspaso
También {agent}: aquí es el preparador, no un comercial
Imágenes de cabecera, margen y pie de la plantilla
Direcció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:
Variable
Qué contiene
Formato 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:
Variable
Qué contiene
Formato y notas
{blocks.PRODUCTS.PART_NUMBER}
Referencia
Texto
{blocks.PRODUCTS.NAME}
Nombre del artículo
También ARTICLE_NAME
{blocks.PRODUCTS.MODEL}
Modelo
Texto
{blocks.PRODUCTS.SERIALNUMBER}
Número de serie o lote preparado
Texto
{blocks.PRODUCTS.AMOUNT}
Unidades preparadas
Número sin formato
{blocks.PRODUCTS.NUM_OF_PACKAGE}
Número de bultos de la preparación
Número sin formato
{blocks.PRODUCTS.providerCode}
Título del documento
Solo existe dentro del bloque
{blocks.PRODUCTS.DELIVERY_NOTE_DATE}
Fecha del documento
Sin 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
Si se abre desde el pedido, la «Plantilla de justificante de entrega» de la ficha del cliente del pedido.
La plantilla con «Por defecto» = Sí y «Aplica a» = Justificantes de entrega.
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.
Variable
Qué contiene
Formato y notas
{CLIENT_NAME}
Tu empresa (nombre comercial)
Texto
{CLIENT_ADDRESS}
Dirección de tu empresa
En MAYÚSCULAS
{CLIENT_CP}
Código postal de tu empresa
Texto
{CLIENT_LOC}
Localidad de tu empresa
En castellano
{CLIENT_PROVINCE}
Provincia de tu empresa
En castellano
{CLIENT_CIF}
NIF de tu empresa
Texto
{comment}
Comentario de la recogida
Texto
{multiple_orders}
Hay más de un pedido en las expediciones
1 o 0
{packages_num}
Bultos totales
Número entero
{weight_total}
Peso total de los bultos
Dos decimales con coma
{volumes_total}
Volumen total
Dos decimales con coma, en m³
{downloadURL}
Dirección para descargar el documento en PDF
Para 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:
Variable
Qué contiene
Formato y notas
{pages.CREATED}
Fecha y hora de la recogida
dd/mm/aaaa hh:mm:ss
{pages.PICKUP_NUM}
Número de la recogida
Texto
{pages.CARRIER}
Transportista, tal como se escribió en la recogida
Texto
{pages.STORE_USER}
Usuario que registró la recogida
Texto
{pages.SHIPPING_COMPANY}
Compañía de transporte de la recogida
Texto
{pages.ORDER_NUMBER}
Pedidos (o traspasos) de la primera expedición
Lista separada por comas
{pages.DELIVERY_NOTE_NUM}
Número de albarán de la primera expedición
Texto
{pages.EXP_TYPE}
«Pagados» o «Debidos»
Texto traducido
{pages.TOTAL_VOLUMES}
Volumen de la primera expedición
En m³, con seis decimales
pages.packages tiene una fila por expedición recogida:
Variable
Qué contiene
Formato y notas
{pages.packages.EXP_NUM}
Número de la expedición
Texto
{pages.packages.ORDER_NUMBER}
Pedidos (o traspasos) de la expedición
Lista separada por comas
{pages.packages.DELIVERY_NOTE_NUM}
Número de albarán
Texto
{pages.packages.CLIENT_NAME}
Destinatario: nombre de empresa de la dirección; si no hay, nombre comercial del cliente
En 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éfono
Texto
{pages.packages.ADDRESS}
Dirección de entrega y número
Texto
{pages.packages.CP}
Código postal de entrega
Texto
{pages.packages.LOC}
Localidad de entrega
Texto
{pages.packages.SHIPPING_SERVICE}
Servicio de transporte
Texto
{pages.packages.SHIPPING_COMPANY}
Compañía de transporte de la recogida
Texto
{pages.packages.EXP_TYPE}
«Pagados» o «Debidos»
Texto traducido
{pages.packages.NUM_PACKAGES}
Bultos de la expedición en esta recogida
Número entero
{pages.packages.WEIGHT}
Peso de esos bultos
Dos decimales con coma
{pages.packages.VOLUMES}
Volumen de esos bultos
Dos decimales con coma, en m³
{pages.packages.CATEGORIES}
Categorías principales de los artículos
Lista separada por comas
{pages.packages.COMMENT}
Comentario de la recogida
Texto
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:
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 uses
Usa
Por 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 equivalente
Son 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.
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.