Como acompanhar parcelamentos no HubCount Alertas

Você vê os parcelamentos tributários de todas as empresas em uma tela, abre as parcelas, baixa as guias e deixa a busca rodando sozinha todo mês. Abaixo estão os passos, as tabelas de referência e as mensagens de erro mais comuns.

Antes de começar

• Autorização para ver a aba. Seu usuário precisa de Visualizar Aba Parcelamentos. Para cadastrar o número de um parcelamento PGFN, precisa de Parcelamentos. Veja Usuários e autorizações.
• Empresa com o acesso certo ao tipo. Cada tipo pede um acesso diferente. A tabela da próxima seção mostra qual.
• Para o PGFN, o número do parcelamento cadastrado antes. Sem ele, o parcelamento PGFN não aparece na lista. Veja a seção “Cadastrar o número do parcelamento PGFN”.
• Para a busca automática, a empresa com endereço cadastrado. A busca agendada ignora empresas sem endereço.

Tipos de parcelamento

A lista de tipos depende da conta. Contas com o Pacote Contábil ou o Pacote Automação, e contas com credenciais SERPRO cadastradas, veem todos os tipos, menos o parcelamento do e-CAC para MEI. As outras contas veem só o e-CAC MEI, Uberlândia e PGFN.

Tipo na tela	Esfera	O que a empresa precisa ter
(eCAC) Parcelamento - Microempreendedor Individual	Federal	Certificado A1 do tipo e-CAC, Ambos ou NFS-e.
Uberlândia	Municipal	Nenhum certificado.
(PGFN) Procuradoria Geral da Fazenda Nacional	Federal	Número do parcelamento cadastrado. Nenhum certificado.
Simples Nacional - Ordinário	Federal	Certificado ou login válido (veja abaixo) e credenciais SERPRO.
Simples Nacional - Especial	Federal	Igual ao anterior.
PERT - Simples Nacional	Federal	Igual ao anterior.
RELP - Simples Nacional	Federal	Igual ao anterior.
MEI - Ordinário	Federal	Igual ao anterior.
MEI - Especial	Federal	Igual ao anterior.
PERT - MEI	Federal	Igual ao anterior.
RELP - MEI	Federal	Igual ao anterior.

Para os tipos que pedem certificado ou login, a empresa só entra na lista do tipo se tiver um destes cadastros: ECAC (A1), Ambos (A1), NFES (A1), Simples (SENHA) ou SERPRO Login. Os tipos SERPRO usam a API da SERPRO. A busca registra “Credenciais SERPRO ausentes” quando a conta não tem o Pacote Contábil, nem o Pacote Automação, nem credenciais SERPRO na empresa. Os tipos SERPRO só rodam a partir do dia 10 de cada mês. Para cadastrar certificados, veja Certificados e logins.

A esfera Estadual aparece na faixa, mas nenhum tipo atual é estadual. Ao abri-la, a lista de tipos mostra Nenhum tipo encontrado.

Ver os parcelamentos de uma empresa

Enquanto nenhum tipo está marcado, a lista fica vazia e mostra Nenhum parcelamento encontrado, com a dica Selecione um tipo ou ajuste os filtros para visualizar os parcelamentos.. O botão Atualizar busca repete a busca.

A coluna de tipos

Cada tipo é um cartão com dois contadores. Regular conta as empresas com o parcelamento em dia. Atenção conta as empresas com o parcelamento em atraso. Os contadores respeitam os filtros de empresa e de grupo, mas não o de situação.

Os filtros

Filtro	O que faz
Empresa	Mostra só os parcelamentos de uma empresa.
Grupo	Mostra só os parcelamentos das empresas de um grupo.
Situação	Todos, Em dia ou Em atraso.
Pesquisar por código	Procura pelo número do parcelamento cadastrado. Só acha parcelamentos que têm número cadastrado, como os do PGFN.

O botão Limpar Filtros limpa os quatro filtros. O filtro por tags do cabeçalho também vale para esta aba. Os resultados vêm ordenados pelo nome da empresa, em páginas de 10, 20 ou 50 linhas.

As colunas da lista

Coluna	O que mostra
Status	Um ícone: vermelho para atraso, âmbar para parcela perto do vencimento e verde para em dia. Passe o mouse para ver o nome do status.
Contribuinte / Identificação	Nome e CNPJ da empresa.
Valor Total	A soma do valor de todas as parcelas do parcelamento.
Situação / Processo	O status em texto e, abaixo, o número do parcelamento quando ele foi cadastrado.

