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 | PHP 8.2 como mínimo, extensión PHP GD
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-09-29 |
| Note / Nota | Compatible con Dolibarr v25 y PHP 8.5 |
UltimateQRcode añade códigos QR a las fichas de Dolibarr (terceros, contactos, productos, documentos comerciales, proyectos…). Cada código QR codifica los campos que usted elige, puede llevar un logotipo en el centro y se imprime en una etiqueta de 120 × 57 mm. Las fichas de personas ofrecen además un código QR vCard que un smartphone escanea para añadir el contacto a su agenda.
Requisitos
| Elemento | Versión |
|---|---|
| Dolibarr | 25.0.0 o superior |
| PHP | 8.2 como mínimo (probado hasta PHP 8.5) |
| Extensión PHP | GD (generación de las imágenes PNG) |
| Módulos Dolibarr | Ningún módulo obligatorio. Las pestañas solo aparecen en los objetos cuyo módulo está activado (Facturas, Stocks, Proyectos…) |
Las bibliotecas chillerlan/php-qrcode y michelf/php-markdown se entregan con el módulo: no hace falta ninguna instalación con Composer.
Instalación
- Descargar el archivo
module_ultimateqrcode-25.0.x.zipdesde el DoliStore - En Dolibarr: Inicio → Configuración → Módulos/Aplicaciones, pestaña Desplegar/instalar un módulo externo, enviar el archivo. En su defecto, descomprimir el archivo en
htdocs/custom/: debe obtenerhtdocs/custom/ultimateqrcode/ - Buscar el módulo UltimateQRcode en la lista y activarlo
- Asignar los permisos a los usuarios o grupos (véase Permisos)
- Actualización desde una versión anterior: sustituir la carpeta
ultimateqrcodey después desactivar y reactivar el módulo para que Dolibarr recargue las pestañas y los permisos.
Configuración del módulo
Acceda a la configuración desde Inicio → Configuración → Módulos/Aplicaciones → UltimateQRcode (icono de engranaje).
La página de configuración tiene cuatro pestañas: Códigos QR, QR con logotipo, Guía del usuario y Acerca de.
Pestaña «Códigos QR» (generador libre)
Esta pestaña es un generador de códigos QR a demanda: el código QR creado aquí no está vinculado a ninguna ficha de Dolibarr y puede codificar cualquier contenido.
| Campo | Descripción |
|---|---|
| Introduzca aquí los datos a codificar en el código QR | El contenido a codificar: URL, dirección de correo electrónico, número de teléfono, texto libre… |
| Calidad | Nivel de corrección de errores: • Baja (L, ≈ 7 %): código QR más compacto • Media (M, ≈ 15 %): uso habitual • Intermedia (Q, ≈ 25 %): buena resistencia • Alta (H, ≈ 30 %): muy resistente a la suciedad y a los arañazos |
| Tamaño | De 1 a 10 píxeles por módulo del código QR |
| Botón GENERAR | Genera y muestra el código QR |
| Botón IMPRIMIR ETIQUETA | Abre el código QR en una etiqueta de 120 × 57 mm (véase Impresión de etiquetas) |
Pestaña «QR con logotipo»
Esta pestaña crea un código QR libre con un logotipo en el centro. Los códigos QR generados se conservan en la carpeta temporal del módulo y pueden volver a mostrarse, imprimirse o eliminarse.
| Elemento | Descripción |
|---|---|
| Introduzca aquí los datos a codificar en el código QR | URL o contenido a codificar |
| Tamaño | De 2 a 10, controla la resolución de la imagen |
| Tabla de logotipos | Logotipos disponibles en documents/mycompany/logos/, con tamaño, fecha, vista previa (lupa), cambio de nombre y eliminación. El botón de opción elige el logotipo a integrar
|
| Botón GENERAR | Crea el código QR con el logotipo elegido |
| ENVIAR ARCHIVO | Añade un nuevo logotipo (se recomienda PNG) |
| Seleccione un código QR para mostrar + MOSTRAR | Vuelve a mostrar un código QR ya generado |
| Icono papelera | Elimina el código QR seleccionado, previa confirmación |
| Botón IMPRIMIR ETIQUETA | Imprime el código QR mostrado en una etiqueta de 120 × 57 mm |
- Nota: la corrección de errores se fuerza a calidad Alta, porque el logotipo oculta una parte de la matriz.
Pestaña «Guía del usuario»
La guía del usuario completa se puede consultar directamente en Dolibarr, en el idioma del usuario (francés, inglés, alemán, español o italiano).
Pestaña «Acerca de»
Muestra la versión del módulo, el autor, la licencia y los enlaces a la documentación.
Uso en las fichas
El módulo añade una pestaña Código QR a las fichas de los 16 objetos siguientes:
| Objeto | Pestaña añadida | Código QR vCard |
|---|---|---|
| Tercero | Código QR | Sí |
| Contacto / Dirección | Código QR | Sí |
| Usuario | Código QR | Sí |
| Miembro | Código QR | Sí |
| Grupo de usuarios | 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 a proveedor | Código QR | |
| Factura a cliente | Código QR | |
| Factura de proveedor | Código QR | |
| Contrato | Código QR | |
| Intervención | Código QR | |
| Proyecto | Código QR |
Estructura común de la pestaña Código QR
Cada pestaña Código QR se organiza en cinco zonas.
Zona 1 — Barra de ajustes
En la parte superior de la pestaña, una barra de ajustes permite elegir:
| Ajuste | Descripción |
|---|---|
| Tamaño | Resolución del código QR, de 2 a 10 píxeles por módulo |
| Calidad | Corrección de errores: Baja (L), Media (M), Intermedia (Q) o Alta (H) |
| Logotipo | Logotipo integrado en el centro del código QR, elegido en la tabla de la zona 2 |
- Nota: en cuanto se selecciona un logotipo, la calidad se fuerza a Alta (H) y aparece la mención (Forzado a Alta con logotipo) junto al selector.
Estos ajustes se guardan por tipo de objeto (facturas, presupuestos, pedidos…) y se aplican a todos los códigos QR de la pestaña.
Zona 2 — Tabla de selección del logotipo
La tabla lista los logotipos de la carpeta documents/mycompany/logos/:
| Columna | Descripción |
|---|---|
| Botón de opción | Selecciona el logotipo, o «Sin logotipo» |
| Logotipo | Nombre del archivo |
| Tamaño | Tamaño del archivo en bytes |
| Fecha | Fecha de envío del archivo |
| Vista previa | Lupa para mostrar el logotipo |
| Acciones | Cambiar el nombre y eliminar |
Un formulario al final de la página permite enviar nuevos logotipos.
- Seguridad: si el logotipo es demasiado grande para la capacidad del código QR, el módulo genera el código QR sin logotipo en lugar de provocar un error, y registra el incidente en el registro de Dolibarr.
Zona 3 — Código QR de los datos
Usted elige los campos a codificar marcándolos:
- la casilla incluye o excluye el campo;
- la columna central muestra la etiqueta y el valor actual del campo (atenuado si no está marcado);
- el código QR generado aparece junto a la tabla, con o sin logotipo, acompañado del botón IMPRIMIR ETIQUETA.
Campos disponibles según el objeto:
| Objeto | Campos disponibles |
|---|---|
| Tercero | Empresa, Dirección, Código postal, Población, País, Teléfono, Email, URL |
| Contacto | Nombre, Apellidos, Teléfono, Móvil, Email, Dirección, Código postal, Población, País, URL |
| Usuario | Login, Nombre, Apellidos, Teléfono, Móvil, Email, Dirección, Código postal, Población, País, URL |
| Miembro | Nombre, Apellidos, Teléfono, Teléfono personal, Email, Dirección, Código postal, Población, País, URL |
| Grupo de usuarios | Nombre del grupo, Descripción, URL |
| Producto / Servicio | Ref., Etiqueta, Descripción, Precio sin IVA, Precio con IVA, Código de barras, Peso, Volumen, URL |
| Lote / Número de serie | Lote/Serie, Fecha de caducidad, Fecha límite de venta, URL |
| Almacén | Etiqueta, Nombre corto de la ubicación, Descripción, Dirección, Código postal, Población, País, URL |
| Presupuesto | Ref., Ref. cliente, Empresa, Email, Teléfono, Fecha, Fecha de fin de validez, Total sin IVA, Total con IVA, Nota pública, URL |
| Pedido de cliente | Ref., Ref. cliente, Empresa, Email, Teléfono, Fecha, Total sin IVA, Total con IVA, Nota pública, URL |
| Pedido a proveedor | Ref., Ref. proveedor, Empresa, Email, Teléfono, Fecha, Total sin IVA, Total con IVA, Nota pública, URL |
| Factura a cliente | Ref., Ref. cliente, Empresa, Email, Teléfono, Fecha de facturación, Fecha límite de pago, Total sin IVA, Total con IVA, Nota pública, URL |
| Factura de proveedor | Ref., Ref. proveedor, Empresa, Email, Teléfono, Fecha de facturación, Fecha límite de pago, Total sin IVA, Total con IVA, Nota pública, URL |
| Contrato | Ref., Ref. cliente, Ref. proveedor, Empresa, Email, Teléfono, Fecha del contrato, Nota pública, URL |
| Intervención | Ref., Empresa, Email, Teléfono, Fecha, Descripción, URL |
| Proyecto | Ref., Etiqueta del proyecto, Empresa, Email, Teléfono, Fecha de inicio, Fecha de fin, Nota pública, URL |
- Nota: los campos adicionales rellenados en la ficha se añaden automáticamente a la lista, en la forma Campo adicional : etiqueta. Los creados por otros módulos se ignoran.
Zona 4 — Código QR de la URL de la ficha
A la derecha (o debajo de la tabla según el ancho de la pantalla), la pestaña muestra:
- la etiqueta URL de la ficha seguida de un enlace a la ficha;
- un segundo código QR que codifica la URL directa de la ficha, también imprimible en etiqueta;
- al final de la página, los botones GRABAR y ANULAR.
Zona 5 — Código QR vCard (Tercero, Contacto, Usuario, Miembro)
Las fichas Tercero, Contacto, Usuario y Miembro muestran además un código QR vCard. Escaneado con un smartphone, propone añadir el contacto directamente a la agenda. El contenido vCard 3.0 codificado se muestra en claro junto al código QR.
Vista previa dinámica
Los códigos QR se actualizan en tiempo real cuando cambia:
- el tamaño;
- la calidad;
- el logotipo;
- los campos marcados.
No es necesario recargar la página. La vista previa usa una petición AJAX enviada 300 ms después del último cambio. Funciona en las 16 pestañas Código QR.
Selección automática de los campos por defecto
En la primera visualización, mientras no se haya guardado ninguna configuración, el módulo marca los campos rellenados en la ficha. Así el código QR es pertinente desde la primera apertura.
Guardar la configuración
Marque o desmarque los campos y haga clic en GRABAR. La selección se aplica a todos los objetos del mismo tipo (una configuración por tipo de objeto).
Pestaña Código QR — Ejemplos por objeto
Factura a cliente
Ejemplo en una factura a cliente: Ref., Empresa, Email, Teléfono, Fecha de facturación, Fecha límite de pago, Total sin IVA, Total con IVA y URL están marcados. El logotipo expert_dolibarr.png está integrado en el centro de ambos códigos QR y la calidad está forzada a Alta (H).
Producto
En un producto, el código QR puede codificar la referencia, la etiqueta, los precios, el código de barras, el peso y el volumen: práctico para el etiquetado en tienda o en almacén.
Almacén
Útil para identificar físicamente las ubicaciones de almacenamiento. El campo Nombre corto de la ubicación precisa la zona (pasillo, estantería…).
Usuario
El código QR del usuario codifica los datos de contacto profesionales (login, nombre, apellidos, teléfonos, email, dirección…), y el código QR vCard los añade a una agenda. Práctico para acreditaciones o tarjetas de visita internas.
- Nota: la pestaña Código QR de un usuario solo es visible para el propio usuario o para quienes tienen permiso para leer las fichas de usuarios.
Imagen de código QR reutilizable (QR con logotipo)
Para obtener una imagen de código QR con logotipo reutilizable en otro lugar (sitio web, folleto, firma de correo), use la pestaña de configuración QR con logotipo:
- introduzca la URL de la ficha o cualquier otro contenido en la zona de entrada;
- elija el tamaño y el logotipo y haga clic en GENERAR;
- vuelva a mostrar el código QR en cualquier momento con Seleccione un código QR para mostrar, imprímalo o elimínelo.
- Nota: la antigua pestaña «QR-Url» de los terceros, que el módulo ya no declaraba, se ha retirado. El código QR de la URL de la ficha sigue disponible en la zona 4 de cada pestaña Código QR.
Impresión de etiquetas
El botón IMPRIMIR ETIQUETA, o un clic en un código QR, abre una ventana de impresión en formato 120 × 57 mm, adaptado a las impresoras de etiquetas habituales.
La etiqueta de una ficha contiene:
- a la izquierda: el código QR de los datos;
- en el centro: la información clave de la ficha (referencia, tercero, total…, según el objeto);
- a la derecha: el código QR de la URL de la ficha.
Los generadores de las pestañas Códigos QR y QR con logotipo imprimen del mismo modo el código QR que acaban de crear.
La ventana abre 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 × 57 mm y suprima los márgenes en las opciones de impresión del navegador.
Permisos
El módulo define dos permisos, que se asignan por usuario o por grupo en Usuarios y grupos:
| Permiso | Efecto |
|---|---|
| Leer los códigos QR | Muestra las pestañas Código QR y los códigos QR generados |
| Crear / Modificar los códigos QR | Permite marcar o desmarcar campos y guardar la configuración |
- Nota: sin el permiso de lectura, las pestañas Código QR no son visibles. Sin el permiso de modificación, el usuario ve los códigos QR pero no puede cambiar la selección de campos. El envío, el cambio de nombre y la eliminación de logotipos están reservados a los administradores.
Novedades y compatibilidad v25
La versión 25.0.0 adapta UltimateQRcode a Dolibarr 25.
| Cambio | Detalle |
|---|---|
| Versiones mínimas | Dolibarr 25.0.0 y PHP 8.2 |
| PHP 8.4 y 8.5 | El módulo no emite ninguna advertencia de obsolescencia: propiedades del descriptor alineadas con el núcleo, página «Acerca de» sin advertencia |
| Pestañas de pago | Se han eliminado las pestañas «Código QR» de los pagos de clientes y proveedores, que apuntaban a páginas inexistentes (error 404) |
| Pestaña QR-Url | Se ha suprimido la página huérfana de la antigua pestaña QR-Url de los terceros; la documentación remite a la pestaña QR con logotipo |
| Permisos traducidos | Los dos permisos se muestran ahora en el idioma del usuario («Leer los códigos QR», «Crear / Modificar los códigos QR») |
| Visualización vCard | El contenido vCard y las direcciones de varias líneas se muestran correctamente, sin «\n» visible ni desbordamiento de la página |
| Campos adicionales | La etiqueta «Campo adicional» está traducida (antes aparecía «ExtraField») |
| Etiquetas ES | «Código QR vCard» corregido en español |
| Guía del usuario | Nueva pestaña de configuración con la guía completa en los 5 idiomas |
| Integración continua | Cada archivo PHP del módulo se comprueba con php -l en PHP 8.4 y 8.5
|
Historial v24
Nuevas funcionalidades v24
| Funcionalidad | Descripción |
|---|---|
| Ajustes por ficha | Tamaño, calidad y logotipo configurables directamente en cada pestaña Código QR |
| Logotipo integrado | Logotipo PNG en el centro de cada código QR, en todas las páginas |
| Vista previa dinámica | Actualización de los códigos QR en tiempo real al cambiar tamaño, calidad, logotipo o campos marcados |
| Código QR vCard | Para terceros, contactos, usuarios y miembros |
| Gestión de logotipos | Envío, vista previa, cambio de nombre y eliminación de logotipos desde cada ficha |
Compatibilidad con Dolibarr v24
| Corrección | Detalle |
|---|---|
| Picto del módulo | Extensión .png añadida a la propiedad $this->picto del descriptor
|
| Moneda | getDolCurrency() en lugar de $conf->currency (obsoleto)
|
| Constantes | dolibarr_set_const() en lugar de escribir directamente en $conf->global
|
Correcciones v24
| Error | Corrección |
|---|---|
| Pestaña de factura no encontrada | Mayúsculas y minúsculas de la clave de pestaña corregidas en el descriptor |
| Parámetro de configuración obsoleto | Eliminado «Tamaño de visualización de los códigos QR (en píxeles)», sustituido por el ajuste de tamaño de cada ficha |
| Logotipo demasiado grande | Paso automático a «sin logotipo» en lugar de un error |
Traducciones v24
Claves de traducción que faltaban añadidas en los 5 idiomas (FR, EN, DE, ES, IT): calidad, gestión del logotipo y todos los tipos de objeto.
Preguntas frecuentes
- El código QR está vacío o muestra «Sin datos»
- No hay ningún campo marcado, o los campos marcados están vacíos en la ficha. Marque al menos un campo rellenado y haga clic en GRABAR.
- La etiqueta no se imprime con el tamaño correcto
- Compruebe que el formato de papel de la impresora está configurado en 120 × 57 mm y suprima los márgenes en las opciones de impresión del navegador.
- Los campos adicionales no aparecen
- Solo se proponen los campos adicionales rellenados en la ficha. Se definen en la configuración del módulo correspondiente (por ejemplo Terceros → Atributos adicionales).
- El código QR con logotipo no se puede leer
- El logotipo ocupa demasiada superficie. Use un logotipo más pequeño, idealmente cuadrado. La calidad ya está forzada a Alta (H) en cuanto se selecciona un logotipo.
- El código QR aparece sin logotipo aunque he seleccionado uno
- El logotipo es demasiado grande para el contenido codificado: el módulo genera entonces el código QR sin logotipo. Pruebe con un logotipo más pequeño o marque menos campos.
- Los códigos QR no se actualizan al cambiar los ajustes
- La vista previa dinámica necesita JavaScript. Compruebe que no haya ningún bloqueador de scripts activo.
- La pestaña Código QR no aparece en algunas fichas
- Compruebe que el módulo está activado, que el módulo Dolibarr del objeto también lo está y que el usuario tiene el permiso Leer los códigos QR. Tras una actualización, desactive y vuelva a activar UltimateQRcode.
- ¿Dónde está la pestaña QR-Url de los terceros?
- Se ha retirado. El código QR de la URL de la ficha está en la pestaña Código QR (zona 4), y la pestaña de configuración QR con logotipo crea imágenes reutilizables.