Variables para plantillas: etiqueta de expedición

La etiqueta de expedición es la etiqueta que Yunbit imprime para cada bulto cuando el envío no va por un transportista con integración: envíos con transportista propio o sin conexión, y envíos por «Sus medios». Sale al terminar el Pick & Pack y también se puede volver a imprimir desde la ficha de la expedición o desde el pedido. Se puede maquetar en HTML (se imprime desde el navegador o se pasa a PDF), en ZPL para impresoras Zebra o en SBPL para impresoras SATO. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Cómo se elige la plantilla

Las plantillas se dan de alta en el gestor de plantillas de documentos. Hay un «Aplica a» para cada formato:

«Aplica a»FormatoCuándo se usa
Etiqueta de expediciónHTMLEl puesto de Pick & Pack no tiene impresora Zebra ni SATO: la etiqueta se abre en el navegador
Etiqueta de expedición (ZPL)ZPLEl puesto imprime en una impresora Zebra
Etiqueta de expedición (SBPL)SBPLEl puesto imprime en una impresora SATO

El formato lo decide la pantalla desde la que se imprime. En el Pick & Pack depende de la impresora configurada en el puesto. En la ficha de la expedición hay un botón para cada formato.

Para el formato que toca, Yunbit busca la plantilla en este orden y usa la primera que encuentra:

  1. La del tipo de pedido: campo «Plantilla de expedición» de la ficha del tipo de pedido. Solo se usa si su formato coincide con el que se imprime: si el tipo tiene una plantilla HTML y el puesto imprime en una Zebra, se pasa al paso 2 y se busca una ZPL. Aquí se usa aunque la plantilla esté marcada como «Antigua».
  2. La plantilla por defecto de tu empresa: la que tiene ese «Aplica a», «¿Es la plantilla por defecto?» = Sí y no está marcada como «Antigua».
  3. Un diseño propio de tu empresa: si Yunbit ha preparado un diseño propio para tu empresa, se usa antes que el estándar.
  4. La plantilla estándar de Yunbit.

Ten en cuenta también:

  • No hay plantilla por transportista, por servicio de transporte ni por cliente. Si la etiqueta tiene que cambiar según el transportista, hazlo dentro de la plantilla con una condición (lo verás en Bloques).
  • Si la expedición junta pedidos de varios tipos, se usa la plantilla del tipo de uno de ellos. Si necesitas que salga siempre la misma, pon la misma plantilla en todos esos tipos.
  • Las expediciones de traspasos de stock no tienen tipo de pedido: usan siempre la plantilla por defecto o la estándar.
  • Deja una sola plantilla por defecto de cada formato. Si hay varias, no se puede saber cuál saldrá.
  • Si una plantilla del gestor no tiene fichero subido, se pasa al paso siguiente sin avisar.

Variables generales

En esta etiqueta casi todo va dentro del bloque labels, que se repite una vez por bulto: las variables están en Bloques. Fuera del bloque solo hay dos, que también se pueden usar dentro:

VariableQué contieneFormato y notas
{NUM_UNITS_DELIVERYNOTE}Unidades preparadas de toda la expedición, contando solo los artículos que salen en el albaránNúmero sin formatear, con punto y cuatro decimales: 12.0000. No cuenta los embalajes ni los artículos ocultos en el albarán
{NUM_UNITS_DELIVERYNOTE_MIN_DECS}Lo mismo, sin ceros decimales de sobraCon los separadores de tu empresa: 12, 2,5. Es la que conviene mostrar

Bloques

labels: una etiqueta por bulto

El bloque labels se repite una vez por cada bulto que se imprime, en orden de número de bulto. Todo lo que tiene que salir en cada etiqueta va dentro. Las variables se escriben con el prefijo labels.: {labels.CLIENT_NAME}.

En HTML, pon cada etiqueta en un elemento con salto de página detrás y fija el tamaño del papel:

<style media="print">
  @page { size: 100mm 152mm; margin: 1mm; }
  .break { page-break-after: always; }
