Variables para plantillas: etiquetas de artículo y de ubicación

Este artículo explica las variables de cuatro plantillas: la etiqueta de artículo, la etiqueta de artículo-ubicación, la etiqueta de ubicación de almacén y la ficha imprimible del artículo. Las etiquetas se imprimen desde «Artículos», «Artículos Stock / SN», «Localizaciones de stock», «Ubicaciones de almacén», la entrada de mercancía y la fabricación, en HTML (navegador), ZPL (impresoras Zebra) o SBPL (impresoras SATO). La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

La etiqueta de lote no está aquí: la tienes en Etiquetas de contenedor y de lote.

Cómo se elige la plantilla

Las plantillas se suben en el gestor de plantillas de documentos. En «Aplica a» eliges el tipo:

Aplica aQué imprimeFormatos con plantilla propia
Etiquetas de artículosUna etiqueta por artículo o por registro de stockHTML, ZPL y SBPL (un tipo para cada formato)
Etiquetas de artículo-ubicaciónUna etiqueta por fila de «Localizaciones de stock»HTML y ZPL
Etiquetas de ubicación de almacenesUna etiqueta por ubicaciónHTML y ZPL
ArtículosLa ficha imprimible del artículoHTML

Tres cosas valen para todas:

  • Al dar de alta una plantilla, el campo «Por defecto» viene marcado a «Sí». Si subes varias del mismo tipo, revisa que solo una quede en «Sí»: con varias, el programa usa una de ellas y no puedes elegir cuál.
  • El campo «Antigua» no aparta la plantilla: una plantilla antigua marcada por defecto se sigue usando.
  • Las imágenes de cabecera, margen y pie de la plantilla no salen en ninguna etiqueta de este artículo. Solo la ficha imprimible usa la imagen de cabecera, como logo.

El orden de prioridad de cada tipo está en su sección.

Etiquetas de artículos

Una etiqueta por cada artículo o registro de stock que imprimes. Es la única de este artículo que admite plantilla propia en los tres formatos.

Desde dónde se imprime

DóndeBotónQué sale
Artículos (ficha y listado)«Imprimir etiqueta», «Imprimir etiqueta ZPL», «Imprimir etiqueta SATO»Una etiqueta por artículo marcado, sin datos de ningún registro de stock: sin número de serie, ubicación ni caducidad. Los botones solo los ven los usuarios con permiso para administrar plantillas. Los de ZPL y SATO salen si la plataforma tiene configurada esa impresora.
Artículos Stock / SN (ficha y listado)Los mismos tresUna etiqueta por registro de stock marcado, con su número de serie, código de barras, ubicación, caducidad…
Artículos Entrados«Imprimir etiqueta(s) de artículo(s)» y sus versiones ZPL y SATOUna por registro, o todas las de la entrada.
Entrada de mercancía«Imprimir etiquetas» de la tabla de líneasUna por registro de stock de las líneas marcadas. Las líneas que todavía no tienen registro salen como etiqueta del artículo. Elige sola la impresora: Zebra si la hay; si no, SATO; si no, el navegador.
Al terminar una entrada, un inventario o una devolución (RMA)Sale solaLas etiquetas de los artículos recibidos que no entran en un envase ni en un continente.
Alta de stock y Asignar stock a entradaSale solaLas de los registros recién creados.
FabricaciónSale sola o con «Imprimir todas»Las de las unidades fabricadas, con las copias que pide la fase.

Si tu plataforma tiene activada la elección de etiqueta al imprimir, los botones de «Artículos», «Artículos Stock / SN» y «Localizaciones de stock» abren antes la ventana «Escoger etiqueta de impresión». En su desplegable «Etiqueta» eliges «Etiqueta por defecto» o cualquier plantilla de etiquetas de artículos del formato con que imprimes.

Cómo se elige la plantilla

  1. La elegida en la ventana «Escoger etiqueta de impresión», o la que manda la fase de fabricación cuando su etiqueta es una plantilla de artículo. Se usa siempre, sea del tipo que sea.
  2. La de la ficha del artículo: campo «Plantilla de etiqueta» para HTML y «Plantilla de etiqueta ZPL» para Zebra. Solo cuenta si es de tipo «Etiquetas de artículos» o de etiquetas de fabricación. El desplegable deja elegir también plantillas de ubicación y de contenedor, pero esas no se usan aquí: el programa pasa al punto siguiente sin avisar.
  3. La de una categoría del artículo: los mismos campos en la ficha de la categoría. Si el artículo está en varias, cuenta la de menor «Nivel» que tenga plantilla. Aquí no se mira el tipo: una categoría con una plantilla de ubicación o de contenedor da etiquetas en blanco o a medias.
  4. La plantilla por defecto de tipo «Etiquetas de artículos» del formato con que imprimes.
  5. La plantilla de fábrica de Yunbit.

