Se você notou que algumas faturas não foram carregadas corretamente ou se deparou com um ícone de alerta no seu painel, este guia vai te ajudar a auditar o problema detalhadamente e tomar as ações necessárias para regularizar o sistema.
🔍 1. Identificando o Alerta de Falha
No menu Faturas, o sistema exibe um aviso visual quando ocorrem problemas na importação automatizada:
-
O Alerta: Há um ícone de triângulo amarelo com uma notificação vermelha logo acima da tabela de faturas. Ao passar o mouse, ele exibe a mensagem "Falhas no processamento de faturas por e-mail".
-
Acessando os detalhes: Para entender o que deu errado, clique em cima desse ícone de alerta. Uma janela interna (modal) se abrirá com o histórico detalhado dos erros.
📋 2. Entendendo a Tela de Histórico de Falhas
Ao abrir a tela "Falhas no processamento de faturas por e-mail", você terá acesso às seguintes informações para auditoria:
-
E-mail: Mostra o endereço de e-mail de origem que tentou enviar a fatura para o sistema.
-
Assunto: Exibe o título do e-mail recebido (geralmente contendo o nome e o código identificador da fatura).
-
Motivo: Apresenta um ícone de alerta vermelho. Ao passar o ponteiro do mouse sobre este ícone, um balão informativo indicará a causa exata do erro — por exemplo, "Contrato não lido".
-
Data: A data exata em que o e-mail foi recebido e a falha foi registrada.
-
Ações (Ícone de Olho 👁️): No canto direito de cada linha, você pode clicar no botão de visualização para inspecionar mais detalhes sobre aquele erro específico.
🛠️ 3. Diagnóstico e Resolução de Erros Comuns
Ao analisar os motivos gerados na listagem, aplique as correções indicadas para cada cenário:
❌ Cenário A: "A senha do PDF está incorreta."
-
O problema: O documento enviado está protegido por uma senha que o sistema desconhece ou que está desatualizada. Se não houver uma senha cadastrada especificamente para a fatura na plataforma, a SolarZ tenta abrir o arquivo utilizando automaticamente o CPF do cliente cadastrado no sistema. Se o titular da conta na concessionária for diferente do cliente cadastrado na plataforma (por exemplo, a conta está no nome do cônjuge, antigo dono ou CNPJ), o sistema não conseguirá abrir o arquivo e exibirá o erro de senha incorreta.
-
A solução: Acesse o menu Unidades, localize o cadastro correspondente e atualize o campo de senha de abertura do PDF com os dados vigentes exigidos pela concessionária (como CPF/CNPJ do titular).
-
⚠️ Atenção sobre o processamento: A atualização da senha ou dos dados cadastrais só terá efeito para os próximos envios de e-mail. O sistema passará a processar tudo de forma 100% automática a partir do momento da correção.
Como corrigir o erro de senha do PDF
-
Clique no ícone de alerta na coluna Motivo.
-
Digite a senha correta do PDF no campo Senha.
Normalmente, a senha é o CPF ou CNPJ do titular, sem pontuação.
-
Clique em Salvar senha.
❌ Cenário B: "UC não encontrada: [Código]"
-
O problema: O robô conseguiu ler a fatura, mas o identificador extraído dela não bate com nenhum cadastro ativo na plataforma.
-
A solução: Busque pela unidade no menu Unidades. Se ela não existir, cadastre-a. Se já existir, edite o campo de identificação da Unidade Consumidora (UC) inserindo exatamente o mesmo número apontado pelo erro no relatório.
❌ Cenário C: "Contrato não lido"
-
O problema: O sistema processou a mensagem, mas falhou ao tentar mapear a conta à carteira de clientes por divergência de numeração contratual.
-
A solução: Valide o número do contrato informado no assunto do e-mail ou no documento anexado e ajuste o preenchimento no cadastro da respectiva Unidade Consumidora.
📥 4. Como tratar as faturas que já falharam? (Ação Obrigatória)
Os e-mails que já chegaram e estão retidos na lista de falhas não serão reprocessados automaticamente retroativamente após a correção do cadastro. Para regularizar essas contas antigas, siga o procedimento manual abaixo:
-
Na própria tela de falhas, localize a linha do erro.
-
Identifique o endereço que aparece na coluna E-mail ou clique no ícone do olho (👁️).
-
Acesse a caixa de e-mail integrada, localize a mensagem recebida e baixe o arquivo PDF original da fatura diretamente para o seu computador.
-
No menu Faturas do sistema SolarZ, clique no botão laranja
⬆️ Upload de Faturas(no canto superior direito).
-
Insira a senha correta de abertura (caso o sistema solicite na tela) e faça o upload manual do PDF para processá-lo imediatamente.
Acompanhar regularmente a tela de Falhas no processamento de faturas por e-mail é fundamental para garantir a saúde da sua operação e a pontualidade nas entregas. Na grande maioria das vezes, erros como "Contrato não lido" não significam uma falha no sistema, mas sim uma pequena incompatibilidade de dados — como um número de contrato digitado incorretamente no cadastro da Unidade Consumidora ou uma mudança de formato por parte da concessionária.
Ao realizar a auditoria visual com o ícone do "olho" (👁️) e corrigir os cadastros preventivamente, você garante que as próximas faturas entrem de forma 100% automática, poupando tempo operacional e evitando a necessidade de uploads manuais no futuro. Mantendo esses dados alinhados, sua esteira de faturamento rodará sempre sem gargalos!