</style>
<!-- BEGIN labels -->
<div class="break">
  <p>{labels.METAGROUP_CLIENT_NAME}</p>
  <p><strong>ENVIAR A:</strong><br>
     {labels.CLIENT_NAME}<br>
     {labels.CONTACT_ADDRESS}<br>
     {labels.CLIENT_CP} - {labels.CLIENT_LOC}</p>
  <p>Bulto {labels.CURRENT} de {labels.TOTAL} · {labels.PACKAGE_WEIGHT} kg</p>
  {labels.BARCODE}
  <p>{labels.BARCODE_TEXT}</p>
</div>
<!-- END labels -->

En ZPL, ^XA y ^XZ van dentro del bloque, para que cada bulto sea una etiqueta Zebra. ^CI28 hace que salgan bien las tildes y las eñes:

<!-- BEGIN labels -->
^XA
^CI28
^FO10,10^A0N,40,40^FD{labels.METAGROUP_CLIENT_NAME}^FS
^FO10,80^A0N,30,30^FDEnviar a: {labels.CLIENT_NAME}^FS
^FO10,120^A0N,30,30^FD{labels.CONTACT_ADDRESS}^FS
^FO10,160^A0N,30,30^FD{labels.CLIENT_CP} - {labels.CLIENT_LOC}^FS
^FO10,220^A0N,30,30^FDBulto {labels.CURRENT} de {labels.TOTAL}^FS
^FO40,280^BCN,100,Y,N,N^FD{labels.BARCODE_TEXT}^FS
^XZ
<!-- END labels -->

En SBPL, cada etiqueta empieza por ^A y acaba con ^Q1 y ^Z, todo dentro del bloque:

<!-- BEGIN labels -->
^A
^H15^V15
^RDB-0,P26,P26,{labels.METAGROUP_CLIENT_NAME}
^H15^V120
^RDB-0,P10,P10,{labels.CLIENT_NAME}
^H15^V170
^RDB-0,P10,P10,{labels.CLIENT_CP} - {labels.CLIENT_LOC}
^H15^V220
^RDB-0,P10,P10,Bulto {labels.CURRENT} de {labels.TOTAL}
^H220^V870
^BG02100{labels.BARCODE_TEXT}
^Q1
^Z
<!-- END labels -->

Para cambiar textos según el caso, usa condiciones dentro del bloque. La variable va sin llaves dentro de la condición:

<!-- IF labels.REL_TYPE != 'StockTransference' -->Nº Pedido:<!-- ELSE -->Nº Traspaso:<!-- ENDIF --> {labels.ORDER_NUMBER}
<!-- IF labels.SHIPPING_COMPANY == 'Transportes García' --> … <!-- ELSEIF labels.PORTES == 'DEBIDOS' --> … <!-- ENDIF -->
<!-- IF labels.CLIENT_TEL != '' --> ({labels.CLIENT_TEL})<!-- ENDIF -->

Bulto

VariableQué contieneFormato y notas
{labels.CURRENT}Posición de este bulto dentro de la expedición: 1, 2, 3…Número entero. Para «bulto 2 de 5»: {labels.CURRENT} de {labels.TOTAL}
{labels.TOTAL}Número total de bultos de la expediciónNúmero entero. Si se imprime un solo bulto (desde el clasificador o al regenerar la etiqueta de un bulto concreto), vale 1 y CURRENT también: sale «1 de 1» aunque la expedición tenga más
{labels.PACKAGE_REF}Número interno del bultoNúmero entero único entre todos los bultos de tu empresa (por ejemplo, 48213). No es la posición 1, 2, 3…
{labels.PACKAGE_WEIGHT}Peso del bultoCon punto y dos decimales: 2.50. Sin unidad: escríbela tú detrás (la estándar pone « KG»)
{labels.PACKAGE_VOLUME}Volumen del bultoCon punto y cuatro decimales: 0.0120; 0 si el bulto no tiene volumen. Sin unidad
{labels.BARCODE_TEXT}Código de barras del bulto, en textoEs lo que hay que poner en el código de barras de ZPL (^BC…^FD) o de SBPL (^BG). Vacía si el bulto no tiene código de barras
{labels.BARCODE}Imagen del código de barras del bultoSolo en HTML: en ZPL y SBPL sale vacía. Llega como HTML: <img class='barcode' src='data:image/gif;base64,…' />. El tamaño se ajusta con CSS sobre la clase barcode. El tipo de código es el configurado para los bultos en tu plataforma (Code 128 si no se ha cambiado)
{labels.NUM_UNITS_PACKAGE}Unidades preparadas que van en este bultoNúmero sin formatear, con punto: 3.0000. No cuenta los embalajes. 0 si no consta
{labels.NUM_UNITS_PACKAGE_MIN_DECS}Lo mismo, sin ceros decimales de sobraCon los separadores de tu empresa: 3, 2,5, 1.250. Es la que conviene mostrar
{labels.NUM_UNITS_PACKAGE_DELIVERYNOTE}Unidades del bulto contando solo los artículos que salen en el albaránNúmero sin formatear. Además de los embalajes, no cuenta los artículos ocultos en el albarán
{labels.NUM_UNITS_PACKAGE_DELIVERYNOTE_MIN_DECS}Lo mismo, sin ceros decimales de sobraCon los separadores de tu empresa

