# Toggl Track

:::tip Disponible
Esta integración está activa y lista para usar en todos los planes Pro.
:::

Conecta Toggl Track a Frihet. Importa tus horas registradas y convierte tiempo en facturas.

## ¿Para qué sirve?

Con Toggl integrado:

- **Importar horas** — Traes tus registros de tiempo a Frihet
- **Crear facturas desde horas** — Convierte horas en facturas por cliente
- **Tarifa configurable** — Define precio/hora por cliente
- **Proyectos y tareas** — Agrupa por proyecto para facturas detalladas

## Requisitos

- **Cuenta Toggl Track activa** — Necesitas tener registrado tiempo
- **API Key de Toggl** — Para conectar
- **Frihet Pro o superior**

## Obtener tu API Key de Toggl

### Paso 1: Abre Toggl

1. Ve a [track.toggl.com](https://track.toggl.com)
2. Inicia sesión
3. En la esquina inferior izquierda, haz clic en tu nombre
4. Selecciona **Configuración** (engranaje)

### Paso 2: Encuentra tu API Key

1. En **Configuración**, ve a **API Token**
2. Verás un token largo (ej: `a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6`)
3. **Cópialo** (importante: guárdalo seguro, no lo compartas)

## Conectar Toggl a Frihet

### Paso 1: Abre Frihet

1. Ve a **Ajustes** → **Integraciones**
2. Busca **Toggl Track**
3. Haz clic en **Conectar**

### Paso 2: Ingresa tu API Key

1. Pega el token de Toggl
2. Haz clic en **Verificar conexión**
3. Si es correcto, verás "✅ Conectado"

### Paso 3: Configura la sincronización

1. Elige **qué proyectos sincronizar**:
   - Todos los proyectos ✅
   - Solo proyectos específicos ⚪

2. Define **tarifa por defecto**:
   - Ejemplo: €60/hora
   - Puedes cambiarla por cliente después

3. Guarda

## Importar horas registradas

### Opción 1: Importación manual

1. En Frihet, ve a **Facturación** → **Importar desde Toggl**
2. Elige rango de fechas:
   - "Este mes"
   - "Últimos 7 días"
   - "Fechas personalizadas"
3. Selecciona qué proyectos importar
4. Haz clic en **"Importar"**
5. Se crean **borradores de factura** (puedes revisar antes de guardar)

### Opción 2: Sincronización automática

Si lo activas en Ajustes:

1. Cada día, Frihet importa automáticamente tus horas de Toggl
2. Las agrupa por cliente
3. Crea borradores de factura
4. Tú las revises y confirmes

## Ejemplo: Convertir horas a factura

### En Toggl

```
Proyecto: Diseño Web - Cliente XYZ
- Lunes 3 feb: 5 horas (Diseño UI)
- Miércoles 5 feb: 3 horas (Desarrollo)
- Total: 8 horas

Proyecto: Consultoría - Juan García
- Jueves 6 feb: 2 horas (Reunión)
- Total: 2 horas
```

### En Frihet (después de importar)

**Factura #1 - Cliente XYZ**
```
Concepto: Diseño Web
- 5 horas @ €60 = €300
- 3 horas @ €60 = €180
Total: €480

Desglose:
- 3 feb: 5h Diseño UI
- 5 feb: 3h Desarrollo
```

**Factura #2 - Juan García**
```
Concepto: Consultoría
- 2 horas @ €60 = €120

Desglose:
- 6 feb: 2h Reunión
```

## Tarifas personalizadas por cliente

Por defecto, todos usan la tarifa de €60/h. Puedes cambiar:

### Opción 1: Editar en la factura

1. Se crea la factura
2. Antes de confirmar, cambias la tarifa manualmente
3. Las horas se recalculan automáticamente

### Opción 2: Tarifa fija por cliente

1. Ve a **Clientes** → abre un cliente
2. En **"Tarifa Toggl"**, ingresa €80/hora
3. La próxima importación usa esa tarifa para ese cliente

## Desglose detallado de tareas

Si en Toggl usas **descripción de tareas**, Frihet las incluye:

```
En Toggl:
- 10:00-12:00 "Reunión con cliente" (2h)
- 14:00-16:30 "Correcciones de diseño" (2.5h)
```

En Frihet aparece como:
```
Factura:
- Reunión con cliente: 2h @ €60 = €120
- Correcciones de diseño: 2.5h @ €60 = €150
Total: €270
```

Puedes editar cada línea antes de confirmar.

## Proyectos y clientes

### Mapeo automático

Frihet intenta mapear:

```
Proyecto Toggl "Cliente A"
→ Cliente Frihet "Cliente A"

Si el cliente no existe:
→ Frihet lo crea automáticamente
```

### Mapeo manual

Si quieres que un proyecto Toggl vaya a otro cliente:

1. Ve a **Ajustes** → **Toggl** → **Mapeo de proyectos**
2. Para cada proyecto, elige cliente Frihet
3. Guarda

**Ejemplo:**
```
Proyecto Toggl "Diseño Q1"
→ Asignar a cliente Frihet "Empresa SL"
```

## Prueba la integración

### Test import

1. En Toggl, registra una hora: "Tarea de prueba" (1 hora)
2. En Frihet, ve a **Facturación** → **Importar desde Toggl**
3. Elige **"Últimas 24 horas"**
4. Haz clic en **"Importar"**
5. Deberías ver una factura borrador

Si no aparece:

- Verifica que Toggl está conectado ✅
- Las horas tienen que ser de hoy o ayer (Toggl puede estar en UTC)
- Recarga Frihet (F5)

### Importar registros de tiempo

Frihet puede convertir tus registros de tiempo en lineas de factura automaticamente:

1. Conecta tu cuenta de Toggl
2. Ve a la pestaña **Datos** de la integracion
3. Haz clic en **Importar registros de tiempo**
4. Introduce tu tarifa por hora
5. Frihet agrupa las entradas por proyecto y crea un borrador de factura

Las entradas se agrupan por proyecto, sumando las horas totales y aplicando la tarifa indicada.

## Cosas que puedes hacer

### Agrupar por proyecto

Importas un proyecto completo del mes:

```
Proyecto "App iOS":
- Semana 1: 20 horas
- Semana 2: 25 horas
Total: 45 horas @ €70/h = €3.150
```

Creas una factura única: "Desarrollo App iOS - Febrero 2025"

### Facturar por sprint

Si trabajas en sprints:

1. En Toggl, cada sprint en un proyecto separado
2. Cada mes, importas y creas factura por sprint
3. Desglose claro para el cliente

### Tarifas por tipo de trabajo

```
Toggl: Tag "Diseño" → €80/h
Toggl: Tag "Desarrollo" → €100/h
Toggl: Tag "Consultoría" → €60/h
```

Puedes mapear estas tarifas diferentes en Frihet.

## Sincronización en tiempo real

El trabajo que registres en Toggl **hoy**:

- Aparecerá disponible para importar en Frihet **mañana**
- Si activas sincronización automática, se importa automáticamente

Toggl envía datos una vez al día (normalmente a las 3am UTC).

## Editar después de importar

Después de importar las horas:

1. La factura está en estado **"Borrador"**
2. Puedes editar:
   - Concepto
   - Tarifa por hora
   - Agregar/quitar líneas
   - Cambiar cliente
3. Cuando esté bien, confirma la factura

Las horas originales en Toggl **no se afectan** — puedes editar la factura libremente.

## Eliminar una importación

Si importaste por error:

1. Busca la factura en **Facturación** → **Facturas**
2. Si aún es **"Borrador"**, puedes **Eliminar**
3. Las horas en Toggl siguen ahí, sin cambios

Si ya la confirmaste como factura, puedes:
- Marcarla como "Cancelada"
- O crear una nota de crédito

## Límites y restricciones

- **Máximo 90 días de historial** en una importación
- **10 importaciones simultáneas** (no debería afectarte)
- **Sin sincronización de eliminaciones** — Si borras una hora en Toggl, la factura en Frihet permanece

## Troubleshooting

### "No veo mis horas en Toggl"

- Verifica que está conectado ✅
- Las horas deben estar registradas (no borradores)
- Espera 24h después de registrar en Toggl

### "¿Puedo cambiar la tarifa después de facturar?"

Sí. Edita la factura:

1. **Facturación** → abre la factura
2. Cambia tarifa por hora
3. Se recalcula automáticamente
4. Guarda cambios

### "¿Qué pasa si cambio la API Key?"

Desconecta y reconecta:

1. **Ajustes** → **Integraciones** → **Toggl**
2. **Desconectar**
3. Ingresa nueva API Key
4. **Conectar**

Las facturas ya creadas quedan igual.

## Próximos pasos

- [Usa Clockify como alternativa a Toggl](./clockify)
- [Automatiza facturas con n8n](./n8n)

---

**Anterior:** [Shopify](./shopify)