Skip to main content

Toggl Track

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
  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)

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​

Anterior: Shopify