Calidad de los datos

Detección de duplicados

dolixdoublons · versión 1.1.8

Usted encuentra las fichas introducidas dos veces y las fusiona: terceros, contactos y miembros.

Precio
79 € sin IVA
Dolibarr
19.0 mínimo
Versión
1.1.8
Licencia
GPL v3+
Idiomas
Francés, inglés, español

79 € sin IVA.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 79 € sin IVA

Pruébelo sin instalar nada: la demo en línea (usuario demo, contraseña demo; datos ficticios, que se restablecen cada noche; la demo está en francés).

Análisis de contactos en Dolibarr 24.0.0, objeto «Contacts / adresses» (Contactos/Direcciones): «4 groupe(s) de doublons trouvé(s), soit 8 fiche(s) concernée(s) sur 14 analysée(s).» (4 grupos de duplicados encontrados, 8 fichas afectadas de 14 analizadas). Cada grupo empareja al mismo contacto introducido en dos terceros distintos —Julien Weber existe a la vez en «Cabinet Vaillant» y en «Association Les Trois Ponts»— y ofrece el botón «Fusionner dans la fiche conservée» (fusionar en la ficha conservada).
Análisis de contactos en Dolibarr 24.0.0, objeto «Contacts / adresses» (Contactos/Direcciones): «4 groupe(s) de doublons trouvé(s), soit 8 fiche(s) concernée(s) sur 14 analysée(s).» (4 grupos de duplicados encontrados, 8 fichas afectadas de 14 analizadas). Cada grupo empareja al mismo contacto introducido en dos terceros distintos —Julien Weber existe a la vez en «Cabinet Vaillant» y en «Association Les Trois Ponts»— y ofrece el botón «Fusionner dans la fiche conservée» (fusionar en la ficha conservada). Captura de la interfaz en francés.
01

Lo que hace el módulo

  • Cuatro criterios para los terceros: mismo email, mismo nombre, mismo teléfono, mismo SIRET / SIREN / número de IVA. Tres para los contactos y los miembros: email, nombre y apellido, teléfono.
  • Normalización antes de la comparación: mayúsculas/minúsculas, espacios, acentos y puntuación ignorados; formas jurídicas eliminadas del nombre; teléfonos reducidos a sus nueve últimas cifras, sea cual sea el formato; nombre y apellido en cualquier orden.
  • El análisis es de solo lectura. Los campos vacíos nunca forman un grupo.
  • Fusión de los tres objetos analizados. Los terceros se fusionan con el método nativo de Dolibarr; los contactos y los miembros, con una fusión escrita en el módulo, porque el núcleo de Dolibarr no fusiona contactos, y los miembros solo desde su versión 23.
  • Fusión de un tercero: presupuestos, pedidos, facturas, contactos, categorías y documentos adjuntos se trasladan a la ficha conservada, cuyos campos vacíos se completan; después se elimina el duplicado.
  • Fusión de un contacto o de un miembro: funciones en presupuestos, pedidos, facturas y proyectos, vínculos con terceros, categorías, eventos de agenda, notificaciones, destinatarios de emailing, campos adicionales, afiliaciones y asociaciones, y la cuenta de usuario vinculada si la hay, se trasladan a la ficha conservada. Sus campos vacíos se completan con los del duplicado y las notas se ponen una tras otra. Todo en una transacción: si un solo paso falla, no se aplica nada.
  • Dos protecciones: número máximo de fichas analizadas (20 000 por defecto) y tamaño máximo de un grupo (10 por defecto). Un valor compartido por demasiadas fichas se señala y se descarta: es una centralita o una dirección genérica, no un duplicado.
  • Multiempresa respetada, usuarios externos limitados a su propio tercero, historial de fusiones consultable, incluido el tipo de objeto fusionado.
02

Para quién es

La misma empresa existe dos veces en su base de datos, con dos grafías, y usted ya no sabe cuál está al día.

Al cabo de unos años, la misma empresa acaba introducida dos veces. «Cabinet Vaillant» y «SARL Cabinet Vaillant», el mismo email escrito con una mayúscula, el mismo teléfono escrito con espacios. Los presupuestos están en una ficha, las facturas en la otra. La cifra de negocio del cliente es falsa, y ya nadie sabe cuál de las dos fichas está al día.

Ordenar por nombre no las pone una al lado de la otra: la forma jurídica, un acento o un espacio bastan para separarlas en la lista.

Para quién es: Bases de datos de varios años, ficheros importados desde una hoja de cálculo, organizaciones en las que varias personas crean fichas sin coordinarse.

03

