# Google Sheets

:::tip Disponible
Esta integración está activa y lista para usar en Frihet.
:::

Exporta tus facturas, gastos y resumen fiscal a hojas de cálculo profesionales en Google Sheets. Comparte informes con tu gestoría con un enlace. Importa datos desde cualquier spreadsheet con detección automática de columnas.

## ¿Para qué sirve?

Con Google Sheets integrado:

- **Exportar facturas** — Libro de facturas con formato profesional, fórmulas y totales
- **Exportar gastos** — Registro de gastos con categorías y resumen por categoría
- **Resumen fiscal** — Resumen trimestral listo para compartir con tu contable
- **Importar datos** — Lee cualquier hoja de cálculo (facturas, gastos, clientes, productos)
- **Detección automática** — Reconoce columnas en español e inglés con coincidencia difusa
- **Control de duplicados** — Detecta registros duplicados antes de importar

## Requisitos

- **Cuenta Google** — Gmail, Google Workspace o Google One
- **Frihet Pro o superior**
- **Google Sheets API habilitada** en Google Cloud Console (la configura el administrador)

:::info Sin credenciales que introducir
Esta integración usa OAuth con Google. No necesitas copiar ninguna API key o token. Simplemente autorizas a Frihet a acceder a Google Sheets mediante una ventana de inicio de sesión de Google.
:::

## Conectar Google Sheets con Frihet

### Paso 1: Iniciar la conexión

1. Ve a **Ajustes** → **Integraciones**
2. Busca **Google Sheets**
3. Haz clic en **Conectar con Google**

### Paso 2: Autorizar en Google

1. Se abrirá la ventana de inicio de sesión de Google
2. Selecciona tu cuenta de Google
3. Revisa los permisos solicitados:
   - Crear y editar hojas de cálculo en Google Sheets
   - Ver y gestionar archivos creados por la aplicación en Google Drive
4. Haz clic en **Permitir**

### Paso 3: Verificar conexión

1. De vuelta en Frihet, verás "Conectado" junto a Google Sheets
2. Las acciones de exportar e importar estarán disponibles
3. La integración está lista para usar

## Cómo funciona

Frihet usa la **API de Google Sheets v4** con flujo de autorización OAuth 2.0:

1. Haces clic en "Conectar con Google" y autorizas en la ventana de Google
2. Google genera tokens de acceso y refresco
3. Frihet almacena ambos tokens cifrados (AES-256-GCM)
4. Con el token de acceso, Frihet puede crear hojas de cálculo y leer las existentes
5. El token se refresca automáticamente cuando expira
6. En ningún momento introduces credenciales de Google en Frihet

## Datos sincronizados

| Dato                    | Dirección              | Frecuencia   |
| ----------------------- | ---------------------- | ------------ |
| Exportar facturas       | Frihet → Google Sheets | Bajo demanda |
| Exportar gastos         | Frihet → Google Sheets | Bajo demanda |
| Exportar resumen fiscal | Frihet → Google Sheets | Bajo demanda |
| Importar datos          | Google Sheets → Frihet | Bajo demanda |

## Exportar a Google Sheets

### Exportar facturas

Crea un libro de cálculo profesional con 3 hojas:

**Hoja 1: Facturas**

| Columna        | Descripción                         |
| -------------- | ----------------------------------- |
| N. Factura     | Número de factura                   |
| Cliente        | Nombre del cliente                  |
| NIF            | NIF/CIF del cliente                 |
| Fecha          | Fecha de emisión                    |
| Vencimiento    | Fecha de vencimiento                |
| Base Imponible | Subtotal sin impuestos              |
| IVA %          | Tipo de IVA aplicado                |
| IVA            | Importe de IVA                      |
| IRPF %         | Retención de IRPF                   |
| IRPF           | Importe de IRPF                     |
| Total          | Importe total                       |
| Estado         | Borrador, enviada, cobrada, vencida |

Incluye:

- Fila de totales con fórmulas `SUM()`
- Formato de moneda EUR
- Formato condicional: cobrada (verde), vencida (rojo), borrador (gris)
- Filtro automático en todas las columnas
- Cabecera fija (frozen)

**Hoja 2: Resumen Fiscal**

Desglose por trimestres (Q1-Q4):

- Base imponible por trimestre
- IVA repercutido
- IRPF retenido
- Totales anuales

**Hoja 3: Detalle de Líneas**

Una fila por línea de factura (expandida):

- N. Factura, Descripción, Cantidad, Precio Unitario, Subtotal, IVA

### Exportar gastos

Crea un libro de cálculo con 2 hojas:

**Hoja 1: Gastos**

- N. Factura, Proveedor, Fecha, Descripción, Categoría, Base, IVA, IRPF, Total, Tipo IVA
- Formato condicional por categoría
- Filtro automático y fila de totales

**Hoja 2: Resumen por Categoría**

- Desglose de gastos por categoría con totales

### Exportar resumen fiscal

Crea un libro de cálculo completo para tu contable con 3 hojas:

- Resumen fiscal (ingresos + gastos + estimación M303)
- Facturas emitidas
- Facturas recibidas (gastos)

### Cómo exportar

1. Ve a **Ajustes** → **Integraciones** → **Google Sheets**
2. En la pestaña **Datos**, elige la acción de exportación
3. Frihet crea la hoja de cálculo en tu Google Drive
4. Se abre automáticamente en una nueva pestaña
5. El enlace se copia al portapapeles para compartir

## Importar desde Google Sheets

### Tipos de datos soportados

| Tipo      | Columnas detectadas automáticamente                    |
| --------- | ------------------------------------------------------ |
| Facturas  | factura, cliente, NIF, fecha, total, IVA, estado       |
| Gastos    | proveedor, fecha, descripción, categoría, importe, IVA |
| Clientes  | nombre, NIF, email, teléfono, dirección                |
| Productos | nombre, descripción, precio, IVA                       |

### Detección automática de columnas

Frihet reconoce cabeceras en español e inglés con coincidencia difusa. Ejemplos:

| Frihet espera | Cabeceras reconocidas                           |
| ------------- | ----------------------------------------------- |
| Fecha         | fecha, date, fecha emisión, issue date          |
| Cliente       | cliente, client, customer, nombre, razón social |
| NIF           | nif, cif, tax id, vat, dni                      |
| Total         | total, importe, amount, monto                   |

Si no se detecta automáticamente, puedes ajustar el mapeo manualmente.

### Flujo de importación

1. **Seleccionar hoja** — Elige una de tus hojas de cálculo de Google Drive o pega una URL
2. **Seleccionar pestaña** — Si la hoja tiene varias pestañas, elige la correcta
3. **Mapeo de columnas** — Frihet detecta automáticamente el tipo de datos y las columnas. Puedes ajustar
4. **Vista previa** — Revisa los datos parseados con avisos de validación
5. **Importar** — Los registros se crean en Frihet

### Detección de duplicados

Antes de importar, Frihet compara los datos con tus registros existentes:

- Compara por número de factura o documento
- Muestra avisos para posibles duplicados
- Puedes omitir duplicados o sobrescribir

## Casos de uso

### Compartir con la gestoría

Exportas el resumen fiscal trimestral a Google Sheets. Compartes el enlace con tu gestoría. Tienen acceso instantáneo a facturas, gastos y estimaciones fiscales en un formato que conocen.

### Migrar desde otro sistema

Tienes tus facturas en un Excel exportado de Billin o cualquier otro programa. Lo subes a Google Sheets, conectas con Frihet, y el importador reconoce las columnas automáticamente. En minutos tienes todos tus datos en Frihet.

### Análisis personalizado

Exportas tus datos a Google Sheets y creas gráficos, tablas dinámicas o fórmulas personalizadas que no están (todavía) en Frihet. Lo mejor de ambos mundos.

## Solución de problemas

### "Error al conectar con Google"

- Verifica que tu cuenta de Google está activa
- Si usas Google Workspace corporativo, tu administrador puede haber restringido las aplicaciones de terceros
- Comprueba que no tienes bloqueadores de ventanas emergentes

### "No se exportaron datos"

- Verifica que tienes facturas o gastos creados en Frihet
- Comprueba que la sesión de Google no ha expirado
- Si el error persiste, desconecta y reconecta Google Sheets

### "No veo mis hojas de cálculo al importar"

- Solo se listan hojas de cálculo de Google Sheets (no Excel ni CSV)
- Verifica que la hoja está en tu Google Drive (no solo compartida)
- Para hojas compartidas, primero añádelas a "Mi unidad"

### "El importador no detecta las columnas"

- Verifica que la primera fila contiene los nombres de columna (cabeceras)
- Las cabeceras deben estar en la fila 1 de la hoja
- Prueba con cabeceras más descriptivas (ej: "Fecha" en vez de "F")
- Puedes ajustar el mapeo manualmente si la detección automática falla

### "La sesión ha expirado"

- Google puede solicitar re-autorización periódicamente
- Ve a **Ajustes** → **Integraciones** → **Google Sheets** y haz clic en **Reconectar**

### "Quiero desconectar"

1. Ve a **Ajustes** → **Integraciones** → **Google Sheets**
2. Haz clic en **Desconectar**
3. Los tokens se eliminan de Frihet
4. Opcionalmente, revoca el acceso en [myaccount.google.com/permissions](https://myaccount.google.com/permissions)

:::tip Integraciones programaticas
Para exportaciones automatizadas o integraciones a medida, consulta la [API REST](/desarrolladores/api-rest) y los [webhooks](/desarrolladores/webhooks) de Frihet. Puedes disparar exportaciones cuando se crea una factura o sincronizar datos con scripts propios.
:::

## Proximos pasos

- [Conecta Google Drive para gestionar archivos](./google-drive)
- [Conecta Google Calendar para vencimientos](./google-calendar)
- [Automatiza exportaciones con n8n](./n8n)
- [Consulta la API REST para acceso programatico](../desarrolladores/api-rest)