Como acompanhar e atualizar as CNDs no HubCount Alertas

Você acompanha, empresa por empresa, se as certidões (CNDs) estão sem débitos, com débitos, vencidas ou em busca. A mesma tela agenda a busca automática, pede uma nova consulta na hora, cancela consultas que travaram e envia ou exporta os documentos. Abaixo estão os passos, todos os filtros e status, o histórico de cada documento e as mensagens de erro.

Antes de começar

• Permissão para ver a aba. A aba CNDs só aparece para quem tem a permissão Visualizar Aba CNDs.
• Permissão para mudar a periodicidade. Salvar, limpar ou replicar o agendamento de um documento exige Mudar periodicidade da busca de CND. Dê as duas permissões em Usuários e autorizações.
• Pelo menos um documento com periodicidade. A lista só mostra os tipos de documento que têm agendamento. Sem nenhum agendamento, a tela abre vazia. Veja Configure a busca.
• Cadastro da empresa completo. Ela precisa de CNPJ válido, endereço com cidade e estado, tipo de empresa (matriz ou filial) e, para os documentos que pedem, inscrição estadual ou municipal. Veja Empresas.
• Certificado ou login. A CND federal e a situação fiscal pedem um certificado A1 de e-CAC. Estados e prefeituras com login pedem o login da CND. Veja Certificados e logins.
• Busca habilitada na empresa. Uma empresa com Desabilitar procura de CNDs para essa empresa marcada fica fora da lista, das atualizações e das exportações.
• Empresas visíveis para o seu usuário. Você vê só as empresas que o seu usuário pode ver. O filtro por tags do cabeçalho também limita a lista. Veja a visão geral.

Veja a situação das CNDs

O que tem na tela

Elemento	O que mostra ou faz
Título e subtítulo	CNDs — Certidões de Débitos e o texto Acompanhe o status das certidões por empresa e esfera governamental.
Abas da tela	CNDs (a lista) e Logs (o histórico das buscas, descrito em Logs de integração).
Faixa de esferas	Visão Geral e uma aba por esfera. As esferas estão na tabela abaixo.
Botões de status	Mostram quantos documentos estão em cada status e filtram a Visão Geral. Veja Status das CNDs.
Engrenagem	Tem a dica Configurações de busca. Abre a janela de periodicidade e empresas. Ao fechar, a lista recarrega.
Ampulheta	Tem a dica Ver CNDs sendo processadas agora. O número soma as consultas em andamento e o ícone gira enquanto houver alguma. Abre as CNDs em progresso.
Empresa	Busca por razão social ou CNPJ. O campo mostra o texto Razão social ou CNPJ.
Grupo	Mostra só as empresas do grupo.
Limpar	Volta empresa, grupo e status ao padrão e recarrega.
Procurar	Aplica a empresa e o grupo escolhidos.
Linha da empresa	Nome, CNPJ e o total de documentos. Ícones com contadores por status, o ícone de download (Baixar documentos da empresa) e o de e-mail (Enviar por e-mail).
Paginação	Por página: 10, 20, 50 ou 100 empresas. O padrão é 10.

Sem filtro, a Visão Geral lista todas as empresas visíveis, mesmo as que ainda não têm documento. Uma empresa sem documento mostra 0 documentos. Ao expandir, a tela avisa Nenhuma CND encontrada para esta empresa.

Esferas

A faixa de esferas vem do servidor. Cada aba reúne os documentos da esfera que têm periodicidade configurada.

Aba	O que reúne
Visão Geral	Uma linha por empresa, com o resumo dos documentos de todas as esferas.
Federal	Documentos da esfera federal. Por exemplo Situação Fiscal, Federal (a CND federal), Trabalhista (CNDT) e Cartão CNPJ.
Estadual	Certidões das secretarias de fazenda dos estados. Por exemplo Fazenda Estado SP e Estado MG.
Municipal	Certidões das prefeituras. Por exemplo Cidade SP e Curitiba PR.
Justiça	Documentos de órgãos da justiça, como tribunais.
Entidades Regulatórias	Documentos de entidades regulatórias.
Imobiliária	CNDs imobiliárias municipais. Esta versão da tela ainda não separa os documentos por imóvel.
Outros	Documentos que não cabem nas esferas acima.

Ao abrir uma esfera, cada cartão traz o nome do documento e contadores com os textos válidas (sem débitos), inválidas (com débitos), pendentes (em progresso) e falhas (falhas). Os dois últimos só aparecem quando o número é maior que zero. Só entram tipos com pelo menos um documento ou uma busca nesses quatro grupos. Se nenhum tipo atende, a tela mostra Nenhuma CND encontrada, com o texto Não há certidões disponíveis para esta esfera governamental com os filtros selecionados.

