Añade un modo de búsqueda acumulativa a cualquier listado de FacturaScripts. Cuando está activo, cada búsqueda se suma a la anterior en lugar de reemplazarla, permitiendo acotar resultados de forma progresiva sin perder el contexto, y además sincronizable entre vistas y con operadores lógicos.

Muy útil para hacer búsquedas en las vistas principales y también en sus listados asociados. Por ejemplo Facturas y sus líneas de Productos: Esto nos permite buscar por ejemplo entre varios clientes que nos han comprado un rodamiento, entre fecha tal, estado tal, y que no sea el 6005 por ejemplo. Hacemos las búsqueda en cada vista que sea necesario, Clientes en la vista principal y el resto de la búsqueda en líneas, cada vez que pulsamos Enter el sistema va acotando y reduciendo la búsqueda de forma acumulada hasta llegar al resultado final. Pudiendo además buscar por campo Todos ó por uno específico: por ejemplo el campo Comentario Privado o Descripción

Funciona en todos los listados del sistema (facturas, albaranes, pedidos, clientes, proveedores, artículos, etc.) sin necesidad de configuración.

**Búsqueda acumulativa:**
- Pulsa el botón de capas (🗂) junto al buscador para activar el modo. El botón se pone en amarillo cuando está activo.
- Escribe tu primera búsqueda y pulsa Enter.
- Escribe una segunda búsqueda. Los resultados mostrarán solo los registros que contengan ambos términos.
- Debajo del buscador aparece un badge con todos los términos acumulados y sus operadores.
- Pulsa el botón de limpiar (🗂✕) para borrar la acumulación y volver al listado completo.

**Operadores lógicos:**
- **AND** (por defecto) — el resultado debe contener ambos términos. Reduce el conjunto.
- **OR** — el resultado puede contener cualquiera de los términos. Amplía el conjunto buscando sobre el total de registros.
- **NOT** — el resultado no debe contener este término. Excluye registros.

Selecciona el operador desde el desplegable junto al buscador antes de escribir el siguiente término.

**Agrupación con paréntesis:**
- Usa los botones `(` y `)` para agrupar términos explícitamente.
- Sin paréntesis, la lógica es automática: AND y NOT se acumulan en el grupo actual, OR abre un nuevo grupo.
- Permite construir expresiones complejas: `("fábrica" AND "norte") OR ("taller" AND "6005")`.

**NOT global:**
- Un NOT colocado después de cerrar un grupo `)` excluye el término de todos los grupos simultáneamente.
- `("azul") OR ("verde") NOT "rojo"` excluye rojo de ambos grupos a la vez.

**Sincronización de vistas relacionadas:**
- En listados con pestañas relacionadas, las vistas se sincronizan automáticamente al buscar en la vista principal.
- Filtras la vista principal → las vistas relacionadas muestran automáticamente solo los registros de los resultados filtrados.
- Las vistas relacionadas muestran un badge con el contador de registros ("Recibos: 12 de 180", "Variantes: 5 de 43"...).

**Tipos de vista relacionada:**

| Vista | Comportamiento | Ejemplos |
|---|---|---|
| Líneas de documento | Buscador acumulado completo + sincronización bidireccional | Líneas de pedido, factura, albarán |
| Detalle con FK* | Solo botón limpiar 🗂✕ — reciben el filtro del padre automáticamente | Recibos, Variantes, Stock, Direcciones, Cuentas bancarias |
| Detalle sin FK* | Solo botón limpiar 🗂✕ — vista independiente en el mismo controlador | Grupos de clientes |

*FK (Foreign Key): clave foránea en base de datos. Es el campo que relaciona una tabla hija con su tabla padre. Por ejemplo `idfactura` en recibos apunta a la factura padre, `idproducto` en variantes apunta al producto padre.

**Selector de campo:**
- Con el modo activo, aparece una fila de casillas con los campos buscables del listado.
- Por defecto está marcado **Todos** — busca en todos los campos como siempre.
- Marca una casilla para limitar la siguiente búsqueda a ese campo. La casilla activa aparece en negrita.
- El campo seleccionado persiste hasta que lo cambies, permitiendo acumular términos en el mismo campo o combinar campos distintos: `[Cliente] "norte" AND [Observaciones] "urgente"`.
- Sin modo activo las casillas no aparecen — no afectan al funcionamiento normal del buscador.

**Compatible con el plugin Comentarioprivado:**
- Si tienes instalado el plugin Comentarioprivado, el campo "Comentario privado" aparece como columna buscable en los listados de albaranes, facturas, pedidos y presupuestos de venta.
- BuscadorAcumulado lo detecta automáticamente e incluye ese campo en todas las búsquedas acumuladas — sin ninguna configuración adicional.
- Permite buscar y cruzar anotaciones internas con cualquier otro campo del documento usando AND, OR y NOT.

**Coordinación con los botones del core:**
- "Todos" y cargar un filtro guardado limpian también la acumulación.
- "Limpiar filtros" y la papelera solo limpian los filtros del panel — el stack acumulado se mantiene.


**Combina Potencia con Simplicidad al hacer las busquedas acumuladas**

**Ir a la documentación para ver como funciona el plugin.**