Pular para o conteúdo principal

Toggl Track

Disponível

Esta integração está ativa e pronta para usar em todos os planos Pro.

Conecte o Toggl Track ao Frihet. Importe suas horas registradas e converta tempo em faturas.

Para que serve?​

Com o Toggl integrado:

  • Importar horas — Traga seus registros de tempo para o Frihet
  • Criar faturas a partir de horas — Converta horas em faturas por cliente
  • Tarifa configurável — Defina preço/hora por cliente
  • Projetos e tarefas — Agrupe por projeto para faturas detalhadas

Requisitos​

  • Conta Toggl Track ativa — Você precisa ter tempo registrado
  • Chave de API do Toggl — Para conectar
  • Frihet Pro ou superior

Obter sua Chave de API do Toggl​

Passo 1: Abra o Toggl​

  1. Vá para track.toggl.com
  2. Faça login
  3. No canto inferior esquerdo, clique no seu nome
  4. Selecione Configurações (engrenagem)

Passo 2: Encontre sua Chave de API​

  1. Em Configurações, vá para API Token
  2. Você verá um token longo (ex: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6)
  3. Copie-o (importante: guarde-o em segurança, não o compartilhe)

Conectar Toggl ao Frihet​

Passo 1: Abra o Frihet​

  1. Vá para Configurações → Integrações
  2. Procure por Toggl Track
  3. Clique em Conectar

Passo 2: Insira sua Chave de API​

  1. Cole o token do Toggl
  2. Clique em Verificar conexão
  3. Se estiver correto, você verá "✅ Conectado"

Passo 3: Configure a sincronização​

  1. Escolha quais projetos sincronizar:

    • Todos os projetos ✅
    • Apenas projetos específicos ⚪

  2. Defina a tarifa padrão:

    • Exemplo: €60/hora
    • Você pode alterá-la por cliente depois

  3. Salve

Importar horas registradas​

Opção 1: Importação manual​

  1. No Frihet, vá para Faturamento → Importar do Toggl
  2. Escolha o período:
    • "Este mês"
    • "Últimos 7 dias"
    • "Datas personalizadas"
  3. Selecione quais projetos importar
  4. Clique em "Importar"
  5. São criados rascunhos de fatura (você pode revisar antes de salvar)

Opção 2: Sincronização automática​

Se você ativar em Configurações:

  1. A cada dia, o Frihet importa automaticamente suas horas do Toggl
  2. As agrupa por cliente
  3. Cria rascunhos de fatura
  4. Você as revisa e confirma

Exemplo: Converter horas em fatura​

No Toggl​

Projeto: Design Web - Cliente XYZ
- Segunda-feira 3 fev: 5 horas (Design UI)
- Quarta-feira 5 fev: 3 horas (Desenvolvimento)
- Total: 8 horas

Projeto: Consultoria - Juan García
- Quinta-feira 6 fev: 2 horas (Reunião)
- Total: 2 horas

No Frihet (após importar)​

Fatura #1 - Cliente XYZ

Conceito: Design Web
- 5 horas @ €60 = €300
- 3 horas @ €60 = €180
Total: €480

Detalhes:
- 3 fev: 5h Design UI
- 5 fev: 3h Desenvolvimento

Fatura #2 - Juan García

Conceito: Consultoria
- 2 horas @ €60 = €120

Detalhes:
- 6 fev: 2h Reunião

Tarifas personalizadas por cliente​

Por padrão, todos usam a tarifa de €60/h. Você pode alterar:

Opção 1: Editar na fatura​

  1. A fatura é criada
  2. Antes de confirmar, você altera a tarifa manualmente
  3. As horas são recalculadas automaticamente

Opção 2: Tarifa fixa por cliente​

  1. Vá para Clientes → abra um cliente
  2. Em "Tarifa Toggl", insira €80/hora
  3. A próxima importação usará essa tarifa para esse cliente

Detalhamento detalhado de tarefas​

Se no Toggl você usa descrição de tarefas, o Frihet as inclui:

No Toggl:
- 10:00-12:00 "Reunião com cliente" (2h)
- 14:00-16:30 "Correções de design" (2.5h)

No Frihet aparece como:

Fatura:
- Reunião com cliente: 2h @ €60 = €120
- Correções de design: 2.5h @ €60 = €150
Total: €270