Nas abas de esfera, os botões de status mostram os totais da esfera. Os totais de Negativa e Positiva aparecem na Visão Geral. O filtro por botão vale para a Visão Geral.

Status das CNDs

Cada documento de uma empresa guarda quatro informações independentes. A tela as combina de formas diferentes em cada lugar.

Informação	Valores	De onde vem
Débitos	Sem débitos ou Com Débitos	O resultado da última busca bem-sucedida.
Tipo da certidão	Negativa ou Positiva	O que o órgão emitiu. Positiva é a certidão que lista débitos.
Execução	Em andamento, Sucesso, Erro ou Tentando novamente	A situação da última tentativa de busca.
Validade	Data de vencimento	A data do PDF. Passada a data, o documento conta como Expirado.

Quando a busca devolve o status Válido c/ débitos, o documento fica com débitos e certidão negativa ao mesmo tempo. Ele conta nos dois botões, Com Débitos e Negativa.

Só entram nas contagens e nas listas os tipos de documento que têm periodicidade.

Botões de status

Botão	O que conta	Cor
Todos	Todos os documentos sem débitos mais todos os com débitos. É o filtro padrão.	Cinza
Sem débitos	Documentos cujo resultado da busca é sem débitos.	Verde
Com Débitos	Documentos cujo resultado da busca é com débitos.	Vermelho
Negativa	Certidões emitidas como negativas.	Verde-esmeralda
Positiva	Certidões emitidas como positivas.	Vinho
Em progresso	Buscas em andamento agora. As que estão em nova tentativa não entram na contagem.	Azul
Expirado	Documentos cuja validade já passou, com ou sem débitos.	Laranja

Os números contam documentos, não empresas. Uma empresa com três documentos sem débitos soma três em Sem débitos.

Status do documento na empresa

Ao expandir uma empresa, cada cartão tem um ícone colorido no canto. Passe o mouse para ler o status. A linha da empresa repete esses ícones, com o número de documentos em cada um. O cartão só existe para documentos que já têm resultado. Por isso ele mostra apenas dois status.

Status	Cor	Quando aparece
Válido	Verde	O documento é sem débitos ou a certidão é negativa.
Com Débitos	Vermelho	O documento é com débitos ou a certidão é positiva.

Cada cartão mostra também a data de validade e, quando existe arquivo, o ícone Baixar CND. Uma busca em andamento ou uma falha não mudam o cartão de um documento que já tinha resultado. Elas aparecem no detalhe do documento e no histórico.

Todos os status do produto

O HubCount tem dez nomes de status de documento. Esta tela usa só alguns. Os demais vêm do fluxo da versão anterior e dos filtros da exportação.

Status	Cor	Onde aparece nesta tela
Não encontrado	Cinza	Reservado para o documento sem classificação. A lista atual não usa.
Válido	Verde	Cartão do documento e contador da empresa.
Inválido	Vermelho	Não é usado aqui. Vem do fluxo da versão anterior.
Expirado	Vinho	Botão de status, como Expirado, e filtro da exportação, como Vencida.
Com Débitos	Vermelho	Cartão, contador, botão de status e detalhe.
Sem débitos	Verde	Botão de status, detalhe e filtro da exportação.
Válido c/ débitos	Âmbar	Não é usado aqui. A busca que devolve esse status conta em Com Débitos e em Negativa.
Em progresso	Azul	Botão de status, detalhe do documento e gaveta de CNDs em progresso.
Falha	Vermelho	Detalhe do documento e filtro do detalhe.
Cancelada	Cinza	Não é usado aqui. Cancelar uma busca grava a execução como Falha.

Status do detalhe do documento

No detalhe do documento, o ícone de cada empresa usa outra regra. A tela olha primeiro se há busca em andamento ou em nova tentativa, depois o resultado e, por último, a falha.

Status	Quando aparece
Em progresso	A busca está em andamento ou em nova tentativa.
Sem débitos	O resultado é sem débitos ou a certidão é negativa.
Com Débitos	O resultado é com débitos ou a certidão é positiva.
Falha	A última tentativa falhou e não há resultado.
Não classificado	A busca terminou, mas o resultado não se encaixa em nenhum dos anteriores.
Não buscado	Nunca houve busca desse documento para a empresa.

Status das buscas (histórico e logs)

O histórico do documento e a aba Logs mostram o andamento de cada tentativa.