Todas las etiquetas de una misma impresión salen con la plantilla del primer artículo. Si marcas artículos con plantillas distintas, imprímelos por separado.

Diferencias:

  • SATO: no mira ni el artículo ni la categoría. Usa la elegida en la ventana o la plantilla por defecto SBPL.
  • Plantilla de fabricación en la ficha del artículo (pasa con los artículos intermedios, que llevan la de su fase): las unidades fabricadas salen con esa plantilla y sus variables, que están en Etiquetas de fabricación. Solo si todas las etiquetas de la impresión son de unidades fabricadas. Si alguna no lo es (por ejemplo, imprimes desde la ficha del artículo), salen todas con la plantilla por defecto de etiquetas de artículos.

Variables sueltas

Valen dentro y fuera del bloque. La columna «Formatos» dice en cuáles existe cada una.

VariableQué contieneFormato y notasFormatos
{today}Fecha de impresióndd-mm-aaaa, con guionesHTML, ZPL, SBPL
{result}OK si todo ha ido bien, ERR si noTexto. Útil para <!-- IF result == "ERR" -->.HTML, ZPL, SBPL
{error_msg}Mensaje de error, si lo hayPor ejemplo, «Artículo con ese número de serie no encontrado».HTML, ZPL, SBPL
{pdf_puppeteer}, {pdf_docraptor}1 si la plataforma genera el PDF con ese motor; si no, vacíaPara cargar un CSS de impresión u otro, como hace la plantilla de fábrica.HTML, ZPL, SBPL

Bloque articles

Repite una vez por etiqueta. Las variables se escriben {articles.NOMBRE}. No tiene bloques dentro.

Ejemplo en HTML:

<!-- BEGIN articles -->
  <div class="etiqueta">
    <p>{articles.ARTICLE_NAME}</p>
    <p>Ref. {articles.PART_NUMBER}</p>
    {articles.BARCODE_IMG}
    <p>{articles.BARCODE_TXT}</p>
  </div>
<!-- END articles -->

Ejemplo en ZPL (las barras las dibuja la impresora con el código en texto):

<!-- BEGIN articles -->
^XA
^CI28
^FO30,30^A0N,30,30^FD{articles.PART_NUMBER} - {articles.NAME}^FS
^FO30,80^BCN,80,Y,N,N^FD{articles.BARCODE_TXT}^FS
^XZ
<!-- END articles -->

En SBPL se escribe igual, con las órdenes de SATO y ^ en lugar del carácter ESC (más en «Cuidado con»).

Las variables marcadas «Registro» son del registro de stock: salen vacías cuando imprimes desde la ficha o el listado de «Artículos», porque ahí no hay registro. Para saber en la plantilla si hay registro, usa <!-- IF articles.ID != "" -->.

Artículo

VariableQué contieneFormato y notasFormatos
{articles.PART_NUMBER}Referencia (part number) del artículoTextoHTML, ZPL, SBPL
{articles.ARTICLE_PARTNUMBER}Lo mismo que PART_NUMBERTexto. Vacía al terminar una entrada, un inventario o una devolución (ver más abajo).HTML, ZPL, SBPL
{articles.ARTICLE_NAME}Nombre del artículoTexto completo, sin recortarHTML, ZPL, SBPL
{articles.SHORT_DESCRIPTION}Descripción cortaPuede llevar HTML, porque el campo admite edición en HTML. En ZPL y SBPL las etiquetas HTML se imprimen como texto.HTML, ZPL, SBPL
{articles.NAME}Descripción corta; si no tiene, el nombre del artículoTexto sin etiquetas HTML y recortado: si la plataforma tiene configurada una longitud máxima para etiquetas, corta ahí y añade «...»; si no, a partir de 40 caracteres corta en el primer espacio (99 como mucho).HTML, ZPL, SBPL
{articles.ARTICLE_REFERENCE}Campo «Referencia» de la ficha del artículoTexto. No es el part number.HTML, ZPL, SBPL
{articles.HAS_REFERENCE}Si el artículo lleva número de serie1 o 0. Para <!-- IF articles.HAS_REFERENCE == "1" -->.HTML, ZPL, SBPL
{articles.MANUFACTURER}Nombre del fabricanteTextoHTML, ZPL, SBPL
{articles.FLAG}Condición o estado del artículoTextoHTML, ZPL, SBPL
{articles.CLIENT_NAME}Cliente propietario del artículo (almacenes que guardan mercancía de otros)Texto. No es el cliente de un pedido.HTML, ZPL, SBPL
{articles.CLIENT_REF}Código de ese clienteTextoHTML, ZPL, SBPL
{articles.IS_CONTINENT}Si es la etiqueta del artículo continente1 o 0HTML, ZPL, SBPL
{articles.ARTICLE_URL}Enlace a la ficha del artículo en la plataformaYa preparado para ir dentro de otra dirección web, por ejemplo la de un servicio que genera códigos QR.HTML, ZPL, SBPL
{articles.ARTICLE_ID}, {articles.IVA_ID}Identificadores internos del artículo y de su tipo de IVASolo sirven para condiciones.HTML, ZPL, SBPL

