Passo a passo
Como gerar a DIRF por ano-calendário no HubCount Alertas
Gere os PDFs da DIRF por ano-calendário a partir de uma planilha ou das empresas, acompanhe o processo e baixe os documentos prontos em ZIP, na versão anterior.
Você gera os PDFs da DIRF de um ano-calendário, por planilha de pessoas ou por empresa com todos os colaboradores, acompanha o processo até o fim e baixa os documentos prontos, um a um ou em um ZIP.
Esta página descreve a tela da versão anterior do HubCount Alertas. Ela tem botões próprios. Os ícones do cabeçalho da versão nova, descritos em Atualizar, exportar e tags, não valem aqui.
Onde fica
A DIRF não tem item no menu lateral. Ela fica só na faixa de abas do HubCount Alertas.
- No menu lateral, abra HubAlertas+ e escolha qualquer item. As abas aparecem no topo.
- Clique na aba DIRF.
O endereço é /hubAlertas/dirf. Em contas que já usam a versão nova, esse endereço abre o Resumo, porque a aba DIRF só existe na tela anterior.
A aba pede a permissão DIRF. Sem ela, a aba aparece desativada. As outras permissões liberam partes da tela:
| Permissão | O que libera |
|---|---|
| Visualizar DIRF | Listar os processos e os documentos. |
| Iniciar geração DIRF | O botão Nova geração. |
| Baixar DIRF | Baixar o ZIP e cada PDF. Os ícones de download aparecem mesmo sem ela, mas o download é recusado. |
Veja como dar permissões em Usuários e autorizações.
Antes de começar
- Cadastre o seu e-mail no usuário. O processo avisa por e-mail quando termina. Sem e-mail no usuário, o HubCount recusa a geração com Usuário sem e-mail cadastrado.
- Tenha o certificado da empresa. O HubCount busca os dados do eSocial da empresa com um certificado A1 ECAC (A1) ou Ambos (A1). Veja Certificados e logins e Certificados e requisitos.
- Tenha as empresas cadastradas. Na planilha, a empresa é achada pelo CNPJ.
Gerar a DIRF
- Na aba DIRF, clique em Nova geração.
- Em Ano-calendário, escolha o ano. A lista traz o ano atual e os cinco anteriores e começa no ano passado.
- Em Modo de geração, escolha Planilha (CNPJ, CPF, Nome, Tipo) ou Empresas (todos os colaboradores).
- Complete o modo, como mostram as duas seções abaixo.
- Clique em Iniciar processo. A tela mostra Processo DIRF iniciado com sucesso.
Modo planilha
Use quando você quer a DIRF só de algumas pessoas.
- Escolha Planilha (CNPJ, CPF, Nome, Tipo). O ponto de interrogação ao lado explica as colunas.
- Clique em Selecionar arquivo e escolha a planilha em .xlsx.
- Clique em Iniciar processo.
A primeira linha da planilha é o cabeçalho. As colunas são:
| Coluna | O que informar |
|---|---|
| CNPJ | O CNPJ da empresa. Obrigatória. O HubCount procura entre as suas empresas e ignora CNPJs que não encontra. |
| CPF | O CPF da pessoa, com 11 dígitos. Obrigatória. Linhas sem 11 dígitos são puladas. |
| Nome | O nome da pessoa. Obrigatória. Se uma linha vier sem nome, o HubCount usa o do eSocial. |
| Tipo | Opcional. empregado (ou colaborador, clt) ou contribuinte_individual (ou autônomo, contribuinte individual, pj). Sem a coluna, vale empregado. |
O HubCount gera o PDF só das pessoas da planilha que têm dados da empresa no eSocial do ano.
Modo empresas
Use quando você quer a DIRF de todos os colaboradores.
- Escolha Empresas (todos os colaboradores).
- No campo Empresas, digite para buscar e escolha as empresas, que aparecem agrupadas por grupo.
- Clique em Iniciar processo.
O HubCount gera um PDF para cada pessoa com dados no eSocial da empresa naquele ano. O tipo, empregado ou contribuinte individual, vem da categoria do trabalhador no eSocial.
Acompanhar o processo
A aba Processos lista os 50 processos mais recentes. Enquanto algum estiver pendente, sincronizando ou gerando, a lista se atualiza sozinha a cada 5 segundos.
| Coluna | O que mostra |
|---|---|
| ID | O número do processo. |
| Ano-calendário | O ano da DIRF. |
| Status | O status do processo, como na tabela abaixo. |
| Progresso | Empresas processadas e total de empresas, como 2/2. |
| PDFs gerados | Quantos PDFs já foram gerados. |
| Data de criação | Quando o processo foi criado. |
| Ações | Ver detalhes e, quando há PDFs, Baixar ZIP. |
| Status | O que acontece |
|---|---|
| Pendente | O processo foi criado e ainda não começou. |
| Sincronizando eSocial | O HubCount confere se os dados do eSocial de cada empresa têm menos de 3 dias. Se não, pede nova sincronização e espera, conferindo a cada 2 minutos por até 4 horas. |
| Gerando PDFs | O HubCount gera os PDFs, empresa por empresa. |
| Concluído | Todas as empresas deram certo. |
| Concluído com erros | Algumas empresas falharam, mas houve PDFs gerados. |
| Falhou | Alguma empresa falhou e nenhum PDF foi gerado. |
Ver os detalhes
- Clique em Ver detalhes na linha do processo.
- Na gaveta Detalhe do processo, leia a lista de Empresas. Cada empresa mostra a mensagem do erro, se houve.
- Leia os Logs, do mais novo ao mais antigo. A gaveta traz até 500.
Sem mensagem, a empresa mostra Status: e um número: 0 pendente, 1 sincronizando eSocial, 2 eSocial falhou, 3 gerando, 4 concluída, 5 com erro e 6 ignorada.
Baixar os documentos
Há duas formas de baixar.
- Para um processo inteiro, clique em Baixar ZIP na linha dele. O arquivo se chama DIRF_processo_ seguido do número, e traz uma pasta por empresa com um PDF por pessoa.
- Para uma pessoa, abra a aba Documentos prontos, filtre em Filtrar por nome, CPF ou empresa e clique no ícone de download da linha.
A aba Documentos prontos mostra os 100 documentos mais recentes, só os gerados. As colunas são Empresa, CPF, Nome, Ano-calendário e Ações. O filtro procura por nome, CPF ou empresa e atualiza enquanto você digita. Quando não há nada, a tela mostra Nenhum documento disponível.
Exemplo com a Contabilidade Exemplo
Em 21/10/2026, a Contabilidade Exemplo gera a DIRF de 2025 da Aurora e da Borges.
- A equipe clica em Nova geração e escolhe 2025.
- Escolhe Empresas (todos os colaboradores) e as duas empresas.
- Clica em Iniciar processo. O processo 1 aparece como Pendente.
- A Aurora tem o eSocial sincronizado há 1 dia. A Borges tem o eSocial de 5 dias atrás, e o HubCount pede uma sincronização nova.
- O status passa por Sincronizando eSocial e Gerando PDFs, e termina em Concluído, com 2/2 e 14 PDFs gerados.
- Um e-mail avisa o fim. A equipe baixa o ZIP do processo e envia a pasta de cada empresa ao cliente.
Para uma única pessoa da Cedro, a equipe prepara uma planilha com uma linha e as colunas CNPJ da Cedro, CPF, Nome e Tipo com o valor empregado, e gera no modo planilha.
Problemas comuns
Ano-calendário inválido.
O HubCount só aceita ano de 2000 até o ano atual. Escolha um ano da lista.
Usuário sem e-mail cadastrado.
O seu usuário não tem e-mail, e o HubCount envia o aviso de término por e-mail. Cadastre o e-mail em Usuários e autorizações e tente de novo.
Selecione ao menos uma empresa.
No modo empresas, nenhuma empresa foi escolhida. No modo planilha, nenhum CNPJ da planilha é de uma empresa sua. Cadastre a empresa ou corrija os CNPJs.
Envie a planilha Excel.
O modo planilha está marcado e nenhum arquivo foi escolhido. Escolha a planilha antes de clicar em Iniciar processo.
Planilha DIRF: cabeçalhos CNPJ, CPF e Nome são obrigatórios.
A primeira linha da planilha não tem as três colunas. Escreva CNPJ, CPF e Nome no cabeçalho.
Planilha sem linhas válidas.
Nenhuma linha tem CPF com 11 dígitos. Confira a coluna CPF.
Erro ao ler planilha DIRF:
O arquivo não pôde ser lido. A janela aceita .xls, mas o HubCount lê só .xlsx. Salve a planilha em .xlsx e envie de novo.
Nenhum evento S-5002 encontrado para a empresa
Aparece nos logs. O HubCount não achou no eSocial da empresa os eventos S-5002, que trazem o imposto retido por trabalhador. Confira o certificado da empresa e se o eSocial dela tem esses eventos, e rode de novo. O aviso parecido Nenhum dado S-5002 encontrado para o ano diz que não há dados no ano escolhido.
Sync eSocial falhou:
Aparece nos logs e na empresa. O HubCount não conseguiu sincronizar o eSocial. O motivo vem depois dos dois pontos. Os mais comuns são Empresa não possuí certificado válido. e certificado expirado. Corrija o certificado e gere de novo.
Timeout aguardando sync eSocial.
A sincronização passou de 4 horas. Gere de novo mais tarde.
Nenhum documento disponível para download.
O processo não gerou PDFs, então não há ZIP. Veja os detalhes do processo.