Status	Cor	O que significa
Em andamento	Azul	A tentativa está em andamento. Enquanto houver novas tentativas, a falha aparece com este status e o texto do erro.
Sucesso	Verde	A busca terminou e gravou o resultado.
Erro	Vermelho	A busca esgotou as tentativas, ou você a cancelou.
Tentando novamente	Laranja	A busca vai tentar de novo.

Como os botões de status se combinam

Regra	Efeito
Sem débitos e Com Débitos	Um tira o outro. Escolha um só.
Negativa e Positiva	Um tira o outro. Escolha um só.
Um botão de cada par	Podem ficar ligados juntos. A lista mostra os documentos que atendem aos dois. Com Débitos com Negativa acha as certidões negativas que listam débitos.
Em progresso e Expirado	Cada um vale sozinho. Ao ligar um deles, todos os outros desligam. Ao ligar qualquer outro botão, eles desligam.
Todos	Desliga todos os filtros de status.
Clicar no botão ligado	Desliga o botão.

Ao filtrar, a Visão Geral mostra só as empresas que têm pelo menos um documento no filtro. Ao expandir uma empresa, os cartões respeitam o mesmo filtro.

Abra o detalhe de um documento

O detalhe mostra o mesmo documento de todas as empresas, com validade, última busca, próxima busca, histórico e download.

Elementos do detalhe

Elemento	O que mostra ou faz
Cabeçalho	Nome do documento e a data da última atualização.
Configurações de Atualização	Seção que se abre ao clicar. Define a periodicidade deste documento. Veja Periodicidade pelo detalhe.
Esfera	Todas as esferas, Federal, Estadual, Municipal, Jurídico, Regulatório, Imobiliário e Outros. Trocar a esfera troca a lista de tipos.
Tipo	Os documentos da esfera. O padrão é Todos.
Status	Sem débitos, Com Débitos, Negativa, Positiva, Em progresso e Falha. O filtro Falha existe aqui, mas não na lista principal.
Total	Um texto fixo com o número de empresas do filtro.
Linha da empresa	Ícone de status, nome e CNPJ da empresa, mais as datas abaixo.
Validade	A data de vencimento do PDF.
Última busca	A data da última tentativa de busca.
Próx.	A próxima data prevista, calculada pela periodicidade do documento.
Paginação	20 empresas por página, com os botões Primeiro, anterior, próximo e Último.
Estado vazio	Nenhum dado disponível!

Histórico de execuções

Ao clicar em Ver histórico, a linha da empresa mostra o Histórico de execuções. São as 50 últimas tentativas, da mais nova para a mais antiga. Cada uma traz o status, a data de execução e, nas falhas, o texto do erro em vermelho. Sem tentativas, aparece Nenhum histórico disponível.

O botão Ver Mais abre uma janela com o nome do documento e da empresa e duas abas.

Aba	Colunas	Observação
Documentos Baixados	Status, Validade, Execução e Ação	Um PDF por busca bem-sucedida. A ação baixa aquele PDF. Sem arquivo, aparece Nenhum documento encontrado.
Tentativas com Erro	Data/Hora de Execução e Erro	Só as tentativas com falha, com a mensagem completa. Sem falhas, aparece Nenhuma tentativa com erro encontrada.

As duas abas trazem o número de itens no título e paginam de 5, 10 ou 25 linhas (Linhas por página).

Baixe o PDF

O PDF baixado leva uma marca da HubCount no topo de cada página. O nome do arquivo traz o tipo do documento e o CNPJ da empresa.

Se o download falha, a tela mostra a mensagem do servidor. Veja Documento inexistente. e Não foi possível buscar documento. em Problemas comuns. Sem resposta do servidor, a tela mostra Não foi possível baixar o documento.

Atualize um documento de uma empresa

O detalhe não tem botão de atualizar. Para buscar de novo um documento de uma empresa, use Atualize as CNDs agora: escolha a empresa e, em Selecionar CNDs, escolha o tipo.

Configure a busca

A engrenagem abre a janela Configurações de busca, com duas abas. Na aba Periodicidade, você define quando cada documento é buscado. Cada documento tem uma só periodicidade, que vale para todas as empresas do escritório. Na aba Empresas, você escolhe quais documentos cada empresa busca.

Regras de atualização

A aba Periodicidade abre com o quadro Regras de atualização. Ele traz três regras.

• Os documentos são atualizados 10 dias após a última captação.
• Os documentos municipais não atualizam nos fins de semana. A busca roda no próximo dia útil.
• A atualização ocorre no período noturno, das 18h às 6h.

Não há campo para escolher a hora. Se você pede a atualização na hora, a regra dos 10 dias vale do mesmo jeito.

Defina a periodicidade de um documento

