# Panel de gestoría

> Un panel centralizado para gestorías y asesorías: genera declaraciones fiscales en lote, gestiona vencimientos, solicita documentos a tus clientes, recibe facturas por email y exporta la contabilidad de cada cliente al formato que use tu software (A3, ContaPlus, DATEV, Xero, QuickBooks o CSV).

## Qué puede hacer una gestoría con Frihet

- **Cockpit multi-cliente**: todas las empresas que gestionas en una sola pantalla, ordenadas por riesgo (las críticas primero), con estado de salud, próximo vencimiento fiscal y saldo vencido por cliente.
- **Declaraciones en lote**: genera M303, M130, M111 y M115 para varios clientes a la vez (PDF o TXT AEAT) y descárgalos en un ZIP.
- **Aging consolidado**: cobros pendientes de toda la cartera en un único cuadro, con tramos 1-30/31-60/61-90/90+ días.
- **Factura desde email**: reenvía la factura de un proveedor a una dirección del workspace y la IA la convierte en un borrador de factura.
- **Solicitudes de documentos**: pide documentación a cada cliente con prioridad y fecha límite; ellos la suben a su portal.
- **Exportación contable**: descarga cada cliente en el formato que necesite tu contabilidad.
- **Asesor gratis**: tu cliente te invita como contable sin que ocupes un asiento de pago.

## Invitar y aceptar clientes

Frihet conecta gestoría y cliente mediante el **rol de contable** dentro del workspace del cliente — no necesitas crear cuentas nuevas ni duplicar datos.

1. **El cliente te invita.** En su workspace, va a **Equipo → Invitar miembros** y te añade con el rol **Contable**.
2. **Aceptas la invitación.** Recibes un email con un enlace; al aceptar, ese cliente aparece en tu **Panel de gestoría**.
3. **Sin coste de asiento.** Un asesor invitado como contable **no consume un asiento de pago** del plan del cliente.

Cada cliente que aceptas se suma a tu cartera y aparece como una tarjeta en el cockpit.

## Tu cartera de clientes

El cockpit muestra una tarjeta por cliente con:

- **Estado de salud** (saludable / atención / crítico), derivado de un scoring determinista 0-100 (pago, volumen, engagement, antigüedad) con predicción de abandono.
- **Próximo vencimiento fiscal** con urgencia por color (rojo ≤7 días, ámbar ≤15 días), tomado del calendario fiscal real del cliente.
- **Saldo vencido** por tramos de antigüedad (30/60/90+).
- **Documentos pendientes** y badge de subidas sin leer en tiempo real.

Las tarjetas se ordenan automáticamente por riesgo: los clientes que necesitan atención aparecen primero.

## Entrar en un cliente

Tienes dos formas de operar sobre un cliente:

- **Sin cambiar de workspace.** Desde la propia tarjeta del cockpit puedes ejecutar **Acciones rápidas**: descargar PDF, TXT AEAT o una exportación contable de ese cliente directamente, sin salir del panel.
- **Entrando al workspace.** Haz clic en la tarjeta para abrir el workspace del cliente con tu rol de contable: ves sus datos, generas modelos y emites facturas en su nombre (numeración independiente por empresa).

## Solicitudes de documentos

El sistema de **solicitud de documentos** comunica gestoría y cliente dentro de Frihet:

1. Crea una solicitud con **título, descripción, prioridad y fecha límite**.
2. El cliente recibe un **email automático** (vía Resend) con un enlace directo a la pestaña **Solicitudes** de su portal.
3. El cliente **sube los ficheros** desde el portal (máx. 7 MB); al subirlos, la solicitud se marca como completada y tú ves un badge de subida sin leer en tiempo real.

Extras:

- **Plantillas reutilizables** con variables (`{{cliente.businessName}}`) y **envío masivo** a 50+ clientes de una vez.
- **WhatsApp en un clic**: mensaje pre-redactado con el enlace al portal.
- **Mensajería contextual**: hilos asociados a cada solicitud, modelo u obligación.

## Factura desde email (OCR)

Reenvía la factura de un proveedor a la dirección de recepción del workspace del cliente
(`receipts@<slug-del-workspace>.frihet.io`). La IA extrae **proveedor, fecha, importe e impuestos**
por OCR (Gemini) y **genera automáticamente un borrador** de factura listo para revisar.

:::note
Es un flujo de captura proveedor→borrador, no un reenvío de facturas ya emitidas. Revisa siempre el borrador antes de contabilizarlo.
:::

## Exportar a A3, ContaPlus y otros

Frihet exporta la contabilidad de cada cliente en **6 formatos**, para que importes en el software que ya uses:

