TrashBin

# TrashBin - Manual de Usuario

## ¿Qué es TrashBin?

TrashBin es una **papelera** para Dolibarr, como la que tienes en tu ordenador. Cuando eliminas un elemento por error (un cliente, un producto, una factura...), en lugar de perderlo definitivamente, se coloca en la papelera. Luego puedes restaurarlo fácilmente.

---

## 📋 Acceder a la Papelera

1. En el menú principal de Dolibarr, haz clic en **"TrashBin"** (icono de papelera)
2. Accedes a la lista de todos los elementos eliminados

---

## 👁️ Consultar la Lista de Elementos Eliminados

La lista muestra:
- **Tipo**: El tipo de elemento (Tercero, Producto, Factura, etc.)
- **Referencia**: El nombre o número del elemento
- **Fecha de Eliminación**: Cuándo se eliminó el elemento
- **Eliminado Por**: Quién eliminó el elemento

### Buscar un Elemento

Utiliza el campo de búsqueda en la parte superior de la página para encontrar rápidamente un elemento por su referencia o nombre.

---

## ♻️ Restaurar un Elemento

### Restaurar un Solo Elemento

1. En la lista, haz clic en la **referencia** del elemento que deseas restaurar
2. En la página de detalles, haz clic en el botón **"Restaurar"**
3. Se muestra una confirmación: el elemento está disponible de nuevo en Dolibarr

> **💡 Consejo**: Los elementos se restauran con toda su información (datos de contacto, precios, líneas de factura, contactos asociados, etc.)

---

## 🗑️ Eliminar Definitivamente

Si estás seguro de que ya no necesitas un elemento, puedes eliminarlo permanentemente de la papelera.

### Eliminar un Elemento Definitivamente

1. Haz clic en la referencia del elemento
2. Haz clic en el botón **"Eliminar Permanentemente"**
3. ⚠️ **Advertencia**: ¡Esta acción es irreversible! El elemento se perderá para siempre.

### Vaciar Toda la Papelera

1. En la parte superior de la lista, haz clic en **"Vaciar Papelera"**
2. Confirma la acción
3. ⚠️ **Advertencia**: ¡Todos los elementos de la papelera se eliminarán definitivamente!

### Vaciar una Selección

1. Marca las casillas de los elementos a eliminar definitivamente
2. Haz clic en **"Vaciar Selección"**
3. Confirma: los elementos marcados se eliminarán definitivamente

---

## 🔍 Ver los Detalles de un Elemento

Haz clic en la referencia de un elemento para ver su información detallada.

### Botón "Ver JSON"

Este botón muestra toda la información técnica del elemento en formato de datos. Es útil para:
- Verificar que un elemento contiene toda la información antes de restaurarlo
- Compartir los detalles con el soporte técnico en caso de problemas

Haz clic en **"Ocultar JSON"** para cerrar esta información.

---

## ⚙️ Configuración (para Administradores)

### Acceder a la Configuración

1. Ve a **Inicio → Configuración → Módulos/Aplicaciones**
2. Encuentra el módulo **TrashBin** en la lista
3. Haz clic en el icono de **engranaje** (⚙️) a la derecha del módulo

### Purga Automática

Puedes configurar una **purga automática** para limpiar automáticamente la papelera.

- **Plazo de Purga Automática (días)**: Número de días que los elementos se conservan en la papelera
  - Ejemplo: Si pones **30**, los elementos eliminados hace más de 30 días se eliminarán automáticamente de la papelera
  - Pon **0** para desactivar la purga automática (los elementos permanecen indefinidamente)

**Recomendación**: 
- Para pequeñas organizaciones: **90 días** (3 meses)
- Para grandes organizaciones: **30 días** (1 mes)

La purga se activa automáticamente cada vez que alguien abre la página de la papelera.

---

## ❓ Preguntas Frecuentes

### ¿Todos mis elementos eliminados van a la papelera?

Sí, TrashBin captura automáticamente la eliminación de todos los tipos de elementos:
- Terceros (clientes/proveedores)
- Contactos
- Productos y servicios
- Facturas
- Presupuestos
- Pedidos
- Proyectos
- Intervenciones
- Etc.

### ¿Puedo restaurar un elemento eliminado hace varios meses?

Sí, siempre que el elemento todavía esté en la papelera. Si hay configurada una purga automática, verifica el período de conservación.

### ¿Se conservan los archivos adjuntos?

La información del elemento se conserva. Los documentos relacionados pueden requerir atención especial según el contexto de eliminación.

### ¿Qué sucede si restauro un cliente eliminado?

El cliente se restaura con:
- Todos sus datos de contacto
- Contactos asociados
- Categorías
- Campos personalizados
- Toda su información
- Documentos
- Imágenes
- Extrafields

### ¿Puedo restaurar una factura con todas sus líneas?

Sí, las facturas se restauran con todas sus líneas, importes y detalles.

---

## 🆘 ¿Necesitas Ayuda?

Si has eliminado un elemento importante por error:

1. **No te preocupes** 😊
2. Ve a **TrashBin**
3. Busca el elemento por su nombre o referencia
4. Haz clic en él para verificar que es el correcto
5. Haz clic en **"Restaurar"**

Si no encuentras el elemento en la papelera, contacta a tu administrador del sistema: puede verificar si se activó la purga automática.

---

## 🔐 Permisos

Tu administrador puede definir quién puede:
- **Leer la papelera**: Ver la lista de elementos eliminados
- **Restaurar objetos**: Devolver elementos a Dolibarr
- **Purgar objetos**: Eliminar definitivamente de la papelera
- **Administrar la papelera**: Acceder a la configuración

Si no tienes acceso a ciertas funciones, contacta a tu administrador.

---

**Módulo TrashBin - Versión 1.0.0**  
*Desarrollado por Goldoweb SL*  
*Soporte: goldoweb@gmail.com*