Visão geral do Finder Contas

O Finder Contas é o portal que acompanha, sozinho, as contas de consumo e os tributos dos imóveis administrados pela imobiliária: energia (Equatorial), água (Saneago), IPTU (Goiânia, Aparecida de Goiânia, Anápolis, Goianira, Senador Canedo e Trindade) e gás de condomínio. O Finder entra nos portais das concessionárias e das prefeituras, lê as faturas e os débitos, guarda o boleto (PDF, código de barras e PIX quando o portal fornece) e mostra tudo no portal: o que está em dia, o que está vencido e o que vence nos próximos dias.

O objetivo é a imobiliária saber, sem entrar em cada site, quais imóveis têm conta atrasada, cobrar o locatário ou o proprietário a tempo e evitar corte de energia ou água e inscrição em dívida ativa.

O que o Finder faz por você

• Consulta automática: num dia e hora que você escolhe (por exemplo, todo domingo à meia-noite), todas as contas voltam para a fila e o Finder consulta uma a uma. Também dá para consultar na hora uma conta, um imóvel ou uma concessionária (veja Como consultar agora).
• Faturas em aberto e vencidas: cada fatura encontrada aparece com referência, vencimento, valor e situação (a vencer, vencida, paga, sem débito).
• Baixa automática: quando uma fatura some da lista do portal da concessionária numa consulta completa, o Finder marca como sem débito (normalmente foi paga).
• Relatórios e exportação: inadimplência por imóvel, faturas por mês e contas que precisam de atenção, na tela, em CSV ou em PDF com o logo da imobiliária, inclusive enviados por e-mail automaticamente. As listas de Faturas, Imóveis e Contas também saem em PDF ou CSV com os filtros da tela.
• Integração: o SAGI (sistema da imobiliária) envia imóveis e contas e recebe as faturas de volta; outros sistemas podem usar a API e os webhooks.

Conceitos principais

Imobiliária

É a empresa cliente. Cada imobiliária enxerga só os próprios imóveis, contas, faturas e usuários.

Imóvel

Um endereço administrado pela imobiliária. O campo mais importante é o Nº do objeto: o código do imóvel no sistema da imobiliária (SAGI). Sem o nº do objeto, as contas do imóvel não entram na consulta automática. Veja Imóveis.

Conta

Uma conta de consumo ou tributo de um imóvel: tipo (Energia, Água, IPTU, Gás), concessionária e os dados de acesso que o Finder usa no portal. Cada concessionária pede dados diferentes (UC, matrícula, inscrição, CCI, CPF/CNPJ do titular…). A lista completa está em Concessionárias e dados de acesso. Veja também Contas.

Fatura

Um débito encontrado na consulta: referência (mês/ano, ou ano/parcela no IPTU), vencimento, valor, código de barras, PIX, PDF e a situação:

• A vencer: em aberto, dentro do prazo.
• Vencida: em aberto, com o vencimento já passado.
• Paga: a concessionária mostrou a fatura como paga.
• Sem débito: a fatura saiu da lista do portal numa consulta (baixa observada; em geral foi paga).

Veja Faturas.

Consulta automática, fila e ciclo

Cada conta ativa tem um lugar na fila de consultas da sua concessionária. Um ciclo recoloca todas as contas na fila (no horário agendado ou quando alguém pede). O Finder pega as contas da fila, consulta o portal e grava o resultado. Detalhes em Como funcionam as consultas automáticas.

Máquinas de consulta

As consultas rodam em computadores preparados pela P3 Sistemas (da P3 ou da imobiliária), chamados de máquinas de consulta. O usuário da imobiliária não precisa instalar nada: tudo é feito pelo portal. A instalação e o acompanhamento das máquinas são do administrador da plataforma, a equipe da P3 Sistemas (Painel de consultas). A imobiliária acompanha as consultas em Configurações → Consultas automáticas e na tela Contas.

Perfis de usuário

O perfil aparece com o mesmo nome em todas as telas (topo da página, Meu perfil e Usuários): "Usuário", "Gerente" ou "Administrador".

O menu

• Dashboard, Imóveis, Contas, Faturas, Relatórios e Ajuda: para todos.
• Gestão: Usuários, Assinatura, Auditoria e Configurações (gerente e administrador). O usuário vê Configurações e Assinatura no bloco principal.
• Integrações: Sistemas conectados (SAGI), Chaves de API, Webhooks e Documentação (gerente e administrador).
• Consultas automáticas: Painel de consultas, Fila de consultas, Gerenciar fila e Registro de consultas (só o administrador da plataforma, a equipe da P3 Sistemas). O gerente e o usuário acompanham as consultas em Configurações → Consultas automáticas.
• Plataforma (só administrador): Imobiliárias, Planos e assinaturas, Faturas, Integrações da plataforma (P3IA, WhatsApp e P3Payments) e Concessionárias.

O botão ☰ no topo recolhe o menu para mostrar só os ícones (a preferência fica guardada no navegador). No celular, o menu abre por cima da tela e fecha ao navegar.

No celular

O Finder funciona no navegador do celular, e os aplicativos para Android e iPhone estão a caminho. No celular:

• uma barra no rodapé leva ao Painel, Imóveis, Contas e Faturas; o botão Menu abre o menu completo;
• as listas (imóveis, contas, faturas, relatórios) aparecem em cartões: o título é o imóvel e cada linha mostra o nome da informação e o valor;
• os indicadores do topo das telas aparecem dois por linha;
• Exportar PDF e Exportar CSV baixam o arquivo no navegador; no aplicativo, abrem o Compartilhar do celular (WhatsApp, e-mail, salvar).

O painel fica no endereço /painel. O endereço findercontas.com.br abre a apresentação do Finder; quem já entrou é levado direto ao painel.

Topo da tela

• Buscar...: digite 2 letras ou mais para procurar imóveis (pelo nome ou endereço) e contas (pelo primeiro dado de acesso, como UC ou matrícula, ou pelo código da concessionária). Mostra até 5 de cada. Clicar num imóvel ou numa conta abre a tela do imóvel. Esc fecha. Sem resultado aparece "Nenhum resultado encontrado".
• Lua/sol: alterna entre tema claro e escuro (Modo escuro / Modo claro).
• Sino: avisos das últimas 24 horas (consultas concluídas ou com erro, faturas vencendo em até 3 dias, faturas que venceram sem pagamento). Veja Notificações.
• Seletor de imobiliária (só administrador): escolhe a imobiliária em que você está trabalhando. Veja Administração da plataforma.
• Seu nome: Meu perfil, Configurações e Sair.

Para procurar outras coisas, use a busca de cada tela: Imóveis (nome, endereço ou nº do objeto), Contas (imóvel, endereço, nº do objeto ou UC), Faturas (filtro Imóvel) e Relatórios.

Onde tirar dúvidas

• Menu Ajuda: este manual, com a caixa Buscar no manual... e o botão Manual completo (abre o manual inteiro numa página). O Guia rápido mostra onde fazer cada coisa.
• Botão Pergunte à IA no canto inferior direito de qualquer tela: abre a P3IA, a inteligência artificial da P3 Sistemas, que responde com base neste manual e começa pelo capítulo da tela em que você está. Se a resposta não ajudar, clique no 👎: a pergunta vai para a lista de melhorias do manual. Sem a IA ligada para a sua imobiliária, no lugar aparece o botão ? (Ajuda desta tela), que abre o capítulo do manual da tela.
• Versão pública do manual: https://findercontas.com.br/manual

Acesso, perfil e notificações

Como entrar no Finder, recuperar a senha, cadastrar a imobiliária, cuidar do próprio perfil (nome, e-mail, senha, verificação em duas etapas) e usar o sino de notificações.

Como entrar no Finder

1. Abra https://findercontas.com.br (a tela "Acesse sua conta").
2. Digite o E-mail e a Senha (o ícone de olho mostra ou oculta a senha digitada).
3. Se aparecer a verificação de segurança (Cloudflare), espere ela terminar; enquanto isso o botão Entrar fica desabilitado.
4. Clique em Entrar. Deu certo, aparece "Bem-vindo!" e abre o Dashboard.

Mensagens que podem aparecer:

• "E-mail ou senha incorretos": confira os dois. A mesma mensagem aparece quando o usuário ou a imobiliária foram desativados.
• "Muitas tentativas. Tente de novo em N min.": depois de 5 senhas erradas em 10 minutos, o acesso fica bloqueado por 15 minutos (os números podem ser ajustados pelo administrador da plataforma).
• "Aguarde a verificação de segurança terminar e tente de novo.": a verificação da Cloudflare ainda não concluiu.
• "Não foi possível confirmar a verificação de segurança. Aguarde o selo de verificação e tente de novo.": a verificação foi recusada; espere o selo aparecer de novo e tente outra vez.

A sessão dura 12 horas (valor ajustável pelo administrador) e é renovada sozinha a cada 30 minutos enquanto o portal está aberto na tela.

Como entrar com a verificação em duas etapas

Se você ativou a verificação em duas etapas, depois da senha aparece a tela "Verificação em duas etapas":

1. Abra o aplicativo autenticador do celular (Google Authenticator, Microsoft Authenticator, Authy…).
2. Digite o código de 6 dígitos do Finder em Código do autenticador.
3. Clique em Confirmar.

O código tem de ser digitado em até 5 minutos depois da senha. Depois de 5 códigos errados, o acesso fica bloqueado por 15 minutos. Para voltar e usar outro usuário, clique em Voltar e entrar com outra conta.

• "Código inválido. Confira a hora do celular e tente de novo.": o relógio do celular pode estar adiantado ou atrasado; ative a hora automática.
• "A verificação expirou. Entre com e-mail e senha de novo.": passaram os 5 minutos; comece de novo.

Perdeu o celular? Peça ao suporte da P3 Sistemas para desativar a verificação em duas etapas do seu usuário.

Como recuperar o acesso (todas as formas)

Depende do que aconteceu:

Como recuperar a senha (esqueci minha senha)

1. Na tela de login, clique em Esqueci minha senha (ao lado do campo Senha).
2. Digite o e-mail e clique em Solicitar.
3. Aparece "Pedido registrado." com uma destas mensagens:
   • "Se o e-mail estiver cadastrado, você receberá em instantes um link para criar uma nova senha (vale 30 minutos).": o e-mail da plataforma está configurado. Chega um e-mail "Redefinição de senha - Finder Contas" com o botão Criar nova senha.
   • "Se o e-mail estiver cadastrado, o responsável pela sua imobiliária receberá o pedido e poderá redefinir sua senha.": o pedido aparece para o gerente na tela Usuários (etiqueta "pediu nova senha"); ele gera o link e envia para você por WhatsApp ou e-mail.

Por segurança, a resposta é a mesma exista ou não o e-mail informado. O link vale 30 minutos e uma única vez.

Como criar a nova senha pelo link

1. Abra o link recebido (tela Redefinir senha).
2. Digite a Nova senha (mínimo 8 caracteres, com letras e números) e repita em Confirmar nova senha.
3. Clique em Salvar nova senha. Aparece "Senha redefinida. Entre com a nova senha." e a tela de login.

• "Link inválido ou expirado. Peça um novo.": o link passou de 30 minutos ou já foi usado.
• "Este link está incompleto. Peça um novo link ao responsável pela sua imobiliária.": o link foi copiado pela metade.
• "Mínimo 8 caracteres", "Use letras e números", "As senhas não conferem": ajuste a senha digitada.

Como cadastrar a imobiliária

1. Na tela de login, clique em Cadastre sua imobiliária (em "Ainda não tem conta?").
2. Preencha Nome da Empresa, Nome Completo, E-mail, CNPJ (opcional), Telefone (opcional), Senha (mínimo 6 caracteres) e Confirmar Senha.
3. Clique em Cadastrar. Aparece "Registro realizado com sucesso!" e você já entra no portal.

A imobiliária nasce no plano Free (até 10 imóveis e 2 usuários) e você entra como gerente. Para ampliar o plano, fale com a P3 Sistemas. Se o e-mail já existir, aparece "E-mail já cadastrado".

Imobiliárias que usam o SAGI normalmente já são criadas pela integração (o SAGI envia o CNPJ e o Finder cria a imobiliária e o gerente).

Como alterar meu nome ou e-mail

1. Clique no seu nome no topo e depois em Meu perfil.
2. No cartão Dados, altere o Nome ou o E-mail e clique em Salvar.
3. Aparece "Perfil atualizado. Faça login novamente para ver o nome novo no topo."

• "Este e-mail já está em uso.": outro usuário já usa esse e-mail.
• "Informe seu nome." ou "Nome muito curto": o nome precisa ter pelo menos 2 letras.

O cartão da esquerda mostra seu perfil, a imobiliária, o último acesso e desde quando você é usuário. Mudanças de perfil ficam na Auditoria.

Como trocar minha senha

1. Em Meu perfil, cartão Alterar senha, digite a Senha atual, a Nova senha (mínimo 8 caracteres, com letras e números) e repita em Confirmar.
2. Clique em Alterar senha. Aparece "Senha alterada".

• "Senha atual incorreta.": a senha atual digitada não confere (fica registrado na Auditoria como "Senha atual errada").
• "A senha precisa ter pelo menos 8 caracteres." / "A senha precisa ter letras e números.": ajuste a nova senha.

Como ativar a verificação em duas etapas

1. Em Meu perfil, cartão Verificação em duas etapas (etiqueta Desligada), clique em Ativar.
2. Leia o QR code com o aplicativo autenticador (ou digite a Chave manual mostrada).
3. Digite o código de 6 dígitos que o aplicativo mostra e clique em Confirmar e ativar. Aparece "Verificação em duas etapas ativada" e a etiqueta muda para Ativa.

• "Código inválido. Escaneie o QR de novo e confira a hora do celular.": o código não bateu; confira a hora do celular.
• cancelar desiste da ativação.

A partir daí, todo login pede o código (veja Como entrar com a verificação em duas etapas). A plataforma pode exigir a verificação de administradores; nesse caso o cartão mostra "A plataforma exige a verificação em duas etapas para administradores. Ative abaixo."

Como desativar a verificação em duas etapas

1. Em Meu perfil, cartão Verificação em duas etapas, clique em Desativar.
2. Digite sua senha em "confirme sua senha" e clique em Desativar agora.

Aparece "Verificação em duas etapas desativada". Com a senha errada aparece "Senha incorreta.".

Notificações (o sino)

O sino no topo mostra até 30 avisos das últimas 24 horas, os mais recentes primeiro. Ele se atualiza sozinho (a cada 30 segundos e na hora em que uma consulta termina):

• Consulta concluída · (concessionária) e Consulta com erro · (concessionária): com o imóvel e a mensagem da consulta em português simples (Mensagens das consultas). Clique para abrir a conta.
• Fatura vence hoje / Fatura vence em N dia(s): faturas em aberto que vencem em até 3 dias. Clique para abrir a conta.
• Fatura venceu sem pagamento: faturas que venceram nos últimos 3 dias e continuam em aberto.
• Só para administradores: alertas de operação abertos (máquina sem sinal, erros seguidos etc.), que levam ao Painel de consultas.

O número vermelho no sino é a quantidade de não lidos (acima de 9 aparece "9+"). Marcar todas como lidas limpa o contador; clicar num aviso marca só ele como lido e abre a tela dele. A leitura fica guardada para o seu usuário. Sem nada nas últimas 24 horas aparece "Nenhuma notificação recente".

Avisos na tela (pop-ups)

No alto da lista do sino, a caixa Avisos na tela escolhe se aparecem pop-ups no canto da tela para avisos novos:

• Avisos na tela: todos: pop-up para erros e para faturas vencendo;
• Avisos na tela: só erros: pop-up só para consultas com erro e faturas que venceram sem pagamento;
• Avisos na tela: desligados (padrão).

A escolha vale só para o seu navegador e não muda a lista do sino. Consultas com sucesso nunca geram pop-up.

Outras formas de ser avisado

• Relatórios por e-mail (PDF automático): Configurações → Relatórios em PDF.
• Webhooks para o sistema da imobiliária: Integrações → Webhooks.
• Alertas de operação por e-mail e WhatsApp: só para a equipe da P3 Sistemas.

Como mudar o tema (claro ou escuro)

Clique no ícone de lua (Modo escuro) ou de sol (Modo claro) no topo. A escolha fica guardada no navegador.

Como sair

Clique no seu nome no topo e em Sair.

Dashboard

O Dashboard é a primeira tela depois do login: um resumo da carteira da imobiliária (imóveis, contas, faturas vencidas e a vencer) e da saúde das consultas automáticas. O título cumprimenta você ("Bom dia", "Boa tarde" ou "Boa noite") e o subtítulo mostra a imobiliária e a hora da última atualização. A tela se atualiza sozinha a cada minuto. O botão Relatórios, no alto, abre a tela Relatórios.

Indicadores do topo

Cada cartão pode ser clicado:

Saúde das consultas

