Exibição de Status de Atualização de Clientes por Frequência de Visitas

Histórico de Alterações

Data	Quem	Comentários
02/10/2026	Renato Lima	Criação do documento

Necessidade

O cliente necessita disponibilizar no GeoSales Portal e Mobile uma visão que permita aos vendedores e gestores identificar de forma rápida a situação de atualização dos clientes em relação à frequência de visitas definida pela empresa.

Para essa identificação, deverá ser utilizada a data da última visita aprovada, já disponibilizada no GeoSales, juntamente com a frequência de visitas em dias, que deverá ser disponibilizada por meio da integração com o ERP.

A partir dessas informações, o GeoSales deverá calcular automaticamente a situação do cliente e apresentar indicadores visuais que permitam identificar clientes Nunca Visitados, Atualizados, Próximos de Vencer e Desatualizados.

O cliente também necessita de filtros por status e indicadores quantitativos, permitindo uma visão consolidada da carteira e facilitando o acompanhamento da situação dos clientes pela equipe comercial e pelos gestores.

Solução

Irá desenvolver no GeoSales a funcionalidade para exibição do Status de Atualização do Cliente, utilizando a data da última visita já integrada do ERP e incorporando a integração do campo Frequência de Visitas (em dias), responsável por definir o intervalo máximo entre visitas.

A solução deverá implementar a regra de cálculo para determinar automaticamente o status de cada cliente, considerando os seguintes cenários:

* Nunca Visitado (Cinza): quando não existir data da última visita.

* Atualizado (Verde): quando a data atual for menor ou igual à data da última visita acrescida da frequência de visitas.

* Próximo de Vencer (Amarelo): quando faltarem até 10 dias para o vencimento da próxima visita.

* Desatualizado (Vermelho): quando a data atual ultrapassar a data limite calculada pela frequência de visitas.

O status deverá ser apresentado de forma intuitiva no Mobile, por meio de indicadores visuais, como cores, ícones ou etiquetas, permitindo rápida identificação da situação de cada cliente.

Além disso, deverão ser disponibilizados:

Filtros por status, permitindo consultar clientes conforme sua situação(Atualizados, Próximos de Vencer, Desatualizados e Nunca Visitados);
Card(s) de indicadores, apresentando o total de clientes em cada status para facilitar o acompanhamento gerencial;
Integração do campo Frequência de Visitas proveniente do ERP, garantindo que a regra de cálculo seja equivalente à utilizada no Protheus e mantendo a consistência das informações entre os sistemas.

Com essa implementação, vendedores e gestores passarão a ter uma visão consolidada da situação dos clientes, facilitando o acompanhamento da carteira, a tomada de decisão e o cumprimento das políticas comerciais estabelecidas pela empresa.

Implementação

1 - Integração com o ERP

Avaliar a origem e disponibilidade do campo de frequência de visitas no Protheus.
Adequar a integração para receber a frequência de visitas em dias.
Armazenar/disponibilizar a informação no GeoSales, conforme a arquitetura de integração existente.
Garantir a atualização da frequência quando houver alteração no ERP.

2 - Regra de cálculo

Utilizar a data da última visita aprovada já existente no GeoSales.
Implementar o cálculo da data de vencimento:

Data de Vencimento = Data da Última Visita + Frequência de Visitas.

Implementar a classificação automática do cliente conforme as regras de negócio definidas.
Considerar a janela de 10 dias para o status Próximo de Vencer.

3 - Disponibilização do status

Disponibilizar o status calculado para utilização nas consultas do GeoSales.
Criar os indicadores visuais correspondentes:

Cinza — Nunca Visitado;

Verde — Atualizado;

Amarelo — Próximo de Vencer;

Vermelho — Desatualizado.

4 - Adequação do Portal

Exibir o status na consulta/listagem de clientes.
Disponibilizar filtros por status.
Implementar os cards com a quantidade de clientes em cada situação.
Garantir que os indicadores respeitem as permissões e a carteira de clientes do usuário.

5 - Adequação do Mobile

Exibir o status do cliente na consulta/listagem de clientes.
Aplicar os respectivos indicadores visuais.
Disponibilizar a consulta por status, conforme definição da interface do Mobile.

6 - Validação e homologação

Realizar testes com clientes nas diferentes situações previstas.
Validar os cálculos comparando os resultados do GeoSales com a regra utilizada no Protheus.
Validar os filtros e os quantitativos apresentados nos cards.
Disponibilizar a funcionalidade para homologação do cliente antes da publicação em produção.

