Cómo crear etiquetas a partir de archivos de datos de Excel y tablas de búsqueda

Tus pedidos están en Excel. Los nombres de tus productos están en Excel. Tus direcciones están en Excel. Y, aun así, cada vez que necesitas etiquetas, alguien abre la hoja de cálculo, copia una fila, la pega en una plantilla, guarda un PDF y repite — cuarenta veces. O peor, alguien escribió un script frágil hace dos años que se rompe cada vez que se renombra una columna.

Este artículo recorre la alternativa: usar un archivo de Excel como fuente de datos y un segundo archivo de Excel (o una segunda hoja) como tabla de búsqueda, y luego producir etiquetas terminadas como PDF de varias páginas, PNG individuales o salida directa a impresora — sin copiar y pegar y sin mantener un analizador.

Lo que tendrás al final:

• Un archivo de datos con una fila por etiqueta y una fila de encabezado que se convierte en los nombres de tus campos.
• Una tabla de búsqueda que resuelve claves como SKU en nombres completos de productos o categorías.
• Un diseño de etiqueta en el estudio de etiquetas de LPSNG con campos asignados a columnas de la hoja de cálculo.
• Un trabajo repetible: cambia la hoja de cálculo, vuelve a ejecutar, obtén nuevas etiquetas.

El Next Generation Label Printing System se encarga del renderizado, la cola de trabajos y la salida por ti. Si quieres transformar valores de campos individuales con Python en lugar de un mapeo simple, eso se cubre por separado en Label Printing API for Python Developers: Field Scripting — este artículo se mantiene en la ruta de la hoja de cálculo.

Requisitos previos: lo que necesitas antes de empezar

• Una edición de RSJ LPSNG con acceso al estudio de etiquetas y a la cola de trabajos. La Cloud Solution, la Embedded Edition (un ordenador de placa única como una Raspberry Pi) y las Enterprise Features exponen la misma funcionalidad principal.
• Tu archivo de datos de Excel, una fila por etiqueta — por ejemplo, número de artículo, descripción, precio.
• Opcionalmente un archivo de búsqueda separado (o una hoja separada) que asigne una clave — por ejemplo, el número de artículo — al texto que realmente quieres en la etiqueta, como el nombre completo del producto o la categoría.
• Un diseño de etiqueta. Ya sea uno que hayas creado en el estudio de etiquetas de LPSNG o un diseño existente que quieras alimentar con datos de la hoja de cálculo.
• Una idea clara de qué columna pertenece a qué campo. Dibújalo en papel si es necesario; cinco minutos aquí ahorran una hora de reasignación.

La interfaz de Excel está documentada en lpsng.rsj.de/en/excel. No se requiere instalación local más allá de tu navegador; la configuración de tu impresora es la única pieza local.

Paso 1: Prepara tu archivo de datos de Excel y la tabla de búsqueda

Estructura el archivo de datos con una fila de encabezado, porque cada encabezado de columna se convierte en un campo con nombre que puedes asignar más tarde.

SKU,Description,Price,Quantity
A-1001,Steel bracket 40mm,4.90,1
A-1002,Steel bracket 60mm,5.40,2
A-1003,Aluminium bracket 40mm,6.10,1

Luego construye la búsqueda como una hoja o archivo separado con una columna de clave y los valores a combinar:

[
  { "SKU": "A-1001", "ProductName": "Steel Bracket, 40 mm, galvanised", "Category": "Hardware" },
  { "SKU": "A-1002", "ProductName": "Steel Bracket, 60 mm, galvanised", "Category": "Hardware" },
  { "SKU": "A-1003", "ProductName": "Aluminium Bracket, 40 mm",        "Category": "Hardware" }
]

Algunas reglas que evitan la mayoría de los problemas posteriores:

• Mantén las claves consistentes. La misma ortografía, el mismo formato, las mismas mayúsculas y minúsculas en ambos lados.
• Elimina celdas combinadas y filas en blanco. Rompen el mapeo de columnas y pueden desplazar la fila de encabezado detectada.
• Vigila los ceros iniciales. Si SKU es 0042, fuerza la columna a texto en Excel — de lo contrario la clave llega como 42 y la búsqueda falla silenciosamente.
• Un solo archivo está bien. Puedes usar el mismo libro para datos y búsqueda colocándolos en hojas separadas.

Antes de subir, una comprobación rápida en pandas detecta los desajustes de claves a tiempo:

import pandas as pd

data   = pd.read_excel("orders-october.xlsx", sheet_name="Data",     dtype=str)
lookup = pd.read_excel("orders-october.xlsx", sheet_name="Products", dtype=str)