Registro de stock

VariableQué contieneFormato y notasFormatos
{articles.SERIALNUMBER}Número de serie del registro; si no tiene, el part numberTexto. Desde «Artículos» es siempre el part number.HTML, ZPL, SBPL
{articles.SSNSERIALNUMBER}Número de serie del registro, sin sustitutoTexto. Registro. Vacía si el registro no tiene número de serie.HTML, ZPL, SBPL
{articles.SERIALNUMBER_CODE}Lo mismo que SERIALNUMBERTexto. Pensada para pintar su código de barras en ZPL.HTML, ZPL, SBPL
{articles.SSNCREATED}Fecha de alta del registroaaaa-mm-dd hh:mm:ss, sin formatear. Registro.HTML, ZPL, SBPL
{articles.EXPIRATION_DATE}Fecha de caducidaddd/mm/aaaa. Registro.HTML, ZPL, SBPL
{articles.lastRevisionDate}Fecha de la última revisióndd/mm/aaaa. Registro. Se escribe así, con minúsculas y mayúsculas.HTML, ZPL, SBPL
{articles.descriptionZone2}Campo «Descripción zona 2» del registroTexto. Registro. Las otras zonas de descripción no tienen variable.HTML, ZPL, SBPL
{articles.LOCATION_CODE}Código de la ubicación del registroTexto. Registro. Si el registro está en varias, la que más cantidad tiene.HTML, ZPL, SBPL
{articles.STORE_LOCATION_BARCODE}Código de barras de esa ubicaciónTexto, no imagen. Registro.HTML, ZPL, SBPL
{articles.STORE_ID}Identificador interno del almacén de esa ubicaciónSolo sirve para condiciones. Registro.HTML, ZPL, SBPL
{articles.ID}Identificador interno del registro de stockVacía si no hay registro. Útil para condiciones.HTML, ZPL, SBPL

Códigos de barras

El código que se imprime es el del registro de stock y, si no tiene, el del artículo. Antes de usar {articles.BARCODE} en HTML, lee «Cuidado con».

VariableQué contieneFormato y notasFormatos
{articles.BARCODE_TXT}El código de barras en textoTexto. Es lo que va dentro de la orden de código de barras en ZPL y SBPL.HTML, ZPL, SBPL
{articles.BARCODE_IMG}Imagen del código en Code 128, solo las barras, sin texto debajoEtiqueta <img>. La recomendada en HTML: pinta siempre el mismo código que BARCODE_TXT.Solo HTML
{articles.BARCODE}En HTML, imagen del código con el texto debajo. En ZPL y SBPL, el código en texto.Etiqueta <img> en HTML. Formato de la imagen: el configurado para artículos y, si no hay ninguno, EAN-13.HTML (imagen), ZPL y SBPL (texto)
{articles.BARCODE_NOLIMIT}La misma imagen que BARCODEEtiqueta <img>Solo HTML
{articles.PART_NUMBER_IMG}Imagen del part number como código de barras, con el texto debajoEtiqueta <img>. Formato: el configurado para part numbers y, si no hay ninguno, Code 128.Solo HTML
{articles.SSN_BARCODE}Código de barras propio del registro de stockTexto, no imagen. Registro.HTML, ZPL, SBPL

Precios

Los importes salen sin símbolo de moneda.

VariableQué contieneFormato y notasFormatos
{articles.ARTICLE_PRICE}Precio de venta sin IVA de la ficha del artículoComa decimal y 4 decimales: «12,5000». Vacía al terminar una entrada, un inventario o una devolución.HTML, ZPL, SBPL
{articles.ARTICLE_PRICE_VAT}Precio de venta con IVA de la ficha del artículoPunto decimal y 4 decimales: «15.1250».HTML, ZPL, SBPL
{articles.ARTICLE_PRICE_TAR}Precio de venta con IVA según la tarifa del cliente genérico (si no tiene, la tarifa general de la plataforma), con las excepciones de precio de esa tarifaCon los decimales y separadores de la plataforma. Si no hay tarifa configurada, precio de venta más IVA.HTML, ZPL, SBPL
{articles.NO_STOCK_PRICE}Precio sin stock de la ficha del artículoPunto decimal y 4 decimales.HTML, ZPL, SBPL
{articles.ARTICLE_IVA}Porcentaje de IVA del artículoNúmero sin «%»: «21.00» o «21».HTML, ZPL, SBPL

Características

No hay un bloque de características: cada una es una variable del bloque articles.