Documentos relacionados

Escopo

Escopo Incluso

Integração do campo Frequência de Visitas do ERP para o GeoSales;
Utilização da data da última visita aprovada já existente no GeoSales;
Implementação do cálculo da data de vencimento;
Implementação dos quatro status:

  * Nunca Visitado;
  * Atualizado;
  * Próximo de Vencer;
  * Desatualizado;

Criação dos indicadores visuais dos status;
Disponibilização da informação no Portal GeoSales;
Disponibilização da informação no Mobile GeoSales;
Criação de filtros por status;
Criação dos cards com quantidade de clientes por status;
Adequação das consultas necessárias para suportar a funcionalidade;
Validação da regra de negócio em homologação.

Escopo Não Incluso

Alteração da regra de frequência de visitas existente no ERP;
Cadastro ou manutenção da frequência de visitas diretamente pelo GeoSales;
Alteração do processo de check-in ou check-out;
Alteração do conceito de visita aprovado utilizado atualmente;
Alteração das regras de comissão dos vendedores;
Criação ou alteração de rotas;
Geração automática de agendas ou visitas;
Priorização automática de clientes;
Criação de novas regras comerciais relacionadas às visitas;
Alterações no cadastro de clientes do ERP não necessárias para a integração da frequência;
Alteração da política comercial da empresa.

Atores

Vendedor - Responsável por consultar a situação dos clientes de sua carteira e utilizar o status como informação de apoio durante o atendimento comercial.

Gestor - Responsável por acompanhar a situação dos clientes de sua equipe e consultar os indicadores consolidados por status.

GeoSales - Responsável por receber a frequência de visitas, realizar o cálculo da situação do cliente, disponibilizar os indicadores e aplicar os filtros.

ERP / Protheus -Responsável por fornecer a informação de frequência de visitas utilizada para o cálculo.

Pré-condições

O cliente deve estar cadastrado e disponível no GeoSales.
A frequência de visitas deve estar cadastrada no ERP para o cliente.
A frequência de visitas deve ser disponibilizada ao GeoSales por meio da integração.
A data da última visita aprovada deve estar disponível no GeoSales.
O usuário deve possuir permissão para consultar os clientes correspondentes à sua carteira ou hierarquia.

Regras de Negócio

RN01 — Frequência de visitas

A frequência de visitas deverá ser obtida do ERP e disponibilizada no GeoSales em dias.

RN02 — Data da última visita

A data utilizada para o cálculo deverá ser a data da última visita aprovada do cliente.

RN03 — Data de vencimento

A data de vencimento da visita deverá ser calculada considerando:

Data de Vencimento = Data da Última Visita + Frequência de Visitas

RN04 — Nunca Visitado

O cliente deverá ser classificado como Nunca Visitado quando não possuir data de última visita.

Indicador: Cinza.

RN05 — Atualizado

O cliente deverá ser classificado como Atualizado (Em Dia) quando a data atual for menor ou igual à data de vencimento calculada.

Regra:

Data Atual ≤ Data da Última Visita + Frequência

Indicador: Verde.

RN06 — Próximo de Vencer

O cliente deverá ser classificado como Próximo de Vencer quando estiver dentro dos 10 dias anteriores à data de vencimento.

Indicador: Amarelo.

RN07 — Desatualizado

O cliente deverá ser classificado como Desatualizado (Vencido) quando a data atual for posterior à data de vencimento.

Regra:

Data Atual > Data da Última Visita + Frequência

Indicador: Vermelho.

RN08 — Prioridade do status

Quando o cliente estiver dentro dos 10 dias anteriores ao vencimento, deverá prevalecer o status Próximo de Vencer, em vez de Atualizado.

RN09 — Atualização do status

O status deverá ser calculado considerando a data atual, não sendo necessário armazenar manualmente o status do cliente.

RN10 — Filtro por status

O usuário deverá poder filtrar os clientes pelos seguintes status:

Todos;
Nunca Visitado;
Atualizado;
Próximo de Vencer;
Desatualizado.

RN11 — Cards

Deverão ser disponibilizados indicadores contendo a quantidade de clientes em cada status.

Os totais apresentados nos cards deverão respeitar os mesmos critérios de clientes disponíveis para o usuário na consulta.

RN12 — Consistência da regra

A regra implementada no GeoSales deverá considerar os mesmos conceitos utilizados pelo ERP para determinar a frequência de visitas, evitando divergência no status apresentado ao usuário.

RN13 — Alteração da frequência

