Module Ultimateqrcode ES

Información

Module name	Ultimateqrcode
Editor / Editeur	Atoo.Net - https://www.atoo-net.com
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-07-25
Note / Nota	Compatible con Dolibarr v24

Instalación

Descargue el módulo y colóquelo en el directorio htdocs/custom/ultimateqrcode/
En Dolibarr: Inicio → Configuración → Módulos/Aplicaciones
Busque el módulo UltimateQRcode en la sección Atoo-Net y actívelo
Los permisos deben configurarse por grupo de usuarios (ver Derechos y permisos)

Configuración del módulo

Se accede a la configuración desde Inicio → Configuración → Módulos/Aplicaciones → UltimateQRcode (icono de llave inglesa) o directamente desde el menú de administración.

La página de configuración consta de tres pestañas.

Pestaña «Códigos QR» (generador libre)

Esta pestaña ofrece un generador de código QR bajo demanda:

Campo	Descripción
Data	El contenido a codificar: URL, dirección de correo electrónico, texto libre, vCard, etc.
ECC	Nivel de corrección de errores: • L (≈7% — el más pequeño): tamaño mínimo • M (≈15%): uso habitual • Q (≈25%): buena resistencia • H (≈30% — el mejor): muy resistente (recomendado con logotipo)
Size	Tamaño de punto (de 1 a 10 píxeles por módulo del código QR)
Botón GENERATE	Genera y muestra el código QR de inmediato

Haga clic en Like this dentro del texto de ayuda para ver un ejemplo de generación.

Pestaña «QR con logotipo»

Esta pestaña permite crear un código QR con un logotipo insertado en el centro:

Campo	Descripción
Data	URL o contenido a codificar (por defecto: https://www.atoo-net.com/)
Tamaño	De 1 a 10 — controla la resolución de la imagen generada
Seleccionar archivo	Logotipo PNG que se incrustará en el centro del código QR
Botón GENERATE	Genera el código QR con el logotipo y lo guarda
Seleccionar código QR a mostrar	Selección entre los códigos QR ya generados para visualizarlos
Botón MOSTRAR	Muestra el código QR seleccionado
Icono Papelera	Elimina el archivo QR seleccionado (con confirmación)

La sección Logotipos subidos enumera todos los archivos PNG almacenados con su tamaño y fecha de subida. Cada línea incluye un botón de eliminación.

Nota: El nivel ECC recomendado para un código QR con logotipo es H (30%), ya que el logotipo cubre una parte del código; la corrección de errores compensa esta pérdida.

Pestaña «Acerca de»

Muestra información sobre la versión del módulo, el autor y el enlace a la documentación.

Uso en las fichas

El módulo añade una pestaña Código QR en las fichas de los siguientes objetos:

Objeto	Pestaña(s) añadida(s)
Cliente/Proveedor	Código QR + QR-Url (pestañas separadas)
Contacto	Código QR
Producto / Servicio	Código QR
Lote / Número de serie	Código QR
Almacén	Código QR
Presupuesto	Código QR
Pedido de cliente	Código QR
Pedido de proveedor	Código QR
Factura de cliente	Código QR
Factura de proveedor	Código QR
Contrato	Código QR
Intervención	Código QR
Proyecto	Código QR
Miembro (asociación)	Código QR
Grupo de usuarios	Código QR
Usuario	Código QR

Estructura común de la pestaña Código QR

[Novedad v24] Cada pestaña de código QR ahora está organizada en cinco zonas:

Zona 1 — Barra de ajustes

Panel de ajustes: tamaño, calidad ECC y selección de logotipo

En la parte superior de cada pestaña de código QR, una barra de ajustes permite configurar:

Ajuste	Descripción
Tamaño	Resolución del código QR (de 2 a 10 píxeles por módulo). Cuanto mayor sea el valor, más grande y legible será el código QR.
Calidad (ECC)	Nivel de corrección de errores: Bajo (L ≈ 7%), Medio (M ≈ 15%), Cuartil (Q ≈ 25%), Alto (H ≈ 30%).
Logotipo	Logotipo PNG que se incrustará en el centro del código QR, seleccionable entre los logotipos subidos.

Nota: Cuando se selecciona un logotipo, la calidad ECC se fuerza automáticamente a Alto (H) para garantizar la legibilidad a pesar del logotipo. Se muestra el aviso (Forzado a Alto con logotipo) junto al selector.

Estos ajustes se guardan de forma independiente por tipo de objeto (factura, presupuesto, pedido, etc.) y se aplican a los dos códigos QR mostrados (datos y URL).

Zona 2 — Tabla de selección de logotipo

La tabla enumera los logotipos disponibles en el directorio documents/mycompany/logos/:

Columna	Descripción
Radio	Botón de opción para seleccionar el logotipo (o «Sin logotipo»)
Logotipo	Nombre del archivo PNG con icono de vista previa
Tamaño	Tamaño del archivo en bytes
Fecha	Fecha de la última subida
Vista previa	Icono de lupa para previsualizar el logotipo
Acciones	Iconos para renombrar y eliminar

Un formulario de subida al final de la página permite añadir nuevos logotipos PNG.

Seguridad: Si el logotipo es demasiado grande en relación con la capacidad del código QR, el módulo cambia automáticamente al modo sin logotipo para evitar un error. Se registra un mensaje en los registros de Dolibarr.

Zona 3 — Código QR de datos configurables

El usuario selecciona mediante casillas de verificación los campos que se incluirán en el código QR:

La columna izquierda contiene la casilla de verificación
La columna central muestra la etiqueta del campo y su valor actual (en gris si no está marcado)
La columna derecha muestra el código QR generado (con o sin logotipo, según la selección)

Los campos disponibles dependen del objeto:

Objeto	Campos disponibles
Cliente/Proveedor	Empresa, Dirección, Código postal, Ciudad, País, Teléfono, Correo electrónico, URL + campos adicionales
Producto	Ref., Descripción, Detalle, Precio sin impuestos, Precio con impuestos, Código de barras, Peso, Volumen, URL + campos adicionales
Almacén	Etiqueta, Nombre corto de la ubicación, Descripción, Dirección, Código postal, Ciudad, País, URL + campos adicionales
Usuario	Login, Nombre, Apellidos, Teléfono, Móvil, Correo electrónico, Dirección, Código postal, Ciudad, País, URL + campos adicionales
Contacto	Tratamiento, Nombre, Apellidos, Empresa, Cargo, Teléfono, Móvil, Correo electrónico, Dirección, etc.
Factura	Ref., Ref. cliente, Empresa, Correo electrónico, Teléfono, Fecha de factura, Vencimiento, Total sin impuestos, Total con impuestos, Nota pública, URL
(otros)	Campos específicos del objeto

Nota: Los campos adicionales (atributos complementarios) definidos en Dolibarr se añaden automáticamente a la lista de campos disponibles.

El código QR mostrado es clicable: un clic abre la ventana de impresión de etiquetas.

Zona 4 — Código QR de la URL de la ficha

La zona inferior muestra:

La etiqueta URL de la ficha [Objeto]
El enlace clicable a la ficha de Dolibarr
Un segundo código QR que codifica la URL directa hacia la ficha (también clicable para la impresión de etiquetas)
Los botones GUARDAR y CANCELAR

Zona 5 — Código QR vCard (Contacto, Usuario, Cliente/Proveedor, Miembro)

Las fichas de Contacto, Usuario, Cliente/Proveedor (empresa) y Miembro disponen de un código QR vCard adicional al final de la página.

Al escanear este código QR con un smartphone se permite añadir directamente el contacto a la agenda telefónica. El contenido vCard codificado se muestra en texto plano debajo del código QR.

Vista previa en tiempo real

[Novedad v24] Los códigos QR se actualizan en tiempo real cuando el usuario modifica:

el tamaño del código QR
el nivel de calidad ECC
el logotipo seleccionado
los campos marcados (QR de datos)

No es necesario recargar la página. La vista previa utiliza una solicitud AJAX con un retardo de 300 ms para evitar llamadas excesivas. Esta función está disponible en las 16 páginas de código QR del módulo.

Selección automática de campos por defecto

En la primera visualización (sin configuración guardada), el módulo selecciona automáticamente los campos cuyo valor no está vacío. Esto garantiza un código QR pertinente desde la primera apertura.

Guardado de la configuración

Marque o desmarque los campos deseados y haga clic en GUARDAR. La selección se guarda y se aplica a todos los objetos del mismo tipo (una configuración global por tipo de objeto).

Pestaña Código QR — Ejemplos por objeto

Factura de cliente

[Novedad v24]

Ejemplo de configuración para una factura de cliente: Ref., Empresa, Correo electrónico, Teléfono, Fecha de factura, Vencimiento, Total sin impuestos y Total con impuestos marcados. El logotipo expert_dolibarr.png está seleccionado e incrustado en el centro del código QR. La calidad ECC se fuerza automáticamente a Alto (H).

Producto

Ejemplo de configuración para un producto: Ref. y Descripción marcados, junto con los campos adicionales Ecotax y ControlHistoryLink. El código QR codifica estos cuatro valores concatenados.

Almacén

Útil para el etiquetado físico de las ubicaciones de almacenamiento. El campo Nombre corto de la ubicación permite precisar la zona de almacenamiento.

Usuario

El código QR del usuario codifica información de contacto (login, nombre, apellidos, teléfono, móvil, correo electrónico, país...). Práctico para tarjetas de identificación o tarjetas de visita internas.

Nota: La pestaña de código QR del usuario solo es visible para el propio usuario o para los usuarios con permiso de lectura sobre las fichas de usuario.

Pestaña QR-Url (solo Clientes/Proveedores)

Las fichas de Cliente/Proveedor disponen de una segunda pestaña QR llamada QR-Url, especializada en la generación de códigos QR con logotipo incrustado que codifican la URL de la ficha.

Funcionalidades:

Elemento	Función
Tamaño (1-10)	Resolución del código QR generado
Seleccionar archivo + SUBIR LOGOTIPO	Subir un logotipo PNG para incrustarlo en el centro
Seleccionar código QR a mostrar	Selección entre los códigos QR ya generados para este cliente/proveedor
Botón MOSTRAR	Muestra el código QR seleccionado
Sección Logotipos subidos	Lista de logotipos disponibles con opciones de descarga y eliminación

El código QR mostrado codifica la URL de la ficha del cliente/proveedor, con el logotipo elegido en el centro de la imagen.

Impresión de etiquetas

Al hacer clic en un código QR de cualquier pestaña, se abre una ventana emergente de impresión, optimizada para etiquetas de formato 120 × 57 mm (compatible con las impresoras de etiquetas habituales).

La etiqueta incluye:

A la izquierda: el código QR de datos configurables
En el centro: la información textual principal (referencia, descripción, nombre, etc. según el objeto)
A la derecha: el código QR de la URL de la ficha

La ventana lanza automáticamente el cuadro de diálogo de impresión del navegador.

Nota: Para una impresión óptima en etiquetas adhesivas, configure la impresora en formato 120×57mm y desactive los márgenes en las opciones de impresión del navegador.

Derechos y permisos

El módulo define dos niveles de permisos, asignables por grupo de usuarios desde Configuración → Usuarios y grupos:

Permiso	Descripción	Efecto
Read qrcode outcomes	Leer los códigos QR	Permite ver las pestañas de código QR y los códigos QR generados
Create/Modify qrcode outcomes	Crear/Modificar	Permite marcar o desmarcar los campos y guardar la configuración

Nota: Sin el permiso Read, las pestañas de código QR no son visibles. Sin el permiso Write, el usuario puede ver los códigos QR pero no modificar la selección de campos.

Novedades y compatibilidad con v24

[Novedad v24] La versión 24 del módulo UltimateQRcode aporta las siguientes mejoras:

Nuevas funcionalidades

Funcionalidad	Descripción
Ajustes por página	Tamaño, calidad ECC y logotipo configurables directamente en cada página de código QR de la ficha
Logotipo incrustado	Posibilidad de incrustar un logotipo PNG en el centro de cada código QR, en todas las páginas
Vista previa en tiempo real	Actualización en tiempo real de los códigos QR al cambiar el tamaño, la ECC, el logotipo o los campos marcados (AJAX, sin recarga)
Código QR vCard	Código QR vCard para contactos, usuarios, clientes/proveedores y miembros, para añadirlos directamente a la agenda telefónica
Gestión de logotipos	Subida, vista previa, cambio de nombre y eliminación de logotipos directamente desde la interfaz de cada ficha

Compatibilidad con Dolibarr v24

Corrección	Detalle
Icono del módulo	Adición de la extensión `.png` en la propiedad `$this->picto` del descriptor del módulo, conforme a la advertencia de Dolibarr v23+.
Moneda	Sustitución de `$conf->currency` (obsoleto) por `getDolCurrency()`.
Constantes	Sustitución de la asignación directa `$conf->global->XXX = value` (obsoleta) por `dolibarr_set_const()`.

Correcciones de errores

Error	Corrección
Pestaña de factura no encontrada	Corrección de la distinción entre mayúsculas y minúsculas de la clave de pestaña en el descriptor del módulo.
Parámetro de administración obsoleto	Eliminación del parámetro «Tamaño de visualización de los códigos QR (en píxeles)», que quedó redundante con el ajuste de tamaño por página.
Desbordamiento del logotipo	Adición de un mecanismo try/catch para gestionar el desbordamiento de capacidad cuando el logotipo es demasiado grande: cambio automático al modo sin logotipo.

Traducciones

Adición de las claves de traducción faltantes en los 5 archivos de idioma (FR, EN, DE, ES, IT) para las nuevas funcionalidades: selección de calidad ECC, gestión de logotipos y todos los tipos de objeto.

FAQ

El código QR está vacío o muestra «Sin datos»: No hay ningún campo marcado, o todos los campos marcados tienen un valor vacío en la ficha. Marque al menos un campo con un valor y haga clic en GUARDAR.

La etiqueta no se imprime en el tamaño correcto: Compruebe que el formato de papel de la impresora esté correctamente configurado en 120×57mm. Desactive los márgenes en las opciones de impresión del navegador.

Los campos adicionales no aparecen: Los atributos complementarios deben estar definidos en Configuración → Atributos complementarios para el objeto en cuestión.

El código QR con logotipo no es legible: El logotipo ocupa demasiado espacio. Utilice un logotipo más pequeño (idealmente cuadrado, de menos de 100×100 píxeles) o aumente el nivel ECC a H para mejorar la corrección de errores. Con el módulo v24, la calidad ECC se fuerza automáticamente a H cuando se selecciona un logotipo.

El código QR se muestra sin logotipo aunque he seleccionado uno: El logotipo probablemente es demasiado grande en relación con el contenido codificado. El módulo cambia automáticamente al modo sin logotipo para evitar un error. Pruebe con un logotipo más pequeño o reduzca el número de campos marcados.

Los códigos QR no se actualizan al cambiar los ajustes: La vista previa en tiempo real requiere que JavaScript esté activado en el navegador. Compruebe que ningún bloqueador de scripts esté activo. Los códigos QR se actualizan automáticamente 300 ms después de cada cambio.

La pestaña de código QR no aparece en algunas fichas: Compruebe que el módulo esté activado y que el usuario disponga del permiso Read qrcode outcomes.

Véase también