Lo que el módulo no hace

Este apartado figura en las 21 fichas de módulos, sin excepción.

  • El módulo detecta, no corrige por sí solo: usted elige la ficha que conservar, fusión por fusión.
  • La comparación es exacta tras la normalización. Dos grafías realmente distintas —una errata en un nombre, una letra de más en un email— no se emparejan.
  • Ninguna detección en productos, proyectos, facturas o documentos.
  • Una fusión elimina definitivamente la ficha fusionada. No hay botón para dar marcha atrás.
  • La fusión de un contacto o de un miembro escribe directamente en la base de datos: los triggers de Dolibarr no se ejecutan y no se crea ningún evento en la agenda. La fusión de un tercero, en cambio, pasa por el método del núcleo.
  • Si la ficha conservada ya tiene el mismo vínculo que el duplicado —misma categoría, mismo vínculo con un tercero, afiliación de la misma fecha, asociación del mismo tipo y de la misma fecha—, la fila redundante del duplicado se descarta en lugar de trasladarse.
  • Los archivos adjuntos a la ficha de un contacto o de un miembro fusionado no se trasladan: se quedan en la carpeta de la ficha eliminada, en el servidor. Para los terceros, la fusión nativa de Dolibarr los mueve.
04

Cómo funciona

El módulo compara sus fichas según criterios que usted elige, y le presenta grupos de fichas realmente idénticas una vez eliminado el formato.

Lo que puede analizar: los terceros, los contactos y direcciones y —si el módulo Miembros está activado— los miembros.

Los criterios:

Criterio Objetos Lo que se ignora
Mismo email terceros, contactos, miembros mayúsculas/minúsculas y espacios
Mismo nombre terceros acentos, puntuación, formas jurídicas (SARL, SAS, EURL, GmbH, Ltd…)
Mismo nombre y apellido contactos, miembros acentos, puntuación, orden del nombre y del apellido
Mismo teléfono terceros, contactos, miembros formato: 01 23 45 67 89, +33 1 23 45 67 89, 0033… dan la misma clave
Mismo SIRET, SIREN o número de IVA terceros espacios, puntuación, mayúsculas/minúsculas

La comparación es una igualdad estricta tras la normalización, no una puntuación de parecido. Dos fichas solo se agrupan si uno de sus valores es realmente idéntico. Por tanto, no hay ninguna «probabilidad de duplicado» que interpretar, y los campos vacíos nunca forman un grupo.

El análisis es de solo lectura. No se modifica nada mientras usted no haya elegido una ficha que conservar, marcado una ficha que fusionar, hecho clic y confirmado.

El módulo fusiona los tres objetos que analiza. El camino no es el mismo para los terceros que para los otros dos.

Los terceros

Para un tercero, el módulo se apoya en la fusión nativa de Dolibarr. Los presupuestos, pedidos, facturas, contactos, categorías y documentos adjuntos del duplicado se trasladan a la ficha que usted conserva, cuyos campos vacíos se completan con los del duplicado. Después, el duplicado se elimina.

Los contactos y los miembros

Dolibarr no sabe fusionar contactos, y los miembros solo desde su versión 23: dos contactos duplicados se copian y se eliminan a mano, esperando no haber olvidado nada. El módulo escribe esta fusión por sí mismo.

Todo lo que apuntaba a la ficha eliminada se traslada a la ficha conservada:

Lo que pasa a la ficha conservada Contactos Miembros
Funciones en presupuestos, pedidos, facturas, proyectos y otros documentos sí —
Vínculos con terceros sí —
Categorías sí sí
Eventos de agenda y recordatorios sí —
Notificaciones y alertas sí —
Destinatarios de campañas de emailing sí —
Afiliaciones (cuotas) — sí
Asociaciones — sí
Campos adicionales sí sí
Cuenta de usuario vinculada sí sí

Los campos vacíos de la ficha conservada —dirección, teléfonos, cargo, fecha de nacimiento, redes sociales— se completan con los del duplicado, y las dos notas se ponen una tras otra. La ficha conservada mantiene su propio vínculo: fusionar dos contactos que pertenecen a dos terceros distintos no afecta a los terceros.

La operación se hace en una transacción. Si un solo paso falla, no se aplica nada: las dos fichas siguen en su sitio y un mensaje lo indica.

Cuando la ficha conservada ya tiene el mismo vínculo que el duplicado —la misma categoría, el mismo vínculo con un tercero, una afiliación de la misma fecha—, la fila redundante del duplicado se descarta en lugar de hacer fallar la operación.

En ambos casos