Caso a frequência de visitas do cliente seja alterada no ERP, o novo valor deverá ser considerado pelo GeoSales após a atualização dos dados provenientes da integração.

RN14 — Sem frequência de visitas

Deverá ser validado com o negócio o comportamento para clientes que possuam data de última visita, mas não possuam frequência de visitas válida no ERP, antes da implementação definitiva dessa situação.

Regras de Integração

RI01 — Origem da informação

A informação de Frequência de Visitas deverá ser obtida a partir do ERP Protheus, utilizando A1_TEMVIS, o campo correspondente à periodicidade de visitas configurada para o cliente.

RI02 — Identificação do cliente

A frequência de visitas recebida do Protheus deverá ser vinculada ao respectivo cliente no GeoSales por meio da chave de identificação utilizada atualmente na integração entre os sistemas.

RI03 — Unidade da frequência

A frequência de visitas deverá ser recebida e considerada pelo GeoSales em dias, representando o intervalo definido para realização das visitas ao cliente.

RI04 — Atualização da informação

A frequência de visitas deverá ser atualizada no GeoSales conforme o processo de integração existente com o Protheus, permitindo que alterações realizadas no ERP sejam refletidas no GeoSales.

RI05 — Data da última visita

Para o cálculo do status, deverá ser utilizada a data da última visita aprovada, informação que já está disponível no GeoSales. Não deverá ser criada uma nova origem para essa informação.

RI06 — Cálculo no GeoSales

O GeoSales será responsável por utilizar a frequência recebida do ERP em conjunto com a data da última visita para determinar a data de vencimento e o status do cliente.

RI07 — Não duplicidade

A integração deverá atualizar a frequência de visitas do cliente existente, evitando a criação de registros duplicados para o mesmo cliente.

RI08 — Cliente sem frequência

Caso o ERP não disponibilize uma frequência de visitas para determinado cliente, o sistema deverá identificar essa situação e não deverá realizar um cálculo incorreto de vencimento. O comportamento de apresentação desse cliente deverá ser definido na homologação/regra de negócio.

RI09 — Alteração da frequência no ERP

Quando a frequência de visitas for alterada no Protheus, o novo valor deverá ser considerado nos cálculos realizados pelo GeoSales após a sincronização da informação.

RI10 — Consistência dos dados

A integração deverá garantir que a frequência de visitas utilizada pelo GeoSales corresponda ao valor vigente no ERP no momento da última sincronização.

RI11 — Falha na integração

Em caso de falha na atualização da frequência de visitas, o sistema deverá preservar o último valor válido disponível no GeoSales, evitando que a indisponibilidade momentânea da integração provoque alteração indevida no status dos clientes.

RI12 — Processamento do status

O status do cliente deverá ser determinado com base nos dados disponíveis no GeoSales após a atualização da frequência, não sendo necessário que o ERP envie diretamente o status Nunca Visitado, Atualizado, Próximo de Vencer ou Desatualizado.

RI13 — Responsabilidade pelo cálculo

O Protheus será a origem da frequência de visitas, enquanto o GeoSales será responsável pelo processamento da regra e pela apresentação do status ao usuário.

RI14 — Validação de integração

Durante a homologação, deverão ser realizados testes comparando a frequência recebida do Protheus com a informação armazenada no GeoSales e validando o cálculo do status para diferentes cenários de clientes.

Fluxograma

Fluxo Resumido

1 - Protheus disponibiliza a frequência de visitas do cliente.

2 - GeoSales recebe e atualiza a frequência por meio da integração.

3 -O sistema identifica a data da última visita aprovada do cliente.

4 - O GeoSales calcula a data de vencimento da visita, considerando a última visita + frequência cadastrada.

5 - O sistema classifica o cliente conforme a situação:

Nunca Visitado: sem data de última visita;
Atualizado: dentro do período de validade;
Próximo de Vencer: faltam até 10 dias para o vencimento;
Desatualizado: prazo de visita já vencido.

6 - O status é disponibilizado no Portal e Mobile, com seu respectivo indicador visual.

7 - O usuário pode filtrar os clientes por status.

8 - Os cards apresentam a quantidade de clientes em cada situação.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor	Aprovado Por	Data
Integração - GeoSales		dd/mm/aaaa

Empresa solicitante

Setor	Aprovado Por	Data
Gerente TI - Cliente	Pessoa que aprovou	00/00/0000
Gerente de Projeto - Cliente	Pessoa que aprovou	00/00/0000
Gerente Comercial - Cliente	Pessoa que aprovou	00/00/0000