Impresión de etiquetas con Python: personaliza campos con LPSNG

Necesitas imprimir etiquetas cuyo contenido no es fijo. Puede que un nombre de producto deba convertirse a mayúsculas, que una fecha de caducidad deba calcularse a partir de una fecha de producción, o que un precio total deba derivarse de la cantidad y el precio unitario. En lugar de ejecutar un script de Python independiente para transformar tus datos antes de cada trabajo de impresión, puedes adjuntar Python directamente a los campos de etiqueta en LPSNG.

Con la API de scripts de campo, insertas pequeños bloques de Python en campos de etiqueta individuales. Antes de que LPSNG renderice la etiqueta, ejecuta esos scripts y usa el valor devuelto como contenido final del campo. Este es el núcleo de la impresión de etiquetas con scripts de Python en LPSNG: valores de campo basados en datos sin una canalización de scripting externa.

Dado que el Sistema de impresión de etiquetas de nueva generación incluye un diseñador visual de etiquetas y ejecución de Python integrada, no necesitas configurar un entorno de Python separado, gestionar controladores de impresora ni manejar protocolos de impresión sin procesar. El flujo de trabajo gestionado mantiene el diseño de etiquetas, la ejecución de scripts y el envío de trabajos de impresión en un solo lugar.

Requisitos previos

Antes de empezar, asegúrate de tener:

• Una cuenta de LPSNG con acceso al diseñador de etiquetas. Esto aplica tanto a la edición en la nube como a la integrada.
• Familiaridad básica con la sintaxis de Python: variables, funciones, métodos de cadenas y f-strings.
• Un diseño de etiqueta con el que trabajar, o la capacidad de crear uno nuevo en LPSNG.
• Opcional: un archivo de datos de muestra, como CSV o Excel, para probar valores de campo dinámicos con registros realistas.

No necesitas una instalación local de Python. Los scripts de Python se ejecutan dentro de LPSNG como parte del proceso de renderizado de etiquetas.

Paso a paso: añadir scripts de Python a los campos de etiqueta

Paso 1: abre el diseñador de etiquetas y selecciona el campo objetivo

Inicia sesión en LPSNG y abre la etiqueta que deseas modificar. En el diseñador de etiquetas, selecciona el campo que debe contener contenido dinámico; por ejemplo, un campo de texto para el nombre del producto.

Si empiezas desde cero, crea una etiqueta nueva, añade un campo de texto y vincúlalo a una fuente de datos o déjalo como marcador de posición para pruebas.

Paso 2: abre las propiedades del campo y localiza la sección de script

Con el campo seleccionado, abre sus propiedades. Busca el área de scripting destinada al código Python. La API de scripts de campo la trata como un bloque de script adjunto al campo, por lo que la sección puede estar etiquetada como Script, Python o algo similar según la versión del diseñador.

El punto importante es que el script pertenece al campo, no a toda la etiqueta. Si adjuntas un script al campo equivocado, no afectará la salida que esperas.

Paso 3: escribe un script que reciba el valor del campo y devuelva un valor modificado

En el área de script de Python, el valor actual del campo está disponible para tu código. Un script mínimo que convierte el valor a mayúsculas tiene este aspecto:

return value.upper()

Si el campo contiene "apple" antes de que se ejecute el script, la etiqueta renderizada mostrará "APPLE".

Usa return para enviar el valor final de vuelta a la etiqueta. LPSNG usa el valor devuelto como contenido impreso del campo.

Paso 4: usa variables de contexto para crear contenido dinámico

Puedes combinar el valor actual del campo con fechas, datos del registro u otro contexto disponible durante el renderizado. Por ejemplo, para añadir la fecha actual a un nombre de producto:

from datetime import datetime

return f"{value} - {datetime.now().strftime('%Y-%m-%d')}"

Si el valor del campo es "Tomato Sauce", el resultado renderizado podría ser:

Tomato Sauce - 2026-08-26

Dependiendo de cómo esté vinculada tu etiqueta a una fuente de datos, el registro de datos actual también puede estar disponible como parte del contexto del script. Consulta la configuración de vinculación de datos de tu etiqueta en el diseñador para confirmar qué variables puedes usar.

Paso 5: prueba el script en el diseñador

Usa la vista previa de la etiqueta o los datos de prueba para verificar la salida antes de imprimir. LPSNG ejecuta los scripts de campo durante la vista previa, por lo que puedes ver el resultado exacto de tu código Python sin enviar un trabajo de impresión.

Haz cambios pequeños y vuelve a ejecutar la vista previa hasta que el campo muestre exactamente lo que necesitas.

Paso 6: guarda la etiqueta y úsala en un trabajo de impresión

Una vez que el script funciona en la vista previa, guarda la etiqueta. Ahora puedes usarla a través de la interfaz web, la API de servicios web o el reproductor LPSNG.

El flujo de trabajo gestionado significa que no necesitas exportar tu script de Python, envolverlo en un procesador de trabajos independiente ni comunicarte con un protocolo de impresora. LPSNG ejecuta el script como parte del renderizado de la etiqueta y envía la salida final a la impresora o formato de archivo seleccionado.

Paso 7: opcional — combina varios campos o realiza cálculos

Los scripts de campo de Python también pueden calcular valores a partir de otros datos. Por ejemplo, si el registro actual expone quantity y unit_price, puedes calcular un precio total:

quantity = float(data["quantity"])
unit_price = float(data["unit_price"])
total = quantity * unit_price

