> ## Documentation Index
> Fetch the complete documentation index at: https://ayuda.daia.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestionar Documentos

> Ver, descargar y eliminar documentos y carpetas

Una vez que hayas [creado carpetas](/hub/crear-carpeta) y [subido documentos](/hub/subir-documentos), necesitarás visualizarlos, descargarlos o eliminarlos según tus necesidades operativas.

<Note>
  La gestión de documentos te permite mantener organizada y actualizada toda tu documentación en el módulo de [Documentación](/hub/documentacion).
</Note>

***

## Ver Documentos de una Carpeta

Para ver todos los documentos almacenados en una carpeta:

1. Ve al módulo de [Documentación](/hub/documentacion)
2. Localiza la carpeta en la tabla
3. Haz clic en el botón **"Ver"**

\[captura]

***

## Modal de Vista de Documentos

Se abrirá un diálogo que muestra todos los archivos de la carpeta en una tabla:

\[captura]

### Columnas de la Tabla

| Columna            | Descripción                                          |
| ------------------ | ---------------------------------------------------- |
| **Fruta**          | Especie o producto asociado al documento             |
| **Tipo documento** | Clasificación del archivo                            |
| **Fecha**          | Cuándo fue subido (puede variar según configuración) |
| **Acciones**       | Botones Ver y Eliminar                               |

<Tip>
  La tabla muestra todos los documentos que fueron [subidos](/hub/subir-documentos) a esta carpeta, organizados por tipo y especie.
</Tip>

***

## Acciones por Documento

Cada documento tiene dos botones de acción disponibles:

\[captura]

### 1. Ver Documento

**Botón**: Ícono de ojo o "Ver"

**Funcionalidad**:

* Abre el archivo en una nueva ventana/pestaña del navegador
* Permite visualizar el documento sin descargarlo
* Funciona con PDFs, imágenes y otros formatos soportados por el navegador

**Cómo usar**:

1. Haz clic en el botón "Ver" del documento
2. Se abrirá una nueva pestaña con el archivo
3. Usa las opciones de tu navegador para:
   * Ver el contenido
   * Descargar el archivo
   * Imprimir
   * Compartir

\[captura]

<Tip>
  Desde la vista previa, puedes usar Ctrl+S (o Cmd+S en Mac) para descargar rápidamente el archivo.
</Tip>

***

### 2. Eliminar Documento

**Botón**: Ícono de basura o "Eliminar"

**Funcionalidad**:

* Borra el documento de la carpeta
* Solicita confirmación antes de eliminar
* La eliminación es permanente

**Proceso de eliminación**:

1. Haz clic en el botón "Eliminar" del documento
2. El sistema mostrará un diálogo de confirmación
3. **Confirma** para eliminar definitivamente
4. **Cancela** para mantener el documento

\[captura]

<Warning>
  Los documentos eliminados no se pueden recuperar. Asegúrate antes de confirmar. Descarga una copia si necesitas respaldo.
</Warning>

***

## Eliminar una Carpeta Completa

Para eliminar una carpeta y todos sus documentos:

1. Ve al módulo de [Documentación](/hub/documentacion)
2. Localiza la carpeta en la tabla principal
3. Haz clic en el botón **"Eliminar carpeta"**

\[captura]

### Proceso de Eliminación de Carpeta

**Pasos**:

1. El sistema solicitará confirmación
2. Mostrará advertencia sobre eliminación de todos los documentos
3. Al confirmar, se eliminará:
   * La carpeta completa
   * **Todos los documentos** dentro de ella
   * Toda la información asociada
4. La operación es **irreversible**

\[captura]

<Warning>
  Al eliminar una carpeta, todos los documentos dentro de ella se perderán permanentemente. No hay forma de recuperarlos.
</Warning>

### Confirmación Requerida

Antes de eliminar, el sistema te pedirá:

* ✓ Confirmar que deseas eliminar la carpeta
* ✓ Verificar que entiendes que es permanente
* ✓ Aceptar que todos los documentos se perderán

