Gestão de Clientes

A página de Clientes é o centro de gestão de toda a sua carteira de clientes. Aqui pode consultar, pesquisar, filtrar e gerir informações de forma centralizada.

Layout da Página

A página está dividida em duas áreas principais:

Estatísticas Rápidas

No painel direito encontra três cartões de estatísticas que funcionam como filtros rápidos:

Total de Clientes

• Mostra o número total de clientes na base de dados
• Indica a percentagem de clientes ativos
• Clique para ver todos os clientes

Clientes Ativos

• Número de clientes com estado ativo
• Percentagem em relação ao total
• Clique para filtrar apenas clientes ativos

Clientes Bloqueados

• Número de clientes bloqueados/suspensos
• Clique para ver apenas clientes bloqueados

Pesquisar Clientes

A barra de pesquisa no topo permite encontrar clientes em tempo real enquanto digita.

Campos Pesquisáveis

Pode pesquisar por qualquer um destes campos:

• Número de Cliente — o código interno (ex: 12345)
• Nome — nome completo ou parcial do cliente
• NIF — número de identificação fiscal
• Email — endereço de email do cliente

A pesquisa não é sensível a maiúsculas/minúsculas e encontra correspondências parciais.

Exemplos de Pesquisa

Filtros Avançados

Clique no botão "Filtros" para aceder ao painel de filtros avançados. O número de filtros ativos aparece como badge no botão.

Estado do Cliente

Filtre por situação do cliente:

• Todos — sem filtro de estado
• Ativos — clientes em atividade normal
• Inativos — clientes sem atividade
• Bloqueados — clientes suspensos

Gestores e Responsáveis

Filtre por pessoa atribuída:

• Gestor — o gestor de conta principal
• Responsável — pessoa responsável pelo cliente
• Gestor RH — gestor de recursos humanos atribuído

Plano de Serviço

Filtre clientes por tipo de plano/avença contratada.

Cessação de Atividade

Para encontrar clientes que cessaram atividade:

1. Ative o filtro "Cessação de Atividade: Sim"
2. Opcionalmente, defina um intervalo de datas
3. A lista mostrará apenas clientes cessados nesse período

Estado de Dívidas

Filtre por situação fiscal:

AT (Autoridade Tributária):

• Regularizada
• Não Regularizada
• Sem informação
• Erro

SS (Segurança Social):

• Regularizada
• Não Regularizada
• Sem informação
• Erro

Gerir Filtros Ativos

• Filtros ativos aparecem como chips abaixo da pesquisa
• Clique no X de um chip para remover esse filtro
• Use "Limpar todos" para remover todos os filtros de uma vez

Lista de Clientes

Os clientes aparecem em cartões com informação condensada e ações rápidas.

Informação no Cartão

Cada cartão mostra:

Lado Esquerdo:

• Número do Cliente — identificador único
• NIF — número de contribuinte
• Nome — nome completo do cliente
• Badges de Dívidas — estado AT e SS

Lado Direito:

• Botões de Acesso Rápido — login em sistemas externos
• Botão Detalhes — abre ficha completa

Indicadores Visuais (Borda Esquerda)

A cor da borda esquerda indica o estado:

Badges de Dívidas

Os badges AT e SS indicam situação de dívidas:

• Verde — "Regularizada" (sem dívidas)
• Vermelho — "Não Regularizada" (dívidas pendentes)
• Amarelo — "Sem informação"

Passe o rato sobre o badge para ver a data da última atualização.

Botões de Acesso Rápido

Dependendo das credenciais configuradas, pode ver botões para:

Paginação

A lista mostra 10 clientes por página. Use os controlos de paginação no fundo:

• Primeira / Última — ir para os extremos
• Anterior / Próxima — navegar página a página
• Números — saltar para página específica

Detalhes do Cliente

Clique num cartão ou no botão "Detalhes" para abrir o painel lateral com informação completa.

Separador: Geral

Informação básica do cliente:

• Nome Completo
• NIF (Número de Identificação Fiscal)
• Email
• Telemóvel
• Telefone
• Observações — notas e anotações

Separador: Acessos

Credenciais organizadas por entidade:

Credenciais Fiscais:

• NIF e senha do Portal das Finanças
• NISS e senha da Segurança Social
• Login ACT

CTT e Correios:

• Via CTT (utilizador e senha)

Outras Entidades:

• IAPMEI (utilizador e senha)
• IEFP (utilizador e senha)
• RU - Registo Único (utilizador e senha)

Separador: Empresa

Informação empresarial e atribuições:

• Morada completa — rua, código postal, localidade
• Gestor — gestor de conta atribuído
• Responsável — pessoa responsável
• Gestor RH — gestor de recursos humanos
• Localização/Arquivo — onde está o dossier físico
• Plano — tipo de serviço contratado
• Avença Personalizada — valor e periodicidade customizados

Separador: Fiscais

Informação fiscal e tributária:

• Datas de Atividade — início e cessação IVA
• Relação com Cliente — cliente desde / até
• Regime de IVA — tipo e data de início
• CIRS — código de atividade
• CAE — códigos de atividade económica (principal e secundários)
• Registo Comercial — número de matrícula

Separador: IRS

Gestão de agregados IRS:

• Criar grupos IRS por ano fiscal
• Ver estado de pagamento e submissão
• Gerir detalhes do agregado

Separador: Sócios

Para empresas, gestão de sócios/acionistas:

• Adicionar novos sócios
• Ver lista com: nome, NIF, NISS, email
• Senhas — fiscais e segurança social de cada sócio
• Capital Social — percentagem de participação
• Editar/Eliminar informação de sócios

Criar Novo Cliente

Clique no botão "Novo Cliente" para adicionar clientes.

Opção 1: Adicionar Manualmente

Preencha o formulário organizado em separadores:

1. Geral — nome, NIF, email, telemóvel, observações
2. Empresa — morada, gestores, plano, localização
3. Acessos — credenciais dos vários sistemas
4. Fiscais — regime, datas, códigos de atividade
5. IRS — configuração de agregado (se aplicável)
6. Sócios — adicionar sócios (para empresas)

Campos Obrigatórios:

• Nome
• Email
• Telemóvel
• NIF
• NISS
• Tipo de Cliente

Opção 2: Importar em Massa

Para adicionar vários clientes de uma vez:

1. Preparar ficheiro — Excel (.xlsx, .xls) ou CSV
2. Carregar — arraste ou selecione o ficheiro
3. Analisar — o sistema valida os dados e mostra:
   • Registos válidos vs. inválidos
   • Clientes novos vs. existentes (atualização)
   • Erros de validação detalhados
4. Selecionar — escolha quais clientes importar
5. Importar — acompanhe o progresso
6. Resultado — veja quantos foram criados/atualizados

Atualizar Dados

Se os dados parecem desatualizados:

1. Clique no botão Atualizar Cache (ícone de refresh) junto à pesquisa
2. Aguarde enquanto os dados são recarregados
3. A lista será atualizada com os dados mais recentes

Guardar Alterações

Ao editar um cliente no painel de detalhes:

1. Faça as alterações necessárias
2. O indicador de "alterações não guardadas" aparece
3. Clique em Guardar para confirmar
4. Ou clique em Cancelar para descartar

As alterações são aplicadas imediatamente após guardar.