Esta guía explica cómo configurar las etiquetas cuando se utiliza una impresora TSPL.
El código de la etiqueta se configura en la sección 'Configuración/Impresión/Etiquetas'.
Podemos personalizar el contenido de la etiqueta para imprimir en cualquier tamaño del medio.

---

1 / Contenido dinámico

Un contenido (texto o código de barras) es un bloque de datos que podemos colocar en la cuadrícula de etiquetas.
Cada bloque tiene coordenadas X e Y, donde la posición X es la ubicación horizontal desde el lado izquierdo de la etiqueta y la posición Y es la ubicación vertical desde el lado superior de la etiqueta.
El tamaño de nuestra etiqueta está establecido en puntos. Dependiendo de la resolución de nuestra impresora y el tamaño de las etiquetas, tendremos más o menos puntos en el ancho y la altura de nuestro medio. Tendremos que cambiar los valores X e Y para colocar el contenido en el lugar correcto.
Por ejemplo: si la resolución de nuestra impresora es 203 ppp (puntos por pulgada), una etiqueta de 51x25 mm tendrá 406 puntos horizontalmente (X) y 203 puntos verticalmente (Y).

Podemos imprimir los siguientes contenidos en nuestras etiquetas:
– el ID del producto : <hibou_print_tspl_products_id>,
– el nombre del producto : <hibou_print_tspl_products_name>,
– la variación del producto: <hibou_print_tspl_products_size>,
– la categoría del producto : <hibou_print_tspl_products_category>,
– el precio del producto : <hibou_print_tspl_products_price> ,
– el precio del producto sin decimales : <hibou_print_tspl_products_price_round_0>,
– el precio del producto con 2 decimales : <hibou_print_tspl_products_price_round_2>,
– el precio del producto ponderado para el múltiple : <hibou_print_tspl_products_price_weighted>,
– el precio de descuento del producto : <hibou_print_tspl_products_discount_price>,
– el código de barras del producto <hibou_print_tspl_bar_code_value>,
– la divisa de la cuenta : <hibou_print_tspl_currency>,
– el código del proveedor del producto : <hibou_print_tspl_products_ref_manufacturer>,
– la referencia externa del producto : <hibou_print_tspl_products_ref_ext>,
– la marca del producto: <hibou_print_tspl_products_brand>,
– la ubicación de almacenamiento del producto: <hibou_print_tspl_products_storage_location>,
– el nombre corto del producto: <hibou_print_tspl_products_short_name>,
– el nombre del punto de venta: <hibou_print_store_name>,
– la información misc_date: <hibou_print_products_misc_date>,
– la información misc_decimal: <hibou_print_products_misc_decimal>,
– la información misc_text: <hibou_print_products_misc_text>,
– la información misc_integer: <hibou_print_products_misc_int>,
– la información misc_varchar: <hibou_print_products_misc_varchar>,
– la información misc_varchar2: <hibou_print_products_misc_varchar2>,
– y cualquier texto libre.

---

2/ Codificar el tamaño de la etiqueta

Cada código de etiqueta debe empiezar con el código de apertura <hibou_print_tspl_start_format> y terminar con el código de cierre <hibou_print_tspl_end_format>.
El código de apertura codifica el formato de la etiqueta en milímetros:

Ejemplo:

<hibou_print_tspl_start_format>50|25

para imprimir en etiquetas de 50 x 25 mm

---

3/ Codificar un contenido de texto

Para el contenido de texto (<hibou_print_tspl_add_text>), debemos establecer las siguientes variables en este orden:
– la posición (X e Y en puntos),
– la fuente (A o del 0 al 5 | 3 por defecto),
– la dirección del texto (0 para horizontal, 90 para vertical, 180 horizontal invertido, 270 vertical invertido),
– la altura de la fuente (multiplicador de 1 a 10),
– el ancho de la fuente (multiplicador de 1 a 10).
Las variables están separadas por barras (|).

Ejemplo:

<hibou_print_tspl_add_text>20|10|2|0|1|1|<hibou_print_products_price> <hibou_print_currency>

<hibou_print_tspl_add_text> significa que estamos imprimiendo un contenido de texto,
20|10 son posiciones X e Y del texto,
2 es la fuente número 2 de la impresora,
0 para imprimir el texto horizontalmente,
1|1 son la altura y el ancho de la fuente,
y <hibou_print_products_price> <hibou_print_currency> significa que queremos imprimir el precio del producto seguido del símbolo de divisa de la cuenta.

---

4 / Codificar un código de barras

Para los códigos de barras (<hibou_print_tspl_bar_code>), debemos establecer las siguientes variables en este orden:
– la posición (X e Y en puntos),
– la altura (en puntos | 100 por defecto),
– la dirección (0 para horizontal, 90 para vertical, 180 horizontal invertida, 270 vertical invertida).

Ejemplo:

<hibou_print_tspl_bar_code>20|300|100|0|<hibou_print_bar_code_value>

<hibou_print_tspl_bar_code> significa que estamos imprimiendo un código de barras,
20|300 son las posiciones X e Y del código de barras,
100 significa que el código de barras tendrá 100 puntos de altura,
0 para imprimir el código de barras en horizontal,
y los números de código de barras del producto.

---

5 / Codificar un código QR

Para los códigos QR (<hibou_print_tspl_dmatrix>), debemos establecer las siguientes variables en este orden:
– la posición (X e Y en puntos),
– la altura (en puntos),
– el ancho (en puntos).

Ejemplo:

<hibou_print_tspl_dmatrix>20|50|80|80|https://www.google.com

<hibou_print_dmatrix> significa que estamos imprimiendo un código QR,
20|50 son las posiciones X e Y del código QR,
80|80 son las medidas del código QR,
y luego el contenido a codificar (el sitio web Google en este ejemplo).

---

6 / Un ejemplo

El código para la siguiente etiqueta sería:

<hibou_print_tspl_start_format>50|25
//Abrir código

<hibou_print_tspl_add_text>20|25|2|0|1|1|<hibou_print_products_name>
//Imprimir el nombre del producto en la parte superior de la etiqueta

<hibou_print_tspl_bar_code>20|70|90|0|<hibou_print_bar_code_value>
//Imprimir el código de barras del producto

<hibou_print_tspl_add_text>330|80|2|90|1|1|<hibou_print_products_price>
//Imprime el precio del producto en vertical después del código de barras

<hibou_print_tspl_add_text>360|80|2|90|1|1|EUR
//Imprimir el signo del euro en vertical debajo del precio de tu producto

<hibou_print_tspl_end_format>
//Cerrar código

---

7/ Enmarcar y tachar un precio

Las variables para enmarcar (<hibou_print_tspl_add_box>) son:
– la posición desde la esquina superior izquierda (X e Y en puntos),
– la posición desde la esquina inferior derecha (X e Y en puntos),
– el grosor del borde (en puntos entre 1 y 10),
– el redondeo de esquinas (entre 0 y 8, done 0 es sin redondeo).

Ejemplo:

<hibou_print_tspl_add_box>50|50|250|90|1|0

crearemos una caja cuadrada de esquinas negro con 200 puntos anchura y 40 puntos de altura.

Para tachar un precio, vamos a superponer una caja de una sola línea sobre el precio. La altura de la caja tendrá el mismo valor que el grosor del borde.

Ejemplo:

<hibou_print_tspl_add_text>250|70|3|0|1|1|<hibou_print_products_price> EUR  
<hibou_print_tspl_add_box>240|83|290|83|1|0