| Formato              | Uso típico                   |
| -------------------- | ---------------------------- |
| **A3 (Innuva)**      | Gestorías en España          |
| **ContaPlus** (Sage) | Contabilidad PYME en España  |
| **DATEV**            | Alemania                     |
| **Xero**             | Internacional                |
| **QuickBooks**       | Internacional                |
| **CSV genérico**     | Cualquier importador / Excel |

Lánzalo desde **Acciones rápidas** en la tarjeta del cliente, o desde dentro de su workspace.

:::info
También hay exportación **SAF-T** disponible. **¿Usas ContaSol?** No hay un formato propio "ContaSol", pero el export **ContaPlus** (fichero `xDiario.txt`) es **compatible con ContaSol** (y con Sage 50 y A3 vía intermediario) — usa ContaPlus para importar en ContaSol.
:::

## Validación IA y cola de presentación

- **Validación IA**: antes de generar el TXT AEAT, Frihet revisa errores en los modelos (reglas + Gemini).
- **Cola de presentación**: revisa y aprueba las declaraciones generadas en lote antes de enviarlas — flujo auditado.
- **Auto-detección fiscal**: Frihet detecta por workspace los modelos aplicables (M303 mensual/trimestral según umbral REDEME, M115 desde gastos de alquiler, M130 vs M131, etc.).

## Permisos y requisitos

- El Panel de gestoría requiere **plan Premium/Enterprise** (la funcionalidad `gestoria` está gateada por plan).
- El acceso a los datos de un cliente exige ser **contable o propietario activo** de ese workspace; cualquier otra cuenta es rechazada silenciosamente.
- **Invitar miembros** a un workspace requiere permiso de gestión de equipo (rol Administrador); ver y operar el panel de gestoría no requiere ser Administrador.
- El asesor invitado como contable **no ocupa un asiento de pago** del plan del cliente.

## Caveats

- Los datos consolidados (aging cross-cliente, obligaciones) solo incluyen los workspaces donde eres contable o propietario activo.
- El flujo de factura desde email genera **borradores**: requieren revisión humana antes de contabilizar.
- No existe un formato de exportación llamado "ContaSol" como tal; el export **ContaPlus** (`xDiario.txt`) es el camino compatible con ContaSol.
- La herramienta de **aging por MCP** está disponible vía API/callable; su exposición en el servidor MCP público se habilita en la siguiente publicación.

## Preguntas frecuentes

### ¿Cómo empiezo a gestionar un cliente en Frihet?

Tu cliente te invita desde su workspace en **Equipo → Invitar miembros** con el rol **Contable**. Al aceptar el email de invitación, el cliente aparece en tu Panel de gestoría.

### ¿El acceso del asesor cuesta un asiento?

No. Un asesor o contable invitado a un workspace **no consume un asiento de pago** del plan del cliente.

### ¿Puedo presentar el Modelo 303 de varios clientes a la vez?

Sí. Usa **Acciones → Declaraciones en lote**, selecciona modelos y trimestre y descarga un ZIP con M303, M130, M111 y M115 en PDF o TXT AEAT.

### ¿A qué formatos contables puedo exportar?

A A3 (Innuva), ContaPlus, DATEV, Xero, QuickBooks y CSV genérico (y SAF-T). Si trabajas con **ContaSol**, usa el export **ContaPlus** (`xDiario.txt`), que es compatible.

### ¿Cómo recibo las facturas de mis clientes?

Tus clientes las suben a su portal en respuesta a una solicitud de documentos, o reenvían facturas de proveedor a `receipts@<slug>.frihet.io`, donde la IA las convierte en borradores.

### ¿Qué necesito para usar el panel?

Plan Premium/Enterprise y ser contable o propietario de los workspaces que gestionas. (Invitar nuevos miembros requiere además permiso de Administrador en ese workspace.)

## Quick start

1. Ve a **Equipo → Panel gestoría** (requiere rol Administrador + plan Premium/Enterprise).
2. Los clientes aparecen ordenados por riesgo: los críticos primero.
3. Usa **Acciones → Declaraciones en lote** para seleccionar modelos y trimestre, luego descarga el ZIP.

## Reference

- API: `GET /v1/gestoria/clients`, `POST /v1/gestoria/batch-models`, `POST /v1/gestoria/aging` — ver [API reference](/desarrolladores/api-rest)
- Settings: Equipo → Permisos → Gestoría

## Related

- [Invitar miembros](./invitar-miembros)
- [Espacios de trabajo](./espacios-trabajo)
- [Modelos fiscales](/cumplimiento/modelos-fiscales)