# App movil gestoria

La app movil de Frihet para gestorias permite gestionar expedientes de clientes sin estar delante del ordenador. Aprueba declaraciones, revisa documentos y comunica incidencias desde el movil con el mismo nivel de seguridad que la version web.

La app esta construida sobre la misma base de codigo que la web, lo que garantiza paridad de funcionalidades y actualizaciones automaticas.

:::caution Publicacion en stores pendiente
La build movil esta lista, pero **todavia no esta publicada en App Store ni Google Play**. Mientras tanto, usa Frihet desde el movil como **PWA** (web-app): abre `app.frihet.io` en el navegador del movil y "Anadir a pantalla de inicio". Las funciones nativas (push, swipe) llegaran con la publicacion en stores.
:::

## Instalacion

Hoy: instala la **PWA** desde el navegador del movil.

- **iOS (Safari)**: abre `app.frihet.io` → Compartir → "Anadir a pantalla de inicio" (requiere iOS 16+).
- **Android (Chrome)**: abre `app.frihet.io` → menu → "Instalar app" / "Anadir a pantalla de inicio" (requiere Android 10+).

Las apps nativas en App Store y Google Play se anunciaran cuando esten publicadas.

:::info Acceso restringido
Las funciones de gestoria estan disponibles exclusivamente para cuentas con el **modulo Gestoria** activo. Los clientes finales de la gestoria usan el portal web, no la app.
:::

Inicia sesion con las mismas credenciales que en web. Si tienes MFA activado, se solicita en el primer inicio de sesion por dispositivo.

## Swipe para aprobar expedientes

La funcionalidad central de la app es la **cola de aprobacion gestual**. Accede desde **Inicio** → **Pendientes de aprobacion**.

Cada expediente se muestra como una tarjeta con:

- Nombre del cliente
- Tipo de documento (M303, M130, M200, IRPF, etc.)
- Periodo declarado
- Importe a ingresar o devolver
- Fecha limite

**Gestos disponibles:**

| Gesto                  | Accion                                                       |
| ---------------------- | ------------------------------------------------------------ |
| Swipe derecha (verde)  | Aprobar — el cliente recibe notificacion de firma disponible |
| Swipe izquierda (rojo) | Rechazar — abre campo de motivo antes de confirmar           |
| Tap                    | Ver detalle completo del expediente                          |
| Swipe arriba           | Dejar para mas tarde (vuelve al final de la cola)            |

Cada aprobacion queda registrada en el audit trail con la marca de tiempo y el dispositivo (movil).

## Notificaciones push

Configura las notificaciones en **App** → **Configuracion** → **Notificaciones**:

| Evento                          | iOS  | Android | Telegram |
| ------------------------------- | ---- | ------- | -------- |
| Nuevo documento cliente         | Push | Push    | Opcional |
| Declaracion lista para revision | Push | Push    | Opcional |
| Vencimiento fiscal en 3 dias    | Push | Push    | Si       |
| Documento firmado por cliente   | Push | Push    | Opcional |
| Mensaje nuevo del cliente       | Push | Push    | Opcional |

Las notificaciones de vencimientos fiscales estan activadas por defecto y no pueden desactivarse (son criticas para el negocio).

Para activar las notificaciones por primera vez, la app solicita permiso del sistema operativo en el primer inicio.

## Documentos y adjuntos

Desde el movil puedes:

- **Ver** PDFs de declaraciones y documentos del cliente (visor nativo).
- **Firmar** documentos con firma digital del dispositivo (biometria o PIN).
- **Adjuntar** ficheros desde la camara o el almacenamiento del movil (ej: DNI del cliente, justificante bancario).
- **Descargar** documentos para revision offline.

El tamano maximo de adjunto desde movil es **20 MB**. Para ficheros mayores, usa la version web.

## Mensajeria con clientes

La app incluye el modulo de mensajeria contextual de Frihet. Los mensajes van vinculados al expediente del cliente — no es un chat generico. Accede desde **Cliente** → **Mensajes**.

:::tip
Los mensajes del movil y de la web estan sincronizados en tiempo real. Puedes empezar una conversacion en el movil y continuarla en el ordenador sin perder contexto.
:::

## Borradores offline (roadmap)

El soporte completo de borradores offline esta planificado para **Q4 2026**. Actualmente disponible en beta:

- **Disponible ahora**: leer expedientes y documentos sin conexion (cache 24h).
- **Beta**: crear notas e incidencias offline — se sincronizan al recuperar conexion.
- **Q4 2026**: crear y editar borradores de declaraciones offline con sincronizacion diferida.

Para unirte a la beta, activa **Configuracion** → **Cuenta** → **Funciones experimentales** → **Modo offline beta**.

## Seguridad

- **Biometria**: desbloqueo con Face ID / Touch ID / huella Android obligatorio si el dispositivo lo soporta.
- **Timeout de sesion**: la sesion se cierra automaticamente tras 30 minutos de inactividad en background.
- **Borrado remoto**: si pierdes el dispositivo, un administrador puede revocar el acceso desde **Configuracion** → **Dispositivos activos**.
- **Sin datos locales**: los documentos del cliente no se almacenan en el dispositivo — solo en cache cifrada temporal.

## Gotchas

- **Biometria corporativa**: en dispositivos con MDM (Mobile Device Management) empresarial, la biometria puede no estar disponible. En ese caso se usa PIN de 6 digitos.
- **Actualizaciones**: la app se actualiza automaticamente en background. Si ves comportamientos inesperados, fuerza la actualizacion desde la App Store / Google Play.
- **Modo oscuro**: disponible y respeta la configuracion del sistema operativo.
- **Tablets**: la app esta optimizada para movil pero es funcional en iPad y tablets Android. La experiencia en tablet es mejor desde el navegador web.

## Relacionado

- [Modulo Gestoria — resumen](./gestoria)
- [Portal white-label para clientes](./gestoria-whitelabel)
- [Self-onboard de clientes VIES](./gestoria-self-onboard)
- [Notificaciones](../configuracion/notificaciones)