# Normalise the join key identically on both sides.
for df in (data, lookup):
    df["SKU"] = df["SKU"].str.strip().str.upper()

orphans = sorted(set(data["SKU"]) - set(lookup["SKU"]))
print(f"{len(data)} data rows, {len(orphans)} keys without a lookup entry")
print(orphans)

Si orphans está vacío, tu búsqueda se resolverá para cada fila.

Paso 2: Diseña o abre tu diseño de etiqueta en LPSNG

Abre el estudio de etiquetas de LPSNG y crea un nuevo diseño o abre uno existente.

• Añade campos de texto para descripciones y precios, campos de código de barras para el número de artículo, y campos de imagen si quieres un logotipo o una foto del producto.
• Nombra cada campo de forma significativa — field_product_name, field_price, field_sku — para que el mapeo de la columna de la hoja de cálculo al campo de la etiqueta sea obvio dentro de seis meses. Para el lado del código de barras, los formatos 1D y 2D compatibles se enumeran en lpsng.rsj.de/en/barcode.
• Reserva suficiente espacio. Los valores de la hoja de cálculo no son uniformes: la primera fila puede ser una descripción corta, la quincuagésima puede ocupar tres líneas. Deja espacio en lugar de reducir la fuente más tarde.
• Transforma los valores solo si lo necesitas. Formatear un precio, concatenar dos columnas o calcular un dígito de control es tarea de un bloque de script de Python adjunto al campo, documentado en la referencia de la API de Python en lpsng.rsj.de/api.

Guarda el diseño. Se convierte en la plantilla para cada fila de tu archivo de Excel — el trabajo de diseño se hace una sola vez.

Paso 3: Asigna las columnas de Excel a los campos de la etiqueta

En la interfaz de Excel de LPSNG, sube o selecciona tu libro como fuente de datos, luego asigna cada columna a un campo. Para los valores de búsqueda, especifica la hoja o archivo de búsqueda y la columna de clave; LPSNG resuelve la búsqueda por fila antes del renderizado, de modo que el campo de la etiqueta recibe el valor combinado, no la clave sin procesar.

La interfaz de mapeo expresa algo como esto — la interfaz escribe la configuración por ti:

# Illustrative shape of the mapping you configure in the Excel interface.
layout: product-label
data_source:
  file: orders-october.xlsx
  sheet: Data
fields:
  field_sku:         SKU
  field_description: Description
  field_price:       Price
lookup:
  file: orders-october.xlsx
  sheet: Products
  key: SKU
  merge:
    field_product_name: ProductName
    field_category:     Category
output:
  format: pdf

Luego previsualiza el mapeo con las primeras filas. La previsualización es donde detectas una columna desfasada o un precio que aterriza en el campo de descripción — antes de gastar un rollo de etiquetas.

Esta es la alternativa gestionada a escribir un analizador personalizado o montar una canalización de línea de comandos: el mapeo en sí no necesita código.

Paso 4: Renderiza etiquetas como PDF, PNG o envíalas a imprimir

Elige tu salida:

• PDF de varias páginas — ideal para archivar, enviar por correo o entregar a una imprenta.
• Imágenes PNG individuales — para incrustar en otro sistema o en un front end web.
• Impresión directa — selecciona la impresora, y la cola de trabajos procesa cada fila como una etiqueta separada.
• JSON — cuando un sistema posterior necesita el resultado renderizado o los datos resueltos en lugar de papel.

Para la automatización, controla el mismo trabajo desde código. La API del servicio web envía trabajos de impresión, renderiza etiquetas individuales como PDF o PNG, y admite impresión directa; la autenticación usa OAuth2, documentado en lpsng.rsj.de/en/webservice. El LPSNG Player independiente recibe un paquete más datos y escribe PDF, PNG, JSON o envía a una impresora:

# Endpoint paths, flags and payload fields are documented on the web service
# and Player pages — the shape below is illustrative only.
curl -X POST "https://<your-lpsng-host>/…"   -H "Authorization: Bearer $LPSNG_TOKEN"   -d '{ "layout": "product-label", "data": "orders-october.xlsx", "output": "pdf" }'

lpsng-player   --package product-label   --data orders-october.xlsx   --output pdf

Si tu equipo vive en Google Sheets en lugar de Excel, el Google Sheets Add-on ofrece el mismo flujo de trabajo de crear e imprimir en el navegador. Y todo el renderizado ocurre en el servidor — no instalas fuentes ni controladores localmente más allá de la configuración de tu impresora.

Paso 5: Verifica la salida y comprueba las búsquedas

