> ## Documentation Index
> Fetch the complete documentation index at: https://ayuda.daia.cl/llms.txt
> Use this file to discover all available pages before exploring further.
# Plantillas
> Editor visual de plantillas de etiquetas ZPL: variables, textos y códigos de barras
La pestaña Plantillas permite diseñar las etiquetas que se imprimirán en producción. DAIA Agent incluye un **editor visual** drag-and-drop que genera el código ZPL sin necesidad de conocer la sintaxis del lenguaje, y un **editor ZPL** para usuarios avanzados.
Cada plantilla tiene un **Nombre**, una **Descripción** y un interruptor **Activa** (solo las plantillas activas se ofrecen al configurar pulsadores e impresión).
***
## El editor visual
Al crear o editar una plantilla se abre el editor. A la izquierda está el **lienzo de diseño** con el tamaño real de la etiqueta — **Ancho (mm)** y **Alto (mm)** a 203 DPI — y a la derecha la **Vista previa**, que con el botón **Actualizar** muestra la etiqueta renderizada con datos de ejemplo.
### Barra de herramientas
| Grupo | Herramientas |
| --------------------- | ---------------------------------------------------------------------------------------------------------- |
| Agregar elementos | Texto, Línea, Code128, EAN13, UPC-A, QR Code, DataMatrix, Voice Pick Code, Fecha Agrícola, Texto Recortado |
| Densidad de impresión | **Por Defecto** o **Darkness** (0–30, comando ZPL `~SD`) para ajustar qué tan oscura sale la impresión |
| Edición | Deshacer (Ctrl+Z), Rehacer (Ctrl+Y), Duplicar (Ctrl+D), Traer al frente, Enviar atrás, Eliminar (Supr) |
Al hacer clic en un elemento del lienzo, el **panel de propiedades** muestra su posición (X/Y en mm) y sus opciones específicas. La casilla **Bloquear elemento** evita moverlo por accidente.
***
## Variables
Las variables se escriben entre corchetes angulares — por ejemplo `` o `` — y se reemplazan automáticamente con los datos reales de producción al momento de imprimir. Puedes combinarlas con texto fijo en un mismo elemento (ej. `Lote: `).
El botón **Insertar variable** del panel de propiedades abre el selector: busca por nombre y muestra cada variable con su ejemplo, agrupada por categoría.
| Variable | Descripción |
| ---------------------------------------------------- | --------------------------------------------- |
| `` / `` / `` | Especie (nombre interno y nombres de display) |
| `` / `` / `` | Variedad, su código y campo extendido |
| `` / `` / `` | Calibre y campos extendidos |
| `` / `` / `` | Categoría y campos extendidos |
| `` / `` / `` | Color y campos extendidos |
| `` | SKU del producto |
| Variable | Descripción |
| -------------------------------------- | ---------------------------- |
| `` / `` / `` | Nombre, código e ID del pack |
| `` | Marca del pack |
| `` | GTN del pack |
| `` | Tipo de empaque |
| `` / `` | Peso neto en kg y en libras |
| Variable | Descripción |
| ------------------------------------------------- | ------------------------------ |
| `` / `` | Nombre y código del productor |
| `` / `` / `` | Identificadores CSG, GGN y SDP |
| `` / `` / `` | Comuna, provincia y región |
| Variable | Descripción |
| -------------------------------------------------------------------- | ----------------------------------------- |
| `` / `` | Código e ID del lote en proceso |
| `` / `` / `` / `` | Fecha de producción en distintos formatos |
| `` | Fecha de cosecha |
| `` | Turno |
| `` / `` | Productor del lote |
| `` / `` | Especie y variedad del lote |
| `` | Orden de trabajo del lote |
| `` / `` | Exportadora |
| `` / `` | Empresa y temporada (códigos externos) |
| Variable | Descripción |
| ------------------------------- | --------------------------------------------------------- |
| `` | Código único de la caja |
| `` / `` | Código de barras GS1 compuesto (con o sin caracteres FNC) |
| `` / `` | Código y descripción del pulsador |
| `` | Código de la salida |
| `` | Nombre de la plantilla |
| `` | Hora actual de impresión |
***
## Elementos y su configuración
### Texto
Texto fijo, variables o una combinación de ambos.
| Propiedad | Descripción |
| --------- | --------------------------------------------------------------------------- |
| Contenido | El texto a imprimir; usa **Insertar variable** para agregar datos dinámicos |
| Fuente | Fuente ZPL (0, A–H); la fuente `0` es la escalable estándar |
| Tamaño | Altura del texto en dots (a 203 DPI, 8 dots = 1 mm) |
| Rotación | 0°, 90°, 180° o 270° |
| Negrita | Simula negrita imprimiendo el texto con doble pasada |
### Línea
Separadores gráficos: orientación horizontal o vertical, **Longitud** y **Grosor** en dots, y color (negro o blanco).
### Códigos de barras — Code128, EAN13, UPC-A
Los tres tipos comparten las mismas propiedades:
| Propiedad | Descripción |
| ------------- | -------------------------------------------------------------------------------------------------------------------- |
| Contenido | El dato a codificar; normalmente una variable (ej. ``, ``) |
| Alto (dots) | Altura de las barras |
| Ancho módulo | Grosor de la barra más delgada (1–10); a mayor valor, código más ancho |
| Mostrar texto | Imprime el valor legible bajo el código |
| Texto arriba | Mueve el texto legible sobre el código |
| Rotación | Orientación del código |
| **GS1-128** | (Solo Code128) activa el modo UCC/EAN-128 para códigos de trazabilidad GS1; úsalo junto con la variable `` |
Para la etiqueta GS1-128 estándar de exportación (GTIN + fecha + lote en un solo código), inserta un **Code128** con contenido `` y activa la casilla **GS1-128**.
### QR Code y DataMatrix
Códigos 2D para contenidos largos (URLs, trazabilidad extendida):
| Propiedad | Descripción |
| ----------------------------- | --------------------------------------------------------------------------------------------- |
| Contenido | Texto o variables a codificar |
| Magnificación / Tamaño módulo | Tamaño del código |
| Corrección (solo QR) | Nivel de corrección de errores: L, M, Q o H (mayor = más tolerante a daños, código más denso) |
### Voice Pick Code
Código de 4 dígitos del estándar **PTI** (Produce Traceability Initiative) usado en picking por voz: se calcula automáticamente a partir del GTIN, el lote y la fecha, y se muestra como 2 dígitos pequeños + 2 dígitos grandes.
| Propiedad | Descripción |
| ---------------------------- | ------------------------------------------------------------- |
| Fuente GTIN | Variable con el GTIN de 14 dígitos (normalmente `pack_gtn`) |
| Fuente Lote | Variable con el lote (normalmente `lote`) |
| Sufijo Lote | Texto opcional que se concatena al lote antes del cálculo |
| Fuente Fecha | Variable con la fecha en formato YYMMDD; puede omitirse |
| Tamaño grande / pequeño | Altura en dots de los 2 dígitos grandes y los 2 pequeños |
| Espacio entre dígitos | Separación horizontal (negativo = más juntos) |
| Fondo negro / letras blancas | Imprime el código en recuadro negro invertido, como exige PTI |
### Fecha Agrícola
Imprime la fecha en formato de **mes agrícola** (noviembre = 1, diciembre = 2, …, octubre = 12) seguido del día, dentro de un recuadro negro con texto blanco. Ejemplo: el 14 de mayo se imprime como `714`.
| Propiedad | Descripción |
| --------------------- | --------------------------------------------------------- |
| Fuente de fecha | Variable de fecha a convertir (normalmente `date_yymmdd`) |
| Tamaño texto | Altura del texto en dots |
| Ancho / Alto recuadro | Dimensiones del recuadro negro |
### Texto Recortado
Extrae una parte de una variable: los N caracteres desde la izquierda o desde la derecha. Útil por ejemplo para imprimir solo los últimos 4 dígitos del lote.
| Propiedad | Descripción |
| ------------------------------------ | ---------------------------------------------- |
| Fuente (variable) | La variable de origen (ej. `lote`) |
| Dígitos | Cuántos caracteres tomar |
| Desde | Izquierda o derecha |
| Fuente / Tamaño / Rotación / Negrita | Formato del texto, igual que un elemento Texto |
***
## Crear una plantilla
En **Configuración → Plantillas**, haz clic en **Nueva plantilla** y asigna nombre y descripción.
Ajusta **Ancho (mm)** y **Alto (mm)** al formato real de etiqueta que usa tu impresora.
Desde la barra de herramientas agrega textos, variables, líneas y códigos, y arrástralos a su posición en el lienzo.
Haz clic en un elemento y ajusta sus propiedades en el panel derecho; usa **Insertar variable** para los datos dinámicos.
Haz clic en **Actualizar** en la Vista previa para ver la etiqueta con datos de ejemplo.
Activa la plantilla con el interruptor **Activa** y haz clic en **Guardar**. Queda disponible para asignarla a pulsadores en el módulo Etiquetado.
***
## Editor ZPL (avanzado)
La pestaña **Editor ZPL** muestra y permite editar el código ZPL directamente. Esto sirve para:
* Usar comandos ZPL que el editor visual no expone
* Importar plantillas ZPL existentes de sistemas anteriores
* Ajustar con precisión el posicionamiento de elementos
El ZPL escrito a mano con comandos avanzados puede no representarse completamente al volver al Editor Visual. Para plantillas complejas, elige un modo de trabajo (visual o código) y mantente en él.
***
## Notas importantes
Antes de producir, imprime una etiqueta de prueba real: la Vista previa es fiel, pero la densidad (Darkness) y el ribbon de cada impresora pueden cambiar el resultado físico.
Verifica que las variables usadas tengan datos en producción: una variable sin valor (ej. `` con un pack sin GTN configurado) sale vacía en la etiqueta y puede invalidar códigos de barras.