A lista mostra 30 documentos por página, em ordem de nome. Ligue Mostrar últimos modificados para ver primeiro os que você mudou há pouco. Cada documento traz:

Item	O que significa
Nome	O nome do documento.
Ícone de alerta	Tem a dica Necessário cadastro de IE. O documento precisa da inscrição estadual da empresa.
Aviso em vermelho	Este documento não está disponível para atualização automática. O documento existe, mas não aceita agendamento.
Executar todo(a)	Sem agendamento ou uma das frequências da tabela abaixo. Só aparecem as frequências que o documento permite.
Dia	Aparece depois de escolher a frequência.
Limpar	Aparece com o dia preenchido. Pede confirmação com o texto Remover o agendamento deste documento? Em seguida a tela avisa Periodicidade removida.
Salvar	Aparece com o dia preenchido.

Frequência	Campo do dia
Mensal	No dia, de 1 a 28
Semanal	No(a), de segunda a domingo
Quinzenal	No(a), de segunda a domingo
Trimestral	No dia, de 1 a 28
Semestral	No dia, de 1 a 28

Cada documento tem uma frequência mínima. A mais curta é semanal. Alguns documentos pedem no mínimo quinzenal e outros, como o Cartão CNPJ, no mínimo trimestral. A lista não oferece as frequências mais curtas que o mínimo.

Replique a mesma periodicidade

Use para aplicar uma frequência a muitos documentos de uma vez.

Salvar só se ativa depois que você escolhe uma das duas opções e, em Documentos selecionados, pelo menos um documento.

Com Somente documentos já configurados, a tela aplica a frequência a todos os documentos que já têm agendamento. Se não houver nenhum, o servidor responde Não foi encontrado nenhum documento agendado!

Se você salva sem escolher frequência, a tela avisa que nenhuma periodicidade foi selecionada e que isso remove o agendamento dos documentos aplicados. Clique em Confirmar remoção para limpar ou em Cancelar para voltar. Ao limpar, a tela mostra Periodicidades limpas com sucesso.

A replicação ignora, sem aviso, os documentos que não aceitam a frequência escolhida.

Escolha os documentos de cada empresa

Por padrão, cada empresa busca todos os documentos agendados que se aplicam a ela. Use a aba Empresas para limitar.

A lista de documentos da empresa traz só os agendados que se aplicam a ela: o estado, a cidade, o certificado e o cadastro precisam servir ao documento. Ao salvar com a lista vazia, a tela avisa que vai remover todos os agendamentos da esfera para aquela empresa e pede Confirmar exclusão

Se você troca de esfera com alterações não salvas, a tela pergunta: Você tem alterações não salvas. Deseja trocar de esfera?

A janela Visualizar CNDs agendadas tem uma aba por esfera, busca por nome do documento e o botão Voltar para lista. Sem documentos, mostra Não há documentos agendados para esta esfera.

A tela avisa também: Empresas com configurações individuais consultam apenas os documentos vinculados à sua configuração.

Periodicidade pelo detalhe

A seção Configurações de Atualização, no detalhe do documento, define a periodicidade só daquele documento. Ela oferece Frequência, Dia da semana (para semanal) e Dia do mês (para as demais, de 1 a 31), além de Salvar e Remover. Quando fechada, mostra um resumo, como Mensal dia 10.

Para a frequência quinzenal, prefira a janela Configurações de busca, que pede o dia da semana. O detalhe oferece todas as frequências. Se a escolhida for mais curta que o mínimo do documento, o servidor recusa o salvamento.

Desabilite a busca de uma empresa

No cadastro da empresa, marque Desabilitar procura de CNDs para essa empresa no bloco Informações para o Módulo do HubAlertas. A empresa sai da lista, das atualizações e das exportações. Veja Empresas.

Atualize as CNDs agora

A busca roda sozinha na periodicidade que você configurou. Use a atualização manual para pedir uma consulta antes, depois de regularizar uma pendência.

Campos da janela

Campo	O que faz
Quadro Antes de iniciar	A atualização continuará em execução mesmo que esta tela seja fechada. Não inicie uma nova atualização para a mesma empresa enquanto a anterior estiver em andamento.
Quadro Atenção	Os documentos são atualizados apenas após 10 dias da última captação, mesmo quando não há débitos. Empresas com configurações individuais consultam apenas os documentos vinculados à sua configuração.
Empresa	Escolha várias empresas. A lista traz só as empresas habilitadas para CND. Selecionar Todas escolhe todas e Remover todas desmarca.
Grupo	Escolhe todas as empresas habilitadas dos grupos.
Colar CNPJs	Cole CNPJs separados por vírgula, ponto e vírgula ou linha nova e clique em Confirmar CNPJs. A tela mostra quantos CNPJs identificou.
Todas agendadas	Consulta todos os tipos que têm periodicidade. Serão consultados os tipos de CND que possuem agendamento configurado.
Selecionar CNDs	Consulta só os tipos que você escolher em Tipos de CND. Selecionar todos e Remover todos ajudam. A lista só traz tipos agendados.
Resumo	Mostra quantas empresas e quantas CNDs entram.
Atualizar CNDs	Enfileira as consultas e fecha a janela.