VariableQué contieneFormato y notasFormatos
{articles.FEAT_CLAVE}Valor de una característica del artículoTexto. Si tiene varios valores, separados por comas. Cómo se forma la clave, debajo de la tabla.HTML, ZPL, SBPL
{articles.FEATURES_TEXT}Todas las características con valor, una por línea: «Nombre: valor»Texto con saltos de línea. En HTML, para verlos, pon white-space: pre-line en el elemento que la contiene.HTML, ZPL, SBPL
{articles.FEATURES_ZPL}Lo mismo, con el salto de línea de ZPLTexto. Solo hace los saltos dentro de un bloque de campo ^FB.Pensada para ZPL

Cómo se forma la clave de FEAT_:

  • Se parte de la referencia de la característica y, si no tiene, de su nombre.
  • Se pasa a mayúsculas y se quitan los acentos (á → A, ñ → N, ç → C).
  • Todo lo que no sea letra o cifra pasa a ser _, sin _ al principio ni al final.
  • Ejemplos: la característica «Tensión de entrada» sin referencia da {articles.FEAT_TENSION_DE_ENTRADA}; una con referencia «POTENCIA LUMINARIA» da {articles.FEAT_POTENCIA_LUMINARIA}.

El valor es el del propio artículo y, si no tiene, el de su artículo maestro (variantes). Una característica sin valor no sale: ni su FEAT_ ni su línea en FEATURES_TEXT. Los valores elegidos en una línea de pedido no cuentan. Estas variables también salen al imprimir desde «Artículos».

Fabricación

VariableQué contieneFormato y notasFormatos
{articles.TEXTO_ETIQUETA}Las líneas de tipo «Texto etiqueta» de la lista de materiales de la orden y fase en que se fabricó la unidad, por orden de posiciónTexto, una línea por cada una. En HTML, para ver los saltos, usa white-space: pre-line; en ZPL no hacen salto. Vacía al imprimir desde «Artículos».HTML, ZPL, SBPL

Si la unidad viene de una fabricación, el bloque lleva además los datos de su etiqueta de fabricación con el prefijo MF_ ({articles.MF_ORDER_NUMBER}, {articles.MF_BARCODE}…), en cualquier plantilla de artículo: están explicadas en Etiquetas de fabricación.

Posición de la etiqueta

VariableQué contieneFormato y notasFormatos
{articles.S_ROW_COUNT}Posición de la etiqueta en la impresión, empezando en 0Número. Útil para saltos de página.HTML, ZPL, SBPL
{articles.S_NUM_ROWS}Número total de etiquetas de la impresiónNúmeroHTML, ZPL, SBPL

Etiquetas que salen al terminar una entrada, un inventario o una devolución

Cuando se imprimen todas las etiquetas de una entrada (al terminarla o desde «Artículos Entrados») solo tienen valor estas variables: PART_NUMBER, ARTICLE_NAME, SHORT_DESCRIPTION, NAME, HAS_REFERENCE, ARTICLE_REFERENCE, SSNCREATED, MANUFACTURER, ID, BARCODE, SERIALNUMBER, SSNSERIALNUMBER, ARTICLE_ID, IS_CONTINENT, CLIENT_NAME, CLIENT_REF, FLAG, los códigos de barras en imagen y en texto, SERIALNUMBER_CODE, TEXTO_ETIQUETA, las características, las de fabricación, ARTICLE_PRICE_TAR y ARTICLE_URL. El resto sale vacío. En este caso hay dos más:

VariableQué contieneFormato y notasFormatos
{articles.UNITS}Unidades de ese registro en la entradaNúmero. No repite la etiqueta: sale una por registro.HTML, ZPL, SBPL
{articles.MULTIPLIER_PER_SN}Unidades por número de serie de la unidad de medida del artículoNúmeroHTML, ZPL, SBPL

Etiquetas de artículo-ubicación

Una etiqueta por cada fila de «Localizaciones de stock», es decir, por cada registro de stock en una ubicación. Sirve, por ejemplo, para la etiqueta de precio de una estantería.

Desde dónde se imprime

Desde Localizaciones de stock (ficha y listado), con «Imprimir etiqueta» (HTML) e «Imprimir etiqueta ZPL». No hay botón de SATO ni tipo de plantilla SBPL para esta etiqueta. Si tu plataforma tiene activada la elección de etiqueta al imprimir, se abre antes la ventana «Escoger etiqueta de impresión» con las plantillas de este tipo.

Cómo se elige la plantilla

  1. La elegida en la ventana «Escoger etiqueta de impresión».
  2. La de la ficha del artículo («Plantilla de etiqueta» o «Plantilla de etiqueta ZPL»), solo si es de tipo «Etiquetas de artículo-ubicación».
  3. La de una categoría del artículo, la de menor «Nivel». Aquí no se mira el tipo.
  4. La plantilla por defecto de tipo «Etiquetas de artículo-ubicación» del formato con que imprimes.
  5. La plantilla de fábrica de Yunbit.