Expedición y pedido

VariableQué contieneFormato y notas
{labels.EXPEDITION_NUM}Número de la expediciónTexto
{labels.ORDER_NUMBER}Número del pedido; en un traspaso de stock, número del traspasoTexto. Si la expedición lleva varios, van separados por comas: P001,P002
{labels.IDNUMBER}«Referencia del cliente» del pedido (el número de pedido del cliente)Texto. Varios pedidos: separadas por comas. Vacía en traspasos de stock
{labels.REL_TYPE}Origen de la expediciónStockTransference si es un traspaso de stock. Solo se rellena al imprimir desde el Pick & Pack: al regenerar desde la ficha de la expedición llega vacía
{labels.DATE}Fecha y hora en que se imprime la etiqueta (no la de la expedición)13/11/2026 09:41
{labels.EXPECTED_DELIVERY_DATE}«Fecha de entrega estimada» del pedidodd/mm/aaaa. Vacía si el pedido no la tiene
{labels.NUM_UNITS}Unidades preparadas de toda la expediciónNúmero sin formatear: 12.0000. No cuenta los embalajes. Es igual en todas las etiquetas
{labels.NUM_UNITS_MIN_DECS}Lo mismo, sin ceros decimales de sobraCon los separadores de tu empresa

Transporte

VariableQué contieneFormato y notas
{labels.SHIPPING_COMPANY}Nombre del transportista de la expediciónTexto. Vacío si no tiene
{labels.SHIPPING_SERVICE}Nombre del servicio de transporteTexto. Vacío si no tiene
{labels.PORTES}Quién paga el transporteTexto fijo en mayúsculas y sin traducir: PAGADOS si la expedición va por «Mis medios»; DEBIDOS en cualquier otro caso. Si la expedición no indica el tipo de envío, se mira el campo «Envío» del pedido

Destinatario («Enviar a»)

La dirección es la de entrega de la expedición; si la expedición no tiene, la de entrega del pedido. Si el pedido tiene «Contacto de recepción», se usa una dirección de envío de la empresa de ese contacto (lo cuenta ¿Por qué en la etiqueta de expedición aparece una dirección diferente a la del pedido?).