Limites de cada pedido

O servidor confere o tamanho do pedido.

Quem pede	Limite
Quem não tem a autorização Admin	25 empresas por pedido.
Qualquer usuário	250 empresas por pedido.

Acima do limite, o pedido é recusado com a primeira mensagem de Problemas comuns. Para carteiras maiores, configure a periodicidade e deixe a busca rodar à noite.

O que a consulta pula

Nem toda empresa e documento escolhidos entram na fila. A consulta pula:

• o documento cuja próxima data prevista ainda não chegou. Isso inclui a regra dos 10 dias;
• a empresa sem endereço, sem cidade ou com a cidade não reconhecida;
• o documento que não se aplica à empresa: estado ou cidade diferente, falta de inscrição, falta de certificado ou tipo de empresa errado;
• o documento sem agendamento, nos tipos que você escolheu.

Se nada sobra, a tela mostra Nenhuma CND será atualizada!, com as causas prováveis.

Acompanhe e cancele as CNDs em progresso

Clique na ampulheta (Ver CNDs sendo processadas agora) para abrir a gaveta CNDs em Progresso. Ela diz Buscando certidões agora. A gaveta recarrega toda vez que você a abre.

Elementos da gaveta

Elemento	O que faz
Número ao lado do título	Soma as buscas em andamento listadas.
Atualizar	Atualiza a lista.
Cancelar selecionados	Aparece com pelo menos uma busca marcada. Cancela só as marcadas.
Cancelar todas	Aparece quando há buscas na lista. Cancela todas as buscas em andamento.
Empresa ou CNPJ	Filtra as empresas da lista por nome ou CNPJ.
Tipo da CND	Filtra os grupos por tipo de documento.
Limpar Filtros	O ícone de fechar ao lado dos filtros limpa tudo.
Paginação	10 tipos de documento por página. Dentro de cada tipo, 5 empresas por vez e 5 buscas por empresa.
Estado vazio	Nenhuma CND em progresso, com o texto Não há certidões sendo processadas no momento.. Com filtro sem resultado: Nenhum resultado encontrado, com o texto Nenhuma certidão corresponde aos filtros aplicados.

A lista reúne as buscas em andamento e as em nova tentativa. Ela respeita as empresas visíveis para o seu usuário.

O que Cancelar todas faz

Cancelar todas pede uma confirmação antes de agir. A janela de confirmação se chama Cancelar consultas em andamento? e diz: Se cancelar as consultas, elas sairão da fila e as consultas futuras irão para o final da fila.

Ao confirmar com Cancelar consultas, o HubCount faz isto:

• troca para Falha o status de todas as buscas em andamento ou em nova tentativa do escritório;
• grava, em cada uma, uma linha no histórico com a mensagem Cancelado pelo usuário Id e o número do seu usuário;
• recarrega a gaveta e avisa: Todas as consultas em andamento foram canceladas.

Três cuidados:

• O botão atinge todo o escritório, não só as empresas que você vê nem as da página aberta.
• A busca cancelada fica como Falha na execução. No detalhe, o documento que já tinha resultado continua mostrando esse resultado, e o histórico registra o cancelamento.
• Para tentar de novo, peça uma nova consulta. Enquanto isso, a próxima busca segue a periodicidade.

Se o servidor não consegue cancelar tudo, a tela mostra Não foi possível cancelar as buscas no momento. Na seleção, mostra Não foi possível cancelar os itens selecionados.

Envie os documentos por e-mail

Envie a uma empresa

O e-mail sai com o assunto Certidões Negativas de Débito. Ele traz uma tabela com Certidão, Situação e Vencimento e o link Clique aqui para baixar um ZIP. O envio individual leva só os documentos válidos: os que estão sem débitos ou negativos e não venceram.

O botão Enviar fica desativado com o campo vazio. Enquanto o e-mail do representante carrega, o campo fica bloqueado. Se o envio falha, a tela mostra Falha ao enviar email.

Baixe todos os documentos de uma empresa