Renderizar con éxito no es lo mismo que renderizar correctamente. Revisa los artefactos:

• Comprueba varias etiquetas contra las filas de origen — la primera fila, la última fila y cualquiera con un formato inusual.
• Confirma que las búsquedas se resolvieron. Si la etiqueta muestra A-1002 donde esperabas “Steel Bracket, 60 mm, galvanised”, la clave no coincidió.
• Escanea algunos códigos de barras con un lector y compara el valor decodificado con los datos previstos. How to Verify Barcodes Before Printing Labels tiene una lista de comprobación más completa.
• Lee la cola de trabajos. Las filas que fallaron o se omitieron aparecen allí, normalmente con el valor problemático o el error del script.
• Si adjuntaste scripts de campo, confirma que las transformaciones se aplicaron — un formato de fecha mal aplicado es fácil de pasar por alto hasta que alguien lee una etiqueta en un estante.

Solución de problemas comunes

Las etiquetas se imprimen con campos en blanco. Comprueba que los encabezados de columna coincidan exactamente con los nombres de campo asignados, y que el archivo de datos no tenga filas en blanco al principio por encima del encabezado. Una sola fila vacía en la parte superior lo desplaza todo.

Una búsqueda no devuelve nada. Las columnas de clave deben coincidir en mayúsculas y minúsculas, espacios circundantes y ceros iniciales. Normaliza ambos lados como se muestra en el Paso 1.

Los códigos de barras se escanean incorrectamente. Verifica que el campo del código de barras esté asignado a la columna correcta, y que el formato elegido pueda soportar la longitud de datos que estás codificando.

El renderizado falla solo en algunas filas. Inspecciona la cola de trabajos en busca de mensajes de error. Las causas comunes son un valor faltante que el diseño requiere, o un error de script dentro de un bloque de campo.

La impresora no recibe nada. Confirma que la impresora está en línea y seleccionada en la configuración de salida. Para escenarios de Google Cloud Print, consulta la documentación de Cloud Printing.

Preguntas frecuentes

¿Puedo usar el mismo archivo de Excel tanto para datos como para búsqueda? Sí. Coloca tus datos en una hoja y tu tabla de búsqueda en otra hoja dentro del mismo libro. Al asignar, selecciona la hoja adecuada para cada rol. Solo asegúrate de que la columna de clave usada para las búsquedas sea consistente en ambas hojas.

¿Necesito escribir código para asignar columnas de Excel a campos de etiqueta? No. La interfaz de Excel de LPSNG proporciona una interfaz de mapeo donde asignas columnas de la hoja de cálculo a campos de etiqueta. Solo necesitas código si quieres transformar valores — por ejemplo, formatear un precio o concatenar campos — lo cual puedes hacer con bloques de script de Python adjuntos a los campos (consulta la documentación de la API de Python).

¿Qué formatos de salida puedo generar a partir de datos de Excel? Puedes generar PDF de varias páginas, imágenes PNG individuales, enviar trabajos directamente a una impresora o producir JSON. La API del servicio web y el LPSNG Player admiten estas salidas, de modo que puedes integrar el renderizado en tus propias aplicaciones.

¿Cómo actualizo las etiquetas cuando cambia el archivo de Excel? Simplemente vuelve a subir el archivo de Excel actualizado o vuelve a ejecutar el trabajo con los nuevos datos. LPSNG aplica el mismo diseño de etiqueta y mapeo, así que no necesitas rediseñar nada. La cola de trabajos procesará las nuevas filas y producirá etiquetas actualizadas.

Conclusión: de la hoja de cálculo a etiquetas listas para el estante

El flujo de trabajo es corto: prepara tus datos de Excel y la tabla de búsqueda, diseña el diseño una vez, asigna columnas a campos, renderiza, verifica. Nada en esa lista requiere que escribas un analizador o que cuides un script.

Next Generation Label Printing System hace el trabajo pesado — renderizado, cola de trabajos, resolución de búsquedas y salida — para que puedas dedicar tu tiempo a los datos en lugar de a la fontanería. Funciona igual ya sea que produzcas diez etiquetas o diez mil, y la API del servicio web permite que otros sistemas activen los mismos trabajos mediante programación.

Prueba la interfaz de Excel en tu edición de LPSNG — cloud, embedded o enterprise — y si tu equipo prefiere las hojas de cálculo en el navegador, echa un vistazo al Google Sheets Add-on para el mismo flujo de trabajo en tu navegador.

Publicaciones relacionadas

• Zebra Designer Alternative for Developers: What to Compare
• How to Connect ESL Tags to Items via API
• What a Vendor-Neutral ESL Interface Means for Developers