> ## 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.

# Estados de Reservación

> Comprende el flujo de estados y cómo gestionarlos

Las reservaciones siguen un flujo de estados que representa su progreso a través del proceso logístico de exportación. Cada estado tiene características específicas y permisos asociados.

<Note>
  Los cambios de estado son **progresivos e irreversibles**. No puedes retroceder a estados anteriores una vez avanzado el proceso.
</Note>

***

## Flujo de Estados

Las reservaciones pasan por 4 estados principales en orden secuencial:

```
Pendiente → Validada → En Planta → Despachada
```

\[captura - Diagrama de flujo]

<Tip>
  Cada estado tiene un color distintivo que te permite identificar rápidamente el progreso en la [lista de reservaciones](/hub/reservaciones).
</Tip>

***

## Estado 1: Pendiente

\[captura]

### Características

* **Color**: Azul
* **Momento**: Reservación recién [creada](/hub/crear-reservacion)
* **Duración típica**: Hasta que se valide la información
* **Estado inicial**: Todas las reservaciones nuevas comienzan aquí

### Permisos y Acciones Disponibles

En este estado puedes:

✓ [**Editar**](/hub/editar-eliminar-reservacion) todos los datos de la reservación
✓ [**Eliminar**](/hub/editar-eliminar-reservacion) la reservación completa
✓ **Agregar o quitar** pallets de la carga
✓ **Subir o eliminar** documentos
✓ **Modificar** fechas de stacking y carga
✓ **Cambiar** empresas asignadas
✓ **Avanzar** al siguiente estado (Validada)

### Cuándo Usar Este Estado

* Cuando recién creas la reservación
* Mientras verificas y completas la información
* Si necesitas hacer correcciones antes de confirmar
* Cuando esperas documentación adicional

<Warning>
  Una vez que avances al estado Validada, no podrás volver a Pendiente ni hacer modificaciones. Asegúrate de que todo esté correcto antes de validar.
</Warning>

***

## Estado 2: Validada

\[captura]

### Características

* **Color**: Verde Oscuro
* **Momento**: Información confirmada y verificada
* **Duración típica**: Hasta que el contenedor llegue a planta
* **Confirmación**: La reservación está lista para proceso

### Permisos y Acciones Disponibles

En este estado puedes:

✓ **Ver** toda la información ([vista de detalles](/hub/ver-reservacion))
✓ **Consultar** documentos adjuntos
✓ **Avanzar** al siguiente estado (En Planta)

En este estado **NO** puedes:

✗ [Editar](/hub/editar-eliminar-reservacion) ningún dato
✗ [Eliminar](/hub/editar-eliminar-reservacion) la reservación
✗ Agregar o quitar pallets
✗ Modificar documentos
✗ Retroceder a Pendiente

### Cuándo Usar Este Estado

* Cuando toda la información está verificada y correcta
* La documentación está completa
* Los pallets están confirmados
* Las fechas están definidas
* Estás listo para que proceda el proceso logístico

<Note>
  La validación es el punto de no retorno para modificaciones. Si detectas un error después de validar, contacta al administrador del sistema.
</Note>

***

## Estado 3: En Planta

\[captura]

### Características

* **Color**: Amarillo/Naranja (puede variar según configuración)
* **Momento**: El contenedor físicamente llegó a la planta de packing
* **Duración típica**: Durante el proceso de carga en planta
* **Proceso activo**: Operaciones de apilamiento y carga en curso

### Permisos y Acciones Disponibles

En este estado puedes:

✓ **Ver** toda la información
✓ **Consultar** estado de carga
✓ **Asociar** el contenedor físico (número de contenedor)
✓ **Avanzar** al siguiente estado (Despachada)

En este estado **NO** puedes:

✗ Editar datos de la reservación
✗ Eliminar la reservación
✗ Modificar pallets o documentos
✗ Cambiar fechas programadas

### Cuándo Usar Este Estado

* Cuando el contenedor llega físicamente a tu planta
* Se inicia el proceso de carga
* El personal está apilando y cargando los pallets
* Se está preparando para el despacho final