Como o status é definido

Status	Quando aparece
Em atraso	O parcelamento está marcado como em atraso. Tem prioridade sobre os outros.
À vencer	O parcelamento não está em atraso, mas alguma parcela vence nos próximos 10 dias.
Em dia	Todos os outros casos.

Abrir as parcelas e baixar a guia

Ao clicar na linha, abre uma janela com o nome da empresa e o número do parcelamento.

Coluna	O que mostra
Parcela	O número da parcela.
Mês	O mês de referência, no formato mês e ano.
Pago em	A data do pagamento.
Vencimento	A data de vencimento.
Valor Pago	O valor pago.
Valor parcela	O valor da parcela.
Status	Não pago, Pago ou Atrasado.
Ações	O download da guia.

O ícone de download fica desativado quando a parcela já está paga ou quando o HubCount ainda não tem a guia. Nesse caso, ao passar o mouse, você vê Documento indisponível. Com a guia disponível, o texto é Baixar documento.

Os filtros da janela usam os nomes A pagar, Pago e Em atraso, que correspondem a Não pago, Pago e Atrasado da coluna. Quando há filtro ativo, a janela mostra quantas parcelas aparecem do total.

De onde vêm as guias

O HubCount guarda a guia quando a busca encontra a parcela do mês. Nos tipos SERPRO, a busca emite a guia da parcela do mês e a guarda. Se a empresa tem marcada a opção Enviar guias de parcelamento por Email, no bloco Informações para o Parcelamento do cadastro, a guia nova também sai por e-mail. Veja Empresas e Regras de envio de e-mail.

Para baixar várias guias de uma vez, use a exportação Exportar DARFs, descrita mais abaixo.

Cadastrar o número do parcelamento PGFN

O PGFN não tem consulta automática por certificado. O HubCount procura o parcelamento pelo número que você cadastrou.

Para cadastrar vários de uma vez, use Importar parcelamentos. A janela oferece Baixar modelo com a planilha modelo. A primeira coluna leva o CNPJ ou o CPF e a segunda leva o número do parcelamento. A primeira linha é o cabeçalho.

O número deve ter até 9 dígitos, só números. Um número fora desse formato gera o motivo “Código manual inválido” no log. Parcelamentos totalmente pagos saem da lista de cadastros.

Agendar a busca automática

A aba Configurações define, por empresa e por tipo, quando o HubCount busca os parcelamentos sozinho.

Opção	Valores	Observação
Dia do mês	Dia 11 a 31 (padrão 15).	Se o mês não tem o dia escolhido, a busca roda no último dia do mês.
Dia da semana	Segunda a domingo.	A busca roda uma vez por mês, no primeiro dia da semana escolhido a partir do dia 11.
Hora	03 a 23.	Não existe horário antes das 03:15.
Minuto	00, 15, 30 ou 45.	Às 03h, só 15, 30 e 45.

O botão de salvar só fica ativo com pelo menos uma empresa e um tipo. Abaixo do botão, o resumo diz quantas empresas e tipos você escolheu.

Regras de execução

A tela mostra o quadro Regras de Execução com estas regras.

• A busca automática executa apenas entre o dia 11 e o último dia de cada mês, a partir das 03:15.
• No modo "Dia do mês": se o dia escolhido não existir naquele mês (ex.: dia 31 em fevereiro), a execução ocorre no último dia do mês.
• No modo "Dia da semana": a execução ocorre uma única vez por mês, no primeiro dia correspondente ao dia da semana escolhido, a partir do dia 11.

Algumas regras complementam o quadro:

• Se a busca do mês já terminou com sucesso ou com erro aceitável para aquela empresa e aquele tipo, o HubCount não busca de novo no mesmo mês. Um erro crítico não impede nova tentativa na próxima data que combinar com o agendamento.
• Se você salva um agendamento e hoje já cai na regra, a busca de hoje é programada na hora, no horário escolhido. Se o horário já passou, ela roda logo.
• Cada empresa tem um agendamento por tipo. Salvar o mesmo par com a mesma regra não duplica nada. Salvar com uma regra diferente dá erro. Para mudar, exclua o agendamento e crie outro.

Ver e excluir agendamentos

A lista Agendamentos por empresa mostra uma linha por empresa, com um selo por tipo, por exemplo (PGFN) Procuradoria Geral da Fazenda Nacional · dia 15 às 03:15. Cada empresa mostra até 3 selos. O selo “+N agendamento(s)” abre os demais e Ver menos recolhe.