El artículo tiene un solo campo «Plantilla de etiqueta» por formato: o lleva una de etiqueta de artículo o una de artículo-ubicación, no las dos. Si necesitas las dos, deja la de artículo-ubicación como plantilla por defecto.

Variables sueltas

Las mismas que en la etiqueta de artículo: {today}, {result}, {error_msg}, {pdf_puppeteer} y {pdf_docraptor}, con el mismo formato.

Bloque data

Repite una vez por fila de «Localizaciones de stock». Las variables se escriben {data.NOMBRE}. No admite copias: cada fila da una etiqueta. No lleva características, datos de fabricación, TEXTO_ETIQUETA, BARCODE_TXT ni BARCODE_IMG.

<!-- BEGIN data -->
  <div class="etiqueta">
    <p>{data.LOCATION_CODE} · {data.PART_NUMBER}</p>
    <p>{data.ARTICLE_NAME}</p>
    <p>PVP {data.ARTICLE_PRICE_TAR}</p>
    {data.STORE_LOCATION_BARCODE}
  </div>
<!-- END data -->

Ubicación

VariableQué contieneFormato y notasFormatos
{data.LOCATION_CODE}Código de la ubicaciónTextoHTML, ZPL
{data.STORE_LOCATION_BARCODE}Campo «Código de barras» de la ubicaciónEn HTML, imagen con el texto debajo; en ZPL, texto. Formato: el configurado para ubicaciones y, si no hay ninguno, Code 128.HTML (imagen), ZPL (texto)
{data.STORE_LOCATION_BARCODE_NOLIMIT}La misma imagenEtiqueta <img>Solo HTML
{data.STORE_ID}Identificador interno del almacénSolo sirve para condiciones.HTML, ZPL

Artículo

VariableQué contieneFormato y notasFormatos
{data.PART_NUMBER}, {data.ARTICLE_PARTNUMBER}Referencia (part number) del artículoTextoHTML, ZPL
{data.ARTICLE_NAME}Nombre del artículoTexto. Se recorta solo si la plataforma tiene configurada una longitud máxima para etiquetas.HTML, ZPL
{data.NAME}Descripción corta; si no tiene, el nombreTexto sin recortar y con el HTML que traiga la descripción corta.HTML, ZPL
{data.SHORT_DESCRIPTION}Descripción cortaPuede llevar HTML.HTML, ZPL
{data.ARTICLE_REFERENCE}Campo «Referencia» de la ficha del artículoTextoHTML, ZPL
{data.HAS_REFERENCE}Si el artículo lleva número de serie1 o 0HTML, ZPL
{data.MANUFACTURER}Nombre del fabricanteTextoHTML, ZPL
{data.FLAG}Condición o estado del artículoTextoHTML, ZPL
{data.CLIENT_NAME}, {data.CLIENT_REF}Cliente propietario del artículo y su códigoTextoHTML, ZPL
{data.IS_CONTINENT}Si es un artículo continente1 o 0HTML, ZPL
{data.ARTICLE_ID}, {data.IVA_ID}Identificadores internosSolo sirven para condiciones.HTML, ZPL

Registro de stock

VariableQué contieneFormato y notasFormatos
{data.SERIALNUMBER}Número de serie; si no tiene, el part numberTextoHTML, ZPL
{data.SSNSERIALNUMBER}Número de serie, sin sustitutoTexto. Vacía si no tiene.HTML, ZPL
{data.SSNCREATED}Fecha de alta del registroaaaa-mm-dd hh:mm:ss, sin formatearHTML, ZPL
{data.EXPIRATION_DATE}Fecha de caducidaddd/mm/aaaaHTML, ZPL
{data.lastRevisionDate}Fecha de la última revisióndd/mm/aaaaHTML, ZPL
{data.descriptionZone2}Campo «Descripción zona 2» del registroTextoHTML, ZPL
{data.ID}Identificador interno del registroSolo sirve para condiciones.HTML, ZPL

Códigos de barras

VariableQué contieneFormato y notasFormatos
{data.BARCODE}Código del registro de stock y, si no tiene, el del artículoEn HTML, imagen con el texto debajo (formato de artículos, EAN-13 si no hay otro); en ZPL, texto.HTML (imagen), ZPL (texto)
{data.BARCODE_NOLIMIT}La misma imagenEtiqueta <img>Solo HTML
{data.SSN_BARCODE}Código de barras propio del registro de stockEn HTML, imagen con el texto debajo (formato de artículos, EAN-13 si no hay otro); en ZPL, texto.HTML (imagen), ZPL (texto)
{data.SSN_BARCODE_NOLIMIT}La misma imagenEtiqueta <img>Solo HTML

Precios