### Asociación de Contenedor

Al cambiar a este estado, el sistema abrirá un diálogo para:

\[captura]

1. **Ingresar el número de contenedor**: Código físico del contenedor
2. **Asociar la reservación al contenedor**: Vinculación en el sistema
3. **Confirmar la asociación**: Registro permanente

<Tip>
  Este paso es crucial para la trazabilidad completa del proceso de exportación.
</Tip>

***

## Estado 4: Despachada

\[captura]

### Características

* **Color**: Verde Claro
* **Momento**: Contenedor enviado y proceso completado
* **Duración**: Estado final permanente
* **Finalización**: La reservación ha cumplido su ciclo completo

### Permisos y Acciones Disponibles

En este estado puedes:

✓ **Ver** toda la información histórica
✓ **Consultar** documentos para auditoría
✓ **Exportar** datos de la reservación
✓ **Generar** reportes

En este estado **NO** puedes:

✗ Editar ningún aspecto
✗ Eliminar la reservación
✗ Cambiar el estado
✗ Modificar documentación

### Cuándo Usar Este Estado

* El contenedor fue enviado exitosamente
* La carga está completa
* Toda la documentación está finalizada
* El proceso logístico terminó

<Note>
  Las reservaciones despachadas sirven como registro histórico y auditable de tus operaciones de exportación.
</Note>

***

## Cómo Cambiar el Estado

### Desde la Vista de Detalles

1. Abre la [vista de detalles](/hub/ver-reservacion) de la reservación
2. Localiza el **botón de estado** en la cabecera
3. Haz clic en el botón
4. Selecciona el **siguiente estado** disponible
5. Confirma el cambio

\[captura]

### Estados Disponibles

El sistema mostrará solo los estados válidos según tu estado actual:

| Estado Actual | Puede Avanzar A |
| ------------- | --------------- |
| Pendiente     | Validada        |
| Validada      | En Planta       |
| En Planta     | Despachada      |
| Despachada    | (Estado final)  |

<Warning>
  Solo puedes avanzar al siguiente estado en secuencia. No puedes saltar estados ni retroceder.
</Warning>

***

## Validaciones de Estado

### Al Cambiar de Pendiente a Validada

El sistema verifica:

* ✓ Todos los campos obligatorios estén completos
* ✓ Al menos un pallet esté agregado
* ✓ Las fechas sean coherentes
* ✓ La información esté consistente

### Al Cambiar de Validada a En Planta

El sistema solicita:

* ✓ Confirmación del usuario
* ✓ Número de contenedor (asociación)
* ✓ Verificación de permisos

### Al Cambiar de En Planta a Despachada

El sistema verifica:

* ✓ El contenedor esté asociado
* ✓ Confirmación final del despacho
* ✓ Registro de fecha/hora de despacho

***

## Visualización de Estados

### En la Lista de Reservaciones

En la [tabla principal](/hub/reservaciones), cada reservación muestra:

* **Badge de color**: Identificador visual rápido
* **Texto del estado**: Nombre claro (Pendiente, Validada, etc.)
* **Filtros**: Puedes filtrar por estado específico

\[captura]

### En la Vista de Detalles

En la [vista detallada](/hub/ver-reservacion):

* **Indicador prominente**: Badge grande en la cabecera
* **Botón de acción**: Para cambiar al siguiente estado
* **Información contextual**: Acciones disponibles según estado

\[captura]

### En el Dashboard

En el [Dashboard](/hub/dashboard):

* **Contadores por estado**: Total de Pendientes, Confirmadas, Despachadas
* **Tarjetas de resumen**: Con colores distintivos
* **Gráficos**: Visualización del flujo de estados

\[captura]

***

## Casos de Uso por Estado

### Escenario 1: Reservación Nueva

```
PENDIENTE
↓
Usuario crea reservación con todos los datos
↓
Revisa y verifica información
↓
Sube documentos requeridos
↓
Cambia a VALIDADA
```

### Escenario 2: Contenedor en Proceso