• Para filtrar, use Tipos de parcelamento e o campo de nome ou CNPJ, e clique em Procurar.
• Para excluir um agendamento, clique no x do selo.
• Para excluir vários, marque a caixa da empresa e clique em Excluir selecionadas.

Antes de excluir, a tela pergunta Excluir agendamentos?. A exclusão não tem volta.

Atualizar agora

O botão de atualizar do cabeçalho, chamado Atualizar parcelamentos, pede uma busca imediata.

O pedido entra na fila e a janela confirma que os parcelamentos foram enfileirados. A busca segue mesmo que você feche a janela. Não inicie outra para a mesma empresa enquanto a primeira não termina. Esta janela não tem agendamento: ela roda na hora. Para escolher o horário, use a área Configurações.

Acompanhar nos logs

A área Logs mostra o resultado de cada busca, da mais recente para a mais antiga.

Coluna	O que mostra
Data da execução	Data e hora da busca.
Empresa e CNPJ	A empresa buscada.
Tipo de parcelamento	O tipo buscado.
Status	Sucesso, Erro aceitável ou Erro crítico.
Motivo	O motivo da classificação.
Mensagem	O texto do erro, quando há.
ID do job	O número do processo, útil para o suporte.

Os filtros são Busca por texto, que procura em empresa, CNPJ, mensagem e número do processo, e Status. Clique em Pesquisar logs para aplicar. Você ordena clicando no título de cada coluna.

Erro aceitável é um problema que você corrige no cadastro ou no acesso. Erro crítico é uma falha da busca ou do portal, que costuma passar sozinha.

Motivo	Status	O que significa
Concluído	Sucesso	A busca atualizou os parcelamentos.
Já atualizado	Sucesso	O mês já tinha a parcela guardada.
Sem parcelamento ativo	Sucesso	A empresa não tem parcelamento ativo do tipo.
Parcelamento manual ausente	Sucesso	O PGFN foi buscado, mas a empresa não tem número cadastrado.
Certificado ausente	Erro aceitável	Não há certificado válido para o tipo.
Credenciais SERPRO ausentes	Erro aceitável	Falta a credencial SERPRO.
Login inválido	Erro aceitável	O acesso ao e-CAC ou ao Conta GOV foi recusado.
Procuração inválida	Erro aceitável	O certificado não tem procuração para o CNPJ.
Código manual inválido	Erro aceitável	O número cadastrado não é aceito ou não foi encontrado.
Execução antes do dia permitido	Erro aceitável	Tipo SERPRO rodado antes do dia 10.
Portal indisponível	Erro crítico	O portal do governo estava instável.
Erro na API SERPRO	Erro crítico	A SERPRO devolveu erro.
Tempo limite excedido	Erro crítico	O portal demorou demais.
Erro de persistência	Erro crítico	Falha ao gravar os dados.
Erro inesperado	Erro crítico	Erro sem classificação.

Exportar

O botão de exportar do cabeçalho abre a janela de exportação já na aba Parcelamentos. A janela tem três escolhas de empresas: Empresa, Grupo e Colar CNPJs, esta com o botão Confirmar CNPJs que leva para a escolha de empresas.

As três ações só ficam ativas com empresas (ou grupos) e pelo menos um tipo escolhidos.

Ação	O que você recebe
Exportar total	A planilha CompanyParcelings.xlsx, aba Parcelamentos, com CNPJ, empresa, total do parcelamento, status e tipo. Usa as empresas escolhidas e não filtra pelos tipos.
Exportar detalhamentos	Um ZIP, CompanyParcelingsBatch.zip, com uma planilha por parcelamento dos tipos escolhidos. Cada planilha tem número, mês, data de pagamento, vencimento, valor pago, valor da parcela e status.
Exportar DARFs	Um ZIP, parcelingsDarfs.zip, com um PDF por parcelamento: a primeira parcela que tem guia. Usa as empresas escolhidas e não filtra pelos tipos.

Exemplo: a Contabilidade Exemplo e o PGFN da Aurora

A Contabilidade Exemplo acompanha cinco empresas. Hoje é 21/10/2026. Três têm parcelamento.

Empresa	Tipo	Número	Situação
Aurora Comércio Ltda	(PGFN) Procuradoria Geral da Fazenda Nacional	1001	Em atraso
Cedro Indústria Ltda	Simples Nacional - Ordinário	2001	Em atraso
Estrela Alimentos Ltda	PERT - Simples Nacional	3001	Em dia

