# Clockify

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

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

## ¿Para qué sirve?

Con Clockify integrado:

- **Importar horas** — Trae tus registros de tiempo a Frihet
- **Crear facturas automáticas** — Convierte tiempo en dinero
- **Por proyecto o cliente** — Agrupa como necesites
- **Tarifas flexibles** — Define precio/hora por cliente o proyecto

## Requisitos

- **Cuenta Clockify activa** — Con horas registradas
- **API Key de Clockify** — Para autenticar
- **Frihet Pro o superior**

## Obtener tu API Key de Clockify

### Paso 1: Abre Clockify

1. Ve a [app.clockify.me](https://app.clockify.me)
2. Inicia sesión
3. En la esquina superior derecha, haz clic en el **engranaje** (Configuración)

### Paso 2: Encuentra tu API Key

1. En **Settings**, ve a **Account**
2. Busca sección **"API"**
3. Verás tu **API Key** (un token largo)
4. Haz clic en **"Copy"** para copiar
5. **Guarda este token en lugar seguro** (no lo compartas)

## Conectar Clockify a Frihet

### Paso 1: Abre Frihet

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

### Paso 2: Ingresa API Key

1. Pega el token de Clockify
2. Haz clic en **Verificar conexión**
3. Si es correcto: "✅ Conectado"

### Paso 3: Configura proyectos

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

2. Establece **tarifa por defecto**:
   - Ejemplo: €55/hora
   - Cambiable por cliente después

3. Guarda

## Importar horas

### Importación manual

1. Ve a **Facturación** → **Importar desde Clockify**
2. Selecciona rango de fechas:
   - "Este mes"
   - "Últimas 2 semanas"
   - "Personalizado"
3. Elige proyectos
4. Haz clic en **"Importar"**
5. Se crean facturas en estado **"Borrador"**

### Sincronización automática

Si la activas:

1. Cada noche, Frihet importa automáticamente tus horas
2. Agrupa por cliente/proyecto
3. Crea borradores de factura
4. Confirmas cuando esté listo

## Ejemplo práctico

### En Clockify

```
Proyecto: Sitio Web
Cliente: Empresa ABC
- Lunes 3 feb: 6 horas (Desarrollo frontend)
- Miércoles 5 feb: 4 horas (Backend)
Total: 10 horas

Proyecto: Consultoría
Cliente: Juan Martínez
- Jueves 6 feb: 3 horas (Auditoría)
Total: 3 horas
```

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

**Factura #1001 - Empresa ABC**
```
Concepto: Desarrollo Sitio Web
- 6h (frontend) @ €55 = €330
- 4h (backend) @ €55 = €220
Subtotal: €550
IVA (21%): €115,50
Total: €665,50

Detalle:
- 3 feb: 6h Desarrollo frontend
- 5 feb: 4h Backend
```

**Factura #1002 - Juan Martínez**
```
Concepto: Auditoría Técnica
- 3h @ €55 = €165
Subtotal: €165
IVA (21%): €34,65
Total: €199,65

Detalle:
- 6 feb: 3h Auditoría
```

## Tarifas personalizadas

### Por cliente

1. Ve a **Clientes** → abre cliente
2. En **"Tarifa Clockify"**, ingresa tu tarifa
3. Próximas importaciones usan esa tarifa

**Ejemplo:**
```
Empresa ABC: €75/h (cliente importante)
Juan Martínez: €55/h (tarifa estándar)
```

### Por proyecto

Edita la factura antes de confirmar:

1. Se importa con tarifa por defecto
2. Cambias la tarifa manualmente
3. Se recalcula automáticamente

## Agrupar horas

### Por proyecto

Si tienes múltiples proyectos del mismo cliente:

1. Importas "Proyecto A" → Factura separada
2. Importas "Proyecto B" → Factura separada
3. O combinas ambas en una factura

### Por período

```
Semana 1 (1-7 feb) → Factura semanal
Semana 2 (8-14 feb) → Otra factura
```

O agrupar todo el mes en una factura grande.

## Descripción de tareas

Si usas **descripciones de tareas** en Clockify:

```
Clockify:
- 09:00-11:00 "Diseño mockups" (2h)
- 13:00-15:30 "Integración API" (2.5h)
```

Frihet importa:
```
Factura:
- Diseño mockups: 2h @ €55 = €110
- Integración API: 2.5h @ €55 = €137.50
Total: €247.50
```

Cada línea editable antes de confirmar.

## Mapeo de proyectos y clientes

### Automático

Clockify: "Cliente XYZ" → Frihet: Cliente "Cliente XYZ"

Si no existe, Frihet lo crea.

### Manual

Para mapear un proyecto a otro cliente:

1. **Ajustes** → **Integraciones** → **Clockify** → **Mapeo**
2. Para cada proyecto, asigna cliente Frihet
3. Guarda

**Ejemplo:**
```
Proyecto Clockify "App Q1"
→ Asignar a cliente Frihet "Startup Tech"
```

## Configurar sincronización automática

Si quieres que se importe automáticamente cada noche:

1. Ve a **Ajustes** → **Integraciones** → **Clockify**
2. Activa **"Sincronización automática"**
3. Elige hora de sincronización (recomendado: 11pm)
4. Guarda

Cada noche:
- Frihet importa tus horas
- Crea borradores de factura
- Tú confirmas cuando quieras

## Prueba la integración

### Test import

1. En Clockify, registra una entrada: "Test entry" (1h)
2. En Frihet, **Facturación** → **Importar desde Clockify**
3. Elige **"Últimas 24 horas"**
4. Haz clic en **"Importar"**
5. Deberías ver un borrador de factura

Si no funciona:

- Verifica que Clockify está conectado ✅
- Las horas deben estar en "completadas" (no en pausa)
- Espera 5 minutos
- Recarga Frihet (F5)

## Ediciones después de importar

La factura llega en estado **"Borrador"**. Puedes:

- ✏️ Editar concepto
- ✏️ Cambiar tarifa/hora
- ✏️ Agregar/quitar líneas
- ✏️ Cambiar cliente
- ✏️ Ajustar IVA

Los cambios en Clockify **no afectan** la factura de Frihet.

### Importar registros de tiempo

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

1. Conecta tu cuenta de Clockify
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.

## Comparación: Clockify vs Toggl

| Característica | Clockify | Toggl |
|---|---|---|
| **API** | Sí ✅ | Sí ✅ |
| **Tarifa/hora** | €55 recomendado | €60 recomendado |
| **Descripción tareas** | Sí | Sí |
| **Equipos** | Sí | Sí |
| **Costo** | Gratuito o €99/año | Gratuito o €108/año |

**Recomendación:** Usa la que ya tengas. Ambas funcionan igual de bien con Frihet.

## Límites

- **Máximo 90 días por importación** (para no sobrecargar)
- **Sin sincronización bidireccional** — Solo Clockify → Frihet
- **API Key válida indefinidamente** — Hasta que la revoques

## Troubleshooting

### "No conecta con Clockify"

- Verifica que el token es correcto (cópialo de nuevo)
- Confirma que tu cuenta Clockify está activa
- Intenta desconectar y reconectar

### "Veo horas en Clockify pero no en Frihet"

- Las horas deben estar "completadas", no en pausa
- Clockify actualiza datos cada 24h, Frihet sincroniza cada 15 minutos
- Recarga Frihet

### "¿Puedo cambiar de Toggl a Clockify?"

Sí. Los pasos:

1. Desconecta Toggl: **Ajustes** → **Integraciones** → **Toggl** → **Desconectar**
2. Conecta Clockify: **Ajustes** → **Integraciones** → **Clockify** → **Conectar**
3. Las facturas ya creadas quedan igual

### "¿Importo histórico de 6 meses?"

Sí, pero en múltiples importaciones:

1. Importa 3 meses (ej: enero-marzo)
2. Confirma las facturas
3. Importa otros 3 meses
4. Así no se mezcla el histórico

## Próximos pasos

- [Automatiza con n8n](./n8n)
- [Conecta tu banco para reconciliación](./revolut)

---

**Anterior:** [Toggl Track](./toggl)