Es una operación irreversible. El módulo pide una confirmación explícita que lo dice, exige los permisos de Dolibarr de creación y de eliminación sobre el objeto afectado además de su propio permiso, y vuelve a comprobar las dos fichas en el servidor antes de escribir nada.

La pantalla cabe en una página, en TercerosDuplicados.

Arriba, el objeto que analizar y las casillas de los criterios. El botón Analizar muestra un aviso del tipo «3 grupo(s) de duplicados encontrado(s), es decir, 6 ficha(s) afectada(s) de 14 analizada(s).» y después una tabla por grupo.

Cada grupo indica como título los criterios que han emparejado esas fichas, y lista las fichas con su nombre en el que se puede hacer clic, su email, su teléfono, sus identificadores y su ciudad. Una columna «Conservar» y una columna «Fusionar» le permiten designar la ficha principal.

En la captura, el grupo 1 empareja «Cabinet Vaillant» y «SARL Cabinet Vaillant» con los cuatro criterios a la vez, aunque sus emails no se escriben con las mismas mayúsculas y sus teléfonos no están introducidos en el mismo formato.

La elección del objeto cambia la lista analizada y los criterios propuestos. En Contactos/Direcciones, cada grupo empareja a la misma persona introducida varias veces —a menudo en dos terceros distintos— y lleva el mismo botón de fusión.

La página de configuración reúne las dos protecciones, el ajuste del historial y la tabla de las fusiones ya realizadas.

El módulo encuentra los verdaderos duplicados y descarta los falsos: una centralita compartida por doce sucursales no es un duplicado, y se ignora.
El módulo encuentra los verdaderos duplicados y descarta los falsos: una centralita compartida por doce sucursales no es un duplicado, y se ignora. Captura de la interfaz en francés.
05

Ajustes

Ajuste Por defecto Efecto
Número máximo de fichas analizadas 20 000 Por encima, el análisis se bloquea para no saturar el servidor.
Tamaño máximo de un grupo 10 Un valor compartido por más fichas que este número se considera una centralita o una dirección genérica: se descarta, y se muestra el número de valores descartados.
Conservar un historial de fusiones activado Registra cada fusión: fecha, usuario, tipo de objeto, ficha conservada, ficha eliminada.

El segundo ajuste es el que evita el falso grupo gigante: sin él, una centralita 03 88 00 00 00 compartida por cuarenta fichas de un mismo ayuntamiento formaría un grupo de cuarenta «duplicados».

Los tres ajustes y el historial de fusiones: qué ficha se conservó, cuál se eliminó, quién lo hizo y cuándo.
Los tres ajustes y el historial de fusiones: qué ficha se conservó, cuál se eliminó, quién lo hizo y cuándo. Captura de la interfaz en francés.
06

Seguridad y salvaguardas

  • Análisis de solo lectura. No es posible ninguna escritura desde la pantalla de análisis sin pasar por el botón de fusión y su confirmación.
  • Un permiso propio, «Usar la detección de duplicados».
  • Además, los permisos estándar de Dolibarr: la fusión exige crear/modificar y eliminar sobre el objeto. Sin el permiso de eliminación, el análisis se puede consultar y los botones de fusión no se muestran; un mensaje explica por qué.
  • Nueva comprobación en el servidor: los identificadores enviados por el formulario nunca se aceptan sin más; las dos fichas se vuelven a leer dentro del ámbito autorizado.
  • Multiempresa: análisis y fusión limitados a las entidades autorizadas.
  • Usuarios externos: una cuenta vinculada a un tercero solo ve su propia ficha; los miembros nunca le son visibles.
  • Comerciales limitados a sus clientes: sin el permiso de Dolibarr para ver todos los terceros, un usuario solo ve y fusiona los terceros de los que es el comercial asignado y sus contactos (más los contactos no vinculados a ningún tercero), como en las listas de Dolibarr. Los contactos privados de otro usuario no se proponen.
  • Cada fusión se escribe en los registros de Dolibarr y en el historial del módulo.
07

Lo que se entrega