VariableQué contieneFormato y notasFormatos
{data.ARTICLE_PRICE}Precio de venta sin IVA de la ficha del artículoPunto decimal y sin ceros sobrantes: «12.5».HTML, ZPL
{data.ARTICLE_PRICE_VAT}Precio de venta con IVA de la ficha del artículoPunto decimal y 4 decimales: «15.1250».HTML, ZPL
{data.ARTICLE_PRICE_TAR}Precio de venta con IVA según la tarifa del almacén de la ubicaciónTodas las comas pasan a punto (ver «Cuidado con»). Es el «PVP» de la plantilla de fábrica.HTML, ZPL
{data.NO_STOCK_PRICE}Precio sin stock de la ficha del artículoPunto decimal y 4 decimales.HTML, ZPL
{data.ARTICLE_IVA}Porcentaje de IVA del artículoNúmero sin «%»HTML, ZPL

Posición de la etiqueta

VariableQué contieneFormato y notasFormatos
{data.S_ROW_COUNT}Posición en la impresión, empezando en 0NúmeroHTML, ZPL
{data.S_NUM_ROWS}Número total de etiquetasNúmeroHTML, ZPL

Etiquetas de ubicación de almacenes

Una etiqueta por ubicación, con su código. Sirve para rotular estanterías y huecos.

Desde dónde se imprime

Desde Ubicaciones de almacén (ficha y listado), con «Imprimir etiqueta» y sus versiones ZPL y SATO. Las etiquetas salen ordenadas por código de ubicación.

Cómo se elige la plantilla

  1. La plantilla por defecto de tipo «Etiquetas de ubicación de almacenes» del formato con que imprimes.
  2. La plantilla de fábrica de Yunbit.

No hay plantilla por ubicación ni ventana para elegirla. Para SATO no hay tipo de plantilla: sale siempre la de fábrica.

Variables sueltas

VariableQué contieneFormato y notasFormatos
{result}ERR si algo fallaCon todo bien sale vacía, no OK.HTML, ZPL, SBPL
{error_msg}Mensaje de error«No se encuentra el almacen».HTML, ZPL, SBPL
{pdf_puppeteer}, {pdf_docraptor}1 si la plataforma genera el PDF con ese motorIgual que en la etiqueta de artículo.HTML, ZPL, SBPL

Esta etiqueta no tiene {today}.

Bloque stores

Repite una vez por ubicación. Las variables se escriben {stores.NOMBRE}. No admite copias.

<!-- BEGIN stores -->
  <div class="etiqueta">
    <p>{stores.CODE}</p>
    {stores.BARCODE}
  </div>
<!-- END stores -->
VariableQué contieneFormato y notasFormatos
{stores.CODE}Código de la ubicaciónTexto sin etiquetas HTMLHTML, ZPL, SBPL
{stores.BARCODE}En HTML, imagen del código de la ubicación con el texto debajo; en ZPL y SBPL, ese código en textoNo es el campo «Código de barras» de la ubicación: se pinta el código. Formato: el configurado para ubicaciones y, si no hay ninguno, Code 128.HTML (imagen), ZPL y SBPL (texto)
{stores.ID}Identificador interno de la ubicaciónSolo sirve para condiciones.HTML, ZPL, SBPL
{stores.S_ROW_COUNT}Posición en la impresión, empezando en 0NúmeroHTML, ZPL, SBPL
{stores.S_NUM_ROWS}Número total de etiquetasNúmeroHTML, ZPL, SBPL

Ficha imprimible del artículo

Es la hoja con los datos del artículo que sale con el botón «Imprimir ficha» de Artículos (ficha y listado). El botón solo lo ven los usuarios con permiso para administrar plantillas. La plantilla se da de alta con «Aplica a» = «Artículos».

Cómo se elige la plantilla

  1. La plantilla por defecto de tipo «Artículos».
  2. La plantilla de fábrica de Yunbit.

Tu plantilla sustituye solo el contenido de la hoja: la página que la rodea es fija. La imagen de cabecera de la plantilla sale como logo de la empresa.

La ficha se imprime para un solo artículo: si marcas varios en el listado, sale solo uno. Imprime las fichas de una en una.

Variables

Todas son sueltas: la ficha no tiene bloques.

Artículo

VariableQué contieneFormato y notas
{name}Nombre del artículoTexto
{short_description}Descripción cortaPuede llevar HTML.
{long_description}Descripción largaHTML
{part_number}Referencia (part number)Texto
{reference}Campo «Referencia» de la ficha del artículoTexto
{barcode}Código de barrasTexto: en la ficha no hay imagen del código.
{isbn}ISBNTexto
{manufacturer}FabricanteTexto
{status}Condición o estado del artículoTexto
{furl}Dirección amigable del artículo en la tienda en líneaTexto
{date}Fecha de alta del artículoaaaa-mm-dd hh:mm:ss, sin formatear

Precio y stock

