Pular para o conteúdo principal

Harvest

Disponível

Esta integração está ativa e pronta para uso no Frihet.

Conecte o Harvest ao Frihet. Importe registros de tempo e converta horas trabalhadas em linhas de fatura automaticamente. Defina taxas por cliente ou projeto e fature diretamente do seu ERP.

Para que serve?​

Com o Harvest integrado:

  • Importar registros de tempo — Traga suas horas registradas no Harvest para o Frihet
  • Criar faturas a partir de horas — Converta tempo em faturas com taxas configuráveis
  • Projetos e clientes — Agrupe horas por projeto para faturas detalhadas
  • Taxas personalizadas — Defina preço/hora por cliente ou projeto
  • Sem duplicatas — As horas já importadas não são re-importadas

Requisitos​

  • Conta Harvest ativa — getharvest.com
  • Personal Access Token — É gerado a partir das configurações do Harvest
  • Account ID — É obtido junto ao token
  • Frihet Pro ou superior

Conectar Harvest com o Frihet​

Passo 1: Obter seu Personal Access Token​

  1. Vá para id.getharvest.com/developers
  2. Faça login com sua conta do Harvest
  3. Clique em Create New Personal Access Token
  4. Dê um nome (ex: "Frihet ERP")
  5. Clique em Create Personal Access Token
  6. Você verá dois dados:
    • Token — Sua chave de acesso (ex: 123456.pt.abcdefg...)
    • Account ID — O identificador numérico da sua conta (ex: 987654)
  7. Copie ambos os valores
Guarde ambos os valores

O Token é exibido apenas uma vez. O Account ID pode ser consultado depois, mas copie ambos agora.

Passo 2: Configurar no Frihet​

  1. Vá para Ajustes → Integrações
  2. Procure por Harvest
  3. Clique em Conectar
  4. Insira seu Personal Access Token
  5. Insira seu Account ID
  6. Clique em Verificar conexão
  7. Se estiver correto, você verá o nome da sua empresa no Harvest

Passo 3: Verificar conexão​

  1. O Frihet exibirá um resumo:
    • Nome da empresa no Harvest
    • Número de projetos ativos
    • Horas registradas recentemente
  2. Você pode fazer uma importação de teste

Como funciona​

O Frihet usa a API v2 do Harvest com dois cabeçalhos de autenticação:

Authorization: Bearer <token>
Harvest-Account-Id: <account-id>
  1. Você fornece seu Personal Access Token e Account ID
  2. O Frihet envia ambos nos cabeçalhos de cada requisição
  3. Os registros de tempo são importados sob demanda ou periodicamente
  4. Cada registro inclui projeto, tarefa, cliente e horas
  5. As credenciais são armazenadas criptografadas (AES-256-GCM) no Frihet

Dados sincronizados​

DadoDireçãoFrequência
Registros de tempoHarvest → FrihetSob demanda / periódica
ProjetosHarvest → FrihetSob demanda
Clientes do HarvestHarvest → FrihetSob demanda
TarefasHarvest → FrihetCom cada registro

Exemplo: Converter horas em fatura​

No Harvest​

Proyecto: Rediseño Web - ClienteXYZ
  Lun 3 feb: 4h — Diseño de wireframes
  Mar 4 feb: 3h — Maquetación responsive
  Jue 6 feb: 5h — Desarrollo frontend
  Total: 12 horas

No Frihet (após importar)​

Factura #1047 - ClienteXYZ
Concepto: Rediseño Web

  Diseño de wireframes:     4h × 75 EUR = 300,00 EUR
  Maquetación responsive:   3h × 75 EUR = 225,00 EUR
  Desarrollo frontend:      5h × 75 EUR = 375,00 EUR

Total: 900,00 EUR

Taxas personalizadas​

Taxa padrão​

Ao configurar a integração, você define uma taxa base (ex: 60 EUR/h). Todas as importações usam esta taxa padrão.

Taxa por cliente​

  1. Vá para Clientes → abra o cliente
  2. Em "Taxa Harvest", insira a taxa específica (ex: 80 EUR/h)
  3. As próximas importações deste cliente usarão essa taxa

Editar na fatura​

Após importar, a fatura está em status Rascunho. Você pode:

  • Alterar a taxa por hora de qualquer linha
  • Adicionar ou remover linhas
  • Ajustar o conceito
  • Confirmar quando estiver pronto

Importar registros de tempo​

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

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

As entradas do Harvest incluem nome do projeto e tarefa diretamente, de modo que cada linha de fatura reflete a tarefa realizada.

Casos de uso​

Agência de desenvolvimento​

Sua equipe registra horas no Harvest por projeto e tarefa. No final do mês, você importa as horas para o Frihet e gera faturas detalhadas para cada cliente com o detalhamento das tarefas.

Consultor independente​

Você registra suas horas de consultoria no Harvest. Semanalmente ou mensalmente, você importa para o Frihet e cria faturas por cliente. Cada fatura mostra o detalhamento exato do que você fez e quanto tempo dedicou.

Faturamento por projeto​

Você tem um projeto grande com orçamento fechado. Você usa o Harvest para rastrear as horas reais e o Frihet para faturar os marcos do projeto. As horas importadas fornecem visibilidade da rentabilidade.

Solução de problemas​

"Erro de autenticação"​

  • Verifique se o Personal Access Token está correto
  • Verifique se o Account ID corresponde à sua conta ativa
  • Se você regenerou o token, atualize-o no Frihet

"Não vejo meus registros de tempo"​

  • Verifique se você registrou horas no Harvest (não rascunhos)
  • Verifique se você selecionou o intervalo de datas correto
  • As entradas de tempo devem ter um projeto atribuído

"As taxas não estão corretas"​

  • Revise a taxa padrão em Ajustes → Harvest
  • Verifique se o cliente possui uma taxa personalizada configurada
  • Você pode editar a taxa diretamente no rascunho de fatura antes de confirmar

"Quero mudar o Account ID"​

  1. Vá para Ajustes → Integrações → Harvest
  2. Clique em Desconectar
  3. Conecte novamente com o novo Account ID e token

Próximos passos​