Barcode Generator

Este nodo convierte un texto o número en una imagen de código de barras o código QR. Devuelve la imagen en base64 puro y como Data URL lista para usar en <img src>, plantillas HTML, emails o archivos PDF. Soporta más de 12 formatos estándar de la industria.

Función

Utiliza la librería bwip-js para renderizar el código como PNG. El valor a codificar puede ser un texto fijo o una variable dinámica del payload ({{campo}}). El resultado nunca afecta al payload de entrada: siempre devuelve un objeto con las propiedades barcode, base64 y dataUrl.

Configuración

Campo	Tipo	Requerido	Por defecto	Descripción
value	Texto	Sí	—	Valor a codificar. Soporta `{{campo}}` y dot-notation.
format	Select	Sí	`code128`	Formato del código de barras. Ver tabla de formatos.
outputMode	Select	No	`dataurl`	Qué va en `data.barcode`: Data URL o base64 puro.
scale	Número	No	`3`	Multiplicador de resolución (1–10). 6 = alta resolución para impresión.
height	Número	No	`15`	Altura de las barras en unidades bwip (5–100). Solo para códigos 1D.
includeText	Select	No	`true`	Mostrar el texto legible debajo del código (solo 1D).
qrErrorCorrection	Select	No	`M`	Nivel de corrección de error para QR: L, M, Q, H.
fgColor	Texto	No	`000000`	Color de las barras en hex de 6 dígitos sin `#`.
bgColor	Texto	No	`ffffff`	Color de fondo en hex de 6 dígitos sin `#`.

Formatos soportados

Valor	Nombre	Dimensión	Uso principal
`qrcode`	QR Code	2D	URLs, textos largos, apps móviles
`code128`	Code 128	1D	Logística, almacenes (más usado)
`code39`	Code 39	1D	Automoción, defensa, alfanumérico
`ean13`	EAN-13	1D	Retail, 13 dígitos
`ean8`	EAN-8	1D	Retail compacto, 8 dígitos
`upca`	UPC-A	1D	Retail USA, 12 dígitos
`itf`	ITF / Interleaved 2 of 5	1D	Logística, pares de dígitos
`pdf417`	PDF417	2D	Documentos, pasaportes
`datamatrix`	Data Matrix	2D	Industrial, componentes electrónicos
`aztec`	Aztec Code	2D	Billetes de tren y avión
`codabar`	Codabar	1D	Bibliotecas, bancos de sangre
`code93`	Code 93	1D	Canada Post

Output

{
  "barcode": "data:image/png;base64,iVBOR...",
  "base64": "iVBOR...",
  "dataUrl": "data:image/png;base64,iVBOR...",
  "format": "code128",
  "text": "1234567890"
}

Campo	Descripción
`barcode`	Valor según `outputMode` (Data URL o base64 puro)
`base64`	Siempre disponible: base64 puro sin prefijo
`dataUrl`	Siempre disponible: `data:image/png;base64,...`
`format`	Formato utilizado
`text`	Valor codificado (ya resuelto si era una variable)

Ejemplos de uso

QR Code para URL de pedido

{
  "type": "barcodeGenerator",
  "config": {
    "label": "QR pedido",
    "value": "https://mitienda.com/pedidos/{{order_id}}",
    "format": "qrcode",
    "scale": 4,
    "qrErrorCorrection": "M",
    "outputMode": "dataurl",
    "nextModule": "generar_html"
  }
}

Code 128 para número de serie

{
  "type": "barcodeGenerator",
  "config": {
    "label": "Código de barras serie",
    "value": "{{numero_serie}}",
    "format": "code128",
    "scale": 3,
    "height": 20,
    "includeText": "true",
    "fgColor": "000000",
    "bgColor": "ffffff",
    "outputMode": "dataurl",
    "nextModule": "imprimir_etiqueta"
  }
}

EAN-13 para etiqueta de producto retail

{
  "type": "barcodeGenerator",
  "config": {
    "label": "EAN-13 producto",
    "value": "{{producto.ean}}",
    "format": "ean13",
    "scale": 3,
    "height": 15,
    "includeText": "true",
    "outputMode": "dataurl",
    "nextModule": "adjuntar_email"
  }
}

Embeber en plantilla HTML

Combinando con el nodo HTML Template, podés embeber el QR directamente:

<img src="{{barcode}}" alt="QR pedido" width="200" height="200" />

Para esto, el flujo sería: barcodeGenerator → htmlTemplate (usando {{barcode}} como variable).

Corrección de error QR

Nivel	Capacidad	Cuándo usarlo
`L`	7%	QRs en pantalla, sin riesgo de daño
`M`	15%	Uso general (recomendado)
`Q`	25%	Etiquetas que pueden ensuciarse
`H`	30%	QRs con logo encima o en entornos hostiles

Notas

EAN-13: requiere exactamente 13 dígitos; EAN-8 requiere 8; UPC-A requiere 12. Un valor con longitud incorrecta causa error.
ITF: requiere un número par de dígitos.
includeText no tiene efecto en formatos 2D (QR, PDF417, DataMatrix, Aztec): estos no incluyen texto legible por diseño.
height solo aplica a códigos 1D; en 2D se ignora.
Para alta resolución de impresión usa scale: 6 o superior. scale: 3 es suficiente para visualización en pantalla.
Los colores fgColor y bgColor deben ser hex de 6 dígitos sin el símbolo # (ej: "1976d2").
El nodo nunca modifica el payload de entrada; la imagen resultante convive con los datos originales si se usa un Merge después.

Nodos relacionados

htmlTemplate — embebe data.barcode en una plantilla HTML con <img src="{{barcode}}">
generatepdf — convierte el HTML con el código de barras en PDF imprimible
sendMail — adjunta o embebe el código en el cuerpo del email
base64tofile — convierte data.base64 en un archivo PNG descargable