Pular para o conteúdo principal

Clockify

Disponível

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

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

Para que serve?​

Com o Clockify integrado:

  • Importar horas — Traga seus registros de tempo para o Frihet
  • Criar faturas automáticas — Converta tempo em dinheiro
  • Por projeto ou cliente — Agrupe como precisar
  • Tarifas flexíveis — Defina preço/hora por cliente ou projeto

Requisitos​

  • Conta Clockify ativa — Com horas registradas
  • Chave de API do Clockify — Para autenticar
  • Frihet Pro ou superior

Obter sua Chave de API do Clockify​

Passo 1: Abra o Clockify​

  1. Vá para app.clockify.me
  2. Faça login
  3. No canto superior direito, clique na engrenagem (Configurações)

Passo 2: Encontre sua Chave de API​

  1. Em Settings, vá para Account
  2. Procure a seção "API"
  3. Você verá sua Chave de API (um token longo)
  4. Clique em "Copy" para copiar
  5. Guarde este token em um local seguro (não o compartilhe)

Conectar Clockify ao Frihet​

Passo 1: Abra o Frihet​

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

Passo 2: Insira a Chave de API​

  1. Cole o token do Clockify
  2. Clique em Verificar conexão
  3. Se estiver correto: "✅ Conectado"

Passo 3: Configure projetos​

  1. Escolha quais projetos importar:

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

  2. Estabeleça tarifa padrão:

    • Exemplo: €55/hora
    • Alterável por cliente depois

  3. Salvar

Importar horas​

Importação manual​

  1. Vá para Faturamento → Importar do Clockify
  2. Selecione o período:
    • "Este mês"
    • "Últimas 2 semanas"
    • "Personalizado"
  3. Escolha projetos
  4. Clique em "Importar"
  5. São criadas faturas no status "Rascunho"

Sincronização automática​

Se você a ativar:

  1. Toda noite, o Frihet importa automaticamente suas horas
  2. Agrupa por cliente/projeto
  3. Cria rascunhos de fatura
  4. Você confirma quando estiver pronto

Exemplo prático​

No Clockify​

Projeto: 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

No Frihet (após importar)​

Fatura #1001 - Empresa ABC

Conceito: Desenvolvimento de Site
- 6h (frontend) @ €55 = €330
- 4h (backend) @ €55 = €220
Subtotal: €550
IVA (21%): €115,50
Total: €665,50

Detalhe:
- 3 feb: 6h Desenvolvimento frontend
- 5 feb: 4h Backend

Fatura #1002 - Juan Martínez

Conceito: Auditoria Técnica
- 3h @ €55 = €165
Subtotal: €165
IVA (21%): €34,65
Total: €199,65

Detalhe:
- 6 feb: 3h Auditoría

Tarifas personalizadas​

Por cliente​

  1. Vá para Clientes → abra o cliente
  2. Em "Tarifa Clockify", insira sua tarifa
  3. Próximas importações usarão essa tarifa

Exemplo:

Empresa ABC: €75/h (cliente importante)
Juan Martínez: €55/h (tarifa padrão)

Por projeto​

Edite a fatura antes de confirmar:

  1. É importada com tarifa padrão
  2. Você altera a tarifa manualmente
  3. É recalculada automaticamente

Agrupar horas​

Por projeto​

Se você tem múltiplos projetos do mesmo cliente:

  1. Importa "Projeto A" → Fatura separada
  2. Importa "Projeto B" → Fatura separada
  3. Ou combina ambas em uma fatura

Por período​

Semana 1 (1-7 feb) → Fatura semanal
Semana 2 (8-14 feb) → Outra fatura

Ou agrupar todo o mês em uma fatura grande.

Descrição de tarefas​

Se você usa descrições de tarefas no Clockify:

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

Frihet importa:

Fatura:
- Desenho de mockups: 2h @ €55 = €110
- Integração de API: 2.5h @ €55 = €137.50
Total: €247.50

Cada linha editável antes de confirmar.

Mapeamento de projetos e clientes​

Automático​

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

Se não existir, o Frihet o cria.

Manual​

Para mapear um projeto para outro cliente:

  1. Configurações → Integrações → Clockify → Mapeamento
  2. Para cada projeto, atribua um cliente Frihet
  3. Salvar

Exemplo:

Projeto Clockify "App Q1"
→ Atribuir ao cliente Frihet "Startup Tech"

Configurar sincronização automática​

Se você quer que seja importado automaticamente toda noite:

  1. Vá para Configurações → Integrações → Clockify
  2. Ative "Sincronização automática"
  3. Escolha o horário de sincronização (recomendado: 23h)
  4. Salvar

Toda noite:

  • Frihet importa suas horas
  • Cria rascunhos de fatura
  • Você confirma quando quiser

Teste a integração​

Importação de teste​

  1. No Clockify, registre uma entrada: "Test entry" (1h)
  2. No Frihet, Faturamento → Importar do Clockify
  3. Escolha "Últimas 24 horas"
  4. Clique em "Importar"
  5. Você deve ver um rascunho de fatura

Se não funcionar:

  • Verifique se o Clockify está conectado ✅
  • As horas devem estar "concluídas" (não em pausa)
  • Espere 5 minutos
  • Recarregue o Frihet (F5)

Edições após importar​

A fatura chega no status "Rascunho". Você pode:

  • ✏️ Editar conceito
  • ✏️ Mudar tarifa/hora
  • ✏️ Adicionar/remover linhas
  • ✏️ Mudar cliente
  • ✏️ Ajustar IVA

As alterações no Clockify não afetam a fatura do Frihet.

Importar registros de tempo​

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

  1. Conecte sua conta do Clockify
  2. Vá para a aba Dados da integração
  3. Clique em Importar registros de tempo
  4. Insira sua tarifa por hora
  5. 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.

Comparação: Clockify vs Toggl​

CaracterísticaClockifyToggl
APISim ✅Sim ✅
Tarifa/hora€55 recomendado€60 recomendado
Descrição tarefasSimSim
EquipesSimSim
CustoGrátis ou €99/anoGrátis ou €108/ano

Recomendação: Use a que você já tem. Ambas funcionam igualmente bem com o Frihet.

Limites​

  • Máximo de 90 dias por importação (para não sobrecarregar)
  • Sem sincronização bidirecional — Apenas Clockify → Frihet
  • Chave de API válida indefinidamente — Até que você a revogue

Troubleshooting​

"Não conecta ao Clockify"​

  • Verifique se o token está correto (copie-o novamente)
  • Confirme se sua conta Clockify está ativa
  • Tente desconectar e reconectar

"Vejo horas no Clockify, mas não no Frihet"​

  • As horas devem estar "concluídas", não em pausa
  • O Clockify atualiza os dados a cada 24h, o Frihet sincroniza a cada 15 minutos
  • Recarregue o Frihet

"Posso mudar do Toggl para o Clockify?"​

Sim. Os passos:

  1. Desconecte o Toggl: Configurações → Integrações → Toggl → Desconectar
  2. Conecte o Clockify: Configurações → Integrações → Clockify → Conectar
  3. As faturas já criadas permanecem iguais

"Importo histórico de 6 meses?"​

Sim, mas em múltiplas importações:

  1. Importe 3 meses (ex: janeiro-março)
  2. Confirme as faturas
  3. Importe outros 3 meses
  4. Assim o histórico não se mistura

Próximos passos​

Anterior: Toggl Track