```
VALIDADA
↓
Contenedor llega a planta física
↓
Usuario cambia a EN PLANTA
↓
Sistema solicita número de contenedor
↓
Se asocia contenedor a la reservación
↓
Personal carga los pallets
```

### Escenario 3: Despacho Completado

```
EN PLANTA
↓
Carga completada
↓
Documentación lista
↓
Usuario cambia a DESPACHADA
↓
Sistema registra fecha/hora de despacho
↓
Reservación archivada como completada
```

***

## Mejores Prácticas

<Tip>
  **Valida solo cuando estés seguro**: Una vez en estado Validada, no podrás hacer cambios. Revisa toda la información antes.
</Tip>

<Tip>
  **Actualiza estados en tiempo real**: Cambia el estado cuando realmente ocurra el evento (llegada a planta, despacho) para mantener información precisa.
</Tip>

<Tip>
  **Usa filtros de estado**: En la lista de reservaciones, filtra por estado para enfocarte en las que requieren tu atención.
</Tip>

<Tip>
  **Documenta el proceso**: Si hay eventos especiales durante el cambio de estado, agrégalo como nota o comunicación interna.
</Tip>

***

## Comparación de Estados

| Aspecto         | Pendiente | Validada     | En Planta  | Despachada  |
| --------------- | --------- | ------------ | ---------- | ----------- |
| **Color**       | Azul      | Verde Oscuro | Amarillo   | Verde Claro |
| **Edición**     | ✓ Sí      | ✗ No         | ✗ No       | ✗ No        |
| **Eliminación** | ✓ Sí      | ✗ No         | ✗ No       | ✗ No        |
| **Ver info**    | ✓ Sí      | ✓ Sí         | ✓ Sí       | ✓ Sí        |
| **Siguiente**   | Validada  | En Planta    | Despachada | (Final)     |
| **Retroceder**  | —         | ✗ No         | ✗ No       | ✗ No        |

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo retroceder de Validada a Pendiente?">
    No, los cambios de estado son progresivos e irreversibles. Una vez validada, no puedes volver a Pendiente. Contacta al administrador si necesitas hacer cambios.
  </Accordion>

  <Accordion title="¿Qué pasa si necesito editar una reservación validada?">
    Las reservaciones validadas no pueden editarse. Si es urgente, contacta al administrador del sistema quien puede tener permisos especiales para revertir estados.
  </Accordion>

  <Accordion title="¿Puedo saltar estados, por ejemplo de Pendiente a Despachada?">
    No, debes seguir el flujo secuencial: Pendiente → Validada → En Planta → Despachada. No se pueden omitir estados.
  </Accordion>

  <Accordion title="¿Cuánto tiempo debe permanecer en cada estado?">
    No hay límite de tiempo. Cada estado permanece hasta que cambies manualmente al siguiente. Depende de tu proceso logístico real.
  </Accordion>

  <Accordion title="¿Qué pasa si cambio de estado por error?">
    No puedes revertir el cambio. Por eso el sistema siempre solicita confirmación antes de cambiar de estado.
  </Accordion>

  <Accordion title="¿Los estados afectan otros módulos del sistema?">
    Sí, algunos módulos pueden tener integraciones. Por ejemplo, al despachar, puede actualizarse el inventario o notificarse a otros sistemas.
  </Accordion>
</AccordionGroup>

***

## Navegación Rápida

<CardGroup cols={3}>
  <Card title="Ver Reservación" icon="eye" href="/hub/ver-reservacion">
    Consultar detalles y estado actual
  </Card>

  <Card title="Crear Reservación" icon="plus" href="/hub/crear-reservacion">
    Crear nueva en estado Pendiente
  </Card>

  <Card title="Editar" icon="pen-to-square" href="/hub/editar-eliminar-reservacion">
    Modificar si está Pendiente
  </Card>

  <Card title="Lista Principal" icon="list" href="/hub/reservaciones">
    Ver todas las reservaciones
  </Card>

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

  <Card title="Ayuda" icon="circle-question" href="/hub/preguntas-frecuentes-reservaciones">
    Más preguntas frecuentes
  </Card>
</CardGroup>