O ícone de download da linha (Baixar documentos da empresa) gera um ZIP com os PDFs de todos os documentos da empresa que têm arquivo, de qualquer status. Cada arquivo se chama com o tipo do documento, o CNPJ, a data e um número. Se falhar, a tela mostra Não foi possível baixar os documentos.

Exporte e envie em lote

O botão de exportar do cabeçalho abre a janela Exportar Dados. Na área de CNDs ela tem uma seleção de empresas e dois blocos de ações. Veja também Atualizar, exportar e tags.

Seleção de empresas

A janela avisa: Obrigatório para envio por e-mail. Nas exportações com filtros, se nada for selecionado, aplica-se a todas as empresas.

Aba	O que faz
Empresa	Escolha várias empresas. Selecionar Todas carrega todas. Remover todas desmarca.
Grupo	Escolha grupos. A ação vale para todas as empresas deles.
Colar CNPJs	Cole os CNPJs e clique em Confirmar CNPJs. Os CNPJs viram uma seleção na aba Empresa.

Envio por e-mail aos clientes

O bloco Envio por e-mail manda os PDFs aos clientes sem passar pelo seu e-mail. Os três botões exigem pelo menos uma empresa ou grupo. Sem isso, a tela mostra Selecione ao menos uma empresa ou grupo para enviar CNDs por e-mail.

Botão	O que envia
Últimos buscados	O último documento disponível de cada tipo, qualquer que seja o status e a validade.
Últimos válidos	O último documento válido, dentro da validade.
Válidos sem débitos	O último documento válido e sem débitos.

Ao clicar, a tela avisa CNDs encaminhadas para processamento. Os documentos serão enviados para os e-mails configurados dos clientes. O envio roda em segundo plano.

Regras do envio:

• Destinatário. O e-mail personalizado da empresa, quando existe. Senão, o e-mail do representante. Cadastre o representante em Responsáveis e representantes.
• Empresa sem e-mail. Ela não recebe. O processo registra Endereço de e-mail do representante não encontrado da(s) empresa(s) e os CNPJs.
• Empresa sem documento. Ela é pulada.
• Bloqueio do escritório. Se Bloquear envio de emails de CNDs diretamente para clientes. estiver marcada, o envio é recusado. Veja Configurações do escritório.
• Válido com débitos. Com Considerar 'Válido Com Débitos' como 'Válido' no envio de emails marcada, esse status passa a valer como válido nos e-mails aos clientes, para a situação fiscal e a CND federal.

Exportação com filtros

O bloco Exportação com filtros tem duas ações. Cada uma se abre ao clicar e traz filtros próprios. Aqui, sem escolher empresa nem grupo, a ação vale para todas as empresas.

Planilha de conferência. Clique em Exportar planilha de conferência, filtre e clique em Exportar Excel. O arquivo conferencia.xlsx baixa direto. Se falhar, a tela mostra Não foi possível exportar a planilha de conferência.

Filtro	Opções
Situação das CNDs	Válida, Não válida, Vencida, Com Débitos, Sem débitos e Em andamento. Sem escolha, vale Todas as situações.
Tipos de CND	Os tipos agendados. Sem escolha, vale Todos os tipos.

A planilha tem três abas.

Aba	O que traz
Resumo Por Documento	Uma linha por tipo, com válidos, com pendência, indisponíveis, total e um status colorido: OK, Com Pendência ou Não Disponivel.
Resumo Por Empresa	Uma linha por empresa, com grupo, CNPJ, responsável, representante, usuários, a situação do cadastro, os totais por status e um status: OK, Com Pendência, Não Disponivel ou Erro Cadastro.
Todos Documentos	Uma linha por empresa e documento, com esfera, nome, datas de criação e de expiração, o status (OK, OK (com débitos), Com Pendência ou Não Disponível) e a mensagem de erro.

ZIP por e-mail. Clique em Exportar Documentos, filtre, digite o e-mail em E-mail para envio e clique no botão de envio. O botão só se ativa com um e-mail válido. Um e-mail inválido mostra Endereço de email inválido.

O ZIP leva os PDFs e uma planilha resumo.xlsx com as abas Dados e Resumo. O filtro de situação só vale quando você escolhe uma única situação. Ao terminar, a tela avisa Relatório de documentos enfileirado. Você receberá o arquivo no e-mail informado em breve. Se falhar, mostra Não foi possível enviar os documentos.

Logs de integração

Abra a aba Logs para ver cada tentativa de busca, com o resultado. Use quando uma empresa não atualiza.