• Consultas nas últimas 24h: porcentagem de consultas com sucesso (verde a partir de 70%, amarelo a partir de 40%, vermelho abaixo; "sem consultas" quando não houve nenhuma), com "N ok · N erro · N na fila".
• Contas com problema: contas cuja última consulta indicou problema de cadastro: Dados de acesso recusados, UC fora da lista, Cadastro incompleto ou Faturas não lidas. Precisam de correção nos dados de acesso (veja Situações e mensagens).
• Nunca consultadas: contas que ainda não passaram por nenhuma consulta (conta nova, imóvel sem nº do objeto, ou a fila ainda não chegou nelas).
• Contas por tipo: quantidade de contas de IPTU, Energia, Água, Gás, Condomínio e outros (este cartão não abre outra tela).

Os três primeiros cartões abrem a tela Contas já filtrada: Na fila de consulta, Com problema de cadastro ou Nunca consultadas (veja Lista de contas). Para trocar, use o filtro de situação.

Gráficos

• Faturas por mês de vencimento: pago, a vencer e vencido por mês; escolha 6 meses, 12 meses ou 24 meses na caixa ao lado do título.
• Carteira por situação: valor e quantidade das faturas pagas, a vencer, vencidas e sem débito.
• Consultas automáticas · últimos 30 dias: consultas com sucesso e com erro por dia.

Listas

• Precisa de atenção: até 8 contas com problema de cadastro na última consulta e até 8 faturas que vencem nos próximos 7 dias. Clique no imóvel para abrir a conta. O link ver relatório abre Relatórios. Sem nada pendente aparece "Nada pendente".
• Últimas consultas: as 10 consultas mais recentes (Quando, Imóvel, Concessionária, Resultado). O resultado mostra ok ou, quando a consulta não foi concluída, o motivo em português simples (passe o mouse para ler a mensagem inteira; veja Mensagens das consultas). Só o administrador da plataforma vê o código técnico do erro. O link todas as contas abre a tela Contas.
• Faturas recentes: as 10 faturas em aberto registradas ou consultadas mais recentemente (Imóvel, Ref., Valor, Venc., Status). O link todas as faturas abre a tela Faturas.
• Só para administradores: Resumo por imobiliária, com imóveis, faturas, a vencer, vencido e inadimplência de cada cliente.

As tabelas podem ser ordenadas clicando no título da coluna; a ordem escolhida fica guardada no navegador.

Onde ver os mesmos números em detalhe

Perguntas comuns

O Dashboard mostra valor vencido, mas o locatário diz que pagou

O Finder mostra o que o portal da concessionária mostrava na última consulta. Pagamentos feitos depois só aparecem na próxima consulta (e o portal da concessionária também leva alguns dias para baixar o pagamento). Para atualizar agora, abra a conta e clique em Consultar agora. Outras formas em Como consultar agora.

Por que o % de inadimplência é alto se quase todas as contas estão em dia?

O cálculo é por imóvel: basta uma fatura vencida em qualquer conta do imóvel (energia, água, IPTU ou gás) para o imóvel contar como em atraso.

Por que o número de "Nunca consultadas" não diminui?

Confira se os imóveis têm Nº do objeto e se a frequência das consultas não está em "Só quando eu pedir" (Configurações → Consultas automáticas). Veja Cadastrei a conta e ela não é consultada.

Imóveis

Na tela Imóveis ficam todos os imóveis da carteira. Cada imóvel reúne as contas dele (energia, água, IPTU, gás) e mostra o total em atraso e a vencer. A tela do imóvel é também onde se cadastram, editam, excluem e consultam as contas.

Lista de imóveis

Menu Imóveis (título "Seus Imóveis", com o total de imóveis cadastrados). Colunas:

• Imóvel: nome e, abaixo, o endereço (quando é diferente do nome). Clique no nome para abrir o imóvel.
• Cidade/UF (em tela menor, aparece embaixo do nome do imóvel).
• Contas: quantidade de contas ativas; clique para abrir o imóvel (em tela menor, "N conta(s)" aparece embaixo do nome).
• Última consulta: data e hora da consulta mais recente, com uma etiqueta por conta: Em dia, Em atraso, Sem débito, Com débito, UC fora da lista, Dados de acesso recusados, Cadastro incompleto, Faturas não lidas, Na fila, Site indisponível, Aguardando verificação ou Nunca (passe o mouse para ver a concessionária e a data). "Nunca" sozinho = nenhuma conta do imóvel foi consultada ainda. O significado de cada etiqueta está em Situações e mensagens.
• Ações: botões Ver (olho), Editar (lápis) e Excluir (lixeira).

Clique no título de uma coluna para ordenar; a ordem fica guardada no navegador. A lista mostra 20 imóveis por página. Em telas menores (notebook), algumas colunas saem da tabela e a informação aparece embaixo de outra coluna, para a tabela caber sem rolar para o lado.

Como procurar um imóvel

Na caixa Buscar por nome, endereço ou nº do objeto..., digite parte do nome ou do endereço, ou o nº do objeto completo (o número exato; parte do número não encontra). Outras formas de achar um imóvel: a busca do topo da tela (nome ou endereço), a tela Contas (busca por imóvel, endereço, nº do objeto ou UC) e o filtro Imóvel da tela Faturas.

Como exportar a lista de imóveis

No alto da lista há dois botões. Os dois respeitam a busca digitada:

Enquanto o arquivo é gerado, o botão mostra "Gerando...". Aparece "PDF gerado" ou "CSV gerado"; se falhar, "Não foi possível exportar". Todos os perfis exportam, e toda exportação fica registrada na Auditoria. O logo do PDF é cadastrado em Configurações → Relatórios em PDF. Para exportar faturas, contas ou relatórios, veja Como exportar (todas as formas).

Como cadastrar um imóvel

1. Em Imóveis, clique em Adicionar.
2. Preencha:
   • Nome (obrigatório): como a imobiliária identifica o imóvel. Sem ele aparece "Nome obrigatório".
   • Nº do objeto: o código do imóvel no seu sistema (SAGI). Só números ("Somente números"). Sem ele as contas não entram na consulta automática.
   • CEP: ao sair do campo, Endereço, Cidade e Estado são preenchidos sozinhos (quando o CEP é encontrado).
   • Endereço, Estado (UF), Cidade.
   • Grupo: a carteira do imóvel (usada no filtro "carteira" dos relatórios).
   • Observação.
3. Clique em Salvar. Aparece "Imóvel criado" e abre a tela do imóvel, pronta para Adicionar Conta.

Se aparecer "Erro ao salvar imóvel" num imóvel novo, a causa mais comum é o limite de imóveis do plano ter sido atingido (veja o cartão Seu Plano em Configurações); fale com a P3 Sistemas para ampliar.

Outras formas de cadastrar imóveis

• SAGI: imobiliárias integradas normalmente não cadastram imóveis no portal; o SAGI envia os imóveis (com o nº do objeto) e as contas sozinho. Veja Integração com o SAGI.
• API: outro sistema pode criar ou atualizar imóveis e contas pelo nº do objeto. Veja Documentação da API.

Como editar um imóvel

1. Na lista, clique em Editar (lápis) na linha do imóvel; ou, dentro do imóvel, no botão Editar.
2. Altere os campos e clique em Salvar (Cancelar volta sem salvar).

Aparece "Imóvel atualizado". As alterações ficam registradas na Auditoria, com o antes e o depois.

Como excluir um imóvel

1. Na lista, clique em Excluir (lixeira); ou, dentro do imóvel, no botão Excluir.
2. Confirme em Excluir Imóvel.

Aparece "Imóvel excluído". Só o gerente e o administrador excluem imóveis; para o usuário comum aparece "Erro ao excluir imóvel".

O que acontece:

• o imóvel sai da lista de Imóveis, das telas Contas e Faturas e deixa de contar no limite do plano;
• as contas do imóvel saem junto e param de ser consultadas (uma consulta que já estava em andamento termina, mas a conta não volta para a fila);
• os dados não são apagados do banco (dá para recuperar pelo suporte).

Para parar só uma conta e manter o imóvel, exclua a conta no cartão dela (menu ⋮ → Excluir, veja Como excluir uma conta). Imóveis que o SAGI deixa de enviar saem da carteira do mesmo jeito, junto com as contas (veja Integração com o SAGI).

Detalhe do imóvel

Ao abrir um imóvel aparecem:

• Cabeçalho: nome, endereço, cidade/UF e os botões Editar, Excluir, Adicionar Conta e Consultar agora (com uma setinha ao lado).
• Resumo: Contas, Em Atraso (quantas contas têm fatura vencida), Total Atraso e Total a Vencer.
• Um cartão por conta (veja abaixo). Sem contas aparece "Nenhuma conta cadastrada".
• Histórico de Consultas: as 20 consultas mais recentes das contas do imóvel: Concessionária, Status (Concluída ou Não concluída), Motivo (em português simples, dizendo o que houve e o que fazer; veja Mensagens das consultas) e Data. O administrador da plataforma vê o código técnico, a coluna Erro e a Duração. Sem nenhuma aparece "Nenhuma consulta registrada".

O cartão da conta

Cada cartão mostra:

• O nome da concessionária (ex.: Equatorial, Saneago, IPTU Goiânia) e, abaixo, o tipo e o número da conta ou a inscrição (ex.: "Energia · 10620590", "IPTU · 382.007.0084.0002").
• Os dados de acesso preenchidos, com o nome que a concessionária usa (ex.: "Unidade Consumidora (UC)", "Matrícula", "Inscrição Imobiliária").
• Para a Equatorial: UC no portal (a UC nacional descoberta na consulta, ou "não vinculada") e, quando o titular tem várias unidades, Titular no portal: N UCs · débito total (clique para ver as UCs; veja UCs deste titular no portal).
• Em Atraso (quantidade de faturas vencidas), A Vencer (quantidade) e Valor Atraso.
• Última consulta: data, hora e há quanto tempo ("hoje", "ontem", "há N dias"). Fica vermelha depois de 30 dias sem consulta. Ainda não consultada quando nunca foi consultada.
• A etiqueta com o resultado da última consulta, no canto de baixo, a mesma da tela Contas (ex.: Em dia, Em atraso, Sem débito, Dados de acesso recusados, Na fila, Site indisponível; Aguardando 1ª consulta quando ainda não há resultado). Passe o mouse para ler a dica. O significado de cada uma está em Situações e mensagens.
• Ver faturas: abre a janela "Faturas — (concessionária)" com as faturas em aberto da conta (Referência, Vencimento, Valor, Status e as ações PDF e Detalhes). Em Detalhes aparecem valor, referência, vencimento, consumo, o Código de Barras e o PIX Copia e Cola com botão Copiar, e os botões Ver PDF e Screenshot (o print do portal); Voltar retorna à lista. O link "N no histórico da conta (pagas ou sem débito)" abre a tela da conta.
• Menu ⋮ (Opções da conta): Abrir conta, Consultar agora, Editar, Excluir.

Como adicionar uma conta ao imóvel

1. No imóvel, clique em Adicionar Conta.
2. Escolha o Tipo (Energia, Água ou IPTU) e depois a Concessionária (a lista muda conforme o tipo).
3. Preencha os campos que aparecem. Os nomes mudam conforme a concessionária: a Equatorial pede a UC, o CPF/CNPJ e a data de nascimento do titular; a Saneago pede a matrícula com hífen e o CPF/CNPJ do titular; o IPTU pede a inscrição ou o CCI. Veja o que cada uma pede em Concessionárias e dados de acesso.
4. Clique em Salvar. Aparece "Conta adicionada" (ou "Erro ao salvar conta").

A conta nova entra na consulta automática no próximo ciclo. Para consultar já, use Consultar agora no cartão dela (menu ⋮).

Contas de gás não são cadastradas por aqui: chegam pela integração (SAGI ou API).

Imóvel com mais de uma conta da mesma concessionária

Um imóvel pode ter várias contas da mesma concessionária: por exemplo, várias inscrições de IPTU (um lote dividido, salas de um mesmo prédio) ou mais de uma conta de luz ou de água. Cada uma aparece num cartão próprio, com o número da conta ou a inscrição ao lado do tipo (ex.: "IPTU · 382.007.0084.0002"), e é consultada separadamente, com as suas faturas e a sua situação.

• Pelo SAGI: todas as contas do objeto chegam sozinhas, cada uma com o seu código de conta do SAGI, e já entram na fila de consulta.
• Pelo portal: clique em Adicionar Conta uma vez para cada conta.

Para consultar só uma delas, use Consultar agora no cartão dela ou a seta ao lado de Consultar agora no alto do imóvel, que lista cada conta com o número. Se uma das contas veio com o número errado (um telefone ou um nome no lugar do número, ou vazio), ela aparece como Cadastro incompleto ou Dados de acesso recusados: corrija no SAGI ou no cartão da conta (menu ⋮ → Editar).

Como editar os dados de acesso de uma conta

1. No cartão da conta, abra o menu ⋮ e clique em Editar (janela Editar Conta).
2. Corrija os campos e clique em Salvar. Aparece "Conta atualizada".

Na tela da conta, o botão Editar no imóvel leva para esta tela do imóvel; lá, siga os passos acima.

O que acontece ao salvar:

• ao mudar um dado de acesso, a fila de consulta passa a usar o valor novo e a correção do portal passa a valer sobre o que o SAGI mandou antes (veja Quem vence nos dados de acesso);
• ao trocar a concessionária, a UC descoberta e o resultado da última consulta são apagados e a conta passa a usar a fila da concessionária nova;
• a conta volta a ser consultada no próximo ciclo; para já, use Consultar agora (que também tira o erro de cadastro da conta);
• tudo fica na Auditoria.

Como excluir uma conta

1. No cartão da conta, abra o menu ⋮ e clique em Excluir.
2. Confirme em Excluir Conta ("Tem certeza que deseja excluir esta conta?").

Aparece "Conta excluída". A conta sai do imóvel, das listas e dos totais, e deixa de voltar para a fila nos próximos ciclos. Os dados não são apagados do banco.

Como consultar agora as contas do imóvel

Na tela do imóvel há três jeitos, conforme o alcance:

Nos três casos as tentativas e os erros da conta são zerados, inclusive o erro de cadastro. Mensagens:

• "N conta(s) deste imóvel na fila de consulta": deu certo (botão do cabeçalho).
• "(concessionária) deste imóvel na fila de consulta": deu certo (uma conta).
• "Nenhuma conta para consultar: confira se o imóvel tem nº do objeto e contas ativas.": cadastre o Nº do objeto no imóvel (botão Editar).
• "Conta sem número de objeto no imóvel (cod_objeto)…": idem, ao consultar uma conta só.
• "Não foi possível colocar na fila de consulta": falha de comunicação; tente de novo.

O resultado aparece no cartão da conta, no Histórico de Consultas e no sino quando a consulta terminar. O tempo depende da fila: com muitas contas na frente, pode levar de minutos a algumas horas. Outras formas (uma concessionária na imobiliária inteira, tudo, só as contas em que o site estava indisponível) estão em Como consultar agora (todas as formas).

Perguntas comuns

Cadastrei a conta e ela não é consultada

Confira: (1) o imóvel tem Nº do objeto; (2) os campos obrigatórios da concessionária estão preenchidos; (3) a situação da conta não é Cadastro incompleto (faltam dados); (4) a concessionária tem consulta automática (a Enel não tem); (5) para a Saneago, a imobiliária cadastrou o acesso gov.br em Configurações; (6) a frequência das consultas não está em "Só quando eu pedir". Depois clique em Consultar agora no cartão da conta.

A conta mostra "UC fora da lista"

O Finder entrou no portal da Equatorial com os dados do titular, mas a UC cadastrada não está entre as unidades desse titular (acontece quando a Equatorial renumera as UCs). Clique em Titular no portal: N UCs no cartão da conta, ou abra a conta: aparecem as unidades encontradas; clique em É este imóvel na correta. Veja Contas.

Onde vejo as faturas deste imóvel?

Depende do que você quer: as em aberto de uma conta, no botão Ver faturas do cartão; todas as faturas de uma conta (inclusive pagas e sem débito), na tela da conta (Abrir conta); todas as do imóvel juntas, na tela Faturas com o filtro Imóvel. Veja Onde ver as faturas.

Contas

A tela Contas lista todas as contas de todos os imóveis, com a situação da última consulta, o valor em atraso e se a conta está na fila de consulta; a lista sai em PDF ou CSV. O detalhe de uma conta mostra as faturas em aberto, o histórico, as consultas feitas e os prints e PDFs guardados. Cadastrar, editar e excluir contas é feito na tela do imóvel (veja Imóveis).

Lista de contas

Menu Contas. Filtros no alto:

• Busca (Imóvel, endereço, nº do objeto, UC...): parte do nome do imóvel, do endereço, do primeiro dado de acesso (UC, matrícula, inscrição) ou da UC nacional; o nº do objeto precisa ser o número completo.
• Todas as concessionárias ou uma delas (pelo código, ex.: EQUATORIAL_GO).
• Situação:
  • Todas as situações;
  • Em atraso: a última consulta encontrou fatura vencida (etiqueta Em atraso);
  • Em dia: há fatura em aberto e nenhuma vencida (etiqueta Em dia). Contas Sem débito (sem nenhuma fatura em aberto) não entram neste filtro;
  • Com problema de cadastro: Dados de acesso recusados, Cadastro incompleto, UC fora da lista ou Faturas não lidas;
  • Nunca consultadas: ainda sem nenhuma consulta;
  • Na fila de consulta: aguardando ou sendo consultadas agora.

O link Corrigir cadastro de Configurações → Consultas automáticas abre esta tela já filtrada em Com problema de cadastro e na concessionária escolhida.

À direita aparecem o total ("N conta(s)") e os botões Exportar PDF e Exportar CSV (Como exportar a lista de contas). A lista mostra 25 contas por página e só as contas de imóveis ativos.

Colunas (clique no título para ordenar; a ordem fica guardada no navegador):

