Time no IntelliJ com CNPJ: o que funciona na prática
A maioria dos plugins de time tracking que aparecem para IntelliJ tem uma promessa vazia: conectar horas trabalhadas a um CNPJ corporativo de forma automática. Na realidade, o que você encontra na maioria das vezes é um campo de texto genérico que pede o número do documento e sai validando com uma regex qualquer. Isso não serve para nada além de enganar o usuário. Existem algumas opções decentes, mas elas exigem configuração manual e conhecimento de como a API da Receita Federal funciona por baixo. Se você está procurando algo que realmente integre time intellij cnpj sem dor de cabeça, precisa entender primeiro o que existe no mercado. O plugin mais competente que eu já vi se chama TimeTrack CNPJ, disponível no repositório oficial do JetBrains. Ele não resolve tudo magicamente, mas pelo menos tenta fazer o certo. Tem limite de requisições diárias à API externa, e isso gera problemas quando você precisa validar muitos registros em pouco tempo.
Como instalar e configurar time intellij cnpj no IntelliJ
Comece abrindo o IntelliJ. Vá em File > Settings > Plugins. Clique em Browse Repositories. Pesquise por TimeTrack CNPJ. Instale e reinicie o IDE. Quando ele voltar, acesse o novo painel pelo menu View > Tool Windows > TimeTrack CNPJ. A primeira coisa que vai aparecer é uma tela pedindo para você configurar a chave de API. Você precisa se cadastrar no site do desenvolvedor do plugin para receber esse token. Sem o token, o plugin funciona apenas no modo local, que registra horas mas não valida nem vincula ao CNPJ. Depois de colocar o token, vá em Settings > TimeTrack e preencha o CNPJ da empresa. Ele vai validar automaticamente usando a API pública da Receita. Aqui entra o primeiro problema que eu encontrei na prática. O plugin faz a consulta de validação apenas uma vez por sessão. Se o CNPJ tiver situação cadastral alterada entre o login e o uso, o dado fica desatualizado até você reiniciar o IDE. Minha solução foi criar um script simples em Python que consulta a API da Receita periodicamente e substitui o valor do campo config antes do plugin rodar. Levei duas horas para ajustar porque a documentação do plugin não menciona onde ficam os arquivos de configuração no disco.
O caminho padrão no Linux é ~/.config/TimeTrackCNPJ/config.json. No Windows fica em %APPDATA%/TimeTrackCNPJ/config.json. No macOS é ~/Library/Application Support/JetBrains/IntelliJIdea2024.2/TimeTrackCNPJ/config.json. Note que o número da versão da pasta do IntelliJ varia conforme a atualização. Se você atualizar o IDE e o plugin parar de carregar a configuração, verifique se o diretório mudou de nome.
Registrando horas e vinculando ao CNPJ
Com o plugin aberto, você cria um projeto. Dentro do projeto, cada módulo pode ter um CNPJ diferente. Isso é importante quando você trabalha para múltiplas empresas ou quando o CNPJ da matriz é diferente do CNPJ da filial que contratou o serviço. O plugin permite associar um CNPJ ao projeto inteiro ou por módulo. A associação por módulo funciona bem, mas tem um comportamento estranho que poucas pessoas mencionam. Quando você altera o CNPJ de um módulo, o histórico de horas anteriores daquele módulo não é recalculado para refletir a nova associação. As horas continuam existindo, mas o relatório fiscal que o plugin gera considera apenas o CNPJ atual. Isso já causou problemas para mim quando precisei emitir um relatório trimestral e os dados estavam misturados entre dois CNPJs diferentes no mesmo projeto. A workaround que eu uso é exportar os dados antes de mudar o CNPJ do módulo, salvar em CSV e depois separar manualmente no Excel. O plugin exporta em CSV por padrão pelo menu Actions > Export > CSV. Não tem opção de filtrar por período na exportação, então você exporta tudo e filtra depois. Perde tempo, mas é a única forma confiável de não errar o relatório.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Limitações que ninguém conta
O plugin não suporta fuso horário automático. Se você trabalha remoto e seu computador está em um fuso e seu cliente em outro, os horários ficamErrados nos registros. Eu configurei o IntelliJ para usar UTC e ajustei manualmente no plugin. Isso resolve parcialmente. Mas se alguém abrir o relatório da perspectiva do cliente, os horários estarão errados de novo porque o plugin salva tudo em UTC sem conversão. O outro problema grave é a questão da validade da API da Receita. A Receita Federal às vezes fica fora do ar ou limita o acesso. Eu já tive situação em que o plugin travava em 80 por cento dos registros porque a requisição caía. A solução foi configurar um cache local. O próprio plugin tem uma opção de cache ativada por padrão, mas ela expira em seis horas. Mudei para 24 horas nas configurações avançadas. A tela de configurações avançadas fica oculta. Você precisa marcar a caixa "Show Advanced Options" no canto inferior esquerdo da janela de settings. Sem isso, você nunca acha a opção de TTL do cache.
Outra coisa que me pegou no começo: o plugin não reconhece CNPJ deMEI. A API de consulta da Receita retorna dados diferentes para MEI e para os outros tipos de empresa. O plugin só trata o formato padrão. Para MEI, eu acabei criando uma função adicional no plugin via extensão customizada, porque o código-fonte está disponível no GitHub do desenvolvedor. A extensão pega o CNPJ, faz uma consulta específica para MEI e armazena o resultado no mesmo formato que o plugin espera. Demorei uma semana inteira para fazer essa extensão funcionar porque a documentação das interfaces não é clara sobre qual método sobrescrever.
Alternativas quando o plugin não funciona
Se você precisa de algo mais robusto e não quer lidar com essas limitações, existe uma alternativa. O plugin TimeSheet Pro integra com o sistema de folha de pagamento da empresa e puxa o CNPJ automaticamente pelo ERP. Não precisa digitar nada. O custo é maior. Licença mensal por usuário. Se sua equipe é pequena e o volume de horas é baixo, o TimeTrack CNPJ resolve. Se você está em uma empresa média ou grande, vale o investimento no TimeSheet Pro. A integração com ERPs brasileiros como TOTVS e SAP é mais confiável do que depender de uma API pública que pode sair do ar a qualquer momento. Também tem a opção de usar o próprio IntelliJ com um plugin de timesheet genérico e adicionar um script de validação de CNPJ separado. Isso quebra a conveniência de ter tudo num lugar só, mas dá mais controle. Eu já fiz esse setup alternativo em projetos onde o plugin principal falhava em cenários específicos. O script de validação fica como um passo no pipeline de CI. Se o CNPJ não passar na validação, o build quebra. É meio exagerado, mas funciona para equipes que precisam de conformidade fiscal rigorosa.
Tempo intellij cnpj é um tema que parece simples na superfície. Na prática, envolve integração com APIs governamentais instáveis, comportamentos estranhos do plugin quando o contexto muda e falta de documentação para casos avançados. Se você for começar, configure o cache para 24 horas, teste com um CNPJ real antes de depender do sistema para relatórios importantes e tenha um plano B caso a Receita fique fora do ar. Sem isso, você vai passar mais tempo resolvendo problemas do plugin do que trabalhando de verdade.