Filtro	O que faz
Empresa	Busca por razão social ou CNPJ.
Sistema	Escolhe o tipo de documento. A lista mostra até 20 opções por vez. Digite para achar o seu. O padrão é Todos os sistemas.
Status	Todos, Sucesso, Falha, Em andamento ou Tentando novamente.
Período	Data inicial e final.
Limpar filtros	Volta aos padrões.

A tabela mostra Empresa, CNPJ, Sistema, Status e uma última coluna que a tela chama de Dados, com a data e a hora da tentativa. Pagine de 10, 20, 50 ou 100 linhas. Sem resultado, a tela mostra Nenhum log encontrado, com o texto Ajuste os filtros para visualizar os logs de integração das CNDs.

O botão Exportar Excel baixa logs_integracao_cnds.xlsx com todos os registros do filtro, não só a página aberta. A planilha traz uma coluna a mais, Erro, com a mensagem de cada falha. O botão fica desativado quando a tabela está vazia. Se falhar, a tela mostra Não foi possível exportar os logs.

Exemplo: a Contabilidade Exemplo

A Contabilidade Exemplo monitora cinco empresas. Hoje é 21/10/2026. A tabela mostra a situação dos documentos de cada uma.

Empresa	Federal	Estadual	Municipal	Situação Fiscal
Aurora Comércio Ltda (SP)	Válido	Com Débitos	Válido	Válido
Borges Serviços Ltda (RJ)	Válido	Válido	Vencido	Com Débitos
Cedro Indústria Ltda (MG)	Com Débitos	Vencido	Válido	Válido
Delta Tecnologia Ltda (PR)	Válido	Válido	Com Débitos	Vencido
Estrela Alimentos Ltda (RS)	Vencido	Com Débitos	Válido, mas com débitos	Válido

Aqui, Vencido é um documento com validade anterior a hoje. Ele conta no botão Expirado. Válido, mas com débitos é a certidão negativa que lista débitos: conta em Com Débitos e em Negativa.

A Contabilidade Exemplo faz isto na segunda de manhã.

O que fazer com cada status

Status	O que a Contabilidade Exemplo faz
Sem débitos ou Válido	Nada. Baixa o PDF só se o cliente pedir. A busca seguinte vem pela periodicidade.
Com Débitos	Abre o PDF para ver os débitos, avisa o responsável pela empresa e pede nova busca depois da regularização, respeitando a regra dos 10 dias.
Negativa com débitos	Confere os débitos que a certidão cita. A certidão ainda vale para o cliente.
Positiva	Trata como pendência: abre o PDF e pede ao cliente a regularização.
Expirado	Pede nova busca da empresa e do tipo. Se a busca falhar, olha o histórico.
Em progresso	Espera. Se a busca fica muito tempo, cancela só aquela e pede de novo.
Falha	Abre o histórico do documento e lê a mensagem. Corrige o certificado ou o cadastro e pede nova busca.

Problemas comuns

Limite de 25 empresas excedido para captação de CNDs

O pedido de atualização tinha mais empresas que o permitido. O texto completo da tela é:

Limite de 25 empresas excedido para captação de CNDs. Selecione menos empresas, utilize a opção “Todas as Empresas” para agendar a captação em segundo plano, ou configure a periodicidade de procura.

Com mais de 250 empresas, a mesma mensagem aparece com o número 250. A janela da versão nova não tem a opção “Todas as Empresas”. Divida o pedido em partes menores ou configure a periodicidade em Configure a busca. Quem tem a autorização Admin não tem o limite de 25.

Selecione pelo menos uma empresa

Você clicou em Atualizar CNDs sem escolher empresa. Escolha empresas, um grupo ou CNPJs.

Selecione pelo menos um tipo de CND para consultar.

Você escolheu Selecionar CNDs e não marcou nenhum tipo. Marque ao menos um, ou volte para Todas agendadas.

Nenhuma CND será atualizada!

O servidor não achou nada para consultar. O texto completo é:

Nenhuma CND será atualizada! Verifique o histórico de busca do documento, se ele foi atualizado recentemente, se o campo ‘tipo de empresa’ e o endereço no cadastro está preenchido corretamente, em caso de documento estadual (SINTEGRA/ICMS) certifique que o campo IE esteja preenchido no cadastro da empresa, ou se já foi configurada a periodicidade do documento.

Siga a lista da mensagem:

1. Abra o histórico do documento. Se ele foi atualizado há menos de 10 dias, a consulta espera.
2. No cadastro da empresa, confira o tipo de empresa, o endereço, a cidade e a inscrição estadual.
3. Confira se o documento tem periodicidade em Configure a busca.

Não foi possível enfileirar a atualização de CNDs.

A atualização não entrou na fila. Tente de novo. Se persistir, chame o suporte e informe o horário.