<Tip>
  Antes de eliminar una carpeta, [visualiza sus documentos](#ver-documentos-de-una-carpeta) y descarga los que necesites conservar.
</Tip>

***

## Tipos de Documentos Disponibles

El sistema permite clasificar los documentos en diferentes tipos (según configuración):

\[captura]

### Tipos Comunes

**Certificaciones**:

* Certificado fitosanitario
* Certificado de origen
* Certificados de calidad

**Documentos Comerciales**:

* Packing list
* Invoice/Factura
* Bill of Lading (B/L)

**Documentos Oficiales**:

* Documento aduanero
* Documentos SAG
* Permisos de exportación

**Otros**:

* Reporte de calidad
* Fotografías
* Documentación adicional

<Note>
  Los tipos de documentos disponibles pueden variar según la configuración de tu empresa en el sistema.
</Note>

***

## Filtrar y Buscar Documentos

### Dentro del Modal de Vista

Dependiendo de la configuración, el modal puede incluir:

* **Búsqueda por tipo**: Filtra documentos por clasificación
* **Búsqueda por fruta**: Muestra solo documentos de una especie
* **Ordenamiento**: Por fecha, tipo o nombre

### En la Tabla Principal

En el módulo de [Documentación](/hub/documentacion), puedes:

* **Filtrar por empresa**: Busca por razón social
* **Filtrar por código SAG**: Localiza productores específicos
* **Ordenar carpetas**: Por número de documentos, fecha, etc.

<Tip>
  Usa los filtros para encontrar rápidamente documentos cuando tengas muchas carpetas y archivos.
</Tip>

***

## Gestión de Permisos

### Permisos para Ver Documentos

* ✓ Puedes ver carpetas según tus accesos configurados
* ✓ Solo visualizas documentos de empresas autorizadas
* ✓ Lectura sin modificación

### Permisos para Eliminar

* ✗ **Eliminar documentos**: Requiere permisos de edición
* ✗ **Eliminar carpetas**: Requiere permisos administrativos

### Mensajes de Error

Si intentas realizar una acción sin permisos suficientes:

\[captura]

* **Error 403**: "No tienes permisos para realizar esta acción"
* **"Acceso denegado"**: Falta autorización
* **"Solo lectura"**: Puedes ver pero no modificar

<Tip>
  Si necesitas acceso adicional para eliminar o modificar, contacta al administrador de tu sistema.
</Tip>

***

## Validaciones del Sistema

### Al Eliminar Documentos

El sistema valida:

✓ **Confirmación explícita**: Debes confirmar la acción
✓ **Permisos**: Verifica autorización para eliminar
✓ **Integridad**: Verifica que el documento no esté en uso

### Al Eliminar Carpetas

Validaciones adicionales:

✓ **Carpeta sin dependencias**: No debe estar referenciada en otros módulos
✓ **Confirmación doble**: Advertencia sobre pérdida de datos
✓ **Permisos administrativos**: Requiere mayor autorización

***

## Indicadores y Mensajes

### Mensajes de Éxito

\[captura]

* **"Documento eliminado correctamente"**
* **"Carpeta eliminada exitosamente"**
* **"Documento descargado"**

### Mensajes de Error

\[captura]

* **"Error al eliminar el documento"**
* **"No tienes permisos suficientes"**
* **"La carpeta está en uso"**
* **"Operación cancelada"**

### Indicadores de Proceso

Durante operaciones:

\[captura]

* Spinner de carga
* Botones deshabilitados temporalmente
* Mensajes de "Procesando..."

***

## Casos de Uso Comunes

### Caso 1: Verificar Documentos Subidos

**Escenario**: Confirmar que se cargaron correctamente

1. [Sube documentos](/hub/subir-documentos) a la carpeta
2. Haz clic en "Ver" en la carpeta
3. Revisa que todos los archivos estén listados
4. Abre cada uno (botón "Ver") para verificar contenido
5. Cierra el modal

### Caso 2: Reemplazar Documento Incorrecto

**Escenario**: Subiste el archivo equivocado

1. Abre la carpeta con "Ver"
2. Localiza el documento incorrecto
3. Haz clic en "Eliminar"
4. Confirma la eliminación
5. Cierra el modal
6. [Sube el documento correcto](/hub/subir-documentos)

### Caso 3: Limpiar Carpeta Obsoleta

**Escenario**: Temporada anterior terminada

1. Localiza la carpeta en la tabla principal
2. Opcionalmente, descarga documentos importantes
3. Haz clic en "Eliminar carpeta"
4. Confirma que entiendes que es permanente
5. La carpeta y todos sus documentos se eliminan

### Caso 4: Descargar Toda la Documentación

**Escenario**: Necesitas respaldo local

1. Abre la carpeta con "Ver"
2. Para cada documento:
   * Haz clic en "Ver"
   * Usa Ctrl+S para descargar
   * Guarda en tu computadora
3. Organiza los archivos localmente

***

## Mejores Prácticas

<Tip>
  **Descarga antes de eliminar**: Si vas a eliminar una carpeta, descarga primero los documentos que puedas necesitar después.
</Tip>

<Tip>
  **Verifica contenido regularmente**: Revisa periódicamente tus carpetas para asegurar que la documentación esté completa y actualizada.
</Tip>

<Tip>
  **Elimina documentos obsoletos**: Mantén el sistema limpio eliminando archivos que ya no sean relevantes (con precaución).
</Tip>

<Tip>
  **Usa nombres descriptivos**: Al [crear carpetas](/hub/crear-carpeta), usa nombres que faciliten identificar el contenido sin tener que abrirlas.
</Tip>

<Tip>
  **Mantén respaldos**: Para documentación crítica, mantén copias locales como respaldo adicional.
</Tip>

***

## Solución de Problemas

<AccordionGroup>
  <Accordion title="No puedo ver un documento" icon="eye-slash">
    **Posibles causas**:

    * El archivo está corrupto
    * El formato no es soportado por tu navegador
    * Problemas de permisos
    * Conexión lenta a internet

    **Solución**: Intenta descargarlo y ábrelo con una aplicación local.
  </Accordion>

  <Accordion title="No veo el botón 'Eliminar'" icon="ban">
    Si no ves opciones de eliminar:

    * Verifica tus permisos con el administrador
    * Puede que solo tengas acceso de lectura
    * Algunos documentos pueden estar protegidos
  </Accordion>

  <Accordion title="¿Puedo recuperar un documento eliminado?" icon="recycle">
    No, las eliminaciones son permanentes y no se pueden deshacer. No existe función de "papelera" o recuperación.

    Por eso el sistema siempre solicita confirmación antes de eliminar.
  </Accordion>

  <Accordion title="La carpeta no se elimina" icon="circle-xmark">
    **Posibles causas**:

    * No tienes permisos administrativos
    * La carpeta está referenciada en otros módulos
    * Hay un error del servidor

    Contacta al administrador para asistencia.
  </Accordion>

  <Accordion title="¿Puedo mover documentos entre carpetas?" icon="arrows-up-down">
    No directamente. Para "mover" un documento:

    1. Descarga el documento de la carpeta original
    2. Elimínalo de la carpeta original
    3. [Súbelo](/hub/subir-documentos) a la nueva carpeta
  </Accordion>

  <Accordion title="¿Hay límite en la cantidad de documentos por carpeta?" icon="hashtag">
    No existe un límite estricto, pero se recomienda mantener las carpetas organizadas y eliminar documentos obsoletos periódicamente para un mejor rendimiento.
  </Accordion>
</AccordionGroup>

***

## Integración con Otros Módulos

### Con Reservaciones

* Documentos de contenedores pueden estar vinculados a [reservaciones](/hub/reservaciones)
* Eliminar documentos puede afectar la documentación de reservas
* Verifica dependencias antes de eliminar

### Con Dashboard

* El [Dashboard](/hub/dashboard) muestra contadores de documentos
* Las eliminaciones actualizan automáticamente los contadores
* La actividad se registra en los logs

***

## Navegación Rápida

<CardGroup cols={3}>
  <Card title="Subir Documentos" icon="upload" href="/hub/subir-documentos">
    Cargar nuevos archivos
  </Card>

  <Card title="Crear Carpeta" icon="folder-plus" href="/hub/crear-carpeta">
    Organizar nueva documentación
  </Card>

  <Card title="Documentación" icon="book" href="/hub/documentacion">
    Volver al módulo principal
  </Card>

  <Card title="Preguntas Frecuentes" icon="circle-question" href="/hub/preguntas-frecuentes-documentacion">
    Dudas y mejores prácticas
  </Card>

  <Card title="Dashboard" icon="chart-line" href="/hub/dashboard">
    Panel de control
  </Card>

  <Card title="Reservaciones" icon="calendar-check" href="/hub/reservaciones">
    Gestionar reservas
  </Card>
</CardGroup>