VariableQué contieneFormato y notas
{price}Precio de venta sin IVA de la ficha del artículo, sin tarifa2 decimales, coma decimal y punto de miles, sin símbolo de moneda
{total_stock}Stock total, sumando todos los almacenesEntero con punto de miles; redondea los decimales.
{available_stock}Stock disponibleEntero con punto de miles
{block_stock}Stock no disponible: total menos disponibleEntero con punto de miles

Medidas

VariableQué contieneFormato y notas
{weight}Peso2 decimales con coma, sin unidad
{width}Ancho2 decimales con coma, sin unidad
{height}Alto2 decimales con coma, sin unidad
{depth}Fondo2 decimales con coma, sin unidad
{volume}Volumen2 decimales con coma, sin unidad

Imágenes

VariableQué contieneFormato y notas
{image}Dirección completa de la primera imagen del artículo (la de menor posición)Para <img src="{image}">. Vacía si el artículo no tiene imagen.
{no_img}Dirección de la imagen «sin imagen» de la plataformaPara usarla cuando {image} esté vacía (ejemplo debajo).
<!-- IF image == "" -->
  <img src="{no_img}">
<!-- ELSE -->
  <img src="{image}">
<!-- ENDIF -->

Tu empresa

VariableQué contieneFormato y notas
{company_name}Nombre de tu empresaTexto
{company_mail}Correo electrónico de tu empresaTexto
{company_tlf}Teléfono de tu empresaTexto. Vacía si no hay.
{company_logo}Dirección completa de la imagen de cabecera de la plantilla; si no tiene, el logo de acceso de la plataformaPara <img src="{company_logo}">.

Otros

VariableQué contieneFormato y notas
{pdf_puppeteer}, {pdf_docraptor}1 si la plataforma genera el PDF con ese motor; si no, vacíaPara cargar un CSS de impresión u otro.

La ficha no tiene características, tarifas, ubicaciones ni código de barras en imagen.

Preguntas frecuentes

¿Cómo pongo el lote en la etiqueta del artículo?

No hay variable de lote en la etiqueta de artículo. La etiqueta del lote es otra plantilla, explicada en Etiquetas de contenedor y de lote.

¿Por qué no salen el número de serie, la ubicación ni la caducidad?

Porque has impreso desde «Artículos», donde no hay registro de stock. Imprime desde «Artículos Stock / SN», «Artículos Entrados» o la entrada de mercancía.

¿Puedo poner la cantidad, el proveedor, el almacén o el precio de coste?

No hay variable para eso en las etiquetas. La única cantidad es {articles.UNITS}, y solo cuando se imprimen todas las etiquetas de una entrada. El almacén solo llega como identificador interno (STORE_ID).

¿El precio lleva IVA?

Depende de la variable. ARTICLE_PRICE es sin IVA. ARTICLE_PRICE_VAT es con IVA y sale de la ficha del artículo. ARTICLE_PRICE_TAR es con IVA y pasa por la tarifa. En la ficha imprimible, {price} es sin IVA.

¿Cómo imprimo varias copias de la misma etiqueta?

Desde los botones de imprimir, cada artículo o registro de stock da una etiqueta, tenga las unidades que tenga. En fabricación, cada fase dice cuántas copias saca de cada unidad.

¿Puedo poner un código QR con el enlace al artículo?

Sí: {articles.ARTICLE_URL} ya viene preparada para ir dentro de otra dirección. Ponla en la src de un <img> que apunte a un servicio que genere códigos QR.

¿Puedo poner la descripción larga en la etiqueta?

En las etiquetas, no: solo hay descripción corta. En la ficha imprimible, sí: {long_description}.

He puesto una plantilla en la ficha del artículo y no se usa. ¿Por qué?

Puede ser por tres motivos. La plantilla no es del tipo de la etiqueta que imprimes (el desplegable de la ficha admite otros tipos). Imprimes en SATO, que no mira la ficha del artículo. O el primer artículo de la impresión tiene otra plantilla, y esa vale para todos.

Nombres que no debes usar

No usesUsaPor qué
{serialnumbers}{articles.SERIALNUMBER} o {articles.SSNSERIALNUMBER}Trae identificadores internos de lo que se ha pedido imprimir, no números de serie.
{data.CODE}{data.LOCATION_CODE}En la etiqueta de artículo-ubicación sale siempre vacía.
{articles.BARCODE} en HTML, si tus códigos no son EAN-13{articles.BARCODE_IMG} y {articles.BARCODE_TXT}Puede pintar un código distinto del que tiene el artículo (ver «Cuidado con»).
{articles.part_number} y otras en minúsculas{articles.PART_NUMBER}El motor distingue mayúsculas: en minúsculas sale vacía. Las únicas que van con minúsculas son lastRevisionDate y descriptionZone2.