return f"{total:.2f}"

Esto es útil para etiquetado de pedidos, albaranes o etiquetas de almacén donde un valor impreso depende de varios campos de entrada.

Ten cuidado de devolver una cadena. Si tu script devuelve un número, es posible que LPSNG no lo renderice como esperas. En caso de duda, convierte el resultado con str() o un f-string.

Verificación: confirmar que tu script de Python funciona

Después de adjuntar un script de Python a un campo, confirma la salida usando al menos una de estas comprobaciones:

• Usa la vista previa de la etiqueta en LPSNG. Es la forma más rápida de ver los valores de campo después de la ejecución del script.
• Genera una salida PDF o PNG a través del servicio web o del reproductor LPSNG y luego inspecciona la etiqueta renderizada. Si no tienes una impresora física disponible, consulta Cómo probar la impresión de etiquetas sin una impresora física.
• Comprueba si hay errores de script en el diseñador. LPSNG puede mostrar excepciones de Python o mensajes de error cuando pruebas el campo.
• Compara la salida entre varios registros de datos. Ejecuta la misma etiqueta con diferentes datos de entrada para confirmar que el script se comporta de forma coherente y no produce valores inesperados para campos vacíos o faltantes.

Solución de problemas comunes

El script no se ejecuta

Asegúrate de que el script esté adjunto al campo correcto. Un script en un campo diferente no afectará al campo que estás inspeccionando. Confirma también que el tipo de campo admita scripting.

Errores de sintaxis

La indentación de Python y los dos puntos faltantes son causas comunes. Si el editor de scripts muestra detalles del error, léelos con atención. Prueba primero con un script mínimo de una línea:

return value

Luego construye la lógica de forma incremental.

Salida incorrecta

Si el valor impreso parece incorrecto, comprueba si tu script devuelve una cadena. Para números y fechas, usa str() o un f-string para producir salida de texto:

return str(total)

Verifica también que el script esté leyendo los nombres de variable correctos para el campo actual y el registro de datos.

Rendimiento con trabajos de impresión grandes

Para lotes grandes, mantén los scripts de campo ligeros. Evita bucles complejos u operaciones costosas repetidas si el mismo resultado puede precalcularse en tu archivo de datos antes de imprimir.

Acceso al contexto

Confirma qué variables e importaciones están disponibles en el entorno del script. La API de scripts de campo está diseñada para modificar valores de campo basándose en el registro actual y el contexto integrado. Es posible que no permita acceso arbitrario a red o archivos por razones de seguridad.

Preguntas frecuentes

¿Puedo usar scripts de Python para generar códigos de barras dinámicamente?

Sí. LPSNG admite scripts de Python en campos, y puedes generar contenido de código de barras dinámicamente devolviendo la cadena adecuada. El tipo de campo de código de barras puede entonces renderizar esa cadena como un código de barras. Consulta la documentación de formatos de código de barras para conocer los tipos admitidos. Si necesitas un flujo completo de impresión de códigos de barras impulsado por API, consulta Automatizar la impresión de etiquetas de códigos de barras con la API de LPSNG.

¿Es posible acceder a fuentes de datos externas desde un script de Python en LPSNG?

La API de scripts de campo está diseñada para modificar valores de campo basándose en el registro de datos actual y el contexto integrado. Es posible que no permita acceso arbitrario a red o archivos por razones de seguridad. Para datos externos, considera usar la API de servicios web o archivos de datos como Excel y CSV para suministrar datos antes de imprimir.

¿Cómo depuro un script de Python que falla silenciosamente?

LPSNG puede mostrar errores de script en el diseñador cuando pruebas el campo. También puedes añadir declaraciones return temporales para inspeccionar valores intermedios:

return f"DEBUG: value={value}, type={type(value)}"

Asegúrate de que el script devuelva una cadena y gestione las excepciones con elegancia para que un registro defectuoso no interrumpa un trabajo de impresión completo.

¿Puedo reutilizar scripts de Python en varias etiquetas?

Los scripts suelen estar adjuntos a campos individuales, pero puedes copiarlos y pegarlos entre etiquetas. Para lógica compleja, considera usar la integración externa a través de la API para preprocesar los datos antes de enviarlos a LPSNG. Esto mantiene simples los scripts de etiqueta y facilita el mantenimiento de la lógica reutilizada.

Conclusión

El scripting de Python en LPSNG te ofrece una forma práctica de crear etiquetas dinámicas basadas en datos sin herramientas externas. Puedes formatear cadenas, calcular valores, añadir fechas y generar contenido de códigos de barras directamente dentro del diseñador de etiquetas.

Una vez que tus scripts de campo de Python funcionen, el siguiente paso es automatizar el flujo de trabajo circundante. Explora la API de servicios web para trabajos de impresión programáticos, o usa el reproductor LPSNG para procesamiento por lotes. Si estás evaluando ediciones, consulta Precios del software de impresión de etiquetas: explicación de los planes RSJ LPSNG.

Inicia sesión en LPSNG y abre el diseñador de etiquetas para probar tu primer script de campo de Python hoy mismo.

Publicaciones relacionadas

• Automatizar la impresión de etiquetas de códigos de barras con la API de LPSNG
• Cómo probar la impresión de etiquetas sin una impresora física
• Precios del software de impresión de etiquetas: explicación de los planes RSJ LPSNG
• Soluciones de impresión de etiquetas para sistemas de gestión de almacenes