Nenhuma CND encontrada

A esfera aberta não tem nenhum documento com periodicidade e empresa em algum status. Configure o agendamento em Configure a busca. Confira também se o filtro de empresa ou de grupo não está escondendo as empresas.

Nenhuma CND encontrada para esta empresa.

Ao expandir a empresa, nenhum documento aparece. A empresa ainda não teve busca bem-sucedida, ou o filtro de status escondeu os documentos. Limpe o filtro com Todos. Se continuar vazio, veja a aba Logs para saber se a busca falhou.

Este documento não está disponível para atualização automática.

O documento não aceita agendamento. O aviso aparece no lugar da frequência. Peça uma consulta manual, quando houver, ou guarde o PDF por outro meio.

Necessário cadastro de IE

O documento consulta o Sintegra ou o ICMS do estado. Cadastre a inscrição estadual na empresa. Veja Empresas.

A empresa não possui nenhum certificado válido para o acesso ao portal do(a)

O texto completo termina com o nome do documento e a frase: Verifique o cadastro de certificados da empresa e tente novamente. A empresa não tem certificado A1, ou o certificado não serve para aquele portal. Cadastre ou vincule o certificado em Certificados e logins. Para a CND federal e a situação fiscal, o certificado precisa ser de e-CAC.

Não foi encontrado um Certificado válido do(s) tipo(s)

O texto completo diz o tipo, o nome da empresa e termina com: Verifique se não há algum certificado expirado. Renove o certificado vencido e vincule o novo à empresa.

Erro ao entrar no perfil da empresa verifique se seu certificado possui procuração para o CNPJ

O certificado usado não tem procuração para o CNPJ da empresa na Receita Federal. Outorgue a procuração no e-CAC ou cadastre o certificado da própria empresa. Depois peça nova busca.

Preencha corretamente a Inscrição Municipal

A CND municipal de Osasco SP exige a inscrição municipal. A busca também exige o CNPJ e o telefone do representante. As três mensagens são Preencha corretamente o CNPJ, Preencha corretamente a Inscrição Municipal e Preencha corretamente o Telefone do Representante. Corrija o cadastro da empresa ou do representante e peça nova busca.

Não foi possível buscar o documento, tente novamente mais tarde.

A assinatura da consulta expirou durante a busca. Peça de novo mais tarde. A busca automática tenta outra vez sozinha.

Ocorreu um erro ao iniciar a busca de CND, entre em contato com o suporte

O serviço de busca da CND não respondeu. Peça a consulta em outro horário. Se a mensagem se repetir para vários documentos, chame o suporte.

Documento inexistente.

O download pediu um documento que não existe mais, ou a empresa do arquivo não é do seu escritório. Atualize a tela. Se persistir, peça uma nova consulta.

Não foi possível buscar documento.

O documento existe, mas a busca não gravou o PDF. Peça uma nova consulta do documento da empresa.

Cancelado pelo usuário Id

Essa linha aparece no histórico quando uma busca em andamento foi cancelada. O número é o do usuário que cancelou. Não é erro do documento. Peça nova busca, se precisar.

O documento … não pode ser agendado com frequência …

O documento tem uma frequência mínima. O texto completo tem este formato: O documento ‘tipo’ não pode ser agendado com frequência ‘frequência’. A frequência mínima permitida é ‘mínima’. O tipo aparece com o nome técnico. Escolha uma frequência igual ou mais longa que a mínima e salve de novo.

Envio de CNDs em lote para clientes está bloqueada!

O escritório marcou Bloquear envio de emails de CNDs diretamente para clientes.. Quem administra desmarca em Configurações do escritório. Enquanto isso, use o envio individual pelo ícone de e-mail da empresa.

Selecione ao menos uma empresa ou grupo para enviar CNDs por e-mail.

Os botões de Envio por e-mail exigem uma seleção. Escolha empresas ou grupos e clique de novo.

Endereço de e-mail do representante não encontrado da(s) empresa(s)

A mensagem termina com os CNPJs das empresas sem e-mail. Cadastre o representante com e-mail em Responsáveis e representantes e envie de novo.

Não foi possível enviar os documentos por e-mail.

O envio em lote falhou antes de enfileirar. Tente de novo com menos empresas. Se persistir, chame o suporte.

Não foi possível carregar os totais.

Os contadores dos botões de status não carregaram. Atualize a página. Se repetir, chame o suporte.

Veja também

• Visão geral do HubCount Alertas
• Atualizar, exportar e tags
• Regras de envio de e-mail
• Certificados e requisitos
• Certificados e logins
• Empresas