VariableQué contieneFormato y notas
{labels.CLIENT_NAME}Nombre del destinatario (primera línea)Si el pedido no tiene contacto de recepción: el «A la atención de» del pedido; si está vacío, el nombre de empresa de la dirección; si tampoco hay, el nombre del cliente
{labels.CONTACT_NAME}Persona de contactoEl primero que haya de: «A la atención de» de la dirección, nombre y apellidos del contacto de recepción, nombre y apellidos del contacto del pedido, empresa de la dirección, nombre del cliente
{labels.CONTACT_ADDRESS}Calle y númeroCalle Mayor, 12
{labels.CLIENT_CP}Código postalTexto
{labels.CLIENT_LOC}PoblaciónNombre de la población; si la dirección no tiene la población elegida de la lista, el texto escrito en la dirección
{labels.CLIENT_PROVINCE}ProvinciaProvincia de la población de la dirección
{labels.CLIENT_TEL}Un teléfono del destinatarioEl primero que haya de: dirección de la expedición, dirección del pedido, contacto de recepción (fijo y luego móvil), contacto del pedido (fijo y luego móvil), ficha del cliente
{labels.CLIENT_TELS}Teléfonos de la ficha del clienteTexto, tal como están escritos en la ficha
{labels.CONTACT_TELS}Teléfonos del contacto del pedidoTexto. Vacío en traspasos de stock
{labels.CONTACT_CELLULAR}Móvil del contacto del pedidoTexto. Vacío en traspasos de stock
{labels.RECEPTION_CONTACT_TELS}Teléfonos del contacto de recepciónTexto. Vacío si el pedido no tiene contacto de recepción
{labels.RECEPTION_CONTACT_CELLULAR}Móvil del contacto de recepciónTexto
{labels.DEST_ADDRESS_TELS}Teléfonos de la dirección de entrega de la expediciónTexto. Vacío si la expedición no tiene dirección propia
{labels.ORDER_ADDRESS_TELS}Teléfonos de la dirección de entrega del pedidoTexto. En traspasos de stock, los de la dirección del almacén de destino

Remitente (tu empresa)

VariableQué contieneFormato y notas
{labels.METAGROUP_CLIENT_NAME}Nombre del remitenteEl de tu empresa. Si el pedido tiene «Cliente relacionado» (cuando trabajas como operador logístico) y ese cliente tiene relleno «Título de las etiquetas de transporte», sale ese título
{labels.METAGROUP_CLIENT_ADDRESS}Dirección del remitenteLa «Dirección origen» de la expedición; si no tiene, una de las direcciones de tu empresa. Si tienes varias, rellena la «Dirección origen» para elegir cuál sale
{labels.METAGROUP_CLIENT_CP}Código postal del remitenteDe la misma dirección
{labels.METAGROUP_CLIENT_LOC}Población del remitenteDe la misma dirección
{labels.METAGROUP_CLIENT_PROVINCE}Provincia del remitenteDe la misma dirección

Posición dentro de la impresión

VariableQué contieneFormato y notas
{labels.S_ROW_COUNT}Posición de la etiqueta en esta impresión, empezando por 0Útil para condiciones: <!-- IF labels.S_ROW_COUNT > 0 -->
{labels.S_NUM_ROWS}Número de etiquetas que salen en esta impresiónPuede ser menor que TOTAL si hay bultos que no se imprimen

Preguntas frecuentes

¿Cuándo se imprime la etiqueta?

Al terminar el Pick & Pack (también el masivo, el de expediciones agrupadas y la autopreparación), si está marcada la casilla de imprimir etiqueta y la expedición va por «Sus medios» o por «Mis medios» con un transportista sin integración. A mano, con el botón «Regenerar etiqueta expedición» de la ficha de la expedición o desde el pedido (Generación manual de etiqueta de expedición). Y desde el clasificador automático, que pide la etiqueta de un solo bulto.

¿Por qué no ha salido la etiqueta de un bulto?

En el Pick & Pack cada bulto tiene su marca de imprimir: los que tienen la marca quitada no salen al terminar. El botón «Regenerar etiqueta expedición» vuelve a imprimir todos los bultos. Si no ha salido ninguna etiqueta, mira ¿Por qué un pedido ha creado albarán pero no ha generado etiqueta?.

¿Se guarda una copia de la etiqueta?

Sí, como documento del pedido con el tipo «Etiqueta». Las ZPL y SBPL se guardan siempre, tal como se enviaron a la impresora. La HTML solo se guarda, convertida a PDF, si tu plataforma lo tiene activado: pídeselo a Yunbit.

¿Puedo tener una plantilla distinta para cada transportista o para cada cliente?

No. Se elige por tipo de pedido o por defecto. Para cambiar la etiqueta según el transportista, usa una condición con labels.SHIPPING_COMPANY o labels.SHIPPING_SERVICE dentro de la plantilla.

¿Cómo pongo «bulto 2 de 5»?