Você pode editar cada linha antes de confirmar.

Projetos e clientes​

Mapeamento automático​

O Frihet tenta mapear:

Projeto Toggl "Cliente A"
→ Cliente Frihet "Cliente A"

Se o cliente não existe:
→ O Frihet o cria automaticamente

Mapeamento manual​

Se você quiser que um projeto do Toggl vá para outro cliente:

  1. Vá para Configurações → Toggl → Mapeamento de projetos
  2. Para cada projeto, escolha o cliente Frihet
  3. Salve

Exemplo:

Projeto Toggl "Design Q1"
→ Atribuir ao cliente Frihet "Empresa SL"

Teste a integração​

Importação de teste​

  1. No Toggl, registre uma hora: "Tarefa de teste" (1 hora)
  2. No Frihet, vá para Faturamento → Importar do Toggl
  3. Escolha "Últimas 24 horas"
  4. Clique em "Importar"
  5. Você deverá ver um rascunho de fatura

Se não aparecer:

  • Verifique se o Toggl está conectado ✅
  • As horas devem estar registradas (não rascunhos)
  • Recarregue o Frihet (F5)

Importar registros de tempo​

O Frihet pode converter seus registros de tempo em linhas de fatura automaticamente:

  1. Conecte sua conta do Toggl
  2. Vá para a aba Dados da integração
  3. Clique em Importar registros de tempo
  4. Insira sua tarifa por hora
  5. O Frihet agrupa as entradas por projeto e cria um rascunho de fatura

As entradas são agrupadas por projeto, somando as horas totais e aplicando a tarifa indicada.

Coisas que você pode fazer​

Agrupar por projeto​

Importe um projeto completo do mês:

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

Crie uma fatura única: "Desenvolvimento App iOS - Fevereiro 2025"

Faturar por sprint​

Se você trabalha em sprints:

  1. No Toggl, cada sprint em um projeto separado
  2. A cada mês, importe e crie a fatura por sprint
  3. Detalhamento claro para o cliente

Tarifas por tipo de trabalho​

Toggl: Tag "Design" → €80/h
Toggl: Tag "Desenvolvimento" → €100/h
Toggl: Tag "Consultoria" → €60/h

Você pode mapear essas tarifas diferentes no Frihet.

Sincronização em tempo real​

O trabalho que você registrar no Toggl hoje:

  • Aparecerá disponível para importação no Frihet amanhã
  • Se você ativar a sincronização automática, será importado automaticamente

O Toggl envia dados uma vez ao dia (normalmente às 3h UTC).

Editar após importar​

Após importar as horas:

  1. A fatura está no status "Rascunho"
  2. Você pode editar:
    • Conceito
    • Tarifa por hora
    • Adicionar/remover linhas
    • Mudar cliente
  3. Quando estiver correto, confirme a fatura

As horas originais no Toggl não são afetadas — você pode editar a fatura livremente.

Excluir uma importação​

Se você importou por engano:

  1. Procure a fatura em Faturamento → Faturas
  2. Se ainda for "Rascunho", você pode Excluir
  3. As horas no Toggl continuam lá, sem alterações

Se você já a confirmou como fatura, pode:

  • Marcá-la como "Cancelada"
  • Ou criar uma nota de crédito

Limites e restrições​

  • Máximo 90 dias de histórico em uma importação
  • 10 importações simultâneas (não deve afetá-lo)
  • Sem sincronização de exclusões — Se você apagar uma hora no Toggl, a fatura no Frihet permanece

Solução de problemas​

"Não vejo minhas horas no Toggl"​

  • Verifique se o Toggl está conectado ✅
  • As horas devem estar registradas (não rascunhos)
  • Espere 24h após registrar no Toggl

"Posso alterar a tarifa após faturar?"​

Sim. Edite a fatura:

  1. Faturamento → abra a fatura
  2. Altere a tarifa por hora
  3. É recalculado automaticamente
  4. Salve as alterações

"O que acontece se eu mudar a Chave de API?"​

Desconecte e reconecte:

  1. Configurações → Integrações → Toggl
  2. Desconectar
  3. Insira a nova Chave de API
  4. Conectar

As faturas já criadas permanecem iguais.

Próximos passos​

Anterior: Shopify​