O responsável abre a aba Parcelamentos e escolhe Federal. Na coluna de tipos, o PGFN mostra Atenção 1 e o PERT - Simples Nacional mostra Regular 1.

Ele clica em PGFN. A lista mostra a Aurora com o ícone vermelho, Em atraso e o valor total de R$ 5.625,00, a soma das seis parcelas. Ao abrir a linha, as parcelas 1 a 3 estão Pago, a parcela 4 (agosto de 2026, R$ 950,00) está Atrasado e as parcelas 5 e 6 estão Não pago. Ele baixa a guia da parcela 4.

Para não depender da lembrança de ninguém, cadastra um agendamento para as três empresas, nos três tipos, no dia 15 às 03:15. Quando o mês seguinte chegar ao dia 15, a busca roda sozinha. Se a Cedro falhar com “Procuração inválida”, o log mostra o erro aceitável, o responsável corrige a procuração e pede Atualizar parcelamentos só para essa empresa.

Problemas comuns

Nenhum parcelamento encontrado

A lista abre vazia até você marcar um tipo na coluna Tipos de Parcelamentos (. Se já marcou, confira os filtros e clique em Limpar Filtros. No PGFN, a lista só mostra parcelamentos com número cadastrado. No filtro por tags, confira se a empresa está nas tags escolhidas.

Nenhum tipo encontrado

A coluna de tipos está vazia na esfera Estadual, porque não há tipo estadual. Volte para Federal ou Municipal.

Parcelamento com o código ‘X’ não foi encontrado ou está inválido. Verifique o cadastro de parcelamentos.

O número cadastrado não existe no portal da PGFN ou tem formato errado. Confira o número em Cadastros, na tela Parcelamentos, e corrija. O número tem até 9 dígitos, só números.

Parcela com o mesmo código já cadastrada para essa empresa.

O número já foi cadastrado para a empresa. Procure-o na lista antes de cadastrar de novo.

A importação de parcelamentos SERPRO não pode ser executada antes do dia 10 do mês.

Os tipos SERPRO só rodam a partir do dia 10. Peça a atualização depois dessa data ou agende a busca para um dia a partir do 11.

Não foi encontrado um Certificado válido do(s) tipo(s) … para empresa: … Verifique se não há algum certificado expirado.

A empresa não tem certificado válido para o tipo. Cadastre ou renove o certificado A1 em Certificados e logins.

A procuração eletrônica cadastrada do certificado digital foi cancelada (acesse o ECAC para mais informações)

A procuração do certificado para a empresa foi cancelada. Renove a procuração no e-CAC e peça uma nova atualização.

Erro no ecac: Você atingiu o número máximo de dispositivos conectados simultaneamente com esta conta. Deslogue do ecac para liberar acessos.

O e-CAC limita as sessões abertas. Saia do e-CAC nos outros dispositivos e tente de novo.

Acesso configurado com verificação em duas etapas, para continuar usando os serviços do Conta GOV é necessário desabilitar essa função no portal.

A conta Gov.br usada no acesso exige duas etapas. Desative a verificação em duas etapas no portal e tente de novo.

Não foi possível acessar o portal PGFN, sistema instável no momento.

O portal da PGFN estava fora do ar. Esse erro é crítico e costuma passar sozinho. Peça a atualização de novo mais tarde.

Já existe agendamento com periodicidade diferente para: …

A empresa já tem agendamento para o tipo, com outra regra. A mensagem lista as empresas e os tipos em conflito. Exclua o agendamento antigo na lista e salve o novo.

Selecione ao menos uma empresa.

Você tentou salvar o agendamento sem empresas. A mesma regra vale para tipos: a mensagem é “Selecione ao menos um tipo de parcelamento.”

Informe um dia do mês entre 11 e 31.

O dia escolhido está fora da janela de busca. Escolha um dia de 11 a 31.

Não há DARFs disponíveis para exportação.

Nenhum dos parcelamentos escolhidos tem guia guardada. Confira as parcelas e faça uma atualização antes de exportar.

Não foi possível carregar os agendamentos.

A lista de agendamentos não abriu. Recarregue a página. Se continuar, avise o suporte.

Próximos passos

• Veja a visão geral do HubCount Alertas para o cabeçalho, o filtro por tags e as regras de e-mail.
• Acompanhe também o FGTS Digital e o MTE.