Con {labels.CURRENT} de {labels.TOTAL}. No uses {labels.PACKAGE_REF}: es el número interno del bulto, no su posición.

¿Puedo poner el país, el NIF, el correo electrónico o las observaciones de envío del destinatario?

No hay variable para eso.

¿Y el teléfono, el NIF o el correo electrónico de mi empresa?

Tampoco hay variable. Si tienen que salir, escríbelos como texto fijo en la plantilla.

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

No. La etiqueta de expedición no lleva importes ni datos comerciales del pedido.

¿Puedo poner la lista de artículos que van en el bulto?

No. No hay bloque de artículos: solo el número de unidades del bulto ({labels.NUM_UNITS_PACKAGE_MIN_DECS}) y de la expedición ({labels.NUM_UNITS_MIN_DECS}).

¿Puedo poner textos traducidos?

Sí, con las palabras del diccionario, como en cualquier plantilla. Lo explica la portada de la serie.

Nombres que no debes usar

No usesUsaPor qué
{labels.PACKAGE_REF} para numerar los bultos{labels.CURRENT} y {labels.TOTAL}PACKAGE_REF es el número interno del bulto (por ejemplo, 48213), no su posición en la expedición
{labels.BARCODE} en ZPL o SBPL{labels.BARCODE_TEXT} dentro del comando de código de barras de la impresoraBARCODE es una imagen HTML y en ZPL y SBPL sale vacía
{labels.NUM_UNITS}, {labels.NUM_UNITS_PACKAGE} para mostrarLas terminadas en _MIN_DECSLas otras salen con punto y cuatro decimales: 3.0000
{labels.client_name} y otras en minúsculas{labels.CLIENT_NAME}El nombre tiene que ir con las mayúsculas exactas; si no, sale vacío sin avisar

Cuidado con

  • Todo dentro del bloque. Lo que esté fuera de <!-- BEGIN labels -->…<!-- END labels --> sale una sola vez. En ZPL, si ^XA y ^XZ quedan fuera, todos los bultos se imprimen encima unos de otros en una sola etiqueta.
  • Llaves. Cualquier {palabra} sin espacios se sustituye por una variable, y si no existe, por nada; {} vacías desaparecen. Las llaves con espacios o dos puntos dentro (@page { size: 100mm 152mm; }, .barcode{width:60mm}) se dejan como están. En ZPL, si necesitas una llave como texto, usa ^FH y su código: _7B para { y _7D para }. Más detalles en la portada de la serie.
  • Los datos llegan tal cual. En HTML, un < dentro de un nombre o de una dirección puede descolocar la etiqueta. En ZPL, un ^ o un ~ dentro de un dato se toma como comando y rompe la etiqueta. Para textos largos en ZPL, usa ^FB (bloque de texto con salto de línea).
  • SBPL. Al enviar la etiqueta a la impresora, ^ y < se cambian por el carácter de control de SATO, y se borran los saltos de línea y los >. Por eso los comandos se pueden escribir con ^, pero ni los textos fijos ni los datos pueden llevar <, > ni ^. No dejes comentarios HTML en la plantilla, salvo los del propio motor (<!-- BEGIN -->, <!-- IF -->…). La plantilla estándar no usa tildes («Expedicion»): si las pones, haz una prueba en tu impresora.
  • Un solo bulto. Al imprimir un solo bulto sale «1 de 1». Si la etiqueta la pide el clasificador automático, el remitente no tiene en cuenta la «Dirección origen» de la expedición ni el título del cliente relacionado.
  • Traspasos reimpresos. {labels.REL_TYPE} llega vacía al regenerar desde la ficha de la expedición: un traspaso de stock reimpreso desde ahí se ve como un pedido.
  • Datos vacíos. La fecha de entrega, los teléfonos, el transportista o el servicio pueden llegar vacíos. Envuelve el texto que los acompaña en una condición: <!-- IF labels.EXPECTED_DELIVERY_DATE != '' -->Entrega: {labels.EXPECTED_DELIVERY_DATE}<!-- ENDIF -->.

Artículos relacionados

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 Configuración logística y almacenes

    Out1