# Notion

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

Conecta tu workspace de Notion a Frihet. Busca páginas, consulta bases de datos y accede a información de proyectos y clientes directamente desde tu ERP sin cambiar de aplicación.

## ¿Para qué sirve?

Con Notion integrado:

- **Buscar páginas** — Encuentra cualquier página de tu workspace desde Frihet
- **Listar bases de datos** — Ve todas tus bases de datos de Notion
- **Consultar registros** — Haz queries a bases de datos con filtros
- **Contexto de proyecto** — Accede a información de proyectos vinculados a facturas
- **Documentación accesible** — Consulta SOPs, contratos o briefs sin salir del ERP

## Requisitos

- **Cuenta Notion activa** — [notion.so](https://www.notion.so)
- **Internal Integration Token** — Se crea desde la configuración de integraciones de Notion
- **Frihet Pro o superior**

## Conectar Notion con Frihet

### Paso 1: Crear una integración interna en Notion

1. Ve a [notion.so/my-integrations](https://www.notion.so/my-integrations)
2. Inicia sesión con tu cuenta de Notion
3. Haz clic en **New integration**
4. Configura la integración:
   - **Name**: "Frihet ERP"
   - **Associated workspace**: Selecciona tu workspace
   - **Capabilities**: Marca al menos "Read content" y "Read user information"
5. Haz clic en **Submit**
6. Copia el **Internal Integration Token** (empieza por `ntn_...`)

:::caution Guarda el token
El token se puede consultar después, pero cópialo ahora para no tener que volver.
:::

### Paso 2: Compartir páginas con la integración

Notion requiere que compartas explícitamente las páginas o bases de datos con tu integración:

1. Abre la página o base de datos que quieres que Frihet pueda ver
2. Haz clic en **...** (menú de la página) → **Connections**
3. Busca **"Frihet ERP"** (el nombre de tu integración)
4. Haz clic para añadirla
5. Repite para cada página o base de datos que necesites

:::info Solo lo que compartas
La integración solo puede acceder a las páginas y bases de datos que compartas explícitamente. No tiene acceso a todo tu workspace.
:::

### Paso 3: Configurar en Frihet

1. Ve a **Ajustes** → **Integraciones**
2. Busca **Notion**
3. Haz clic en **Conectar**
4. Pega tu **Internal Integration Token** (`ntn_...`)
5. Haz clic en **Verificar conexión**
6. Si es correcto, verás el nombre de tu workspace

## Cómo funciona

Frihet usa la **API de Notion** (versión 2022-06-28):

1. Proporcionas tu Internal Integration Token
2. Frihet envía el token en la cabecera `Authorization: Bearer ntn_...`
3. Además, incluye la cabecera `Notion-Version: 2022-06-28` en cada petición
4. Las búsquedas y consultas se realizan bajo demanda
5. El token se almacena cifrado (AES-256-GCM) en Frihet

## Datos sincronizados

| Dato | Dirección | Frecuencia |
|------|-----------|------------|
| Páginas (búsqueda) | Notion → Frihet | Bajo demanda |
| Bases de datos (listado) | Notion → Frihet | Bajo demanda |
| Registros de base de datos | Notion → Frihet | Bajo demanda (query) |
| Propiedades de página | Notion → Frihet | Con cada consulta |

## Funcionalidades

### Buscar páginas

Busca cualquier página compartida con la integración por título o contenido:

1. Desde Frihet, usa la función de búsqueda de Notion
2. Escribe el término de búsqueda
3. Frihet devuelve las páginas que coincidan
4. Haz clic en un resultado para ver los detalles o abrir en Notion

### Listar bases de datos

Ve todas las bases de datos compartidas con la integración:

1. Frihet consulta todas las bases de datos accesibles
2. Muestra nombre, descripción y número de registros
3. Selecciona una para consultar sus registros

### Consultar bases de datos

Haz queries a una base de datos con filtros:

1. Selecciona la base de datos
2. Aplica filtros (por propiedad, estado, fecha, etc.)
3. Frihet muestra los registros que coincidan
4. Útil para consultar, por ejemplo, una base de datos de clientes o proyectos

### Importar contactos

Puedes importar contactos desde cualquier base de datos de Notion:

1. Conecta tu cuenta de Notion
2. Selecciona la base de datos que contiene tus contactos
3. Frihet detecta automaticamente los campos: nombre, email, direccion e identificacion fiscal
4. Los contactos se importan como clientes en Frihet
5. Los duplicados se detectan por nombre (no se importan dos veces)

Frihet busca campos con nombres como "Name", "Email", "Address", "Tax ID", "NIF" tanto en ingles como en español.

## Casos de uso

### Base de datos de clientes en Notion

Mantienes una base de datos de clientes en Notion con campos como empresa, contacto y notas. Desde Frihet, consultas esa base de datos para obtener contexto al crear una factura.

### Documentación de proyectos

Tienes la documentación de cada proyecto en Notion (briefs, contratos, alcance). Al facturar un proyecto, consultas la página de Notion directamente desde Frihet para verificar el alcance acordado.

### CRM ligero

Usas Notion como CRM informal con una base de datos de deals. Desde Frihet, consultas el estado de cada deal para saber cuándo es momento de enviar una factura.

## Solución de problemas

### "Error de autenticación"

- Verifica que el token es correcto y empieza por `ntn_`
- Comprueba que la integración no ha sido desactivada en Notion
- Si regeneraste el token, actualízalo en Frihet

### "No encuentro mis páginas"

- La integración solo ve las páginas que compartes explícitamente con ella
- Abre la página en Notion → **...** → **Connections** → Añade tu integración
- Las páginas hijo de una página compartida son accesibles automáticamente

### "No puedo acceder a una base de datos"

- Comparte la base de datos con la integración (mismo proceso que con páginas)
- Verifica que la integración tiene capability "Read content" activada

### "Los datos están desactualizados"

- Las consultas a Notion son en tiempo real (bajo demanda)
- Si no ves cambios recientes, recarga la vista en Frihet
- Notion puede tardar unos segundos en reflejar cambios muy recientes

### "Quiero desconectar"

1. Ve a **Ajustes** → **Integraciones** → **Notion**
2. Haz clic en **Desconectar**
3. Opcionalmente, desactiva o elimina la integración en [notion.so/my-integrations](https://www.notion.so/my-integrations)

## Próximos pasos

- [Conecta Trello para gestión de proyectos](./trello)
- [Conecta Asana para tareas y proyectos](./asana)
- [Automatiza con n8n](./n8n)