Cuidado con

  • Códigos de barras cortos en EAN-13. Si no se ha configurado otro formato, las imágenes de código de barras de artículo ({articles.BARCODE}, {data.BARCODE}, {data.SSN_BARCODE}) usan EAN-13. Con un código de menos de 12 cifras, o vacío, no se pinta ese código: se pinta uno nuevo, con el año y la semana actuales y el código relleno de ceros (o con el prefijo GS1 de tu empresa, si lo tiene). La imagen no coincide entonces con el texto, y un artículo sin código sale con unas barras que no son suyas. En la etiqueta de artículo usa {articles.BARCODE_IMG} (Code 128, pinta siempre el código tal cual) y pon el texto con {articles.BARCODE_TXT}. En la de artículo-ubicación, si tus códigos no son EAN-13 completos, pide a Yunbit que configure Code 128 como formato de los códigos de barras de artículos.
  • Códigos con letras en EAN-13. Un EAN-13 solo admite cifras. Si el código lleva letras, en la etiqueta de artículo {articles.BARCODE} sale como texto en lugar de imagen. Usa {articles.BARCODE_IMG}.
  • Tamaño de las imágenes de código de barras. Llegan como <img class='barcode' …>. Dales tamaño con CSS, como la plantilla de fábrica: img.barcode { width: 60mm; height: 15mm; }. BARCODE y BARCODE_NOLIMIT son la misma imagen.
  • Código de la ubicación o código de barras de la ubicación. La etiqueta de ubicación de almacén pinta el código de la ubicación; la de artículo-ubicación pinta su campo «Código de barras». Si los dos son distintos, las barras de una y otra no coinciden.
  • Separadores decimales. Cada precio sale con el suyo: {articles.ARTICLE_PRICE} con coma («12,5000»), {articles.ARTICLE_PRICE_VAT} con punto («15.1250»), {articles.ARTICLE_PRICE_TAR} con los de la plataforma. En la etiqueta de artículo-ubicación, {data.ARTICLE_PRICE_TAR} pasa todas las comas a punto: si la plataforma usa punto para los miles, 1.234,56 sale «1.234.56».
  • Formatos de fecha. {today} va con guiones (dd-mm-aaaa); EXPIRATION_DATE y lastRevisionDate, con barras (dd/mm/aaaa); SSNCREATED y el {date} de la ficha, sin formatear (aaaa-mm-dd hh:mm:ss).
  • Nombre recortado. Si la plataforma tiene configurada una longitud máxima para etiquetas, {articles.NAME} puede cortar una letra con tilde por la mitad y dejar un carácter raro al final. Si te pasa, usa {articles.ARTICLE_NAME}.
  • **{articles.NAME} vacía.** Si a un artículo se le borró la descripción corta, NAME puede salir vacía en lugar de traer el nombre. Usa {articles.ARTICLE_NAME} o una condición sobre SHORT_DESCRIPTION.
  • HTML dentro de la descripción corta. SHORT_DESCRIPTION puede traer etiquetas HTML. En ZPL y SBPL se imprimen como texto: usa NAME, que llega limpia.
  • ZPL. Pon ^CI28 justo después de cada ^XA para que salgan bien tildes y eñes, como la plantilla de fábrica. Los datos se escriben tal cual: un ^ o un ~ en el nombre o la descripción corta la orden ZPL. Si usas ^FH, el _ de los datos pasa a ser carácter de escape.
  • SBPL (SATO). Al generar la etiqueta, todo ^ y todo < pasan a ser el carácter ESC, y se borran todos los > y los saltos de línea. Por eso las órdenes SATO se escriben con ^. Un <, > o ^ en el nombre o la descripción sale estropeado, y un comentario HTML que no sea del motor (<!-- nota -->) llega a la impresora: no dejes comentarios propios en una plantilla SBPL.
  • Ventana «Escoger etiqueta de impresión» con SATO. Imprimiendo en SATO, la ventana ofrece las plantillas HTML, y la elegida se manda a la impresora tal cual. Con SATO deja «Etiqueta por defecto».
  • Plantilla en una categoría. La plantilla de una categoría se usa tanto para la etiqueta de artículo como para la de artículo-ubicación, sea del tipo que sea. Si en una categoría pones una de artículo-ubicación, la etiqueta de artículo de sus artículos sale con ella, en blanco o a medias (salvo que el artículo tenga la suya en la ficha). Pon en las categorías el tipo de plantilla que más imprimes y deja el otro como plantilla por defecto.
  • Más de 2000 etiquetas. Una impresión admite como mucho 2000 etiquetas. Si pides más, sale el aviso «Se han pedido N etiquetas y el máximo por impresión es 2000: imprime por partes.» y no se imprime nada.
  • Llaves en CSS y JavaScript. El motor toma como variable cualquier {palabra} y se come {}; lo explica la portada de la serie.
  • Codificación. Guarda la plantilla en UTF-8, como las plantillas de fábrica.

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