• Imóvel: nome (clique para abrir o imóvel), com o nº do objeto (#) e o grupo.
• Conta: tipo, nome da concessionária e o primeiro dado de acesso (UC, matrícula, inscrição…).
• UC nacional: para a Equatorial, a UC de 15 dígitos descoberta na consulta (em tela menor, aparece embaixo da conta como "UC …").
• Última consulta ("nunca" se ainda não foi consultada; em tela menor, aparece embaixo da situação).
• Situação: Em dia, Em atraso, Sem débito, Com débito, UC fora da lista, Dados de acesso recusados, Cadastro incompleto, Faturas não lidas, Na fila, Site indisponível, Aguardando verificação ou Aguardando 1ª consulta. Passe o mouse na etiqueta para ler a dica (veja Situações e mensagens).
• Em atraso: valor e número de faturas vencidas.
• Consulta: Consultando agora, Na fila (aguardando a vez), Não concluída (passe o mouse para ler o motivo em português simples) ou "-" (fora da fila ou já concluída). O administrador da plataforma vê também a posição na fila (Na fila · nº X) e o número de tentativas (Erro (N)).
• Ações: Abrir conta e o raio ⚡ (Consultar agora), que fica desabilitado enquanto a conta está sendo consultada.

Em telas menores (notebook), algumas colunas saem da tabela e a informação aparece embaixo de outra coluna, para a tabela caber sem rolar para o lado. Na coluna Situação aparecem, nesse caso, a data da última consulta e a etiqueta da fila (Na fila, Consultando agora, Não concluída).

Como exportar a lista de contas

Os botões ficam no alto da lista, ao lado do total. Os dois levam todas as contas do filtro (não só a página aberta), com a busca, a concessionária, a situação e a ordem da tela:

A situação sai com os mesmos rótulos da tela (Em dia, Dados de acesso recusados…). Enquanto o arquivo é gerado, o botão mostra "Gerando...". Aparece "PDF gerado" ou "CSV gerado"; se falhar, "Não foi possível exportar". Todos os perfis exportam, e toda exportação fica registrada na Auditoria. Outras exportações em Como exportar (todas as formas).

Como consultar uma conta agora

1. Na lista Contas, clique no ⚡ da linha; ou abra a conta e clique em Consultar agora (o botão se chama Priorizar na fila quando a conta já está na fila).
2. Aparece "Conta colocada na frente da fila de consulta".

A conta volta para a fila na frente de todas as da mesma concessionária, com tentativas e erros zerados (inclusive o erro de cadastro). Enquanto a conta está sendo consultada, o botão mostra Consultando agora... e fica desabilitado.

• "Conta sem número de objeto no imóvel (cod_objeto)…": abra o imóvel, clique em Editar e preencha o Nº do objeto.
• "Não foi possível enfileirar": falha de comunicação; tente de novo.

Para consultar mais de uma conta de uma vez (o imóvel inteiro, uma concessionária inteira, tudo, só as que pararam por site indisponível), veja Como consultar agora (todas as formas).

Detalhe da conta

Título: "Concessionária · primeiro dado de acesso", com o imóvel (link), o nº do objeto e o endereço. Botões:

• Portal: abre o site da concessionária (quando cadastrado).
• Imóvel: abre a tela do imóvel.
• Consultar agora / Priorizar na fila / Consultando agora....

Indicadores:

• Vencidas: quantidade de faturas vencidas e o valor ("nada em atraso" quando não há).
• A vencer: quantas faturas em aberto ainda estão no prazo e, abaixo, o valor delas ("nada a vencer" quando todas estão vencidas ou pagas).
• Última consulta: data e hora, com "resultado: …" usando os mesmos rótulos da tela Contas (ex.: em dia, em atraso, sem débito, dados de acesso recusados).
• Consulta automática: Na fila, Consultando agora ("em andamento agora"), Concluída, Não concluída (com o motivo em português simples) ou Aguardando o próximo ciclo. O administrador da plataforma vê também a posição na fila (Na fila · nº X) e o número de tentativas.

Cartão Dados de acesso: tipo, concessionária (nome e código), cada dado de acesso com o nome que a concessionária usa (CPF e CNPJ aparecem mascarados), UC nacional ("identificada em …" ou "ainda não identificada"), Código da conta (o código no seu sistema) e Cadastrada em. Para alterar, clique em Editar no imóvel: abre a tela do imóvel; lá, no cartão da conta, use o menu ⋮ → Editar (Como editar os dados de acesso).

Abas da conta

Faturas

Só as faturas em aberto (o número entre parênteses é a quantidade): Referência, Vencimento, Valor, Status, Consultada (quando a consulta viu a fatura) e as ações PDF, Print (o print do portal) e Detalhes (valor, vencimento, status, consumo, código de barras, PIX, data da consulta e, se for o caso, "Sem débito em"). Nesta janela o código de barras e o PIX aparecem para selecionar e copiar; os botões Copiar ficam na tela Faturas e na janela Ver faturas do imóvel.

Quando o portal não informa a data de vencimento, o Finder estima pelas faturas anteriores e mostra (estimado); confira no boleto (PDF). Sem faturas em aberto aparece "Nada em aberto" (com o botão Ver histórico) ou "Nenhuma fatura registrada".

Histórico

Faturas pagas e sem débito: Referência, Vencimento, Valor, Situação, Baixa e as ações PDF, Print e Detalhes. A coluna Baixa mostra a data da consulta em que o portal deixou de listar a fatura (sem débito) ou em que a mostrou como paga.

Consultas

Linha do tempo das consultas desta conta: Sucesso, Erro e Faturas baixadas (quando faturas saíram da lista do portal), com a data, a mensagem em português simples (o que houve e o que fazer; veja Mensagens das consultas) e o botão evidência (o print da tela do portal no fim daquela consulta). O administrador da plataforma vê também a mensagem técnica original, a duração, os passos internos e a máquina que consultou.

Evidências

Galeria dos prints e PDFs guardados em cada consulta, inclusive das consultas que não trouxeram fatura. Clique na imagem para ampliar. Servem de prova do que o portal mostrava naquele dia.

UCs deste titular no portal

Aparece em contas da Equatorial quando o Finder entrou com o CPF/CNPJ do titular e leu as unidades (UCs) dele, em geral porque não encontrou a UC cadastrada (situação UC fora da lista). A Equatorial às vezes renumera as unidades; o cartão mostra todas as UCs do titular:

• UC no portal (a vinculada à conta fica em verde, com "vinculada a esta conta").
• Endereço bate: quanto o endereço da UC parece com o do imóvel (verde a partir de 60%).
• Endereço e titular no espelho: lidos no espelho da fatura (o botão espelho abre o PDF).
• Faturas: quantidade; clique para ver as faturas de cada UC.
• Em aberto: valor em aberto da UC.
• Rodapé: débito total do titular (todas as UCs).

Como vincular a UC certa

Há dois caminhos para a mesma lista:

• na tela da conta, cartão UCs deste titular no portal; ou
• na tela do imóvel, no cartão da conta, clique em Titular no portal: N UCs · débito total.

Depois:

1. Encontre a UC cujo endereço é o do imóvel.
2. Clique em É este imóvel e confira a janela Vincular UC a esta conta.
3. Clique em Vincular e consultar.

Aparece "UC vinculada. A conta voltou para a frente da fila com essa UC." As próximas consultas usam essa UC direto, a UC anterior é substituída e fica registrado na Auditoria. Só o gerente e o administrador veem o botão É este imóvel. Com menos de 8 dígitos aparece "Informe a UC (código do portal)."

Perguntas comuns

A situação está "dados de acesso recusados"

O portal recusou os dados de acesso (UC, CPF/CNPJ, data de nascimento, matrícula…). Confira no cadastro e corrija pelo imóvel (Editar no imóvel → cartão da conta → ⋮ → Editar). Corrigida, a conta volta a ser consultada no próximo ciclo; para já, Consultar agora.

A situação está "site indisponível"

O problema foi do site da concessionária (fora do ar, bloqueio de acesso, lentidão), não da conta. O Finder tenta de novo sozinho; para tentar já, use Consultar agora na conta ou Tentar de novo agora em Configurações → Consultas automáticas. Veja Quando a consulta falha.

A fatura sumiu das faturas em aberto

Ela saiu da lista do portal numa consulta completa e virou sem débito (aba Histórico, com a data da baixa), ou o portal a mostrou como paga.

Onde vejo por que a consulta desta conta falhou?

Depende de onde você está:

As mensagens vêm em português simples, dizendo o que houve e o que fazer (Mensagens das consultas). O administrador da plataforma vê também o código técnico no Registro de consultas e na Fila de consultas.

Faturas

A tela Faturas reúne todas as faturas encontradas nas consultas, de todos os imóveis, com filtros por situação, concessionária, tipo, vencimento, período e imóvel. Ela abre mostrando só o que está em aberto (vencidas + a vencer).

Situação da fatura

A etiqueta gravada é atualizada a cada consulta. Os filtros Vencidas e A vencer usam a data de vencimento comparada com hoje, então uma fatura pode aparecer em "Vencidas" antes de a próxima consulta trocar a etiqueta.

Filtros

• Concessionária: Todas ou uma (pelo código).
• Tipo: Todos, Energia, Água, IPTU, Gás, Condomínio.
• Vencimento de / até: intervalo de datas de vencimento.
• Status: Em aberto (padrão: vencidas + a vencer), Vencidas, A vencer, Pagas, Sem débito, Todas.
• Período: mês de referência (mês/ano).
• Imóvel (Buscar imóvel...): parte do nome ou do endereço, ou o nº do objeto completo.
• Limpar: aparece quando há filtro diferente do padrão e volta tudo para "Em aberto".

O alto da tela mostra "N fatura(s) encontrada(s)". Os cartões Vencido e A vencer do Dashboard abrem esta tela já filtrada. Faturas de imóveis ou contas excluídos não aparecem.

Colunas e ações

Colunas (clique no título para ordenar; a ordem fica guardada no navegador): # (número da fatura no Finder), Imóvel, Concessionária, Referência, Valor, Vencimento (com (estimado) quando o portal não trouxe a data), Última consulta (quando a consulta viu a fatura pela última vez) e Status. Em telas menores (notebook), algumas colunas saem da tabela e a informação aparece embaixo de outra coluna, para a tabela caber sem rolar para o lado. A concessionária vai para baixo do imóvel e a data da última consulta para baixo do status. Ações de cada linha:

• PDF: abre o boleto guardado (quando existe).
• Copiar código de barras e Copiar PIX (quando o portal fornece). Aparece "Código de barras copiado!" ou "PIX copiado!".
• Detalhes: valor, referência, vencimento, consumo, Última consulta, Registrada em (quando a fatura entrou no Finder), Código de Barras e PIX Copia e Cola com botão de copiar ("Não disponível" quando não há), Ver PDF e Screenshot (o print do portal).

Onde ver as faturas (todas as formas)

Depende do que você quer ver:

Como exportar as faturas

1. Aplique os filtros desejados.
2. Clique em Exportar PDF ou Exportar CSV (no alto da tela, à direita).

Os dois levam todas as faturas do filtro (não só a página aberta), com todos os filtros e a ordem da tela:

Enquanto o arquivo é gerado, o botão mostra "Gerando...". Aparece "PDF gerado" ou "CSV gerado"; se falhar, "Não foi possível exportar". Todos os perfis exportam, e toda exportação fica registrada na Auditoria. O logo do PDF é cadastrado em Configurações → Relatórios em PDF. Todas as formas de exportar estão em Como exportar (todas as formas).

Como pagar ou enviar o boleto ao locatário

1. Filtre por Vencidas ou A vencer (e pelo Imóvel, se quiser).
2. Na linha da fatura, clique em Copiar código de barras ou Copiar PIX e cole onde precisar; ou abra o PDF e envie o arquivo.

O Finder não paga contas; ele localiza e organiza os boletos. Depois do pagamento, a fatura só muda de situação na próxima consulta da conta.

Vencimento estimado

Alguns portais (por exemplo, a segunda via da Equatorial) não mostram a data de vencimento. Nesse caso o Finder calcula a data pelo dia de vencimento das faturas anteriores da mesma conta e mostra (estimado). Confira a data no PDF do boleto.

Perguntas comuns

Por que uma fatura paga continua em aberto?

O Finder só sabe do pagamento na próxima consulta (e o portal da concessionária também demora alguns dias para baixar pagamentos). Para atualizar agora, abra a conta e clique em Consultar agora (ou use outra forma de consultar agora).

Por que faturas de um imóvel sumiram?

Faturas de imóveis ou contas excluídos não aparecem. Faturas que saíram da lista do portal viram sem débito (filtro Sem débito ou Todas).

O IPTU aparece com várias linhas por ano

No IPTU, cada parcela é uma fatura, com referência ano/parcela (ex.: 2026/03). A referência ano/00 é a cota única ou uma dívida inteira (por exemplo, dívida ativa de anos anteriores).

A Saneago mostra várias faturas com a mesma referência

A Saneago pode listar mais de uma fatura com a mesma referência (mês/ano). O Finder guarda cada uma pelo número da fatura, e cada uma dá baixa sozinha quando sai da lista do portal.

Como funcionam as consultas automáticas

Este capítulo explica o que acontece por trás: a fila de consultas, os ciclos e o que o Finder faz quando uma consulta não dá certo. A imobiliária acompanha tudo em Configurações → Consultas automáticas e na tela Contas. O Painel de consultas, a Fila de consultas, o Gerenciar fila e o Registro de consultas são telas do administrador da plataforma, a equipe da P3 Sistemas (Painel de consultas, fila e registro).

Como consultar agora (todas as formas)

"Consultar agora", "consultar só uma concessionária", "atualizar as faturas" ou "mandar para a fila" pode ser feito de vários jeitos. Escolha pelo alcance que você quer:

Regras que valem para todas as formas:

• O imóvel precisa ter Nº do objeto; sem ele aparece "Nenhuma conta para consultar…" ou "Conta sem número de objeto no imóvel (cod_objeto)…".
• Contas com dados de acesso recusados ou cadastro incompleto (as da coluna Corrigir cadastro): Consultar agora (na conta ou no imóvel) tenta de novo. Iniciar ciclo agora e Tentar de novo agora deixam essas contas de fora até alguém corrigir o cadastro.
• O resultado aparece na conta, no cartão do imóvel e no sino quando a consulta terminar; o tempo depende de quantas contas estão na frente.

Como acompanhar o andamento (todas as formas)

A fila de consultas

Cada conta ativa (de imóvel com Nº do objeto) tem um lugar na fila da sua concessionária. As máquinas de consulta pedem ao Finder "a próxima conta", consultam o portal e devolvem o resultado. A ordem da fila é:

1. Contas com prioridade (quem clicou em Consultar agora na conta, ou vinculou uma UC);
2. Contas nunca consultadas;
3. Contas consultadas há mais tempo.

Como a conta aparece para a imobiliária (coluna Consulta da lista Contas e indicador Consulta automática da conta):

• na fila: esperando a vez.
• consultando agora: a consulta está acontecendo agora.
• concluída: a consulta deste ciclo terminou.
• não concluída: a consulta não deu certo; passe o mouse (lista) ou veja abaixo do indicador (conta) para ler o motivo em português simples.
• aguardando o próximo ciclo (na lista, "-"): a conta ainda não entrou na fila (em geral, imóvel sem nº do objeto, ou conta nova esperando o próximo ciclo).

Conta sem nenhum dado de acesso preenchido sai da fila na hora com a situação Cadastro incompleto ("A conta não tem os dados de acesso preenchidos. Complete o cadastro da conta no imóvel."). No IPTU de Anápolis e no gás, o CPF/CNPJ sozinho já basta para consultar.

Uma consulta que trava no meio volta sozinha para a fila.

Ciclos de consulta

Um ciclo recoloca todas as contas ativas na fila. Configure em Configurações → Consultas automáticas:

• Frequência: Toda semana, A cada 15 dias, Todo mês, Todo dia ou Só quando eu pedir.
• Dia da semana (semanal e quinzenal) ou Dia do mês (1 a 28, mensal).
• Hora de início (de hora em hora, 00:00 a 23:00).

O padrão de uma imobiliária nova é toda semana, domingo, às 00:00. Ao abrir um ciclo:

1. Contas que estavam sem dado de acesso e foram corrigidas no cadastro passam a usar o dado novo e voltam a ser consultadas.
2. Contas concluídas e as que pararam por site indisponível voltam para a fila.
3. Contas com dados de acesso recusados ou cadastro incompleto ficam de fora até a correção (aparecem como "N com dados inválidos fora").
4. Contas novas entram na fila.

O botão Iniciar ciclo agora abre um ciclo na hora, para todas as concessionárias ou só uma. O ciclo de uma concessionária só não muda o ciclo agendado da imobiliária. A API da integração também pode pedir um ciclo (aparece como "pedido pela integração"); um ciclo pedido pelo SAGI aparece como "pedido no portal".

Quando a consulta falha

Para a imobiliária, uma consulta que não deu certo cai em um de dois grupos, os mesmos das colunas de Configurações → Consultas automáticas:

Outras duas situações: UC fora da lista (Equatorial) pede ação: vincule a UC certa na conta (como); Faturas não lidas quer dizer que o site da concessionária mudou e a P3 Sistemas foi avisada. As duas entram no filtro Com problema de cadastro da tela Contas. O motivo de cada consulta aparece em português simples na conta, no imóvel, no Dashboard e no sino (Mensagens das consultas).

O que acontece em cada consulta

1. O Finder entra no portal da concessionária ou da prefeitura com os dados de acesso da conta (ou com a credencial da imobiliária, no caso da Saneago via gov.br).
2. Lê a lista de faturas ou débitos em aberto.
3. Guarda cada fatura (referência, vencimento, valor, código de barras, PIX, PDF quando possível) e um print da tela como evidência.
4. Faturas que estavam em aberto no Finder e não vieram na lista completa viram sem débito (baixa automática). Quando a leitura foi parcial, nada é baixado.
5. Grava a situação da conta (Sem débito, Com débito, Dados de acesso recusados…) e atualiza os totais, o sino e os webhooks.

Quanto tempo leva

Cada consulta leva de alguns segundos a poucos minutos, conforme o portal. Uma carteira grande (milhares de contas) pode levar horas ou mais de um dia por ciclo. Acompanhe em Configurações → Consultas automáticas: a coluna Consultadas mostra "X de Y" e a barra de cada concessionária.

Por que algumas concessionárias demoram mais

• Equatorial: o portal bloqueia acessos repetidos do mesmo endereço; as consultas se revezam entre máquinas e fazem pausas entre contas.
• Saneago: entra pelo gov.br com a credencial da imobiliária (certificado digital ou CPF e senha) e pode pedir captcha ou código de duas etapas; nesses casos a conta aparece como Aguardando verificação e a equipe da P3 Sistemas ajuda.
• IPTU de Trindade e Anápolis: têm captcha em cada consulta.

Para o administrador da plataforma

Detalhes técnicos que só a equipe da P3 Sistemas vê e ajusta.

As três categorias de falha

Na fila, toda falha cai em uma de três categorias. Para a imobiliária, bloqueio da concessionária e erro na consulta aparecem juntos como Site indisponível, e dados cadastrais aparece como Corrigir cadastro:

Tentativas, espera e volta automática

• Tentativas por ciclo (1 a 10; padrão 3), Espera (min) entre tentativas (5 a 1440; padrão 120) e Bloqueio/erro voltam a cada (dias) (0 a 30; padrão 1; 0 = só no próximo ciclo ou pelo botão) ficam em Configurações → Consultas automáticas e só aparecem para o administrador.
• Esgotadas as tentativas, a conta fica em erro até esse prazo, o próximo ciclo, ou alguém recolocá-la na fila (Como recolocar na fila as contas com erro).
• Um login_recusado repetido em duas ou mais máquinas diferentes que estavam funcionando vira credencial_invalida (dados cadastrais).
• Uma consulta que passa do tempo máximo (padrão 20 minutos; Saneago 45) porque a máquina travou ou caiu volta sozinha para a fila.
• O Painel de consultas mostra a posição de cada conta, o tempo médio e a previsão de término (ETA) de cada concessionária; a Fila de consultas mostra a coluna Posição e as tentativas.

Relatórios

Menu Relatórios: relatórios em abas (Inadimplência, Faturas por mês e Contas em atenção), cada um com filtros, indicadores e exportação em CSV (planilha) ou PDF (com o logo, o nome e o CNPJ da imobiliária no cabeçalho). Os botões CSV e Exportar PDF ficam no alto da tela e exportam a aba aberta. O PDF também pode ser enviado por e-mail automaticamente (veja Configurações → Relatórios em PDF). Todos os perfis veem e exportam os relatórios. O administrador da plataforma (equipe P3 Sistemas) vê também a aba Consultas automáticas.

Inadimplência

Imóveis com fatura vencida sem pagamento, do maior valor vencido para o menor.

• Filtros: concessionária; carteira (Todas as carteiras ou uma; só aparece quando os imóveis têm grupo); atraso mínimo (Qualquer atraso, Atraso ≥ 15 dias, ≥ 30, ≥ 60 ou ≥ 90 dias); busca Buscar imóvel, objeto, conta... (imóvel, nº do objeto, concessionária ou carteira).
• Indicadores: Imóveis em atraso, Faturas vencidas, Valor vencido, Maior atraso.
• Colunas: Imóvel (com o nº do objeto; clique para abrir o imóvel), Carteira (quando há), Concessionárias (as que têm débito), Faturas, Valor vencido, Mais antiga (vencimento mais antigo) e Dias (de atraso; vermelho a partir de 60, amarelo a partir de 30). A última linha soma o total da lista mostrada ("Total (filtrado)" quando há busca).
• Sem nada vencido aparece "Nenhum imóvel em atraso".

Faturas por mês

Evolução mensal pelo mês de vencimento.

• Filtros: período De / até (padrão: os últimos 12 meses), concessionária, carteira.
• Gráficos: "Valor faturado por mês e concessionária" e "Pago × a vencer × vencido".
• Tabela: Mês, Faturas, Total, Pago, A vencer, Vencido e % vencido.

Consultas automáticas

Aba só do administrador da plataforma (equipe P3 Sistemas): desempenho técnico das consultas no período. A imobiliária acompanha as consultas em Configurações → Consultas automáticas (como).

• Filtros: De / até e concessionária.
• Indicadores: Consultas, Taxa de sucesso (vermelho abaixo de 50%), Erros, Tempo médio.
• Consultas por dia: sucesso × erro.
• Motivos de erro: os 10 motivos mais comuns, com a quantidade.

Contas em atenção

Contas que precisam de ação:

• nunca consultada: nunca passou por uma consulta;

• problema: dados de acesso recusados, cadastro incompleto, UC fora da lista ou faturas não lidas;

• desatualizada: sem consulta há mais do prazo escolhido (Sem consulta há mais de 7, 15, 30 (padrão) ou 60 dias).

• Filtros: prazo sem consulta, concessionária e a busca (imóvel, nº do objeto, concessionária, dado de acesso ou UC).

• Indicadores: Total em atenção, Nunca consultadas, Com problema de cadastro, Desatualizadas.

• Colunas: Situação, Imóvel, Conta (concessionária e dado de acesso), UC nacional, Última consulta ("há N dias"), Resultado e o botão abrir (abre a conta).

• Na tela aparecem até 300 contas; o CSV e o PDF levam até 5.000. Sem nada aparece "Tudo em dia".

Como exportar um relatório em PDF

1. Abra a aba desejada e aplique os filtros.
2. Clique em Exportar PDF. Aparece "PDF gerado" e o arquivo é baixado (ex.: inadimplencia_AAAA-MM-DD.pdf).

O PDF sai em A4 deitado, com:

• Cabeçalho em todas as páginas: logo da imobiliária, nome, CNPJ, título do relatório e data de emissão.
• Filtros usados, indicadores e a tabela com a linha de total.
• Rodapé: quem gerou, data e hora, e "Página X de Y".

A caixa de busca da aba não entra no PDF nem no CSV: eles saem com os filtros das caixas de seleção (concessionária, carteira, atraso, período, prazo). O logo é cadastrado em Configurações → Relatórios em PDF; sem logo, o cabeçalho mostra só o nome e o CNPJ.

Como exportar em CSV

Clique em CSV: baixa os dados da aba em planilha (abre no Excel com acentos corretos). Aparece "CSV gerado"; se falhar, "Não foi possível exportar". Colunas de cada relatório:

• Inadimplência: Nº objeto, Imóvel, Carteira, Cidade, Concessionárias, Faturas vencidas, Valor vencido, Vencimento mais antigo, Dias em atraso.
• Faturas por mês: uma linha por mês e concessionária: Mês (no formato 09/2026), Concessionária, Faturas, Valor total, Pago, Vencido, A vencer.
• Consultas automáticas (administrador da plataforma): uma linha por dia e concessionária: Dia, Concessionária, OK, Erro, Tempo médio (s).
• Contas em atenção: Situação, Nº objeto, Imóvel, Carteira, Tipo, Concessionária, Conta/UC, UC nacional, Última consulta, Resultado, Dias sem consulta.

Nos arquivos, a concessionária e o tipo da conta aparecem com o mesmo nome da tela (por exemplo, "IPTU Goiânia" e "Energia"), nunca com o código interno.

Toda exportação de relatório (CSV ou PDF) fica registrada na Auditoria.

Como exportar (todas as formas)

Depende do que você quer levar para fora do Finder:

Todos os PDFs (listas e relatórios) saem com o logo, o nome e o CNPJ da imobiliária no cabeçalho e "Página X de Y" no rodapé. Todos os perfis exportam, e toda exportação fica registrada na Auditoria.

Como receber os relatórios por e-mail

Em Configurações → Relatórios em PDF, escolha a frequência (toda semana, todo mês ou todo dia), o dia, o horário, os e-mails e quais relatórios vão no PDF. Detalhes em Configurações. Só o gerente e o administrador configuram o envio.

Configurações

Menu Configurações (no grupo Gestão; para o usuário comum, no bloco principal do menu). Também abre pelo seu nome no topo → Configurações. Todos os usuários veem a tela; só o gerente e o administrador alteram: para o usuário comum os campos ficam desabilitados e os botões não aparecem. Os cartões:

Dados da Empresa

Nome da Empresa (obrigatório), CNPJ, Telefone, E-mail, Cidade e Estado (sigla de 2 letras). Clique em Salvar: aparece "Dados da empresa atualizados!" (ou "Erro ao atualizar dados"). O nome e o CNPJ aparecem no cabeçalho dos relatórios em PDF; o e-mail é sugerido como destinatário dos relatórios por e-mail.

Seu Plano

Mostra o plano, os limites ("Até N imóveis · N usuários") e as barras de uso de Imóveis e Usuários (amarela a partir de 70%, vermelha a partir de 90%), além do total de contas e faturas e da "última consulta automática". A partir de 90% de uso aparece "Você está perto do limite do plano." Para trocar de plano, use a tela Assinatura (abaixo).

Assinatura (plano, faturas e pagamento)

Menu Gestão → Assinatura (para o usuário comum, no bloco principal do menu). A tela tem:

• Seu plano: nome do plano, situação, valor e ciclo (mensal ou anual), Pago até, cortesia ou Teste grátis até (quando há), troca agendada para a próxima renovação e as barras de uso de imóveis e usuários. O gerente vê também Cancelar a renovação (ou Reativar a renovação).
• Faturas em aberto: cada fatura com valor, vencimento e o botão Pagar.
• Planos: os planos disponíveis, com Mensal e Anual no alto (o anual mostra quanto se economiza). Cada cartão traz o preço, os limites, os recursos e o botão Contratar (ou Testar 7 dias grátis, quando a imobiliária ainda tem direito ao teste; ou Plano atual; ou Falar com a P3 quando o plano é sob consulta).
• Histórico de faturas: todas as faturas, com a situação (Em aberto, Paga, Cancelada), a data e a forma de pagamento.

Situação da assinatura:

Como contratar ou trocar de plano

Só o gerente (ou o administrador) contrata.

1. Em Assinatura → Planos, escolha Mensal ou Anual.
2. Clique em Contratar no plano desejado e confirme.
3. Aparece "Fatura do plano … gerada: escolha como pagar." e a janela de pagamento abre (veja abaixo).

Teste grátis

A imobiliária que nunca pagou um plano nem fez teste vê nos planos pagos o selo N dias grátis para testar e o botão Testar N dias grátis (os dias são definidos em cada plano; o padrão é 7). Ao confirmar:

• O plano e os limites valem na hora, sem fatura e sem pagamento ("Teste grátis do plano … até …").
• Em Seu plano aparece a situação Teste grátis e Teste grátis até a data. Os gerentes (e o e-mail de cobrança) recebem um e-mail quando o teste começa.
• Nos 3 últimos dias, um aviso no alto das telas lembra quando o teste termina.
• Nos 2 últimos dias do teste sai a primeira fatura (por e-mail, com o assunto "Seu teste grátis termina em …"), que vence no dia seguinte ao fim do teste. Pagando, o plano continua e o período pago começa nesse dia.
• Não quer continuar? Clique em Cancelar a renovação antes do fim: a fatura é cancelada e, terminado o teste, a imobiliária volta para o plano grátis, sem cobrança.
• Não pagou nem cancelou: depois do vencimento vale a mesma regra de atraso e bloqueio das outras faturas.
• O teste é um por imobiliária: quem já testou ou já pagou um plano contrata direto, com fatura.

Pelo site (findercontas.com.br), o botão Testar N dias grátis de cada plano leva ao cadastro; ao criar a conta, o teste do plano escolhido já começa.

O plano e os limites mudam quando o pagamento é confirmado, e o período começa nesse dia. Regras da troca:

• Plano maior: os dias que faltam do plano atual viram desconto na fatura ("crédito de R$ … do plano atual").
• Plano menor (ou trocar o anual pelo mensal, ou voltar para o grátis): fica agendado para a próxima renovação, sem cobrança agora ("A troca para o plano … vale a partir de …").
• Plano com limite menor que o uso atual não pode ser escolhido: aparece quantos imóveis e usuários a imobiliária tem hoje.

Como pagar uma fatura (Pix, boleto ou cartão)

Qualquer usuário da imobiliária pode pagar.

1. Em Assinatura, clique em Pagar na fatura.
2. Confira Nome ou razão social de quem paga, CPF ou CNPJ (obrigatório no boleto) e E-mail para a fatura.
3. Escolha a forma:
   • Pix: clique em Gerar Pix; leia o QR Code no app do banco ou use Copiar no código. Vale por 24 horas e a confirmação é na hora.
   • Boleto: clique em Gerar boleto; use Abrir o boleto (PDF), copie a Linha digitável ou pague pelo Pix do boleto. O boleto compensa em até 3 dias úteis.
   • Cartão (quando liberado): preencha Número do cartão, Validade (MM/AA), CVV, Nome impresso no cartão, CPF do titular, Data de nascimento do titular, Telefone do titular (com DDD) e o Endereço de cobrança do cartão (o CEP preenche rua, bairro, cidade e UF) e clique em Pagar com cartão. É à vista e a confirmação é na hora; recusado, aparece o motivo informado pela operadora. Os dados do cartão vão direto para a EFI: o Finder não vê nem guarda o número.
4. Com a janela aberta, o Finder confere o pagamento sozinho a cada 10 segundos; Já paguei confere na hora. Confirmado, aparece "Recebemos o seu pagamento" e o plano já fica ativo.

Se a imobiliária pagar no Pix e depois no boleto da mesma fatura (ou o contrário), a forma que sobrou é cancelada automaticamente.

Renovação, atraso e bloqueio

• A fatura de renovação sai alguns dias antes do fim do período pago e vence no primeiro dia do novo período. Os gerentes recebem a fatura por e-mail, e um aviso aparece no alto das telas ("A fatura do Finder Contas de R$ … vence em …").
• Venceu sem pagamento: a situação vira Em atraso e o aviso no alto passa a mostrar até quando pagar para não bloquear.
• Passou da carência: Bloqueada. Qualquer tela leva para a Assinatura, onde a fatura pode ser paga; pagou, tudo volta na hora (consultas, SAGI e API inclusive). Os gerentes recebem um e-mail avisando do bloqueio.

Como cancelar a renovação

1. Em Assinatura → Seu plano, clique em Cancelar a renovação (só o gerente).
2. Confirme: o plano vale até o fim do período pago e depois a imobiliária volta para o plano grátis (com os limites dele; nada é apagado).

Para desfazer antes do fim do período, clique em Reativar a renovação.

Integrações

O SAGI, as chaves de API e os webhooks ficam em Integrações (o assistente de IA, o WhatsApp e os pagamentos são configurados pelo administrador da plataforma em Plataforma → Integrações da plataforma); o cartão das Configurações tem os atalhos Sistemas conectados e Chaves de API (para gerente e administrador). Veja Integrações.

Consultas automáticas

Define com que frequência todas as contas da imobiliária são consultadas de novo e mostra como está o ciclo em cada concessionária. É aqui que a imobiliária acompanha as consultas. Os conceitos estão em Como funcionam as consultas automáticas.

O topo do cartão mostra:

• Frequência atual (ex.: "toda semana, domingo às 00:00"; "só quando alguém pedir" na frequência manual).
• Último ciclo: quando, e a origem (agendado, pedido no portal ou pedido pela integração), "só (concessionária)" quando foi de uma concessionária, quantas contas entraram e "N com dados inválidos fora".
• Próximo ciclo ("só quando alguém pedir" na frequência manual).

Logo abaixo vem a tabela de andamento por concessionária. O cartão se atualiza sozinho a cada minuto. Todos os perfis veem o cartão; só o gerente e o administrador mudam a frequência e usam os botões.

Como ler o andamento por concessionária

Uma linha por concessionária com conta ativa na imobiliária (passe o mouse no título das colunas para ler a explicação):

Abaixo da tabela, o cartão lembra: no dia e hora escolhidos, todas as contas são consultadas de novo; se o site de uma concessionária não responder, o Finder tenta de novo sozinho; contas em Corrigir cadastro voltam a ser consultadas depois de corrigidas no imóvel; para consultar uma conta na hora, use Consultar agora na conta.

Como mudar a frequência das consultas

1. Escolha a Frequência: Toda semana, A cada 15 dias, Todo mês, Todo dia ou Só quando eu pedir.
2. Escolha o Dia da semana (semanal e quinzenal) ou o Dia do mês (1 a 28, mensal) e a Hora de início (não aparece em "Só quando eu pedir").
3. Clique em Salvar frequência (fica habilitado depois de mudar algo). Aparece "Frequência das consultas salva".

Dica: escolha um horário de pouco movimento (madrugada ou fim de semana); os portais bloqueiam menos.

Como iniciar um ciclo agora (todas ou uma concessionária)

1. Na lista ao lado de Iniciar ciclo agora, deixe Todas as concessionárias ou escolha uma (a lista mostra o código e quantas contas cada uma tem, ex.: "EQUATORIAL_GO (120)").
2. Clique em Iniciar ciclo agora e confirme a pergunta:
   • todas: "Iniciar um ciclo agora? Todas as contas desta imobiliária (N) voltam para a fila de consulta.";
   • uma: "Iniciar um ciclo só de (concessionária)? As N conta(s) dela voltam para a fila de consulta. O ciclo agendado da imobiliária não muda."
3. Aparece "Ciclo iniciado: N conta(s) na fila", com as novas e "N com dados cadastrais inválidos ficaram de fora" quando houver.

Com uma concessionária só, apenas as contas dela voltam para a fila, e o ciclo agendado não muda. Para consultar só uma concessionária de um imóvel, use a setinha ao lado de Consultar agora na tela do imóvel. Todas as formas: Como consultar agora.

Como tentar de novo agora as contas com site indisponível

1. Clique em Tentar de novo agora (N) (N = contas paradas porque o site da concessionária não respondeu ou bloqueou o acesso; o botão fica desabilitado com zero).
2. Confirme "Recolocar na fila agora N conta(s) paradas por bloqueio da concessionária ou erro na consulta?".

Aparece "N conta(s) recolocada(s) na fila." ou "Nenhuma conta parada por bloqueio ou erro na consulta.". Vale para todas as concessionárias. As contas em Corrigir cadastro não voltam: corrija o cadastro da conta e use Consultar agora nela. Para uma conta só, use Consultar agora na conta (todas as formas).

Para o administrador da plataforma

O administrador da plataforma (equipe P3 Sistemas) vê no mesmo cartão:

• o quadro Andamento das N conta(s), com etiquetas aguardando, nova tentativa, consultando, concluídas, bloqueio da concessionária, erro na consulta e dados cadastrais (com nada para consultar aparece "Nada para consultar agora. X de Y concluídas neste ciclo…");
• os campos Tentativas por ciclo (1 a 10), Espera (min) entre tentativas (5 a 1440) e Bloqueio/erro voltam a cada (dias) (0 a 30; 0 = só no próximo ciclo ou pelo botão), salvos junto com a frequência;
• a explicação das três categorias de falha (Para o administrador da plataforma);
• o botão com o nome Recolocar na fila (N) (mesmo efeito de Tentar de novo agora);
• Limpar tudo e iniciar ciclo novo (abaixo).

Para recolocar só uma concessionária ou itens escolhidos, ele usa o Painel e a Fila de consultas (todas as formas).

Limpar tudo e iniciar ciclo novo (administrador da plataforma)

Só para o administrador da plataforma, com uma imobiliária escolhida no seletor do topo (não vale "Todas as imobiliárias"). O botão Limpar tudo e iniciar ciclo novo abre uma janela que mostra o que será apagado de vez: as faturas, as leituras das consultas, o registro de consultas e os arquivos (prints e PDFs) da imobiliária. Ficam: imóveis, contas, cadastros e credenciais. Opcionalmente, marque para incluir as contas paradas por dados cadastrais. Para confirmar, digite exatamente o nome da imobiliária ("Para confirmar, digite exatamente o nome da imobiliária."). A limpeza roda no servidor em etapas, com barra de progresso (pode fechar a janela), e termina abrindo um ciclo novo ("Base limpa e ciclo novo iniciado: N conta(s) na fila."). Use só quando for preciso refazer toda a base.

Relatórios em PDF

Cartão com o logo da imobiliária e o envio automático dos relatórios por e-mail.

Como colocar o logo da imobiliária nos PDFs

1. Clique em Enviar logo (ou Trocar logo, se já houver um).
2. Escolha uma imagem PNG ou JPG de até 1 MB, de preferência horizontal e com fundo branco ou transparente.

Aparece "Logo atualizado: já vale para os próximos PDFs". O logo aparece no cabeçalho de todos os PDFs (Exportar PDF e envio por e-mail). O botão da lixeira remove ("Remover o logo dos PDFs?"). Mensagens de erro: "Use uma imagem PNG ou JPG", "O logo precisa ter até 1 MB", "Não consegui ler essa imagem. Salve de novo como PNG ou JPG e tente outra vez."

Como receber os relatórios por e-mail automaticamente

1. Frequência: Desligado, Toda semana, Todo mês ou Todo dia.
2. Dia da semana (semanal) ou Dia do mês (mensal) e Horário.
3. E-mails que recebem o relatório, separados por vírgula (vem sugerido o e-mail da imobiliária).
4. Relatórios no PDF (pelo menos um):
   • Inadimplência por imóvel (imóveis com fatura vencida sem pagamento);
   • Contas em atenção (sem consulta há mais de 30 dias ou com problema de cadastro);
   • Faturas por mês (últimos 12 meses);
   • Consultas automáticas (últimos 7 dias): opção que só o administrador da plataforma vê.
5. Clique em Salvar envio automático. Aparece "Envio automático salvo" (ou "Envio automático desligado").

Todos os destinatários recebem o mesmo e-mail, com um resumo da inadimplência e um único PDF anexado com os relatórios escolhidos. O cartão mostra a Situação ("Ligado: …" ou "Desligado"), o Último envio ("enviado" ou "falhou: motivo") e o Próximo envio. Ligar o envio não manda nada na hora: o primeiro sai no próximo horário marcado.

Mensagens: "E-mail inválido: …" (confira os endereços) e "Informe pelo menos um e-mail para receber o relatório."

Como enviar os relatórios por e-mail agora (todas as formas)

Aparece "Relatório enviado para (e-mails)". Se aparecer "O servidor de e-mail da plataforma ainda não está configurado…", o administrador da P3 precisa configurar o SMTP em Notificações e alertas.

Acesso aos portais das concessionárias

Credenciais da imobiliária (não do locador) que o Finder usa para entrar nos portais em nome dela. Hoje é o caso da Saneago, que entra pelo gov.br. O cartão tem um bloco por concessionária que exige credencial.

Como cadastrar o acesso gov.br da Saneago

1. No bloco da Saneago, escolha a linha do tipo de credencial:
   • Certificado digital A1 (e-CNPJ, arquivo .pfx); ou
   • CPF/usuário e senha da conta gov.br.
2. Clique em Cadastrar (ou Substituir, se já houver).
3. Preencha:
   • certificado: Arquivo do certificado (.pfx / .p12) e Senha do certificado (conferida na hora, abrindo o certificado);
   • CPF e senha: CPF da conta gov.br e Senha.
4. Marque Vale para todas só se a mesma credencial deve valer para todas as concessionárias.
5. Clique em Salvar. Aparece "Certificado salvo: (nome)" ou "CPF e senha salvos".

Regras importantes:

• A conta gov.br usada precisa estar sem verificação em duas etapas; senão o Finder fica esperando o código.
• Com certificado e CPF/senha cadastrados, o Finder prefere o certificado.
• A linha mostra "cadastrado" (ou "credencial geral (todas as concessionárias)"), o nome ou usuário, "válido até (data)" no certificado (com "(vence em breve!)" quando faltam menos de 30 dias) e quem atualizou e quando.
• A chave Ativo liga e desliga a credencial sem apagar (desligada aparece "desativado (o Finder não usa)"); Remover apaga ("Remover esta credencial?").
• Senhas e certificados ficam cifrados no banco e só saem na hora da consulta.
• Sem credencial ativa, as contas da Saneago não são consultadas.

Administradores da plataforma veem também Login por máquina (uma conta gov.br por máquina de consulta, para uma não derrubar a sessão da outra), com Login para uma máquina, a chave Ativo e Remover.

Notificações e alertas (administrador da plataforma)

Cartão visível só para o administrador da plataforma. Tem o botão Salvar (N) (N = campos alterados):

• E-mail (SMTP): Servidor SMTP, Porta (587 STARTTLS ou 465 SSL), Usar TLS/SSL, Usuário, Senha, E-mail remetente e Nome do remetente; Enviar teste para + Testar e-mail (salve antes de testar). Necessário para recuperar senha por e-mail, enviar relatórios e alertas.
• Alertas de operação: Alertas ligados, Avisar quando normalizar, Máquina sem sinal após (min), Erros seguidos para alertar, Fila parada há (horas), Tempo máx. por consulta (min), e os e-mails e WhatsApps que recebem os alertas.
• Segurança de acesso: Sessão expira em (horas), Tentativas de login antes de bloquear, Bloqueio após tentativas (min), Exigir duas etapas de administradores, e a opção das máquinas aceitarem a chave mestra compartilhada.

Senhas e chaves só mostram "configurada"; salvar sem digitar mantém o valor atual. Ver últimos envios de e-mail e WhatsApp lista os envios (Quando, Canal, Destino, Assunto, Resultado) e os erros. O WhatsApp (P3 Messenger) e a chave geral do assistente (P3IA) ficam em Plataforma → Integrações da plataforma. Nos envios de WhatsApp, o resultado mostra Entregue ou Lido quando os avisos de entrega do P3 Messenger estão registrados.

Painel de consultas, fila e registro

Telas do grupo Consultas automáticas no menu: só para o administrador da plataforma (a equipe da P3 Sistemas). O gerente e o usuário da imobiliária não veem este grupo; quem abre um desses endereços sem ser administrador volta para o Dashboard.

Para a imobiliária: o andamento das consultas fica em Configurações → Consultas automáticas (tabela por concessionária com consultadas, na fila, site indisponível e corrigir cadastro, e os botões Iniciar ciclo agora e Tentar de novo agora; veja Configurações) e na tela Contas (coluna Consulta e filtros Na fila de consulta e Com problema de cadastro; veja Contas). Para consultar na hora, use Consultar agora na conta ou no imóvel (todas as formas).

O restante deste capítulo é para o administrador da plataforma.

Painel de consultas

Menu Consultas automáticas → Painel de consultas (a tela se atualiza sozinha a cada 10 segundos). Um cartão por imobiliária e concessionária:

• No título, o código da concessionária (ex.: EQUATORIAL_GO), a versão em uso nas máquinas e, para o administrador, o nome da imobiliária.
• Etiqueta da fila: Consultando, N na fila, Em espera (contas aguardando a espera entre tentativas) ou Fila vazia.
• Etiqueta de sinal: Online (alguma máquina deu sinal nos últimos 3 minutos) ou Sem sinal (normal com a fila vazia).
• Barra de progresso do ciclo: concluídas (verde), consultando ou em espera (azul), bloqueio (amarelo), erro (vermelho), cadastro (preto), com "X% consultadas com sucesso neste ciclo" e o total de contas.
• Contadores: concluídas, na fila, bloqueio, erro, cadastro (passe o mouse para ver a explicação).
• Conta atual e a fase (quando uma máquina está consultando), a última mensagem, Tempo médio por conta, ETA (previsão de término) e Heartbeat (último sinal da máquina).

Sem nenhum cartão aparece "Nenhuma consulta automática registrada ainda".

Como recolocar bloqueios ou erros de uma concessionária

1. No cartão da concessionária, clique em Recolocar bloqueios (N) ou Recolocar erros (N) (só aparecem quando há contas nessa situação).
2. Confirme a pergunta ("Recolocar na fila agora N conta(s) de (concessionária) paradas por bloqueio?" ou "… com erro na consulta?").

Aparece "N conta(s) de (concessionária) de volta na fila." Contas com dados cadastrais inválidos não voltam: é preciso corrigir o cadastro.

Como recolocar na fila as contas com erro (todas as formas)

Depende do alcance e do tipo de erro:

Contas com erro de dados cadastrais só voltam depois de corrigir o cadastro (ou com Consultar agora, Reprocessar ou Enviar para Fila, que tentam de novo). Mais formas de consultar em Como consultar agora.

Recursos do administrador da plataforma

Também no Painel de consultas:

• Alertas de operação (N): máquina sem sinal, erros seguidos, login humano necessário (Saneago/gov.br), consulta devolvida à fila por tempo esgotado, fila parada. Cada alerta tem marcar resolvido ("Alerta marcado como resolvido"). Destinatários e limites em Configurações → Notificações e alertas.
• Precisa de você: quando uma máquina pede ajuda de uma pessoa (captcha ou código do gov.br), o botão Ajudar (máquina) mostra a tela da máquina ao vivo. Clique na imagem exatamente onde clicaria; os botões Digitar, Enter, Tab e Esc enviam teclas. Depois do desafio, o login continua sozinho (não digite a senha). Fechar sai.
• Pausar / retomar uma concessionária inteira: botões de pausa e play no cartão (pausa todas as máquinas daquela concessionária; cada uma termina a conta atual).
• Instalar o … em outra máquina: um cartão por concessionária com Baixar instalador (instalador Windows, fica na bandeja do sistema; a chave "Ativo" do ícone liga e desliga as consultas) e Atualizar N máquina(s) desatualizadas.
• Máquinas em operação (com "N ativa(s)"): filtros por concessionária e Máquina, usuário, apelido…, e as colunas Máquina (com apelido; lápis para renomear), Versão ("desatualizada" quando há versão nova), Rede, Estado (Offline sem sinal há mais de 3 min, Pausada, ocioso, consultando), OK / Erro, Último resultado e Heartbeat (em tela menor, Rede e Último resultado saem da tabela). O menu de cada máquina tem: Retomar consultas, Pausar (termina a conta atual), Atualizar para vX, ligar ou desligar concessionárias do terminal, instalar outra concessionária na mesma máquina, Configurar (pool, Chrome, login manual), Pedir login agora (gov.br), Desconectar conta (sessão e perfil), Revogar chave da máquina, Desinstalar desta máquina e Tirar da lista. Os comandos são executados no próximo ciclo da máquina (até 1 minuto).
• Comandos enviados às máquinas: Quando, Máquina, Comando, Detalhe e Situação (Pendente, Entregue, Executado, Falhou ou modelo (vale 7 dias)).

Fila de consultas

Menu Consultas automáticas → Fila de consultas (título da tela: "Fila de Processamento", com "N registro(s) na fila"). Lista os itens da fila, um por imóvel e concessionária.

• Filtros: concessionária (Todas concessionárias ou uma), situação (Todas as situações, Aguardando, Consultando agora, Concluídas, Com erro (todas), Erro: bloqueio da concessionária, Erro: na consulta, Erro: dados cadastrais) e busca Buscar login1 ou cod_objeto....
• Resumo por concessionária: aguardando, nova tentativa, consultando, concluídas, bloqueio da concessionária, erro na consulta, dados cadastrais, com uma frase explicando o momento (ex.: "Nada para consultar agora: X de Y concluídas neste ciclo…").
• Colunas: ID, Imobiliária, Objeto, Concessionária, Status (com "nova tentativa às…" ou a categoria do erro), Posição (ordem em que o Finder vai consultar na concessionária), Login, UC nacional, Tentativas, Último erro, Atualizado em. Em tela menor, ID, UC nacional (vai para baixo do login), Tentativas e Atualizado em saem da tabela.

Ações:

• Recolocar na fila (N): devolve as contas paradas por bloqueio ou erro na consulta (da concessionária filtrada, ou de todas). Aparece "N conta(s) recolocada(s) na fila.".
• Com itens marcados ("N selecionado(s)"):
  • Resetar Status: volta para aguardando e tira a espera, mantendo tentativas e erro ("Status resetado com sucesso").
  • Reprocessar: volta para aguardando zerando tentativas e erro ("Itens marcados para reprocessamento").

Nenhuma dessas ações passa a conta na frente da fila.

Gerenciar fila

Menu Consultas automáticas → Gerenciar fila (título "Gerenciar Fila"). Lista contas (não itens da fila), inclusive as que nunca entraram na fila ("Sem consulta").

• Filtros: imobiliária (administrador), concessionária, status (Todas, Sem consulta, Na fila (IDLE), Processando, Concluído, Erro) e busca Buscar login, imóvel, cod_objeto....
• Colunas: Imobiliária, Objeto, Imóvel, Concessionária, Login, Fila, Última consulta. Em tela menor, o nº do objeto aparece embaixo do imóvel.
• Marque as contas e clique em Enviar para Fila: elas vão para a fila com tentativas e erros zerados (sem prioridade). Contas de imóvel sem nº do objeto são puladas. Aparece "N conta(s) enviada(s) para a fila".
• Enviar Todas Filtradas (aparece depois de marcar uma linha): pede confirmação ("Confirmar envio em massa") e manda todas as contas do filtro, ignorando as que já estão na fila ou em consulta. Aparece "N conta(s) enviada(s) para a fila (N ignorada(s))".

Registro de consultas

Menu Consultas automáticas → Registro de consultas: histórico de todas as consultas feitas.

• Filtros: Concessionária, Status (Todos, Sucesso, Erro, Em andamento), De e Até.
• Colunas: ID, Objeto, Concessionária, Status, Mensagem, Duração, Executado em (o administrador vê também Máquina e Saída). Em tela menor, ID, Saída e Duração saem da tabela.

Além das consultas, o registro mostra marcas como baixa (faturas que saíram da lista do portal), reenfileirado (conta recolocada na fila) e recuperacao (consulta devolvida à fila por tempo esgotado).

Use o registro para entender por que uma conta falhou: a mensagem diz o motivo com o código técnico (ex.: "BLOCKED_BY_PROTECTION: …" = bloqueio do portal; "INVALID_CREDENTIALS: …" = dados recusados). A imobiliária vê a mesma mensagem traduzida para português simples. Veja Mensagens das consultas.

Usuários e auditoria

Telas do grupo Gestão (gerente e administrador). O usuário comum não vê estas telas.

Usuários

Menu Gestão → Usuários: quem acessa o portal da imobiliária. Colunas (clique no título para ordenar): Nome (com a etiqueta pediu nova senha quando a pessoa pediu na tela de login), E-mail, Perfil (Administrador, Gerente, Usuário), Último Login, Status (Ativo / Inativo) e Ações.

Os botões de ação não aparecem na sua própria linha, e o gerente não vê ações nas linhas de administradores.

Como criar um usuário

1. Clique em Novo usuário (janela Novo Usuário).
2. Preencha Nome, E-mail, Senha e Perfil:
   • Usuário: o dia a dia (imóveis, contas, faturas, relatórios); vê Configurações só para leitura.
   • Gerente: tudo do usuário, mais usuários, auditoria, alterar as configurações (inclusive frequência das consultas, Iniciar ciclo agora e Tentar de novo agora) e integrações. As telas do grupo Consultas automáticas (Painel, Fila, Gerenciar fila, Registro) são só do administrador da plataforma.
   • Administrador: só aparece para a P3 Sistemas.
3. Clique em Criar. Aparece "Usuário criado com sucesso".
4. Passe o e-mail e a senha para a pessoa (ou gere um link para ela criar a própria senha, veja abaixo).

Regras: a senha precisa ter pelo menos 8 caracteres, com letras e números; o e-mail não pode estar em uso; o número de usuários é limitado pelo plano (veja o cartão Seu Plano em Configurações). Quando uma regra não é atendida, aparece "Erro ao criar usuário".

Como editar um usuário

1. Clique em Editar (lápis) na linha do usuário (janela Editar Usuário).
2. Altere Nome, E-mail, Perfil ou digite uma Nova Senha (em branco mantém a atual).
3. Clique em Salvar. Aparece "Usuário atualizado com sucesso" (ou "Erro ao atualizar usuário").

Ninguém altera o próprio perfil; o gerente não altera administradores nem dá o perfil Administrador.

Como redefinir a senha de alguém (todas as formas)

Como gerar um link para a pessoa criar a própria senha

1. Na linha do usuário, clique em Gerar link de redefinição (ícone de cadeado; fica destacado quando a pessoa pediu nova senha).
2. Na janela "Link de nova senha para (nome)", copie o link (aparece "Link copiado") e envie por WhatsApp ou e-mail. Ele vale 30 minutos e uma única vez.

Gerar o link atende o pedido de "esqueci minha senha" daquela pessoa. O link só aparece para usuários ativos.

Como desativar um usuário

1. Clique em Desativar na linha do usuário.
2. Confirme em Desativar Usuário: "O usuário não conseguirá mais acessar o sistema."

Aparece "Usuário desativado com sucesso" e o status muda para Inativo. Ninguém desativa a si mesmo. A tela não tem botão para reativar um usuário desativado: fale com o suporte da P3 Sistemas.

Auditoria

Menu Gestão → Auditoria: registro de tudo que foi feito no portal. O gerente vê só a própria imobiliária.

• Filtros: Todas as ações ou uma ação, entidade (Tudo ou uma), Usuário (nome/e-mail), Buscar na descrição / IP, data inicial e final, e Limpar. O administrador filtra também por imobiliária.
• Colunas: Quando, Imobiliária (só para o administrador; etiqueta "via admin" quando a P3 operou a imobiliária), Usuário, Ação, Alvo (o que foi alterado: Imóvel, Conta, Usuário, Imobiliária…, com o número), Descrição, IP (em tela menor, aparece embaixo da descrição) e o botão Ver detalhes (o que mudou, antes e depois).

Ações registradas: Login, Login recusado, Criou, Editou, Excluiu, Senha alterada, Senha atual errada, Link de senha, Pediu nova senha, Enfileirou (consultar agora, ciclos iniciados, envios para a fila), Fila (tentar de novo / recolocar na fila, resetar e reprocessar), Exportou (CSV e PDF das telas Faturas, Imóveis e Contas e dos Relatórios), Configuração (ciclos, relatórios por e-mail, credenciais…), além de bloqueios de login, verificação em duas etapas e sincronizações do SAGI (que aparecem com o código técnico da ação).

Use a auditoria para responder "quem mudou o login desta conta?", "quem vinculou a UC?", "quem exportou o relatório?" ou "quem iniciou o ciclo?".

Integrações: SAGI, API e webhooks

Os sistemas da imobiliária ligados ao Finder ficam no grupo Integrações do menu (gerente e administrador): Sistemas conectados (SAGI), Chaves de API, Webhooks e Documentação. Os serviços da P3 Sistemas (assistente de IA P3IA, WhatsApp dos alertas e cobrança dos planos) são configurados pelo administrador da plataforma em Plataforma → Integrações da plataforma (veja Administração da plataforma).

Sistemas conectados

Menu Integrações → Sistemas conectados, com a situação no canto (SAGI: Integrado ou Não configurado):

• SAGI: gera a chave de sincronização da imobiliária (veja abaixo).
• Seu sistema pela API: atalhos Chaves de API, Webhooks e Documentação.

Integração com o SAGI

O SAGI desktop envia os imóveis (com o nº do objeto) e as contas, e recebe de volta as faturas e os resultados das consultas.

• A chave do SAGI é gerada em Integrações → Sistemas conectados, cartão SAGI: Gerar chave (primeira vez) ou Gerar chave nova (confirme "Gerar uma chave nova? A anterior deixa de funcionar no SAGI."). A chave nova aparece uma única vez ("Copie agora! A chave não será exibida de novo. Cole-a na configuração do SAGI."); depois o cartão mostra só a Chave em uso, parcialmente oculta.
• Carteira: o SAGI manda todos os nº do objeto ativos; imóveis que deixarem de vir saem da carteira do Finder (nada é apagado).
• Imobiliária nova: um CNPJ que ainda não existe no Finder cria a imobiliária, o gerente e a chave automaticamente.
• IPTU pela cidade do imóvel: IPTU enviado como "IPTU Goiânia" para imóveis de Aparecida, Anápolis, Goianira, Senador Canedo ou Trindade é trocado sozinho pela prefeitura certa.

Quem vence nos dados de acesso (SAGI × portal)

Para cada campo de acesso da conta:

• Valor vazio vindo do SAGI nunca apaga o que está no Finder.
• Conta vazia no Finder recebe o valor do SAGI.
• Se o SAGI mandar de novo o mesmo valor de antes e alguém corrigiu no portal, fica a correção do portal.
• Se o SAGI mandar um valor novo (diferente do que mandou antes), vale o do SAGI.

Chaves de API

Menu Integrações → Chaves de API. Cada sistema que usa a API do Finder precisa de uma chave.

Como criar uma chave de API

1. Clique em Nova chave e dê um nome (ex.: "ERP produção").
2. A chave (começa com fca_) aparece uma única vez: copie e guarde num lugar seguro. O botão Já guardei só libera depois de copiar.

A lista mostra nome, começo da chave, quem criou e quando, e o último uso (com IP) ou "nunca usada".

Como revogar uma chave

Clique em Revogar na linha da chave e confirme na janela Revogar chave: a chave para de funcionar na hora ("Chave revogada. Chamadas com ela passam a ser recusadas."). Não há como desfazer; crie outra se precisar.

Webhooks

Menu Integrações → Webhooks. O Finder envia um aviso (POST em JSON) para o endereço do seu sistema quando acontece um evento:

• fatura.nova: fatura nova encontrada.
• fatura.atualizada: fatura mudou (paga, sem débito, valor…).
• consulta.concluida: consulta de uma conta terminou.
• consulta.erro: consulta falhou.
• conta.cadastro_invalido: a conta tem dados de acesso inválidos.

Como cadastrar um webhook

1. Clique em Novo webhook.
2. Informe a URL (use HTTPS; endereços internos são recusados) e marque os eventos.
3. Salve. O secret aparece uma única vez: é com ele que o seu sistema confere a assinatura (HMAC-SHA256) de cada aviso.

A lista mostra URL, eventos, entregas (última, "N na fila", "N falha(s) em 24 h") e a situação (Ativo ou Pausado). No botão Ações de cada webhook: Enviar teste ("Teste entregue: HTTP 200 em N ms" ou "Teste não entregue: …"), Histórico de entregas, Editar, Pausar / Reativar (pausado, não recebe avisos), Gerar novo secret (o anterior deixa de valer) e Excluir (apaga o webhook).

Entregas e novas tentativas

Sem resposta 2xx em 10 segundos, o Finder tenta de novo em 1, 5, 30 e 120 minutos. O Histórico de entregas mostra cada envio (na fila, entregue, falhou, cancelada), tentativas, a resposta HTTP, Ver corpo e Reenviar.

Documentação da API

Menu Integrações → Documentação: o guia completo para o programador do seu sistema, com exemplos. Resumo:

• Endereço base /api/v1, cabeçalho X-Api-Key com a chave, respostas em JSON ({ ok, data, erro }), datas no horário de Brasília, páginas de até 500 itens.
• Situação da integração, lista de concessionárias (com os campos de acesso de cada uma) e resumo da carteira.
• Imóveis: listar, consultar, criar ou atualizar pelo nº do objeto, já com as contas do imóvel (sem duplicar; contas que não vierem não são apagadas), e tirar da carteira.
• Contas: listar, consultar, gravar os dados de acesso e consultar agora (passa na frente da fila).
• Faturas: listar (com filtro "desde"), consultar e baixar o PDF.
• Ciclo de consultas: iniciar um ciclo.
• Situação da conta (em_atraso, em_dia, sem_informacao), status da fatura (PENDENTE, VENCIDA, PAGA, SEM_DEBITO) e da consulta (aguardando, em_andamento, concluida, erro, cadastro_invalido, fora_da_fila).

O botão Gerar PDF da página abre a impressão do navegador (escolha "Salvar como PDF").

Concessionárias e dados de acesso

Cada concessionária (ou prefeitura, no IPTU) pede dados diferentes para o Finder consultar. Preencha os campos da conta exatamente como pedido aqui; dado errado ou faltando vira cadastro incompleto ou dados de acesso recusados (e a conta aparece em Corrigir cadastro, em Configurações → Consultas automáticas). Os campos aparecem com esses nomes na janela Adicionar Conta / Editar Conta da tela do imóvel (como cadastrar).

Resumo

O nome exato de cada concessionária pode variar um pouco na lista do portal; o código entre parênteses é o que aparece nas telas Contas, Faturas e no cartão da conta.

Equatorial Energia (GO)

• UC obrigatória. O CPF/CNPJ e a data de nascimento do titular ajudam o Finder a entrar (o portal pede os dados do titular).
• A consulta descobre a UC nacional (15 dígitos) e mostra "UC no portal" no cartão da conta.
• Quando a UC cadastrada não está entre as do titular, a conta fica UC fora da lista: abra a conta e use UCs deste titular no portal → É este imóvel (Contas).
• O portal bloqueia acessos repetidos; as consultas são espaçadas e podem demorar.
• É a única que informa pagamento (fatura "Paga").
• Quando a segunda via não mostra a data de vencimento, o Finder estima a data e mostra "(estimado)".

Saneago (GO)

• Matrícula com hífen (ex.: 1629331-2) e o CPF/CNPJ do titular.
• Entra pelo gov.br com a credencial da imobiliária (certificado digital A1 ou CPF e senha), cadastrada em Configurações → Acesso aos portais das concessionárias (como cadastrar). Sem essa credencial ativa, a Saneago não é consultada.
• A conta gov.br precisa estar sem verificação em duas etapas. Às vezes aparece captcha: o Finder resolve sozinho ou a equipe da P3 Sistemas ajuda (enquanto isso, a conta aparece como Aguardando verificação).
• A mesma referência (mês/ano) pode ter mais de uma fatura; cada uma é tratada pelo número da fatura.

IPTU

• Goiânia: só a inscrição imobiliária (14 dígitos, sem pontos).
• Aparecida de Goiânia: o CCI (código curto do carnê) e o CPF/CNPJ do proprietário, como está no cadastro da prefeitura. Se o CPF foi digitado no campo do CCI, o Finder troca os campos sozinho.
• Anápolis: a inscrição ou o CPF/CNPJ do proprietário (basta um; sem a inscrição, a consulta procura os imóveis pelo CPF/CNPJ). Com só o CPF e vários imóveis, a conta volta pedindo a inscrição. Tem captcha de imagem. Consulta só o ano corrente.
• Goianira: só o CCI.
• Senador Canedo: o código (CCI) e o CPF/CNPJ do proprietário. Se o código for de outro proprietário, a conta é recusada.
• Trindade: código ou inscrição do imóvel, CPF/CNPJ e nome do proprietário completo, como está na prefeitura (o portal só consulta com nome + documento). Tem captcha.
• No IPTU, cada parcela é uma fatura (referência ano/parcela; ano/00 = cota única ou dívida inteira). A guia em PDF é gerada quando o portal permite.
• IPTU enviado pelo SAGI como "IPTU Goiânia" para imóveis de outra cidade é trocado sozinho pela prefeitura certa (pela cidade do imóvel).

Gás de condomínio (GO)

A consulta descobre qual distribuidora atende o condomínio (Supergasbras, Ultragaz, Nacional Gás, Consigaz…). O CPF/CNPJ do titular sozinho basta; a matrícula ou o código do cliente ajuda. Algumas distribuidoras pedem também o CEP e a cidade do imóvel, tirados do cadastro do imóvel (mantenha o CEP e a cidade preenchidos). Contas de gás chegam pela integração (SAGI ou API); a janela Adicionar Conta do portal não oferece o tipo gás.

Enel (GO)

Cadastrada, mas sem consulta automática: as contas podem ser cadastradas, mas não são consultadas.

Tela Concessionárias (administrador da plataforma)

Menu Plataforma → Concessionárias: lista as concessionárias cadastradas, com Código, Nome, o nome de exibição nas máquinas de consulta, Tipo, UF / Cidade, Autenticação, Consulta (Suportado = consulta automática; Manual = sem consulta automática), Status (Ativa / Inativa) e Ações. O administrador cadastra (Nova Concessionária) e edita:

• Identificação: Código (maiúsculas, números e "_"; não muda depois e é o mesmo usado pela fila de consultas), Nome, nome de exibição nas máquinas, porta do painel local, Tempo máx. por consulta, Tipo (Energia, Água, IPTU, Gás, Condomínio), UF, Cidade e URL do portal.
• Campos de acesso (o que o Finder preenche): para os campos 1 a 4, o rótulo que aparece na conta (ex.: "Matrícula"), o placeholder (a dica dentro do campo) e se é obrigatório.
• Perfil da automação: Autenticação (Pública (sem login); Usuário e senha da imobiliária; Transmit DRS / 2 etapas (dados do titular); gov.br: certificado A1 ou CPF + senha da imobiliária; gov.br: só CPF + senha da imobiliária), Sessão, forma do PDF, Captcha, sitekey do captcha e Observações.

Remover desativa a concessionária ("Contas vinculadas a ela deixam de ser consultadas.").

Administração da plataforma (P3 Sistemas)

Recursos só do administrador da plataforma (equipe P3 Sistemas). Gerentes e usuários das imobiliárias não veem estas telas.

Como trabalhar numa imobiliária específica

1. No topo, clique no seletor de imobiliária (ícone de troca, com o nome da imobiliária atual ou "Todas as imobiliárias").
2. Procure em Buscar imobiliária... e clique na imobiliária.

A página recarrega e as telas passam a mostrar os dados daquela imobiliária; ações feitas assim aparecem na auditoria dela com a etiqueta "via admin". Todas as imobiliárias volta à visão geral (o Painel de consultas mostra todos os clientes; algumas ações, como Limpar tudo e iniciar ciclo novo, exigem uma imobiliária escolhida).

Imobiliárias

Menu Plataforma → Imobiliárias: Nome, CNPJ, Plano, Imóveis, Contas, Faturas, Usuários, Status e Criado em. Ações de cada linha:

• Nova imobiliária (no alto) / Editar: Nome, CNPJ, E-mail, Telefone, Cidade, Estado, Plano (os planos do catálogo; escolher um já preenche os limites dele), Máximo de imóveis, Máximo de usuários e a agenda de consultas (Frequência, Dia da semana ou do mês, Hora, Tentativas, Espera (min) e "Bloqueio volta (dias)"). Padrão: toda semana, domingo, 00:00, 3 tentativas, 120 minutos de espera, erros voltam a cada 1 dia.
• Visualizar: dados, se o SAGI está integrado e estatísticas (imóveis, contas, faturas, usuários).
• Desativar: "A imobiliária ficará inativa, mas os dados serão preservados." Ninguém dela consegue entrar.
• Excluir definitivamente (botão vermelho, só aparece na imobiliária já desativada): apaga a imobiliária e tudo o que é dela, sem volta.

Como excluir uma imobiliária definitivamente (ex.: cadastro duplicado)

1. Desative a imobiliária (lixeira). É reversível: confira que é a certa — numa duplicada, a que não recebe mais as sincronizações do SAGI e não tem os usuários em uso.
2. Na mesma linha, clique em Excluir definitivamente. A janela mostra o que será apagado: imóveis, contas, faturas, leituras e registro das consultas, itens da fila, usuários, auditoria, chaves de API, webhooks e os arquivos (prints e PDFs), com o id e o CNPJ.
3. Digite exatamente o nome da imobiliária e clique em Excluir definitivamente.

A exclusão roda no servidor em 9 etapas, com barra de progresso (pode fechar a janela): primeiro a imobiliária sai do ar (a fila para, a chave do SAGI e as de API deixam de valer), depois os dados são apagados e, por fim, a imobiliária. O registro fica na Auditoria da sua imobiliária, com o nome, o CNPJ e o que foi apagado. A imobiliária do seu próprio usuário não pode ser excluída. Se a exclusão parar no meio, clicar de novo termina o resto.

Criar a imobiliária não cria usuário: escolha a imobiliária no seletor do topo e crie o gerente em Usuários. Imobiliárias que chegam pelo SAGI já vêm com o gerente.

Planos e assinaturas

Menu Plataforma → Planos e assinaturas, com duas abas e o botão Rodar rotina agora (gera renovações, aplica bloqueios e confere pagamentos na hora; ela também roda sozinha a cada 5 minutos).

• Planos: o catálogo. Novo plano / lápis: Código (ex.: PRO; não muda se houver imobiliária no plano), Nome, Descrição curta, Preço mensal (R$), Preço anual (R$) (mostra o desconto do anual), Máximo de imóveis, Máximo de usuários, Recursos (um por linha, aparecem no cartão do plano e no site), Dias de teste grátis (0 = sem teste; padrão 7 nos planos pagos), Ordem, Aparece no site e na tela Assinatura, Destaque ("Mais escolhido") e Ativo.
  • Preço mensal vazio = sob consulta (a imobiliária fala com a P3 pelo WhatsApp). Preço zero = grátis. Anual vazio = só mensal.
  • Dias de teste grátis: na primeira contratação a imobiliária usa o plano esses dias sem pagar; a primeira fatura sai nos 2 últimos dias do teste e vence no dia seguinte ao fim (veja Teste grátis). Um teste por imobiliária; quem já pagou um plano não tem teste. Na aba Assinaturas a situação aparece como Teste grátis. Os administradores da plataforma recebem um aviso (os e-mails e WhatsApps de Notificações da plataforma) quando uma imobiliária começa o teste, quando cancela durante o teste e quando paga o primeiro plano, com o contato dela.
  • A tabela de planos do site (findercontas.com.br) é montada com estes planos.
  • Mudar o preço vale para contratações e renovações novas; quem já assina mantém o preço combinado até trocar de plano.
• Assinaturas: uma linha por imobiliária, com plano, valor e ciclo, situação, pago até, cortesia, uso (em vermelho quando passa do limite) e o que está em aberto (clique no valor para abrir essas faturas em Faturas). Busca por imobiliária, plano ou situação. Ações:
  • Definir (ícone de ajuste): Cobrar pelo portal ligado ou desligado, Plano, Ciclo, Valor combinado (R$) (desconto), Pago até, Cortesia até e Observação. Os limites da imobiliária passam a ser os do plano. Desligar Cobrar pelo portal volta a imobiliária para "Sem cobrança": as faturas em aberto são canceladas e ela nunca é bloqueada.
  • Fatura avulsa: descrição, valor e vencimento; paga, estende a assinatura por um ciclo a partir do fim do período atual. Os gerentes recebem por e-mail.

Faturas

Menu Plataforma → Faturas: as faturas dos planos de todas as imobiliárias (contratação, renovação e avulsas).

• Totais no topo: A receber (em aberto, no prazo), Em atraso (em aberto e vencidas), Recebido no mês e Mês anterior. Clique num deles para filtrar a lista.
• Filtros: busca (imobiliária, descrição ou número da fatura, ex.: 12), imobiliária, situação (Em aberto, Em atraso, Pagas, Canceladas ou Todas), forma de pagamento (Pix, Boleto, Cartão ou Baixa manual) e vencimento de/até. Clicar no nome da imobiliária na lista filtra só as faturas dela. Limpar filtros volta para as em aberto.
• Exportar PDF e Exportar CSV saem com os filtros da tela.
• Ações de cada fatura:
  • Consultar no P3Payments (ícone de sincronizar): confere a cobrança agora; se já foi paga, dá baixa e aplica o plano na hora (útil quando o aviso de pagamento não chegou).
  • Abrir o boleto, Copiar a linha digitável e Copiar o Pix copia e cola, quando já foram emitidos (para mandar à imobiliária).
  • Ver no P3Payments: abre a cobrança no console do P3Payments.
  • Baixa manual (pago por fora): Valor recebido, Pago em e Observação. A fatura fica paga e o plano é aplicado; o Pix e o boleto emitidos são cancelados.
  • Cancelar: com Motivo; cancela também o Pix e o boleto emitidos. Não dá para desfazer.

Como começar a cobrar uma imobiliária que já usa o Finder

As imobiliárias antigas ficam "Sem cobrança" e nunca são bloqueadas. Para passar a cobrar uma delas:

1. Em Assinaturas, clique em Definir na imobiliária.
2. Deixe Cobrar pelo portal ligado, escolha Plano e Ciclo e, se houver desconto, o Valor combinado.
3. Em Pago até, informe até quando ela já está paga (ou dê uma Cortesia até).
4. Salvar. A fatura de renovação sai sozinha alguns dias antes dessa data.

Onde ligar o pagamento online

Em Plataforma → Integrações da plataforma → Pagamentos (P3Payments · EFI) (veja Integrações da plataforma). Com o pagamento desligado, as faturas aparecem para a imobiliária com Combinar o pagamento (WhatsApp da P3) e a baixa é manual.

Integrações da plataforma

Menu Plataforma → Integrações da plataforma: os serviços da P3 Sistemas ligados ao Finder. As imobiliárias não veem esta tela (em Integrações → Sistemas conectados elas só têm o SAGI e a API).

• Assistente de IA (P3IA): liga o botão Pergunte à IA das telas. A parte de cima vale para a imobiliária escolhida no seletor do topo (chave própria dela no P3IA, IA ligada, Salvar chave, Testar chave, lixeira para remover); embaixo, Chave geral e avisos da plataforma: a chave geral (vale para as imobiliárias sem chave própria), o endereço do P3IA e o Segredo do webhook do P3IA (Salvar). No fim do cartão, Perguntas sem resposta: o resumo dos últimos 30 dias (perguntas, sem resposta, avaliações útil e não útil) e as perguntas que a IA não soube responder, com quando, tela (abre o manual dela), pergunta e imobiliária. Depois de completar o capítulo do manual, clique em Resolvido; Mostrar as resolvidas traz o histórico.
• WhatsApp (P3 Messenger): envio dos alertas de operação por WhatsApp. Campos Endereço do P3 Messenger (já vem https://messenger.p3sistemas.com/api) e Chave de API (X-Api-Key) do cliente P3 Sistemas no P3 Messenger (os alertas saem pelo número conectado nele). A situação no cabeçalho do cartão diz Conectado, Desconectado, Sem resposta ou Não configurado. Testar conexão confirma o cliente e o número. Em Avisos de entrega, Registrar avisos registra o Finder no P3 Messenger (o segredo o próprio Finder gera; nada para copiar): a partir daí cada WhatsApp enviado mostra se foi Entregue, Lido ou falhou na lista de últimos envios. O cartão mostra também os envios dos últimos 30 dias e tem Enviar teste para (DDD + número) com Testar WhatsApp (use outro número que não o que envia: o WhatsApp não entrega para ele mesmo, e o Finder recusa esse teste). Se um envio aparecer com Número bloqueado no P3 Messenger, é porque os envios anteriores para ele nunca foram entregues: libere o número na lista de bloqueio do P3 Messenger.
• Pagamentos (P3Payments · EFI): liga a cobrança dos planos pelo portal. Campos: Pagamento pelo portal ligado, Aceitar cartão, Endereço do P3Payments, Chave de API da aplicação (X-Api-Key) (escopos cobrancas:ler e cobrancas:escrever), Código da conta EFI no P3Payments, Segredo do webhook da aplicação, URL do webhook (onde o P3Payments avisa o pagamento: https://findercontas.com.br/api/pagamentos/p3payments/webhook, a mesma cadastrada no webhook da aplicação no P3Payments), Contratação vence em (dias), Renovação sai antes do fim (dias) e Carência antes do bloqueio (dias). O cartão usa o identificador de conta e o ambiente (homologação ou produção) cadastrados na conta EFI do P3Payments: o Finder lê de lá, e o Testar conexão mostra se o cartão está disponível. Testar conexão (fica desligado até a chave e o código da conta estarem salvos) confere a chave e a conta.

Como ligar o assistente de IA (P3IA) para uma imobiliária

A P3IA, inteligência artificial da P3 Sistemas, responde as dúvidas do botão Pergunte à IA com este manual. Cada imobiliária tem a sua empresa e a aplicação finder-contas no P3IA (a P3 Sistemas cria).

1. No P3IA (https://ia.p3sistemas.com): Empresas → empresa da imobiliária → Aplicações e chaves → Finder Contas → Nova chave. Copie a chave (aparece uma única vez).
2. No Finder: escolha a imobiliária no seletor do topo e abra Plataforma → Integrações da plataforma, cartão Assistente de IA (P3IA).
3. Cole a chave em Chave da aplicação (X-Api-Key), clique em Salvar chave e ligue a chave IA ligada (liga e desliga na hora: "IA da P3 ligada: o botão "Pergunte à IA" já responde nas telas" / "Assistente de IA desligado").
4. Testar chave confirma no P3IA a empresa e a aplicação da chave ("Chave válida: empresa …, aplicação …"). Se a chave for de outra aplicação, aparece o aviso "A chave funciona, mas é da aplicação … (esperado: finder-contas)."

A chave fica cifrada no servidor e nunca vai para o navegador. Sem chave própria, vale a chave geral da plataforma, se o administrador ligou (situação Ligado (chave geral)); o administrador a configura no bloco Chave geral da plataforma do mesmo cartão (Salvar chave geral). O botão da lixeira remove a chave da imobiliária ("Remover a chave do P3IA desta imobiliária?").

Como receber os avisos do P3IA (pergunta sem resposta)

1. No P3IA (https://ia.p3sistemas.com): empresa → aplicação finder-contas → Webhooks → Novo webhook.
2. Em URL, informe https://findercontas.com.br/api/ajuda/p3ia/webhook, marque Selecionar todos os eventos e clique em Criar webhook.
3. Na tela Webhook criado, clique em Copiar segredo (começa com whsec_; aparece uma única vez).
4. No Finder, em Plataforma → Integrações da plataforma → Assistente de IA (P3IA), cole em Segredo do webhook do P3IA e clique em Salvar.
5. No P3IA, clique em Testar no webhook: deve aparecer Ping entregue.

A partir daí, cada pergunta sem resposta, falha da IA ou conta de IA pausada manda um e-mail (e WhatsApp, se configurado) para os destinatários dos alertas de operação, no máximo 5 por hora; todas ficam na lista Perguntas sem resposta. As avaliações dos usuários (útil / não útil) entram no resumo.

Máquinas de consulta

As consultas rodam em computadores Windows com o programa de consulta do Finder instalado (um por concessionária). No Painel de consultas o administrador:

• baixa o instalador de cada concessionária e atualiza as máquinas desatualizadas;
• acompanha cada máquina (sinal, versão, rede, resultados) e pausa, retoma, atualiza, configura, desconecta, revoga a chave ou desinstala;
• ajuda quando a consulta pede uma pessoa (captcha, gov.br), pelo botão Ajudar;
• recebe e resolve os alertas de operação.

Veja Recursos do administrador da plataforma.

Concessionárias

Cadastro dos portais consultados, dos campos de acesso de cada um e da forma de autenticação. Veja Tela Concessionárias.

Notificações da plataforma

Em Configurações → Notificações e alertas: SMTP (e-mail), alertas de operação e segurança de acesso. Em Plataforma → Integrações da plataforma: WhatsApp (P3 Messenger), assistente de IA (P3IA) e pagamentos (P3Payments). Veja Configurações.

Situações e mensagens

Glossário das etiquetas e mensagens que aparecem no Finder: o que cada uma quer dizer e o que fazer.

Situação da conta (última consulta)

A situação aparece com o mesmo rótulo e a mesma cor em todas as telas: lista Contas, lista Imóveis, cartão da conta no imóvel, tela da conta ("resultado: …") e nos arquivos PDF e CSV da lista de contas. Nenhum código técnico aparece. Passe o mouse na etiqueta para ler a dica (coluna "Dica na tela").

Na lista Imóveis, conta sem nenhuma consulta aparece como nunca. O filtro Com problema de cadastro da tela Contas (e o cartão Contas com problema do Dashboard) reúne Dados de acesso recusados, Cadastro incompleto, UC fora da lista e Faturas não lidas.

Para o administrador da plataforma, que vê os códigos técnicos nas telas da fila e do registro, a correspondência é: login_recusado e credencial_invalida viram Dados de acesso recusados; cadastro_invalido vira Cadastro incompleto; erro, bloqueado e portal_indisponivel viram Site indisponível; login_necessario vira Aguardando verificação; PROCESSANDO vira Na fila; PENDENTE vira Aguardando 1ª consulta.

Situação da fatura

Situação na fila de consultas

Como a imobiliária vê (coluna Consulta da lista Contas e indicador Consulta automática da conta):

No Histórico de Consultas do imóvel, o Status de cada consulta aparece como Concluída ou Não concluída, com a coluna Motivo.

Em Configurações → Consultas automáticas, as contas que não foram concluídas aparecem em duas colunas: Site indisponível (o site da concessionária não respondeu ou bloqueou; o Finder tenta de novo sozinho) e Corrigir cadastro (dados de acesso recusados ou incompletos; só a correção resolve). Detalhes em Quando a consulta falha.

O administrador da plataforma vê também Na fila · nº X (posição na fila da concessionária), Nova tentativa às HH:MM, Erro (N) (N = tentativas) e Sem consulta (Gerenciar fila), e as três categorias de erro: bloqueio da concessionária, erro na consulta e dados cadastrais.

Mensagens das consultas

A mensagem de cada consulta aparece na aba Consultas da conta, no Histórico de Consultas do imóvel (coluna Motivo), no indicador Consulta automática da conta, ao passar o mouse em Não concluída na lista Contas, na lista Últimas consultas do Dashboard e no sino. Para a imobiliária, a mensagem vem em português simples, dizendo o que houve e o que fazer, sem códigos técnicos:

Mensagens que já são claras (ex.: "N fatura(s) saíram da lista do portal…") aparecem como estão.

Códigos técnicos (administrador da plataforma)

O administrador da plataforma vê a mensagem original, com o código, no Registro de consultas, na Fila de consultas e na aba Consultas da conta:

• BLOCKED_BY_PROTECTION: o portal bloqueou o acesso (DRS, "requisição rejeitada", excesso de acessos). Temporário.
• PORTAL_UNAVAILABLE / TIMEOUT: o portal estava fora do ar, não carregou ou demorou demais.
• INVALID_CREDENTIALS: o portal recusou os dados da conta.
• VALIDATION: faltam dados obrigatórios na conta (ex.: "Informe o CPF/CNPJ do proprietário").
• NAVIGATION: a consulta não achou o que esperava na tela (portal mudou ou lento).
• LOGIN_REQUIRED: precisa de login humano (gov.br).
• "conta sem login/UC cadastrado: nada a consultar": a conta não tem dado de acesso.
• "voltou para a fila após bloqueio da concessionária (…)" / "… após erro na consulta (…)": a conta foi recolocada na fila (automático ou pelo botão).
• "recuperado: passou de N min em PROCESSANDO…": a consulta travou e a conta voltou sozinha para a fila.
• "login recusado em N máquinas que estavam logando normalmente…": a recusa foi confirmada (credencial_invalida).

Mensagens comuns do portal

Perguntas frequentes

Respostas curtas para as dúvidas mais comuns. Quando a mesma tarefa pode ser feita de mais de um jeito, a resposta começa com "Depende" e lista as opções.

Primeiros passos

Como começo a usar o Finder?

1. Cadastre os imóveis (ou ligue a integração SAGI em Integrações → Sistemas conectados), sempre com o Nº do objeto.
2. Cadastre as contas de cada imóvel com os dados que a concessionária pede (Concessionárias e dados de acesso).
3. Se tiver contas da Saneago, cadastre o acesso gov.br da imobiliária em Configurações → Acesso aos portais das concessionárias.
4. Escolha a frequência das consultas em Configurações → Consultas automáticas e clique em Iniciar ciclo agora.
5. Acompanhe no Dashboard e nos Relatórios.

Quanto tempo até ver as faturas?

Depende do tamanho da fila: cada conta leva de segundos a poucos minutos. Em Configurações → Consultas automáticas, a coluna Consultadas mostra quantas contas de cada concessionária já foram consultadas ("X de Y") e quantas ainda estão Na fila; o sino avisa quando cada consulta termina.

Como cadastro imóveis e contas?

Depende de como a imobiliária trabalha:

• Pelo portal: Imóveis → Adicionar; depois, na tela do imóvel, Adicionar Conta (Imóveis).
• Pelo SAGI: o SAGI envia imóveis e contas sozinho depois de configurar a chave (Integração com o SAGI).
• Pela API: o sistema da imobiliária cria ou atualiza imóveis e contas pelo nº do objeto (Documentação da API).

Contas de gás só entram pela integração (SAGI ou API).

Consultas

Por que minha conta não é consultada?

• O imóvel não tem Nº do objeto.
• Faltam dados obrigatórios da concessionária (situação Cadastro incompleto).
• A concessionária recusou os dados (situação Dados de acesso recusados; a conta aparece em Corrigir cadastro em Configurações → Consultas automáticas) e ainda não foi corrigida.
• A concessionária não tem consulta automática (ex.: Enel).
• Saneago sem credencial gov.br ativa em Configurações.
• A frequência está em "Só quando eu pedir": inicie um ciclo.
• A conta é nova e o próximo ciclo ainda não rodou: use Consultar agora.

Como consulto agora? / Como forço a consulta?

Depende do alcance:

• Uma conta: tela da conta → Consultar agora (ou o ⚡ na lista Contas, ou ⋮ → Consultar agora no cartão do imóvel). Passa na frente da fila.
• Só uma concessionária de um imóvel: tela do imóvel → setinha ao lado de Consultar agora → escolha a concessionária. Passa na frente da fila.
• Todas as contas de um imóvel: tela do imóvel → botão Consultar agora. Entram na ordem normal.
• Todas as contas de uma concessionária (imobiliária inteira): Configurações → Consultas automáticas → escolha a concessionária → Iniciar ciclo agora.
• Tudo: Configurações → Consultas automáticas → Iniciar ciclo agora com "Todas as concessionárias".
• Só as contas paradas porque o site estava indisponível: Configurações → Consultas automáticas → Tentar de novo agora (N) (gerente).

Recolocar só uma concessionária, itens escolhidos da fila ou contas escolhidas a dedo é feito pela equipe da P3 Sistemas (administrador da plataforma). Tabela completa em Como consultar agora (todas as formas).

Como consulto só uma concessionária?

Depende do alcance que você quer — são duas situações diferentes:

1. Só uma concessionária de um imóvel (ex.: só a energia do imóvel 4632): abra o imóvel, clique na setinha ao lado de Consultar agora e escolha a concessionária; ou, no cartão da conta, menu ⋮ → Consultar agora. A conta passa na frente da fila.
2. Todas as contas de uma concessionária na imobiliária (ex.: todas as da Equatorial): Configurações → Consultas automáticas, escolha a concessionária na lista ao lado de Iniciar ciclo agora e clique no botão. Só as contas dela voltam para a fila; o ciclo agendado não muda (gerente).

Como consulto todas as contas de um imóvel?

Abra o imóvel e clique em Consultar agora (o botão, não a setinha): todas as contas do imóvel voltam para a fila, na ordem normal. Para uma conta passar na frente, use Consultar agora nela.

Como consulto tudo de novo?

Configurações → Consultas automáticas → Iniciar ciclo agora com "Todas as concessionárias" (gerente). Contas em Corrigir cadastro ficam de fora até serem corrigidas.

Como mudo o dia e a hora das consultas automáticas?

Configurações → Consultas automáticas: Frequência, Dia da semana (ou Dia do mês) e Hora de início → Salvar frequência. Só o gerente altera.

Muitas contas estão com "site indisponível". O que faço?

Nada na conta: o site da concessionária está bloqueando ou fora do ar. O Finder tenta de novo sozinho (nos dias seguintes ou no próximo ciclo). Para tentar já, depende do alcance:

• Todas as paradas, de todas as concessionárias: Configurações → Consultas automáticas → Tentar de novo agora (N) (gerente).
• Todas as contas de uma concessionária: escolha a concessionária ao lado de Iniciar ciclo agora (gerente).
• Uma conta: Consultar agora na conta.

Se o problema durar vários dias, fale com o suporte da P3 Sistemas.

Corrigi os dados de uma conta em "Corrigir cadastro". E agora?

A conta volta a ser consultada no próximo ciclo. Para consultar já, Consultar agora na conta (tira o erro de cadastro e passa na frente da fila).

Como sei se a consulta terminou?

Depende do nível de detalhe: o sino mostra "Consulta concluída" ou "Consulta com erro"; a tela da conta mostra Última consulta e a aba Consultas; o cartão da conta no imóvel mostra a data; Configurações → Consultas automáticas mostra o andamento por concessionária. Veja Como acompanhar o andamento.

Por que a consulta falhou?

Depende de onde você está olhando: tela da conta → indicador Consulta automática e aba Consultas; lista Contas → passe o mouse em Não concluída na coluna Consulta; tela do imóvel → Histórico de Consultas, coluna Motivo; Dashboard → Últimas consultas; sino → Consulta com erro. A mensagem vem em português simples, dizendo o que houve e o que fazer (Mensagens das consultas).

Contas e cadastro

Como corrijo o login, a UC ou a matrícula de uma conta?

Na tela do imóvel, cartão da conta → ⋮ → Editar → corrija → Salvar. Se você estiver na tela da conta, Editar no imóvel leva até lá. Imobiliárias com SAGI também podem corrigir no SAGI (vale o valor novo que o SAGI mandar; veja Quem vence nos dados de acesso).

A conta está "UC fora da lista". Como resolvo?

Depende de onde você está: na tela da conta, cartão UCs deste titular no portal; na tela do imóvel, link Titular no portal: N UCs no cartão da conta. Nos dois, clique em É este imóvel na UC certa e em Vincular e consultar (gerente ou administrador).

Como excluo algo?

Depende do que é:

• Conta: cartão da conta no imóvel → ⋮ → Excluir.
• Imóvel: lista Imóveis ou tela do imóvel → Excluir (gerente). As contas do imóvel saem junto e param de ser consultadas (Como excluir um imóvel).
• Usuário: Usuários → Desativar (não apaga).
• Credencial gov.br: Configurações → Remover (ou desligue a chave Ativo para só pausar).
• Chave de API: Revogar. Webhook: Excluir (ou Pausar).
• Logo dos PDFs: botão da lixeira em Configurações → Relatórios em PDF.

Faturas e valores

O locatário pagou, mas a fatura continua vencida

O Finder só vê o pagamento na próxima consulta (e o portal da concessionária pode levar dias para baixar). Use Consultar agora na conta.

O que é "sem débito"?

A fatura saiu da lista do portal numa consulta completa. Normalmente foi paga, mas não é comprovante de pagamento.

Onde vejo as faturas?

Depende do que você quer ver:

• Todas, com filtros: tela Faturas.
• De um imóvel: tela Faturas com o filtro Imóvel; ou, por conta, Ver faturas no cartão da conta no imóvel.
• De uma conta: tela da conta, abas Faturas (em aberto) e Histórico (pagas e sem débito).
• Só vencidas / a vencer: tela Faturas, Status Vencidas / A vencer, ou os cartões Vencido / A vencer do Dashboard.

Veja Onde ver as faturas.

Onde pego o código de barras ou o PIX?

Depende da tela: na tela Faturas, botões Copiar código de barras, Copiar PIX e PDF na linha (ou em Detalhes); no imóvel, Ver faturas → Detalhes → Copiar; na tela da conta, Detalhes mostra o código para selecionar e PDF abre o boleto.

O vencimento aparece "(estimado)"

O portal não informou a data; o Finder estimou pelas faturas anteriores. Confira no PDF do boleto.

Relatórios e exportação

Como exporto os dados?

Depende do que você quer:

• Faturas: Faturas → Exportar PDF ou Exportar CSV (respeita os filtros).
• Lista de imóveis: Imóveis → Exportar PDF ou Exportar CSV (respeita a busca).
• Lista de contas: Contas → Exportar PDF ou Exportar CSV (respeita a busca, a concessionária, a situação e a ordem).
• Relatórios (inadimplência, faturas por mês, contas em atenção): Relatórios → aba → CSV ou Exportar PDF.
• Por e-mail: Configurações → Relatórios em PDF (automático, Enviar agora ou Enviar teste).
• Para outro sistema: SAGI, API ou webhooks.

Veja Como exportar (todas as formas).

Como tiro um PDF da lista de faturas, imóveis ou contas?

Depende da lista. Nas três, aplique os filtros e clique em Exportar PDF (ao lado fica Exportar CSV, para planilha):

• Faturas: botão no alto da tela; sai faturas_AAAA-MM-DD.pdf com os indicadores Faturas, Valor total, Vencido em aberto e A vencer (como).
• Imóveis: botão ao lado da busca; sai imoveis_AAAA-MM-DD.pdf com os indicadores Imóveis, Contas e Sem nº do objeto (como).
• Contas: botão ao lado do total; sai contas_AAAA-MM-DD.pdf com os indicadores Contas, Com atraso, Valor em atraso e Nunca consultadas (como).

O PDF leva todas as linhas do filtro (não só a página aberta), com o logo, o nome e o CNPJ da imobiliária no cabeçalho e "Página X de Y" no rodapé. Aparece "PDF gerado". Todos os perfis exportam, e a exportação fica na Auditoria. Cadastre o logo em Configurações → Relatórios em PDF.

Como mando o relatório de inadimplência para o proprietário?

Depende: para mandar uma vez, Relatórios → Inadimplência, filtre e clique em Exportar PDF (o PDF sai com o logo da imobiliária; cadastre em Configurações → Relatórios em PDF) e envie o arquivo. Para mandar sempre, cadastre o e-mail em Configurações → Relatórios em PDF com o relatório "Inadimplência por imóvel" marcado (todos os destinatários recebem o relatório da carteira inteira).

Como recebo os relatórios toda segunda-feira por e-mail?

Configurações → Relatórios em PDF: frequência Toda semana, dia Segunda, horário, e-mails e relatórios; Salvar envio automático. Para receber já, Enviar agora.

A busca da aba de relatório não entrou no PDF

A caixa de busca filtra só a tela. O PDF e o CSV usam os filtros de seleção (concessionária, carteira, atraso, período, prazo).

Plano e pagamento

Dá para testar um plano antes de pagar?

Sim. Quem nunca pagou um plano nem fez teste vê Testar N dias grátis em Assinatura → Planos (e no site): o plano vale na hora, sem pagar, e a primeira fatura vence no dia seguinte ao fim do teste. Para não continuar, clique em Cancelar a renovação antes. Veja Teste grátis.

Como mudo de plano?

Em Assinatura → Planos, o gerente clica em Contratar no plano desejado e paga a fatura (Pix, boleto ou cartão). O plano muda quando o pagamento é confirmado. Plano maior: os dias que faltam do atual viram desconto. Plano menor: fica agendado para a próxima renovação. Veja Como contratar ou trocar de plano.

Paguei e o plano não mudou

Pix confirma na hora; boleto em até 3 dias úteis. Abra Assinatura → Pagar na fatura e clique em Já paguei para conferir na hora. Se ainda assim não mudar, fale com a P3 Sistemas com o comprovante.

O portal só abre a tela Assinatura

A imobiliária está Bloqueada: a assinatura venceu e passou a carência sem pagamento. Pague a fatura em aberto na própria tela; o acesso, as consultas automáticas, o SAGI e a API voltam na hora.

Recebo a fatura por e-mail?

Sim: os gerentes da imobiliária (e o e-mail informado em E-mail para a fatura) recebem a fatura de renovação, a confirmação do pagamento e o aviso de bloqueio.

Acesso e usuários

Esqueci minha senha

Depende: na tela de login, Esqueci minha senha (chega um link por e-mail, se o e-mail da plataforma estiver configurado). Se o e-mail não chegar, peça ao gerente da imobiliária: em Usuários ele gera um link ou define uma senha nova. Veja Como recuperar o acesso.

Como troco a senha de outra pessoa?

Depende (gerente): Usuários → Gerar link de redefinição (a pessoa cria a senha) ou Usuários → Editar → Nova Senha (você define). Veja Como redefinir a senha de alguém.

Como dou acesso a um funcionário?

Gerente: Usuários → Novo usuário (perfil Usuário para o dia a dia, Gerente para quem administra). O número de usuários é limitado pelo plano.

Como sei quem fez uma alteração?

Gestão → Auditoria: filtre por ação, usuário, período ou busque na descrição. Mostra o antes e o depois em Ver detalhes.

Ajuda

Como uso o assistente de ajuda?

Clique em Pergunte à IA no canto inferior direito de qualquer tela e escreva a dúvida: quem responde é a P3IA, a inteligência artificial da P3 Sistemas. A resposta vem deste manual, começando pelo capítulo da tela aberta. Clique em 👍 ou 👎: o 👎 manda a pergunta para a lista de melhorias do manual. O ícone de atualizar começa uma conversa nova e o ícone de livro abre o manual da tela.

O botão "Pergunte à IA" não aparece

A IA não está ligada para a sua imobiliária: no lugar aparece o botão ?, que abre o manual da tela. Quem liga é a P3 Sistemas (administrador da plataforma, em Plataforma → Integrações da plataforma): peça pelo suporte.

O assistente não soube responder

Procure no menu Ajuda (tem busca) ou fale com o suporte da P3 Sistemas (sac@p3sistemas.com).

Guia rápido: onde fazer cada coisa

Tabela de tarefas do Finder: o que você quer fazer, em qual tela e qual botão. Quando a mesma tarefa tem mais de um jeito (por exemplo, consultar uma conta, um imóvel ou uma concessionária inteira), todas as opções aparecem, uma por linha. "Gerente" indica que só o gerente (e o administrador) vê a opção.

Consultar e atualizar

Acompanhar as consultas

Cadastro

Faturas e boletos

Exportar e relatórios

Integrações e IA

Plano e pagamento

Usuários e acesso