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.
Una etiqueta por fila de «Localizaciones de stock»
HTML y ZPL
Etiquetas de ubicación de almacenes
Una etiqueta por ubicación
HTML y ZPL
Artículos
La ficha imprimible del artículo
HTML
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.
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 tres
Una 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 SATO
Una por registro, o todas las de la entrada.
Entrada de mercancía
«Imprimir etiquetas» de la tabla de líneas
Una 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 sola
Las etiquetas de los artículos recibidos que no entran en un envase ni en un continente.
Alta de stock y Asignar stock a entrada
Sale sola
Las de los registros recién creados.
Fabricación
Sale 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
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.
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.
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.
La plantilla por defecto de tipo «Etiquetas de artículos» del formato con que imprimes.
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.
Variable
Qué contiene
Formato y notas
Formatos
{today}
Fecha de impresión
dd-mm-aaaa, con guiones
HTML, ZPL, SBPL
{result}
OK si todo ha ido bien, ERR si no
Texto. Útil para <!-- IF result == "ERR" -->.
HTML, ZPL, SBPL
{error_msg}
Mensaje de error, si lo hay
Por 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ía
Para 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
Variable
Qué contiene
Formato y notas
Formatos
{articles.PART_NUMBER}
Referencia (part number) del artículo
Texto
HTML, ZPL, SBPL
{articles.ARTICLE_PARTNUMBER}
Lo mismo que PART_NUMBER
Texto. 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ículo
Texto completo, sin recortar
HTML, ZPL, SBPL
{articles.SHORT_DESCRIPTION}
Descripción corta
Puede 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ículo
Texto 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ículo
Texto. No es el part number.
HTML, ZPL, SBPL
{articles.HAS_REFERENCE}
Si el artículo lleva número de serie
1 o 0. Para <!-- IF articles.HAS_REFERENCE == "1" -->.
HTML, ZPL, SBPL
{articles.MANUFACTURER}
Nombre del fabricante
Texto
HTML, ZPL, SBPL
{articles.FLAG}
Condición o estado del artículo
Texto
HTML, 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 cliente
Texto
HTML, ZPL, SBPL
{articles.IS_CONTINENT}
Si es la etiqueta del artículo continente
1 o 0
HTML, ZPL, SBPL
{articles.ARTICLE_URL}
Enlace a la ficha del artículo en la plataforma
Ya 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 IVA
Solo sirven para condiciones.
HTML, ZPL, SBPL
Registro de stock
Variable
Qué contiene
Formato y notas
Formatos
{articles.SERIALNUMBER}
Número de serie del registro; si no tiene, el part number
Texto. Desde «Artículos» es siempre el part number.
HTML, ZPL, SBPL
{articles.SSNSERIALNUMBER}
Número de serie del registro, sin sustituto
Texto. Registro. Vacía si el registro no tiene número de serie.
HTML, ZPL, SBPL
{articles.SERIALNUMBER_CODE}
Lo mismo que SERIALNUMBER
Texto. Pensada para pintar su código de barras en ZPL.
HTML, ZPL, SBPL
{articles.SSNCREATED}
Fecha de alta del registro
aaaa-mm-dd hh:mm:ss, sin formatear. Registro.
HTML, ZPL, SBPL
{articles.EXPIRATION_DATE}
Fecha de caducidad
dd/mm/aaaa. Registro.
HTML, ZPL, SBPL
{articles.lastRevisionDate}
Fecha de la última revisión
dd/mm/aaaa. Registro. Se escribe así, con minúsculas y mayúsculas.
HTML, ZPL, SBPL
{articles.descriptionZone2}
Campo «Descripción zona 2» del registro
Texto. Registro. Las otras zonas de descripción no tienen variable.
HTML, ZPL, SBPL
{articles.LOCATION_CODE}
Código de la ubicación del registro
Texto. 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ón
Texto, no imagen. Registro.
HTML, ZPL, SBPL
{articles.STORE_ID}
Identificador interno del almacén de esa ubicación
Solo sirve para condiciones. Registro.
HTML, ZPL, SBPL
{articles.ID}
Identificador interno del registro de stock
Vací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».
Variable
Qué contiene
Formato y notas
Formatos
{articles.BARCODE_TXT}
El código de barras en texto
Texto. 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 debajo
Etiqueta <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 BARCODE
Etiqueta <img>
Solo HTML
{articles.PART_NUMBER_IMG}
Imagen del part number como código de barras, con el texto debajo
Etiqueta <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 stock
Texto, no imagen. Registro.
HTML, ZPL, SBPL
Precios
Los importes salen sin símbolo de moneda.
Variable
Qué contiene
Formato y notas
Formatos
{articles.ARTICLE_PRICE}
Precio de venta sin IVA de la ficha del artículo
Coma 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ículo
Punto 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 tarifa
Con 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ículo
Punto decimal y 4 decimales.
HTML, ZPL, SBPL
{articles.ARTICLE_IVA}
Porcentaje de IVA del artículo
Nú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.
Variable
Qué contiene
Formato y notas
Formatos
{articles.FEAT_CLAVE}
Valor de una característica del artículo
Texto. 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 ZPL
Texto. 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
Variable
Qué contiene
Formato y notas
Formatos
{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ón
Texto, 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
Variable
Qué contiene
Formato y notas
Formatos
{articles.S_ROW_COUNT}
Posición de la etiqueta en la impresión, empezando en 0
Número. Útil para saltos de página.
HTML, ZPL, SBPL
{articles.S_NUM_ROWS}
Número total de etiquetas de la impresión
Número
HTML, 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:
Variable
Qué contiene
Formato y notas
Formatos
{articles.UNITS}
Unidades de ese registro en la entrada
Nú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ículo
Número
HTML, 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
La elegida en la ventana «Escoger etiqueta de impresión».
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».
La de una categoría del artículo, la de menor «Nivel». Aquí no se mira el tipo.
La plantilla por defecto de tipo «Etiquetas de artículo-ubicación» del formato con que imprimes.
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
Variable
Qué contiene
Formato y notas
Formatos
{data.LOCATION_CODE}
Código de la ubicación
Texto
HTML, ZPL
{data.STORE_LOCATION_BARCODE}
Campo «Código de barras» de la ubicación
En 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 imagen
Etiqueta <img>
Solo HTML
{data.STORE_ID}
Identificador interno del almacén
Solo sirve para condiciones.
HTML, ZPL
Artículo
Variable
Qué contiene
Formato y notas
Formatos
{data.PART_NUMBER}, {data.ARTICLE_PARTNUMBER}
Referencia (part number) del artículo
Texto
HTML, ZPL
{data.ARTICLE_NAME}
Nombre del artículo
Texto. 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 nombre
Texto sin recortar y con el HTML que traiga la descripción corta.
HTML, ZPL
{data.SHORT_DESCRIPTION}
Descripción corta
Puede llevar HTML.
HTML, ZPL
{data.ARTICLE_REFERENCE}
Campo «Referencia» de la ficha del artículo
Texto
HTML, ZPL
{data.HAS_REFERENCE}
Si el artículo lleva número de serie
1 o 0
HTML, ZPL
{data.MANUFACTURER}
Nombre del fabricante
Texto
HTML, ZPL
{data.FLAG}
Condición o estado del artículo
Texto
HTML, ZPL
{data.CLIENT_NAME}, {data.CLIENT_REF}
Cliente propietario del artículo y su código
Texto
HTML, ZPL
{data.IS_CONTINENT}
Si es un artículo continente
1 o 0
HTML, ZPL
{data.ARTICLE_ID}, {data.IVA_ID}
Identificadores internos
Solo sirven para condiciones.
HTML, ZPL
Registro de stock
Variable
Qué contiene
Formato y notas
Formatos
{data.SERIALNUMBER}
Número de serie; si no tiene, el part number
Texto
HTML, ZPL
{data.SSNSERIALNUMBER}
Número de serie, sin sustituto
Texto. Vacía si no tiene.
HTML, ZPL
{data.SSNCREATED}
Fecha de alta del registro
aaaa-mm-dd hh:mm:ss, sin formatear
HTML, ZPL
{data.EXPIRATION_DATE}
Fecha de caducidad
dd/mm/aaaa
HTML, ZPL
{data.lastRevisionDate}
Fecha de la última revisión
dd/mm/aaaa
HTML, ZPL
{data.descriptionZone2}
Campo «Descripción zona 2» del registro
Texto
HTML, ZPL
{data.ID}
Identificador interno del registro
Solo sirve para condiciones.
HTML, ZPL
Códigos de barras
Variable
Qué contiene
Formato y notas
Formatos
{data.BARCODE}
Código del registro de stock y, si no tiene, el del artículo
En 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 imagen
Etiqueta <img>
Solo HTML
{data.SSN_BARCODE}
Código de barras propio del registro de stock
En 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 imagen
Etiqueta <img>
Solo HTML
Precios
Variable
Qué contiene
Formato y notas
Formatos
{data.ARTICLE_PRICE}
Precio de venta sin IVA de la ficha del artículo
Punto decimal y sin ceros sobrantes: «12.5».
HTML, ZPL
{data.ARTICLE_PRICE_VAT}
Precio de venta con IVA de la ficha del artículo
Punto 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ón
Todas 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ículo
Punto decimal y 4 decimales.
HTML, ZPL
{data.ARTICLE_IVA}
Porcentaje de IVA del artículo
Número sin «%»
HTML, ZPL
Posición de la etiqueta
Variable
Qué contiene
Formato y notas
Formatos
{data.S_ROW_COUNT}
Posición en la impresión, empezando en 0
Número
HTML, ZPL
{data.S_NUM_ROWS}
Número total de etiquetas
Número
HTML, 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
La plantilla por defecto de tipo «Etiquetas de ubicación de almacenes» del formato con que imprimes.
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
Variable
Qué contiene
Formato y notas
Formatos
{result}
ERR si algo falla
Con 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 motor
Igual 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 -->
Variable
Qué contiene
Formato y notas
Formatos
{stores.CODE}
Código de la ubicación
Texto sin etiquetas HTML
HTML, 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 texto
No 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ón
Solo sirve para condiciones.
HTML, ZPL, SBPL
{stores.S_ROW_COUNT}
Posición en la impresión, empezando en 0
Número
HTML, ZPL, SBPL
{stores.S_NUM_ROWS}
Número total de etiquetas
Número
HTML, 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
La plantilla por defecto de tipo «Artículos».
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
Variable
Qué contiene
Formato y notas
{name}
Nombre del artículo
Texto
{short_description}
Descripción corta
Puede llevar HTML.
{long_description}
Descripción larga
HTML
{part_number}
Referencia (part number)
Texto
{reference}
Campo «Referencia» de la ficha del artículo
Texto
{barcode}
Código de barras
Texto: en la ficha no hay imagen del código.
{isbn}
ISBN
Texto
{manufacturer}
Fabricante
Texto
{status}
Condición o estado del artículo
Texto
{furl}
Dirección amigable del artículo en la tienda en línea
Texto
{date}
Fecha de alta del artículo
aaaa-mm-dd hh:mm:ss, sin formatear
Precio y stock
Variable
Qué contiene
Formato y notas
{price}
Precio de venta sin IVA de la ficha del artículo, sin tarifa
2 decimales, coma decimal y punto de miles, sin símbolo de moneda
{total_stock}
Stock total, sumando todos los almacenes
Entero con punto de miles; redondea los decimales.
{available_stock}
Stock disponible
Entero con punto de miles
{block_stock}
Stock no disponible: total menos disponible
Entero con punto de miles
Medidas
Variable
Qué contiene
Formato y notas
{weight}
Peso
2 decimales con coma, sin unidad
{width}
Ancho
2 decimales con coma, sin unidad
{height}
Alto
2 decimales con coma, sin unidad
{depth}
Fondo
2 decimales con coma, sin unidad
{volume}
Volumen
2 decimales con coma, sin unidad
Imágenes
Variable
Qué contiene
Formato 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 plataforma
Para usarla cuando {image} esté vacía (ejemplo debajo).
Dirección completa de la imagen de cabecera de la plantilla; si no tiene, el logo de acceso de la plataforma
Para <img src="{company_logo}">.
Otros
Variable
Qué contiene
Formato y notas
{pdf_puppeteer}, {pdf_docraptor}
1 si la plataforma genera el PDF con ese motor; si no, vacía
Para 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 uses
Usa
Por 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.
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.