Esta guía explica cómo configurar las etiquetas cuando se utiliza una impresora ZPL.
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_zpl_products_id>,
– el nombre del producto : <hibou_print_zpl_products_name>,
– la variación del producto: <hibou_print_zpl_products_size>,
– la categoría del producto : <hibou_print_zpl_products_category>,
– el precio del producto : <hibou_print_zpl_products_price> ,
– el precio del producto sin decimales : <hibou_print_zpl_products_price_round_0>,
– el precio del producto con 2 decimales : <hibou_print_zpl_products_price_round_2>,
– el precio del producto ponderado para el múltiple : <hibou_print_zpl_products_price_weighted>,
– el precio de descuento del producto : <hibou_print_zpl_products_discount_price>,
– el código de barras del producto <hibou_print_zpl_bar_code_value>,
– la divisa de la cuenta : <hibou_print_zpl_currency>,
– el código del proveedor del producto : <hibou_print_zpl_products_ref_manufacturer>,
– la referencia externa del producto : <hibou_print_zpl_products_ref_ext>,
– la marca del producto: <hibou_print_zpl_products_brand>,
– la ubicación de almacenamiento del producto: <hibou_print_zpl_products_storage_location>,
– el nombre corto del producto: <hibou_print_zpl_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 un contenido de texto

Para el contenido de texto (<hibou_print_zpl_add_text>), debemos establecer las siguientes variables en este orden:
– la posición (X e Y en puntos),
– la fuente (de la A a la Z o del 0 al 9),
– el tamaño de fuente (en puntos),
– la dirección del texto (N para horizontal, R para vertical, I horizontal invertido, B vertical invertido),
– la altura de la fuente (en puntos),
– el ancho de la fuente (de forma predeterminada, podemos establecer el mismo valor que la altura de la fuente).
Las variables están separadas por barras (|).

Ejemplo:

<hibou_print_zpl_add_text>20|10|D|N|30|30|<hibou_print_products_price> <hibou_print_currency>

<hibou_print_zpl_add_text> significa que estamos imprimiendo un contenido de texto,
20|10 son posiciones X e Y del texto,
D es la fuente D de la impresora,
N para imprimir el texto horizontalmente,
30|30 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.

Si nuestro contenido de texto es largo, podemos acortarlo con los siguientes códigos: <hibou_print_zpl_cut_start> y <hibou_print_zpl_cut_end> Ejemplo:

<hibou_print_products_name>|<hibou_print_zpl_cut_start>0</hibou_print_zpl_cut_start>||<hibou_print_zpl_cut_end>20</hibou_print_zpl_cut_end>|  

solo se imprimen los primeros 20 caracteres del nombre del producto.

---

3 / Codificar un código de barras

Para los códigos de barras (<hibou_print_zpl_bar_code>), debemos establecer las siguientes variables en este orden:
– la posición (X e Y en puntos),
– la dirección (N para horizontal, R para vertical, I horizontal invertida, B vertical invertida),
– la altura (en puntos entre 1 y 32000),
– la visualización de números de código de barras (Y para sí o N para no),
– la posición de los números de código de barras (N si está debajo del código, Y si está arriba del código).

Ejemplo:

<hibou_print_zpl_bar_code>20|300|N|10|Y|N

<hibou_print_zpl_bar_code> significa que estamos imprimiendo un código de barras,
20|300 son las posiciones X e Y del código de barras,
N para imprimir el código de barras en horizontal,
10|Y|N significa que el código de barras tendrá 10 puntos de altura, y los números de código de barras se muestran debajo del código.

---

4 / Codificar un código QR

Para los códigos QR (<hibou_print_zpl_products_qr_code>), debemos establecer las siguientes variables en este orden:
– la posición (X e Y en puntos),
– el modelo (1 para normal o 2 para mejorado - recomendado),
– el tamaño (de 1 a 10),
– el nivel de precisión (H para ultra alto, Q para alto, M para estándar, L para bajo),
– el valor de la máscara (de 0 a 7).

Ejemplo:

<hibou_print_zpl_products_qr_code>20|50|2|5|M|7|https://www.google.com

<hibou_print_zpl_products_qr_code> significa que estamos imprimiendo un código QR,
20|50 son las posiciones X e Y del código QR,
0|2|5|M|7 son las configuraciones específicas del código QR,
y luego el contenido a codificar (el sitio web Google en este ejemplo).

---

5 / Un ejemplo

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

<hibou_print_zpl_start_format>
//Abrir código

<hibou_print_zpl_add_text>20|25|D|N|10|10|<hibou_print_products_name>
//Imprimir el nombre del producto en la parte superior de la etiqueta

<hibou_print_zpl_bar_code>20|70|N|80|Y|N
//Imprimir el código de barras del producto

<hibou_print_zpl_add_text>330|80|D|B|16|10|<hibou_print_products_price>
//Imprime el precio del producto en vertical después del código de barras

<hibou_print_zpl_add_text>360|80|D|B|16|10|EUR
//Imprimir el signo del euro en vertical debajo del precio de tu producto

<hibou_print_zpl_end_format>
//Cerrar código

---

6/ Enmarcar y tachar un precio

Las variables para enmarcar (<hibou_print_zpl_add_box>) son:
– la posición (X e Y en puntos),
– el ancho (en puntos entre 1 y 32000),
– la altura (en puntos entre 1 y 32000),
– el grosor del borde (en puntos entre 1 y 32000),
– el color de la línea de caja (B para el negro y W para el blanco),
– el redondeo de esquinas (entre 0 y 8, done 0 es sin redondeo).

Ejemplo:

<hibou_print_zpl_add_box>50|100|200|40|4|B|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_zpl_add_text>250|70|D|N|16|10|<hibou_print_products_price> EUR  
<hibou_print_zpl_add_box>240|83|150|2|2|B|0