Lo que el módulo escribe en su instalación
Tablas creadas en la base de datosUna tabla: llx_dolixdoublons_log. Registra el historial de fusiones (fecha, usuario, tipo de objeto, ficha conservada, ficha fusionada, nombres de las dos fichas, entidad).
PermisosUn permiso: «Usar la detección de duplicados». La fusión exige además los permisos estándar de Dolibarr sobre el objeto: crear/modificar Y eliminar. Sin el permiso de eliminación, el análisis se puede consultar pero los botones de fusión no se muestran.
Desinstalación
  • Desactive el módulo en ConfiguraciónMódulos. El menú desaparece.
  • Las fusiones ya realizadas no se pueden anular: la ficha fusionada se ha eliminado.
  • La tabla de historial llx_dolixdoublons_log y los ajustes del módulo no se eliminan.
  • Se añade una tabla: llx_dolixdoublons_log. Solo contiene el historial de fusiones.
  • El análisis solo lee un conjunto mínimo de columnas —nombre, email, teléfonos, identificadores, ciudad— y no las escribe en ninguna parte.
  • La única escritura posible es la fusión que usted lanza.
  • Ninguna conexión saliente: no se envía nada a ninguna parte.
08

Compatibilidad

El descriptor del módulo solo declara una versión mínima. En el código no figura ningún límite superior: las versiones siguientes son aquellas en las que el módulo se ha ejecutado de verdad.

Compatibilidad del módulo Detección de duplicados
Versiones de DolibarrDolibarr 19.0 mínimo. Instalado y ejecutado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.0, 24.0.1 y 24.0.2.
PHP mínimo7.4
Módulos de Dolibarr que activarTerceros
LicenciaGPL v3 o posterior, código fuente completo
IdiomasFrancés, inglés, español
MenúMenú Terceros«Duplicados».
09

Instalación

  1. Obtenga el módulo en el DoliStore y descargue el archivo zip.
  2. En Dolibarr: InicioConfiguraciónMódulospestaña «Instalar módulo externo», y suba el zip. Si no, descomprima la carpeta dolixdoublons en htdocs/custom/.
  3. Active «Detección de duplicados» en la lista de módulos. La tabla del historial se crea en ese momento.
  4. Conceda el permiso «Usar la detección de duplicados» a los usuarios correspondientes. Para fusionar, deben tener además los permisos de Dolibarr de creación y de eliminación sobre el objeto afectado: terceros, contactos o miembros.
  5. Fije los dos límites y el historial en la página de configuración del módulo.

El detalle — permisos de la carpeta custom, alojamiento compartido, actualizaciones, desinstalación — está en la página Instalación y actualizaciones.

10

Preguntas frecuentes

¿En qué versiones de Dolibarr funciona este módulo?

El descriptor exige Dolibarr 19.0 como mínimo y PHP 7.4 como mínimo. El módulo se ha instalado y ejecutado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.0, 24.0.1 y 24.0.2. Si utiliza una versión más antigua y tiene alguna duda, escriba antes de comprar.

¿Puede el análisis modificar mi base de datos?

No. El análisis solo lee y agrupa. No se escribe nada mientras usted no haya elegido una ficha que conservar, marcado una ficha que fusionar, hecho clic en el botón y confirmado la ventana de aviso.

¿Qué pasa con el contenido de la ficha eliminada cuando se fusionan terceros?

Se traslada a la ficha conservada mediante el propio método de fusión de Dolibarr: presupuestos, pedidos, facturas, contactos, categorías. Los campos vacíos de la ficha conservada se completan con los del duplicado. Solo entonces se elimina el duplicado. La operación es irreversible: haga una copia de seguridad antes de una campaña de fusión.

¿El módulo fusiona también contactos y miembros?

Sí. El núcleo de Dolibarr no fusiona contactos, y los miembros solo desde su versión 23. La fusión de un contacto o de un miembro está escrita en el módulo. Traslada a la ficha conservada todo lo que apuntaba a la ficha eliminada: funciones en presupuestos, pedidos, facturas y proyectos, vínculos con terceros, categorías, eventos de agenda, notificaciones, destinatarios de emailing, campos adicionales y, para un miembro, sus afiliaciones y asociaciones. La cuenta de usuario vinculada, si la hay, también se traslada. Los campos vacíos de la ficha conservada se completan con los del duplicado, las notas se ponen una tras otra y después se elimina el duplicado. Todo se hace en una transacción: si un paso falla, no se aplica nada.

¿Puede proponerme falsos duplicados?

La comparación es una igualdad estricta tras la normalización, no una puntuación de parecido: dos fichas solo se agrupan si uno de sus valores es realmente idéntico una vez eliminado el formato. Los valores compartidos por más fichas que el límite de grupo —una centralita, un buzón genérico— se descartan y se señalan.

¿Y si lo desinstalo?

El menú desaparece. Las fusiones ya realizadas se mantienen: son datos de su base de datos. La tabla del historial y los ajustes también se mantienen; puede eliminarlos usted mismo.

¿Quién se encarga del soporte y cómo funcionan las actualizaciones?

El soporte lo presta la persona que escribió el módulo, en support@dolix.fr. El pedido, el pago, la factura y la descarga corren a cargo del DoliStore, donde se publican las nuevas versiones.

11

Historial de versiones

Tomado del archivo ChangeLog.md del módulo: una sola fuente.

1.1.83 de noviembre de 2026

Interfaz traducida al español (es_ES). Probado en 19.0.4 a 24.0.2 con Dolibarr en español.

1.1.731 de octubre de 2026

Recargar la página después de una fusión: la página vuelve por sí sola a los resultados del análisis; recargar (F5) ya no muestra «Acceso denegado» y no repite nada. Probado en 19.0.4 a 24.0.2.

1.1.630 de octubre de 2026

Confirmación de la fusión en la ventana propia de Dolibarr en lugar del cuadro del navegador: la fusión solo se lanza con su botón «Sí», con el token de seguridad de la sesión. Página de configuración: enlace de vuelta a la lista de módulos. Probado en 19.0.4 a 24.0.2.

1.1.525 de octubre de 2026

Permisos de Dolibarr respetados: un usuario sin el permiso de ver todos los terceros ya solo ve y fusiona los terceros de los que es el comercial asignado y sus contactos (más los contactos no vinculados a ningún tercero), como en las listas de Dolibarr; los contactos privados de otro usuario ya no se proponen. Probado en 19.0.4 a 24.0.2.

1.1.422 de octubre de 2026

Correcciones para Dolibarr 19 y 20: en la 19, la búsqueda de terceros duplicados fallaba (la columna phone_mobile solo existe en la tabla de terceros desde la 20); en la 19 y la 20, la fusión de dos terceros devolvía un error 500 (archivos del núcleo no cargados). El módulo ya solo lee esa columna si existe y carga esos archivos antes de la fusión. Probado en 19.0.4 a 24.0.2.

1.1.310 de septiembre de 2026

Técnico: la función de comprobación del token anti-CSRF lleva ahora un nombre con el prefijo del módulo, para que una función del mismo nombre añadida algún día a Dolibarr no pueda impedir que se abra la página. Un token vacío se rechaza explícitamente.

1.1.210 de septiembre de 2026

Corrección importante: el formulario de fusión enviaba siempre el tipo de objeto «tercero», fuera cual fuera el tipo analizado. Una fusión lanzada desde los contactos o los miembros se trataba como una fusión de terceros. Ahora se envía el tipo realmente mostrado, y la fusión de contactos y de miembros, escrita desde la 1.1.0, es realmente accesible desde la pantalla. Corrección: la pantalla de configuración devolvía un error 500 al guardar, porque la función de Dolibarr que escribe los ajustes se llamaba sin que su biblioteca estuviera cargada. Los ajustes se guardan con normalidad.

1.1.110 de septiembre de 2026

Corrección de compatibilidad con PostgreSQL: la detección de las columnas opcionales pasa ahora por la capa de abstracción de Dolibarr, porque en PostgreSQL una consulta con error anula la transacción en curso. Ningún dato se alteraba.

1.1.010 de septiembre de 2026

Fusión de contactos y fusión de miembros, que Dolibarr no ofrece de forma nativa: todo lo que apunta a la ficha eliminada se traslada a la ficha conservada —documentos y elementos vinculados, vínculos, eventos, categorías, notificaciones, afiliaciones, asociaciones y cuenta de usuario asociada— en una transacción. Detección de miembros duplicados, propuesta cuando el módulo Miembros está activado. Gestión de los conflictos de clave única durante una fusión. Compatibilidad entre versiones: las columnas que faltan según la versión de Dolibarr se detectan y se ignoran. El historial distingue ahora el tipo de objeto fusionado.

1.0.09 de septiembre de 2026

Primera versión: detección de terceros y contactos duplicados con cuatro criterios, normalización antes de la comparación, análisis de solo lectura, fusión de terceros con el método nativo de Dolibarr, protecciones, historial y página de configuración.

12

Soporte de este módulo

Escriba a support@dolix.fr. Responde la persona que escribió el módulo.

Respuesta en un plazo de dos días laborables. No es un servicio de guardia.

Qué incluir en su mensaje

  • La versión exacta de Dolibarr.
  • El módulo afectado y su versión — aquí dolixdoublons 1.1.8.
  • Lo que ha hecho, y lo que esperaba.
  • El mensaje de error copiado tal cual, o una captura de pantalla.
  • Cómo está instalado Dolibarr, si lo sabe.

Este módulo está a la venta en el DoliStore.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 79 € sin IVA
También

Los demás módulos