GeoSales - Contribuições do(a) usuário(a) [pt-br]

Rotina de Agendamento de clientes Automático

2026-09-14T13:27:46Z

Renatolima: /* Relatório de Clientes Inativos */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;

'''2.''' Aplica os filtros necessários;

'''3.''' '''1.''' Analisa os clientes apresentados;

'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;

'''5.''' Seleciona os clientes que deseja trabalhar;

'''6.''' Aciona a opção para criação da agenda;

'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;

'''8.''' O gestor define os vendedores que participarão;

'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;

'''10.''' Define o período para distribuição das atividades;

'''11.''' O sistema realiza a distribuição automática dos clientes;

'''12.''' Apresenta um resumo da agenda que será criada;

'''13.''' O gestor poderá revisar a geração;

'''14.''' Após a confirmação, o sistema cria os eventos na agenda;

'''15.''' Os eventos serão identificados como atividades do tipo Retomada;

'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.
* Valor Ticket Médio

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Pós-condições ==
Após a confirmação da geração:

* As atividades de retomada serão criadas;
* Cada atividade estará associada ao respectivo cliente;
* Cada atividade estará atribuída ao responsável/vendedor;
* As datas serão distribuídas conforme os parâmetros informados;
* O evento possuirá identificação de atividade de retomada;
* O evento possuirá observação com o resumo das informações do cliente.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''
Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-14T13:27:33Z

Renatolima: /* Relatório de Clientes Inativos */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;

'''2.''' Aplica os filtros necessários;

'''3.''' '''1.''' Analisa os clientes apresentados;

'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;

'''5.''' Seleciona os clientes que deseja trabalhar;

'''6.''' Aciona a opção para criação da agenda;

'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;

'''8.''' O gestor define os vendedores que participarão;

'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;

'''10.''' Define o período para distribuição das atividades;

'''11.''' O sistema realiza a distribuição automática dos clientes;

'''12.''' Apresenta um resumo da agenda que será criada;

'''13.''' O gestor poderá revisar a geração;

'''14.''' Após a confirmação, o sistema cria os eventos na agenda;

'''15.''' Os eventos serão identificados como atividades do tipo Retomada;

'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.
* Ticket Médio

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Pós-condições ==
Após a confirmação da geração:

* As atividades de retomada serão criadas;
* Cada atividade estará associada ao respectivo cliente;
* Cada atividade estará atribuída ao responsável/vendedor;
* As datas serão distribuídas conforme os parâmetros informados;
* O evento possuirá identificação de atividade de retomada;
* O evento possuirá observação com o resumo das informações do cliente.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''
Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T18:10:28Z

Renatolima: /* Pré-condições */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;

'''2.''' Aplica os filtros necessários;

'''3.''' '''1.''' Analisa os clientes apresentados;

'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;

'''5.''' Seleciona os clientes que deseja trabalhar;

'''6.''' Aciona a opção para criação da agenda;

'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;

'''8.''' O gestor define os vendedores que participarão;

'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;

'''10.''' Define o período para distribuição das atividades;

'''11.''' O sistema realiza a distribuição automática dos clientes;

'''12.''' Apresenta um resumo da agenda que será criada;

'''13.''' O gestor poderá revisar a geração;

'''14.''' Após a confirmação, o sistema cria os eventos na agenda;

'''15.''' Os eventos serão identificados como atividades do tipo Retomada;

'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Pós-condições ==
Após a confirmação da geração:

* As atividades de retomada serão criadas;
* Cada atividade estará associada ao respectivo cliente;
* Cada atividade estará atribuída ao responsável/vendedor;
* As datas serão distribuídas conforme os parâmetros informados;
* O evento possuirá identificação de atividade de retomada;
* O evento possuirá observação com o resumo das informações do cliente.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''
Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T18:06:40Z

Renatolima: /* Necessidade */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;

'''2.''' Aplica os filtros necessários;

'''3.''' '''1.''' Analisa os clientes apresentados;

'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;

'''5.''' Seleciona os clientes que deseja trabalhar;

'''6.''' Aciona a opção para criação da agenda;

'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;

'''8.''' O gestor define os vendedores que participarão;

'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;

'''10.''' Define o período para distribuição das atividades;

'''11.''' O sistema realiza a distribuição automática dos clientes;

'''12.''' Apresenta um resumo da agenda que será criada;

'''13.''' O gestor poderá revisar a geração;

'''14.''' Após a confirmação, o sistema cria os eventos na agenda;

'''15.''' Os eventos serão identificados como atividades do tipo Retomada;

'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''
Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T18:06:29Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;

'''2.''' Aplica os filtros necessários;

'''3.''' '''1.''' Analisa os clientes apresentados;

'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;

'''5.''' Seleciona os clientes que deseja trabalhar;

'''6.''' Aciona a opção para criação da agenda;

'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;

'''8.''' O gestor define os vendedores que participarão;

'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;

'''10.''' Define o período para distribuição das atividades;

'''11.''' O sistema realiza a distribuição automática dos clientes;

'''12.''' Apresenta um resumo da agenda que será criada;

'''13.''' O gestor poderá revisar a geração;

'''14.''' Após a confirmação, o sistema cria os eventos na agenda;

'''15.''' Os eventos serão identificados como atividades do tipo Retomada;

'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''
Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T17:38:28Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''
Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T17:37:50Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''
A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''
Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''
O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''
A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''
O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''
O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''
O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''
Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''
A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''
O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''
A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''
Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''
A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''
Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''
O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''
Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''
A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''
A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''
A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''
A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''
A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''
A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:53:40Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:50:49Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Inteligence_geração_agenda.png|1100px]]

====Fluxo resumido da solução====

Inteligência → Relatório de clientes inativos → Análise → Seleção → Configuração da agenda → Distribuição automática → Resumo → Validação → Criação dos eventos → Atividade de Retomada para o vendedor

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Arquivo:Inteligence geração agenda.png

2026-09-11T15:46:46Z

Renatolima:

Rotina de Agendamento de clientes Automático

2026-09-11T15:44:56Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:36:59Z

Renatolima: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==
A implementação deverá contemplar as seguintes etapas:

'''Etapa 1 — Evolução do relatório'''
* Revisar o relatório de clientes sem compra;
* Disponibilizar as informações comerciais necessárias;
* Disponibilizar informações de crédito;
* Disponibilizar a curva ABC;
* Disponibilizar indicadores de inatividade e frequência;
* Criar a ação para iniciar a geração da agenda.

'''Etapa 2 — Tela de configuração'''

Desenvolver a etapa responsável pela configuração da geração, contemplando:

* Tipo de atividade;
* Vendedores;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Demais parâmetros definidos no detalhamento funcional.

'''Etapa 3 — Motor de distribuição'''

Implementar a lógica responsável por:

* Receber os clientes resultantes do relatório;
* Agrupar os clientes por vendedor;
* Aplicar a capacidade diária;
* Distribuir as atividades;
* Respeitar o período definido;
* Preparar os eventos.

'''Etapa 4 — Resumo'''

Desenvolver a tela de conferência da geração, permitindo ao gestor visualizar e revisar o resultado antes da efetivação.

'''Etapa 5 — Criação dos eventos'''

Após a confirmação:

* Criar os eventos;
* Associar cliente e vendedor;
* Definir data;
* Definir tipo “Retomada”;
* Gerar a observação automática.

'''Etapa 6 — Validação'''

Realizar testes contemplando:

* Um vendedor;
* Múltiplos vendedores;
* Grande quantidade de clientes;
* Diferentes capacidades diárias;
* Períodos diferentes;
* Clientes com e sem informações financeiras;
* Clientes com diferentes classificações ABC;
* Validação da distribuição;
* Validação da criação dos eventos.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:30:24Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Implementação ==

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:27:58Z

Renatolima: /* Observação automática da atividade */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

'''Retomada de cliente inativo'''
* Última compra: 15/05/2026
* Inatividade: 118 dias
* Frequência média de compra: 45 dias
* Valor vendido no período: R$ 35.500,00
* Quantidade de pedidos: 12
* Curva ABC: A
* Status: Ativo
* Valor em aberto: R$ 3.200,00
* Valor vencido: R$ 0,00
* Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:27:20Z

Renatolima: /* Criação dos eventos */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

* Cliente;
* Vendedor/responsável;
* Data;
* Tipo de atividade;
* Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:26:52Z

Renatolima: /* Revisão antes da confirmação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

* Confirmar todos os vendedores;
* Retirar determinado vendedor;
* Manter determinado vendedor para geração posterior;
* Revisar a quantidade de atividades;
* Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:26:30Z

Renatolima: /* Resumo da geração */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
* Vendedor;
* Quantidade de clientes elegíveis;
* Quantidade de clientes selecionados;
* Quantidade de atividades a gerar;
* Quantidade de atividades por dia;
* Data inicial;
* Data final;
* Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:20:38Z

Renatolima: /* Geração em massa */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Vendedor
! Cliente Selecionados
|-
| Renato || 10
|-
| Andre || 20
|-
| Carlos || 15
|-
|}

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:17:01Z

Renatolima: /* Geração em massa */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

{| class="wikitable"
! Vendedor
! Clientes
! Atividades/dia
! Dias necessários
|-
| Renato || 10 || 2 || 5
|-
| André || 20 || 2 || 5
|-
| Carlos || 15 || 2 || 8*
|-
|}

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:07:50Z

Renatolima: /* Geração em massa */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

* Clientes selecionados;
* Vendedor responsável;
* Quantidade de atividades por dia;
* Período informado;
*Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T15:06:14Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

'''1.''' O usuário acessa o relatório de clientes sem compra;
'''2.''' Aplica os filtros necessários;
'''3.''' '''1.''' Analisa os clientes apresentados;
'''4.''' Utiliza as informações comerciais e financeiras para definir as oportunidades;
'''5.''' Seleciona os clientes que deseja trabalhar;
'''6.''' Aciona a opção para criação da agenda;
'''7.''' O sistema apresenta uma segunda etapa para configuração da geração;
'''8.''' O gestor define os vendedores que participarão;
'''9.''' Define a quantidade de atividades que deverão ser realizadas por dia;
'''10.''' Define o período para distribuição das atividades;
'''11.''' O sistema realiza a distribuição automática dos clientes;
'''12.''' Apresenta um resumo da agenda que será criada;
'''13.''' O gestor poderá revisar a geração;
'''14.''' Após a confirmação, o sistema cria os eventos na agenda;
'''15.''' Os eventos serão identificados como atividades do tipo Retomada;
'''16.''' A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
* Cliente;
* Vendedor responsável;
* Supervisor;
* Organização de venda;
* Canal;
* Curva ABC;
* Valor vendido no período;
* Quantidade de pedidos;
* Data da última compra;
* Quantidade de dias de inatividade;
* Frequência média de compra.

'''Informações financeiras'''
* Status do cliente;
* Indicador de cliente bloqueado/não bloqueado;
* Valor total em aberto;
* Valor total vencido/em atraso;
* Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

* Clientes classificados como A;
* Clientes classificados como A e B;
* Clientes com determinado valor médio de compras;
* Clientes sem compra há mais de 90 dias;
* Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
* Clientes sem bloqueio financeiro;
* Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:58:23Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.

'''Informações financeiras'''
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:58:04Z

Renatolima: /* Pré-condições */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.

'''Informações financeiras'''
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
* Usuário possuir acesso ao módulo Inteligência;
* Relatório de clientes sem compra estar disponível;
* Clientes possuírem vínculo com vendedor;
* Informações de vendas estarem disponíveis;
* Informações necessárias para os indicadores estarem integradas;
* Funcionalidade de agenda/eventos estar disponível;
* Usuário possuir permissão para gerar atividades;
* Vendedores selecionados estarem ativos/disponíveis para receber atividades.

== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:57:42Z

Renatolima: /* Atores */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.

'''Informações financeiras'''
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
'''Gestor'''

Responsável por:

* Consultar o relatório;
* Aplicar filtros;
* Analisar os clientes;
* Definir os critérios de priorização;
* Selecionar os vendedores;
* Definir capacidade diária;
* Definir período;
* Validar o resumo;
* Confirmar a geração.

'''Vendedor/Responsável pela atividade'''

Responsável por:

* Receber as atividades de retomada;
* Consultar as informações apresentadas na atividade;
* Realizar o contato/visita ao cliente;
* Registrar o resultado da atividade conforme os recursos existentes no sistema.

'''Sistema'''

Responsável por:

* Consultar e apresentar os dados;
* Processar os clientes selecionados;
* Distribuir as atividades;
* Criar os eventos;
* Registrar o tipo da atividade;
* Gerar a observação automaticamente.

== Pré-condições ==
Usuário possuir acesso ao módulo Inteligência;
Relatório de clientes sem compra estar disponível;
Clientes possuírem vínculo com vendedor;
Informações de vendas estarem disponíveis;
Informações necessárias para os indicadores estarem integradas;
Funcionalidade de agenda/eventos estar disponível;
Usuário possuir permissão para gerar atividades;
Vendedores selecionados estarem ativos/disponíveis para receber atividades.
== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:56:36Z

Renatolima: /* Escopo Não Incluso */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.

'''Informações financeiras'''
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
* Transferência automática de carteira;
* Criação de nova estrutura de carteira;
* Alteração do relacionamento cliente/vendedor;
* Alteração da visualização de pedidos históricos;
* Criação automática de rotas;
* Otimização geográfica de visitas;
* Sugestão automática de pedido;
* Sugestão de produtos;
* Inteligência preditiva para escolha automática dos clientes;
* Automação de cobrança;
* Regras de comissão;
* Alterações na integração de pedidos;
* Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
Gestor

Responsável por:

Consultar o relatório;
Aplicar filtros;
Analisar os clientes;
Definir os critérios de priorização;
Selecionar os vendedores;
Definir capacidade diária;
Definir período;
Validar o resumo;
Confirmar a geração.
Vendedor/Responsável pela atividade

Responsável por:

Receber as atividades de retomada;
Consultar as informações apresentadas na atividade;
Realizar o contato/visita ao cliente;
Registrar o resultado da atividade conforme os recursos existentes no sistema.
Sistema

Responsável por:

Consultar e apresentar os dados;
Processar os clientes selecionados;
Distribuir as atividades;
Criar os eventos;
Registrar o tipo da atividade;
Gerar a observação automaticamente.

== Pré-condições ==
Usuário possuir acesso ao módulo Inteligência;
Relatório de clientes sem compra estar disponível;
Clientes possuírem vínculo com vendedor;
Informações de vendas estarem disponíveis;
Informações necessárias para os indicadores estarem integradas;
Funcionalidade de agenda/eventos estar disponível;
Usuário possuir permissão para gerar atividades;
Vendedores selecionados estarem ativos/disponíveis para receber atividades.
== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:56:18Z

Renatolima: /* Escopo Incluso */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.

'''Informações financeiras'''
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
* Evolução do relatório de clientes sem compra;
* Exibição das informações comerciais necessárias;
* Exibição das informações de crédito;
* Exibição da curva ABC;
* Indicadores de frequência e inatividade;
* Ação para iniciar a criação da agenda;
* Seleção de vendedores;
* Definição de quantidade de atividades por dia;
* Definição de período;
* Geração em massa;
* Distribuição automática dos clientes;
* Tela de resumo;
* Revisão antes da confirmação;
* Criação automática dos eventos;
* Identificação do evento como “Retomada”;
* Geração automática da observação;
* Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
Transferência automática de carteira;
Criação de nova estrutura de carteira;
Alteração do relacionamento cliente/vendedor;
Alteração da visualização de pedidos históricos;
Criação automática de rotas;
Otimização geográfica de visitas;
Sugestão automática de pedido;
Sugestão de produtos;
Inteligência preditiva para escolha automática dos clientes;
Automação de cobrança;
Regras de comissão;
Alterações na integração de pedidos;
Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
Gestor

Responsável por:

Consultar o relatório;
Aplicar filtros;
Analisar os clientes;
Definir os critérios de priorização;
Selecionar os vendedores;
Definir capacidade diária;
Definir período;
Validar o resumo;
Confirmar a geração.
Vendedor/Responsável pela atividade

Responsável por:

Receber as atividades de retomada;
Consultar as informações apresentadas na atividade;
Realizar o contato/visita ao cliente;
Registrar o resultado da atividade conforme os recursos existentes no sistema.
Sistema

Responsável por:

Consultar e apresentar os dados;
Processar os clientes selecionados;
Distribuir as atividades;
Criar os eventos;
Registrar o tipo da atividade;
Gerar a observação automaticamente.

== Pré-condições ==
Usuário possuir acesso ao módulo Inteligência;
Relatório de clientes sem compra estar disponível;
Clientes possuírem vínculo com vendedor;
Informações de vendas estarem disponíveis;
Informações necessárias para os indicadores estarem integradas;
Funcionalidade de agenda/eventos estar disponível;
Usuário possuir permissão para gerar atividades;
Vendedores selecionados estarem ativos/disponíveis para receber atividades.
== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:55:34Z

Renatolima: /* Histórico de Alterações */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.

'''Informações financeiras'''
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
Evolução do relatório de clientes sem compra;
Exibição das informações comerciais necessárias;
Exibição das informações de crédito;
Exibição da curva ABC;
Indicadores de frequência e inatividade;
Ação para iniciar a criação da agenda;
Seleção de vendedores;
Definição de quantidade de atividades por dia;
Definição de período;
Geração em massa;
Distribuição automática dos clientes;
Tela de resumo;
Revisão antes da confirmação;
Criação automática dos eventos;
Identificação do evento como “Retomada”;
Geração automática da observação;
Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
Transferência automática de carteira;
Criação de nova estrutura de carteira;
Alteração do relacionamento cliente/vendedor;
Alteração da visualização de pedidos históricos;
Criação automática de rotas;
Otimização geográfica de visitas;
Sugestão automática de pedido;
Sugestão de produtos;
Inteligência preditiva para escolha automática dos clientes;
Automação de cobrança;
Regras de comissão;
Alterações na integração de pedidos;
Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
Gestor

Responsável por:

Consultar o relatório;
Aplicar filtros;
Analisar os clientes;
Definir os critérios de priorização;
Selecionar os vendedores;
Definir capacidade diária;
Definir período;
Validar o resumo;
Confirmar a geração.
Vendedor/Responsável pela atividade

Responsável por:

Receber as atividades de retomada;
Consultar as informações apresentadas na atividade;
Realizar o contato/visita ao cliente;
Registrar o resultado da atividade conforme os recursos existentes no sistema.
Sistema

Responsável por:

Consultar e apresentar os dados;
Processar os clientes selecionados;
Distribuir as atividades;
Criar os eventos;
Registrar o tipo da atividade;
Gerar a observação automaticamente.

== Pré-condições ==
Usuário possuir acesso ao módulo Inteligência;
Relatório de clientes sem compra estar disponível;
Clientes possuírem vínculo com vendedor;
Informações de vendas estarem disponíveis;
Informações necessárias para os indicadores estarem integradas;
Funcionalidade de agenda/eventos estar disponível;
Usuário possuir permissão para gerar atividades;
Vendedores selecionados estarem ativos/disponíveis para receber atividades.
== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:55:17Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.

====Relatório de Clientes Inativos====

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

'''Informações comerciais'''
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.

'''Informações financeiras'''
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

====Critérios para análise e seleção====

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

====Criação da Agenda====

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

====Parâmetros para geração da agenda====

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

'''Tipo de atividade'''

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

'''Tipo sugerido: Retomada'''

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

====Vendedores====

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

====Quantidade de atividades por dia====

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

====Período de execução====

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

====Geração em massa====

A geração deverá ser realizada de forma automática e em massa.

O sistema deverá considerar:

Clientes selecionados;
Vendedor responsável;
Quantidade de atividades por dia;
Período informado;
Critérios definidos no relatório.
Exemplo

O resultado possui:

Vendedor Clientes selecionados
Renato 10
André 20
Carlos 15

O gestor define:

2 atividades por dia

O sistema deverá realizar automaticamente a distribuição:

Vendedor Clientes Atividades/dia Dias necessários
Renato 10 2 5
André 20 2 10
Carlos 15 2 8*

*Considerando arredondamento para o último dia.

====Resumo da geração====

Antes da criação definitiva dos eventos, o sistema deverá apresentar uma tela de resumo.

O objetivo é permitir que o gestor valide o resultado da geração antes da confirmação.

'''Sugestão de informações'''
Vendedor;
Quantidade de clientes elegíveis;
Quantidade de clientes selecionados;
Quantidade de atividades a gerar;
Quantidade de atividades por dia;
Data inicial;
Data final;
Quantidade de dias necessários.

O resumo deverá permitir identificar como os clientes serão distribuídos entre os vendedores.

====Revisão antes da confirmação====

O gestor deverá poder revisar o resultado da geração.

Será possível, por exemplo:

Confirmar todos os vendedores;
Retirar determinado vendedor;
Manter determinado vendedor para geração posterior;
Revisar a quantidade de atividades;
Cancelar a geração.

Somente após a confirmação os eventos deverão ser efetivamente criados.

====Criação dos eventos====

Após a confirmação, o sistema deverá criar automaticamente as atividades na agenda dos respectivos vendedores.

Cada evento deverá estar associado, no mínimo, a:

Cliente;
Vendedor/responsável;
Data;
Tipo de atividade;
Observação.

O evento deverá ser identificado como uma atividade de Retomada.

====Observação automática da atividade====

Para evitar que o vendedor precise retornar ao relatório para entender o motivo da atividade, o sistema deverá gerar uma observação contendo um resumo das principais informações utilizadas na análise.

Exemplo

Retomada de cliente inativo
Última compra: 15/05/2026
Inatividade: 118 dias
Frequência média de compra: 45 dias
Valor vendido no período: R$ 35.500,00
Quantidade de pedidos: 12
Curva ABC: A
Status: Ativo
Valor em aberto: R$ 3.200,00
Valor vencido: R$ 0,00
Limite de crédito: R$ 10.000,00

A composição definitiva das informações da observação deverá ser definida durante a implementação.

== Escopo ==

=== Escopo Incluso ===
Evolução do relatório de clientes sem compra;
Exibição das informações comerciais necessárias;
Exibição das informações de crédito;
Exibição da curva ABC;
Indicadores de frequência e inatividade;
Ação para iniciar a criação da agenda;
Seleção de vendedores;
Definição de quantidade de atividades por dia;
Definição de período;
Geração em massa;
Distribuição automática dos clientes;
Tela de resumo;
Revisão antes da confirmação;
Criação automática dos eventos;
Identificação do evento como “Retomada”;
Geração automática da observação;
Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
Transferência automática de carteira;
Criação de nova estrutura de carteira;
Alteração do relacionamento cliente/vendedor;
Alteração da visualização de pedidos históricos;
Criação automática de rotas;
Otimização geográfica de visitas;
Sugestão automática de pedido;
Sugestão de produtos;
Inteligência preditiva para escolha automática dos clientes;
Automação de cobrança;
Regras de comissão;
Alterações na integração de pedidos;
Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
Gestor

Responsável por:

Consultar o relatório;
Aplicar filtros;
Analisar os clientes;
Definir os critérios de priorização;
Selecionar os vendedores;
Definir capacidade diária;
Definir período;
Validar o resumo;
Confirmar a geração.
Vendedor/Responsável pela atividade

Responsável por:

Receber as atividades de retomada;
Consultar as informações apresentadas na atividade;
Realizar o contato/visita ao cliente;
Registrar o resultado da atividade conforme os recursos existentes no sistema.
Sistema

Responsável por:

Consultar e apresentar os dados;
Processar os clientes selecionados;
Distribuir as atividades;
Criar os eventos;
Registrar o tipo da atividade;
Gerar a observação automaticamente.

== Pré-condições ==
Usuário possuir acesso ao módulo Inteligência;
Relatório de clientes sem compra estar disponível;
Clientes possuírem vínculo com vendedor;
Informações de vendas estarem disponíveis;
Informações necessárias para os indicadores estarem integradas;
Funcionalidade de agenda/eventos estar disponível;
Usuário possuir permissão para gerar atividades;
Vendedores selecionados estarem ativos/disponíveis para receber atividades.
== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Rotina de Agendamento de clientes Automático

2026-09-11T14:19:55Z

Renatolima: Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 25/06/2026 || Renato Lima || Criação do documento |- |} == Necessidade == O cli...'

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente necessita de uma funcionalidade que permita identificar, a partir do relatório de clientes sem compra disponível no módulo Inteligência, quais clientes representam oportunidades de retomada comercial e, com base nessas informações, facilitar a criação de uma agenda de atividades para a equipe de vendas.

Atualmente, embora o sistema disponibilize informações relacionadas ao histórico comercial dos clientes, é necessário realizar a análise e o planejamento das atividades de forma manual. Em cenários com grande quantidade de clientes e vendedores, esse processo pode demandar elevado esforço operacional.

A necessidade é permitir que o gestor utilize informações como curva ABC, valor vendido, quantidade de pedidos, data da última compra, frequência de compra, período de inatividade e informações de crédito para avaliar os clientes e definir quais deverão ser trabalhados pela equipe.

O sistema deverá atuar como apoio à decisão, não sendo responsável por determinar automaticamente quais clientes devem ser priorizados.

Após a seleção, o gestor deverá conseguir configurar parâmetros de geração e criar, de forma massiva, atividades de retomada para os vendedores responsáveis pelos clientes.

== Solução ==
Será implementada uma evolução no relatório de clientes sem compra do módulo Inteligência, permitindo que o resultado da análise seja utilizado como origem para uma rotina de agendamento automático de atividades de retomada.

O fluxo será dividido em etapas:

O usuário acessa o relatório de clientes sem compra;
Aplica os filtros necessários;
Analisa os clientes apresentados;
Utiliza as informações comerciais e financeiras para definir as oportunidades;
Seleciona os clientes que deseja trabalhar;
Aciona a opção para criação da agenda;
O sistema apresenta uma segunda etapa para configuração da geração;
O gestor define os vendedores que participarão;
Define a quantidade de atividades que deverão ser realizadas por dia;
Define o período para distribuição das atividades;
O sistema realiza a distribuição automática dos clientes;
Apresenta um resumo da agenda que será criada;
O gestor poderá revisar a geração;
Após a confirmação, o sistema cria os eventos na agenda;
Os eventos serão identificados como atividades do tipo Retomada;
A observação do evento conterá informações relevantes sobre o cliente para auxiliar o vendedor durante o atendimento.
4. Relatório de Clientes Inativos

O relatório existente no Inteligência será utilizado como ponto inicial do processo.

Além das informações já disponíveis, deverão ser disponibilizados dados que permitam ao gestor avaliar a relevância e o momento de retomada de cada cliente.

Informações comerciais
Cliente;
Vendedor responsável;
Supervisor;
Organização de venda;
Canal;
Curva ABC;
Valor vendido no período;
Quantidade de pedidos;
Data da última compra;
Quantidade de dias de inatividade;
Frequência média de compra.
Informações financeiras
Status do cliente;
Indicador de cliente bloqueado/não bloqueado;
Valor total em aberto;
Valor total vencido/em atraso;
Limite de crédito.

Essas informações deverão permitir que o gestor faça uma análise conjunta do comportamento comercial e financeiro do cliente.

5. Critérios para análise e seleção

O gestor poderá utilizar as informações do relatório para estabelecer seus próprios critérios de priorização.

Exemplos:

Clientes classificados como A;
Clientes classificados como A e B;
Clientes com determinado valor médio de compras;
Clientes sem compra há mais de 90 dias;
Clientes cuja frequência habitual de compra seja inferior ao período atual de inatividade;
Clientes sem bloqueio financeiro;
Clientes com limite de crédito disponível.

Os critérios acima são exemplos de utilização das informações e não deverão ser aplicados automaticamente pelo sistema, salvo aqueles que forem definidos como filtros da própria consulta.

6. Criação da Agenda

A partir do resultado do relatório, o gestor poderá iniciar o processo de criação da agenda.

A opção de criação deverá considerar o conjunto de dados resultante dos filtros aplicados no relatório.

Dessa forma, o usuário não precisará repetir na tela de criação todos os filtros já utilizados no relatório.

Exemplo

O gestor poderá filtrar previamente:

Canal = Varejo
Supervisor = João
Período = últimos 12 meses
Clientes sem compra há mais de 90 dias

Após aplicar esses filtros, somente os clientes resultantes da consulta serão considerados na etapa de criação da agenda.

7. Parâmetros para geração da agenda

Na etapa de configuração da agenda, o gestor deverá informar os parâmetros necessários para a geração automática.

7.1. Tipo de atividade

O sistema deverá utilizar um tipo específico para identificar os eventos criados pela rotina.

Tipo sugerido: Retomada

O tipo deverá ser atribuído automaticamente, evitando que o gestor tenha que selecionar manualmente o tipo da atividade em cada geração.

7.2. Vendedores

O gestor deverá poder selecionar os vendedores para os quais deseja gerar as atividades.

A seleção deverá permitir trabalhar com múltiplos vendedores simultaneamente.

Isso é necessário para permitir a geração em massa em empresas que possuem grande quantidade de vendedores.

7.3. Quantidade de atividades por dia

O gestor deverá informar a quantidade de atividades que deseja gerar diariamente.

Exemplo:

2 atividades por dia.

Caso existam 10 clientes para determinado vendedor, o sistema poderá distribuí-los em cinco dias.

Caso existam 20 clientes, serão distribuídos em dez dias, considerando a mesma capacidade diária.

7.4. Período de execução

O gestor deverá informar o período no qual as atividades deverão ser distribuídas.

Exemplo:

Início: 14/09/2026
Fim: 25/09/2026

O sistema deverá respeitar o período definido durante a distribuição das atividades.

== Escopo ==

=== Escopo Incluso ===
Evolução do relatório de clientes sem compra;
Exibição das informações comerciais necessárias;
Exibição das informações de crédito;
Exibição da curva ABC;
Indicadores de frequência e inatividade;
Ação para iniciar a criação da agenda;
Seleção de vendedores;
Definição de quantidade de atividades por dia;
Definição de período;
Geração em massa;
Distribuição automática dos clientes;
Tela de resumo;
Revisão antes da confirmação;
Criação automática dos eventos;
Identificação do evento como “Retomada”;
Geração automática da observação;
Respeito à estrutura atual de cliente/vendedor.

=== Escopo Não Incluso ===
Transferência automática de carteira;
Criação de nova estrutura de carteira;
Alteração do relacionamento cliente/vendedor;
Alteração da visualização de pedidos históricos;
Criação automática de rotas;
Otimização geográfica de visitas;
Sugestão automática de pedido;
Sugestão de produtos;
Inteligência preditiva para escolha automática dos clientes;
Automação de cobrança;
Regras de comissão;
Alterações na integração de pedidos;
Outras funcionalidades não relacionadas diretamente à geração da agenda de retomada.

== Atores ==
Gestor

Responsável por:

Consultar o relatório;
Aplicar filtros;
Analisar os clientes;
Definir os critérios de priorização;
Selecionar os vendedores;
Definir capacidade diária;
Definir período;
Validar o resumo;
Confirmar a geração.
Vendedor/Responsável pela atividade

Responsável por:

Receber as atividades de retomada;
Consultar as informações apresentadas na atividade;
Realizar o contato/visita ao cliente;
Registrar o resultado da atividade conforme os recursos existentes no sistema.
Sistema

Responsável por:

Consultar e apresentar os dados;
Processar os clientes selecionados;
Distribuir as atividades;
Criar os eventos;
Registrar o tipo da atividade;
Gerar a observação automaticamente.

== Pré-condições ==
Usuário possuir acesso ao módulo Inteligência;
Relatório de clientes sem compra estar disponível;
Clientes possuírem vínculo com vendedor;
Informações de vendas estarem disponíveis;
Informações necessárias para os indicadores estarem integradas;
Funcionalidade de agenda/eventos estar disponível;
Usuário possuir permissão para gerar atividades;
Vendedores selecionados estarem ativos/disponíveis para receber atividades.
== Regras de Negócio ==

'''[RN1] - Origem da geração'''

A agenda deverá ser gerada a partir dos clientes resultantes do relatório de clientes sem compra do Inteligência.

'''[RN2] - Filtros '''

Os filtros aplicados no relatório deverão determinar o conjunto de clientes considerado para a geração da agenda.

'''[RN3] - Decisão do gestor '''

O sistema não deverá determinar automaticamente quais clientes devem ser priorizados. A seleção deverá permanecer sob responsabilidade do gestor.

'''[RN4] - Curva ABC '''

A classificação ABC deverá ser apresentada como informação para apoio à decisão e poderá ser utilizada como critério de seleção.

'''[RN5] - Histórico comercial '''

O relatório deverá disponibilizar informações relacionadas ao histórico de compras do cliente, incluindo última compra, frequência, quantidade de pedidos e valor vendido.

'''[RN6] - Inatividade '''

O sistema deverá apresentar o período de inatividade do cliente, preferencialmente em quantidade de dias, além da data da última compra.

'''[RN7] - Crédito '''

O sistema deverá apresentar informações de crédito do cliente, incluindo status, valores em aberto, valores vencidos e limite de crédito, quando disponíveis.

'''[RN8] - Tipo de atividade '''

Os eventos gerados automaticamente pela rotina deverão utilizar o tipo Retomada ou outro tipo previamente definido para essa finalidade.

'''[RN9] - Seleção de vendedores '''

A geração deverá permitir a seleção de múltiplos vendedores em uma única operação.

'''[RN10] - Capacidade diária '''

O gestor deverá informar a quantidade de atividades que deverão ser distribuídas por dia.

'''[RN11] - Período '''

A distribuição deverá respeitar o período informado pelo gestor.

'''[RN12] - Distribuição '''

Os clientes deverão ser distribuídos automaticamente considerando o vendedor responsável e a quantidade de atividades definida.

''' RN13 — Geração em massa '''

A rotina deverá permitir gerar atividades para diversos vendedores em uma única execução.

'''RN14 — Validação'''

Os eventos não deverão ser criados definitivamente antes da confirmação do resumo apresentado ao gestor.

'''RN15 — Revisão'''

O gestor deverá poder retirar vendedores da geração antes da confirmação.

'''RN16 — Observação'''

Os eventos gerados deverão possuir uma observação automática com informações relevantes do cliente.

'''RN17 — Estrutura de vendedores'''

A rotina deverá respeitar a estrutura atual de relacionamento entre cliente e vendedor existente no sistema.

'''RN18 — Carteira'''

A funcionalidade não deverá criar uma nova estrutura de carteira ou realizar transferência automática de clientes entre vendedores.

'''RN19 — Pedidos anteriores'''

A rotina não deverá alterar regras existentes de visualização ou propriedade dos pedidos históricos dos clientes.

'''RN20 — Rotas'''

A primeira versão não deverá realizar criação ou otimização automática de rotas.

'''RN21 — Sugestão de pedido'''

A primeira versão não deverá gerar sugestão automática de produtos ou pedidos.

'''RN22 — Evolução futura'''

A estrutura deverá permitir futuras evoluções para utilização em outros processos, como cobrança, rotas e sugestões comerciais.

== Fluxograma ==

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Projeto/CRM

2026-09-11T13:57:49Z

Renatolima:

* [[ Adição de Notas no Força de Vendas]]

* [[ Alterações cadastrado de eventos]]

* [[ Acesso a agenda na mesa do cliente]]

* [[ Criação da fase dos pedidos web e mobile]]

* [[ Cadastrar Contato de Cliente]]

* [[ Atendimento ao Cliente Força de Vendas CRM]]

* [[ Criar mecanismos para priorizar oportunidades com maior potencial de conversão]]

* [[ Implementação do Funil de Vendas Unificado para CRM no GeoSales - Funil de Vendas (CRM GeoSales)]]

* [[ Criação da fase dos prospect web e mobile]]

* [[ Rotina de Agendamento de clientes Automático ]]

Cadastro e inserção de observações padrão

2026-09-09T13:16:59Z

Renatolima: /* Fluxograma */

Cadastro e inserção de observações padrão

2026-09-09T13:15:19Z

Renatolima: /* Fluxograma - Complemento */

Cadastro e inserção de observações padrão

2026-09-09T13:14:58Z

Renatolima: /* Fluxograma - Complemento */

Cadastro e inserção de observações padrão

2026-09-09T13:14:45Z

Renatolima: /* Fluxograma */

Arquivo:Mermaid-diagram.png

2026-09-09T13:14:16Z

Renatolima:

Cadastro e inserção de observações padrão

2026-09-09T13:13:50Z

Renatolima: /* Fluxograma */

Cadastro e inserção de observações padrão

2026-09-09T13:08:19Z

Renatolima: /* Adequações no Fluxo de Pedido — complemento */

Cadastro e inserção de observações padrão

2026-09-09T13:08:02Z

Renatolima: /* Adequações no Fluxo de Pedido — complemento */

Cadastro e inserção de observações padrão

2026-09-09T13:04:30Z

Renatolima: /* Adequações no Fluxo de Pedido */

Cadastro e inserção de observações padrão

2026-09-09T13:02:47Z

Renatolima: /* Adequações no Cadastro de Observações */

Cadastro e inserção de observações padrão

2026-09-09T12:59:47Z

Renatolima: Desfeita a edição 19052 de Renatolima (Discussão)

Cadastro e inserção de observações padrão

2026-09-09T12:58:34Z

Renatolima: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 22/05/2026 || Renato Lima || Criação do documento
|-
| 09/09/2026 || Renato Lima || Adicionar ao cadastro a opção do cliente
|-
|}

== Necessidade ==
O cliente apresentou a necessidade de otimizar o processo de preenchimento das observações utilizadas no fluxo comercial do GeoSales Evo. Atualmente, ao copiar um pedido, as observações não são reaproveitadas, exigindo que os usuários realizem o preenchimento manual dos textos em cada novo pedido.

Durante o levantamento, foi identificado que muitas observações seguem um padrão operacional, principalmente relacionadas a informações de frete, pedido e nota fiscal, gerando retrabalho operacional e aumentando o risco de inconsistências nas informações registradas.

Diante deste cenário, o cliente necessita de uma funcionalidade que permita cadastrar modelos de observações padrão e reutilizá-los de forma prática no fluxo de pedidos, mantendo a possibilidade de personalização conforme a necessidade de cada negociação.

===Necessidade — complemento===

O cliente identificou também a necessidade de permitir que as observações padrão sejam direcionadas a clientes específicos. Dessa forma, determinados textos poderão ser utilizados exclusivamente em pedidos de um determinado cliente, enquanto observações sem vínculo com cliente permanecerão disponíveis para utilização de forma geral.

Essa flexibilização permitirá maior personalização das informações utilizadas no processo de pedidos, mantendo a possibilidade de utilização de modelos comuns a todos os clientes.

== Solução ==

Adequar o GeoSales Evo para permitir o cadastro e utilização de observações padrão no fluxo de pedidos.

A solução deverá contemplar:

* Cadastro de modelos de observação padrão;
* Definição do tipo da observação:
* Frete;
* Pedido;
* Nota Fiscal;
* Seleção de observações padrão diretamente no fluxo do pedido;
* Inserção automática do texto no campo correspondente;
* Possibilidade de edição e complementação do texto após inserção;
* Controle de acesso através do Controle de Ação.

===Solução — complemento===

O cadastro de observações padrão deverá permitir que o usuário informe, de forma opcional, o cliente ao qual a observação estará vinculada.

O cadastro passará a contemplar, além das informações já previstas:

* Título da observação;
* Texto padrão da observação;
* Tipo da observação — Frete, Pedido ou Nota Fiscal;
* Cliente — informação opcional.

Quando um cliente for informado no cadastro, a observação será considerada específica daquele cliente e deverá ser disponibilizada somente quando o pedido estiver sendo realizado para o cliente vinculado.

Quando nenhum cliente for informado, a observação será considerada genérica e poderá ser disponibilizada para utilização em pedidos de todos os clientes.

== Implementação ==
A implementação da funcionalidade deverá contemplar adequações estruturais, funcionais e visuais no GeoSales Evo, permitindo que os usuários realizem o gerenciamento e utilização de observações padrão diretamente na plataforma.

=== Adequações Funcionais ===

O sistema deverá disponibilizar uma nova estrutura de gerenciamento de observações padrão, permitindo:

* Inclusão de novas observações padrão;
* Edição de observações cadastradas;
* Exclusão de observações;
* Consulta/listagem das observações cadastradas;
* Definição do tipo da observação;
* Identificação visual do tipo da observação cadastrada.

=== Adequações no Cadastro de Observações ===

Será necessário incluir uma nova tela contendo:

* Grid/listagem das observações cadastradas;
* Ações de incluir, editar e excluir;
* Informações mínimas:
* Título da observação;
* Tipo da observação;
* Texto padrão da observação.

Caso de Uso – Cadastro e Inserção de Observações Padrão no Pedido
Objetivo

Permitir o cadastro de modelos de observações padrão e possibilitar sua utilização no fluxo de pedidos, através da seleção e inserção automática de textos previamente cadastrados nos campos de observação.

Atores
Usuário do Sistema
Administrador do Sistema
Pré-Condições
Usuário possuir permissão ativa no Controle de Ação para acesso à funcionalidade.
Pedido deve estar em processo de inclusão ou edição.
Deve existir ao menos um modelo de observação cadastrado para utilização.
Pós-Condições
Observação padrão inserida no pedido.
Texto poderá ser ajustado manualmente pelo usuário antes da finalização do pedido.
Informações permanecem gravadas no pedido conforme preenchimento final.
Fluxo Principal
1. Cadastro de Observação Padrão
Usuário acessa a tela de cadastro de observações padrão.
Sistema apresenta formulário para preenchimento.
Usuário informa:
Título da observação;
Texto padrão;
Tipo da observação:
Frete;
Pedido;
Nota Fiscal.
Usuário salva o cadastro.
Sistema valida as informações e grava o modelo de observação.
2. Utilização da Observação no Pedido
Usuário acessa o fluxo de inclusão ou edição de pedido.
Usuário acessa a aba de observações.
Sistema apresenta a opção de inserir observação padrão conforme permissão do Controle de Ação.
Usuário seleciona o tipo da observação.
Sistema lista os modelos cadastrados para o tipo selecionado.
Usuário seleciona o modelo desejado.
Sistema insere automaticamente o texto no campo de observação correspondente.
Usuário poderá complementar ou editar o texto inserido.
Usuário salva o pedido.
Sistema grava a observação conforme preenchimento final.
Fluxos Alternativos
FA01 – Usuário sem permissão
Usuário acessa o pedido.
Sistema identifica ausência de permissão no Controle de Ação.
Opção de inserir observação padrão não será exibida.
FA02 – Nenhum modelo cadastrado
Usuário seleciona o tipo de observação.
Sistema não localiza modelos cadastrados.
Sistema apresenta mensagem informando que não existem observações cadastradas para o tipo selecionado.
FA03 – Edição do texto padrão
Após inserir a observação, usuário altera parcialmente ou totalmente o texto.
Sistema mantém apenas a versão final preenchida no pedido.
Regras de Negócio
O cadastro de observações deverá permitir apenas os tipos:
Frete;
Pedido;
Nota Fiscal.
A visualização da funcionalidade dependerá de permissão no Controle de Ação.
O texto inserido poderá ser alterado manualmente antes da gravação do pedido.
A alteração do texto no pedido não deverá modificar o cadastro padrão da observação.
O sistema deverá listar apenas modelos compatíveis com o tipo selecionado.
Escopo
Incluso
Cadastro de observações padrão.
Definição do tipo da observação.
Inserção automática da observação no pedido.
Controle de acesso por permissão.
Possibilidade de edição manual do texto inserido.
Não Incluso
Versionamento de observações padrão.
Histórico de utilização das observações.
Compartilhamento de observações entre empresas/base distintas.
Inclusão automática da observação sem ação do usuário.
Estimativa de Esforço
Etapa Complexidade Horas
Criação do cadastro de observações padrão Média 10h
Implementação de permissões (Controle de Ação) Média 4h
Implementação no fluxo de pedido Média 8h
Validações e regras de negócio Baixa 4h
Testes e homologação Média 6h
Total Estimado 32h
Caso de Uso - Cadastro de endereço de entrega.pdf
PDF
criar conforme este modelo
Cadastro e Inserção de Observações Padrão no Pedido
Índice
Histórico de Alterações
Necessidade
Solução
Implementação
Adequações Funcionais
Adequações no Cadastro de Observações
Adequações no Fluxo de Pedido
Controle de Permissões
Documentos relacionados
Escopo
Escopo Incluso
Escopo Não Incluso
Atores
Pré-condições
Regras de Negócio
Fluxograma
Aprovação
Histórico de Alterações
Data Quem Comentários
22/05/2026 Renato Lima Criação do documento
Necessidade

O cliente apresentou a necessidade de otimizar o processo de preenchimento das observações utilizadas no fluxo comercial do GeoSales Evo. Atualmente, ao copiar um pedido, as observações não são reaproveitadas, exigindo que os usuários realizem o preenchimento manual dos textos em cada novo pedido.

Durante o levantamento, foi identificado que muitas observações seguem um padrão operacional, principalmente relacionadas a informações de frete, pedido e nota fiscal, gerando retrabalho operacional e aumentando o risco de inconsistências nas informações registradas.

Diante deste cenário, o cliente necessita de uma funcionalidade que permita cadastrar modelos de observações padrão e reutilizá-los de forma prática no fluxo de pedidos, mantendo a possibilidade de personalização conforme a necessidade de cada negociação.

Solução

Adequar o GeoSales Evo para permitir o cadastro e utilização de observações padrão no fluxo de pedidos.

A solução deverá contemplar:

Cadastro de modelos de observação padrão;
Definição do tipo da observação:
Frete;
Pedido;
Nota Fiscal;
Seleção de observações padrão diretamente no fluxo do pedido;
Inserção automática do texto no campo correspondente;
Possibilidade de edição e complementação do texto após inserção;
Controle de acesso através do Controle de Ação.
Implementação

A implementação da funcionalidade deverá contemplar adequações estruturais, funcionais e visuais no GeoSales Evo, permitindo que os usuários realizem o gerenciamento e utilização de observações padrão diretamente na plataforma.

Adequações Funcionais

O sistema deverá disponibilizar uma nova estrutura de gerenciamento de observações padrão, permitindo:

Inclusão de novas observações padrão;
Edição de observações cadastradas;
Exclusão de observações;
Consulta/listagem das observações cadastradas;
Definição do tipo da observação;
Identificação visual do tipo da observação cadastrada.
Adequações no Cadastro de Observações

Será necessário incluir uma nova tela contendo:

Grid/listagem das observações cadastradas;
Ações de incluir, editar e excluir;
Informações mínimas:
Título da observação;
Tipo da observação;
Texto padrão da observação.
Adequações no Fluxo de Pedido

Durante a inclusão ou edição do pedido:

O sistema deverá disponibilizar uma opção para inserção de observações padrão;
A funcionalidade deverá ser controlada através do Controle de Ação;
O usuário poderá selecionar o tipo da observação;
O sistema deverá listar apenas os modelos cadastrados para o tipo selecionado;
O usuário poderá selecionar o modelo desejado;
O sistema deverá inserir automaticamente o texto no campo correspondente;
Após a inserção, o usuário poderá editar e complementar o texto conforme necessidade operacional;
O texto final deverá ser salvo normalmente junto ao pedido.
Controle de Permissões

O sistema deverá permitir configuração de permissões para:

Visualizar funcionalidade de observações padrão;
Inserir observações padrão no pedido;
Cadastro manual de observações padrão;
Edição de observações;
Exclusão de observações.
Documentos relacionados

Não se aplica.

Escopo
Escopo Incluso
Cadastro de observações padrão;
Definição do tipo da observação;
Consulta/listagem das observações;
Inclusão de observação padrão no fluxo de pedido;
Edição manual do texto após inserção;
Controle de acesso por permissão.
Escopo Não Incluso
Versionamento de observações padrão;
Histórico de utilização das observações;
Inclusão automática de observações sem interação do usuário;
Compartilhamento de observações entre bases distintas;
Sincronização com ERP.
Atores
Vendedor
Supervisor Comercial
Administrador do Sistema
Pré-condições
Usuário autenticado no sistema;
Usuário possuir permissão para utilização da funcionalidade;
Pedido estar em inclusão ou edição;
Existir ao menos uma observação padrão cadastrada para utilização.
Regras de Negócio

[RN1] - O sistema deverá permitir cadastro de múltiplas observações padrão;

[RN2] - Cada observação deverá possuir apenas um tipo vinculado;

[RN3] - O sistema deverá permitir apenas os seguintes tipos:

Frete;
Pedido;
Nota Fiscal;

[RN4] - A visualização da funcionalidade deverá ser controlada através do Controle de Ação;

[RN5] - O sistema deverá listar apenas observações compatíveis com o tipo selecionado;

[RN6] - Após inserção da observação no pedido, o usuário poderá editar livremente o conteúdo;

[RN7] - Alterações realizadas no pedido não deverão impactar o cadastro padrão da observação;

[RN8] - O cadastro da observação deverá possuir no mínimo:

Título;
Tipo;
Texto da observação;

[RN9] - A funcionalidade estará disponível apenas no portal.

Fluxograma
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.

Setor Aprovado Por Data
Integração - GeoSales dd/mm/aaaa
Setor Aprovado Por Data Assinatura
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
hoje 8:51
O cliente deseja que as obsevações padrões, possa levar em consideração o cliente também, necessitamos realizar um adiciona ao caso de uso contemplando esta modificação de ao cadastrar a observação, possa informar ou não ao cliente, quando tiver cliente deve exibir especificamente para o cliente, quando não tiver pode ser exibido a todos.

Claro. Como a solicitação é uma evolução do caso de uso já elaborado, eu sugiro acrescentar a possibilidade de vincular opcionalmente a observação a um cliente, deixando explícito o comportamento para observações gerais e específicas.

Adição ao Caso de Uso
Necessidade — complemento

O cliente identificou também a necessidade de permitir que as observações padrão sejam direcionadas a clientes específicos. Dessa forma, determinados textos poderão ser utilizados exclusivamente em pedidos de um determinado cliente, enquanto observações sem vínculo com cliente permanecerão disponíveis para utilização de forma geral.

Essa flexibilização permitirá maior personalização das informações utilizadas no processo de pedidos, mantendo a possibilidade de utilização de modelos comuns a todos os clientes.

Solução — complemento

O cadastro de observações padrão deverá permitir que o usuário informe, de forma opcional, o cliente ao qual a observação estará vinculada.

O cadastro passará a contemplar, além das informações já previstas:

Título da observação;
Texto padrão da observação;
Tipo da observação — Frete, Pedido ou Nota Fiscal;
Cliente — informação opcional.

Quando um cliente for informado no cadastro, a observação será considerada específica daquele cliente e deverá ser disponibilizada somente quando o pedido estiver sendo realizado para o cliente vinculado.

Quando nenhum cliente for informado, a observação será considerada genérica e poderá ser disponibilizada para utilização em pedidos de todos os clientes.

====Adequações no Cadastro de Observações - Complemento====

O cadastro deverá ser ajustado para permitir a vinculação opcional de um cliente.

Informações mínimas:

* Título;
* Tipo da observação;
* Texto padrão;
* Cliente — opcional.

O campo '''Cliente''' deverá permitir a pesquisa e seleção de um cliente cadastrado no sistema.

=== Adequações no Fluxo de Pedido ===

Durante a inclusão ou edição do pedido:

* O sistema deverá disponibilizar uma opção para inserção de observações padrão;
* A funcionalidade deverá ser controlada através do Controle de Ação;
* O usuário poderá selecionar o tipo da observação;
* O sistema deverá listar apenas os modelos cadastrados para o tipo selecionado;
* O usuário poderá selecionar o modelo desejado;
* O sistema deverá inserir automaticamente o texto no campo correspondente;
* Após a inserção, o usuário poderá editar e complementar o texto conforme necessidade operacional;
* O texto final deverá ser salvo normalmente junto ao pedido.

=== Controle de Permissões ===

O sistema deverá permitir configuração de permissões para:

* Visualizar funcionalidade de observações padrão;
* Inserir observações padrão no pedido;
* Cadastro manual de observações padrão;
* Edição de observações;
* Exclusão de observações.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Cadastro de observações padrão;
* Definição do tipo da observação;
* Consulta/listagem das observações;
* Inclusão de observação padrão no fluxo de pedido;
* Edição manual do texto após inserção;
* Controle de acesso por permissão.

==== Escopo Incluso — complemento ====
* Inclusão do campo Cliente no cadastro de observações padrão;
* Possibilidade de cadastrar observações gerais;
* Possibilidade de cadastrar observações específicas por cliente;
* Filtro das observações conforme o cliente do pedido;
* Disponibilização das observações gerais e específicas do cliente no fluxo de pedido.

=== Escopo Não Incluso ===
* Versionamento de observações padrão;
* Histórico de utilização das observações;
* Inclusão automática de observações sem interação do usuário;
* Compartilhamento de observações entre bases distintas;
* Sincronização com ERP.

== Atores ==
* Vendedor
* Supervisor Comercial
* Administrador do Sistema

== Pré-condições ==
* Usuário autenticado no sistema;
* Usuário possuir permissão para utilização da funcionalidade;
* Pedido estar em inclusão ou edição;
* Existir ao menos uma observação padrão cadastrada para utilização.

== Regras de Negócio ==
'''[RN1] -''' O sistema deverá permitir cadastro de múltiplas observações padrão;

'''[RN2] -''' Cada observação deverá possuir apenas um tipo vinculado;

'''[RN3] -''' O sistema deverá permitir apenas os seguintes tipos:

* Frete;
* Pedido;
* Nota Fiscal;

'''[RN4] -''' A visualização da funcionalidade deverá ser controlada através do Controle de Ação;

'''[RN5] -''' O sistema deverá listar apenas observações compatíveis com o tipo selecionado;

'''[RN6] -''' Após inserção da observação no pedido, o usuário poderá editar livremente o conteúdo;

'''[RN7] -''' Alterações realizadas no pedido não deverão impactar o cadastro padrão da observação;

'''[RN8] -''' O cadastro da observação deverá possuir no mínimo:

* Título;
* Tipo;
* Texto da observação;

'''[RN9] -''' A funcionalidade estará disponível apenas no portal.

=== Regras de Negócio - Complemento ===
'''[RN10] -''' O vínculo da observação com um cliente deverá ser opcional.

'''[RN11] -''' Quando a observação possuir um cliente vinculado, ela deverá ser disponibilizada exclusivamente para pedidos do cliente informado no cadastro.

'''[RN12] -''' Quando a observação não possuir cliente vinculado, ela deverá ser considerada uma observação geral e poderá ser utilizada para qualquer cliente.

'''[RN13] -''' No fluxo de pedido, o sistema deverá considerar o cliente selecionado no pedido para filtrar as observações padrão disponíveis.

'''[RN14] -''' O sistema deverá apresentar conjuntamente as observações gerais e as observações específicas vinculadas ao cliente do pedido.

'''[RN15] -''' Observações vinculadas a outros clientes não deverão ser disponibilizadas para seleção no pedido.

'''[RN16] -''' A alteração do texto da observação no pedido não deverá alterar o modelo padrão cadastrado, independentemente de a observação ser geral ou específica de um cliente.

== Fluxograma ==
[[Arquivo:Diagrama_cadastro_observacao.png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}

Cadastro e inserção de observações padrão

2026-09-09T12:55:59Z

Renatolima: /* Escopo Incluso */

Cadastro e inserção de observações padrão

2026-09-09T12:54:22Z

Renatolima: /* Regras de Negócio - Complemento */

Cadastro e inserção de observações padrão

2026-09-09T12:53:28Z

Renatolima: /* Regras de Negócio -Complemento */

Cadastro e inserção de observações padrão

2026-09-09T12:53:18Z

Renatolima: /* Regras de Negócio */

Cadastro e inserção de observações padrão

2026-09-09T12:50:03Z

Renatolima: /* Solução */

Cadastro e inserção de observações padrão

2026-09-09T12:49:18Z

Renatolima: /* Necessidade */

Cadastro e inserção de observações padrão

2026-09-09T12:48:42Z

Renatolima: /* Histórico de Alterações */

Impedir Salvamento de Pedido CIF sem Regra de Frete

2026-09-08T18:41:42Z

Renatolima: /* Regras de Integração */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 08/09/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Necessita de um controle que impeça o salvamento de pedidos quando a venda for realizada na modalidade de frete CIF e não houver uma regra de frete configurada no GeoSales para realizar o respectivo cálculo.

Atualmente, o GeoSales realiza o cálculo do frete CIF com base nas regras de frete existentes em sua estrutura. Entretanto, em situações nas quais não existe uma regra aplicável ao pedido, o cálculo do frete não é realizado, permitindo que o pedido possa seguir para salvamento sem que essa condição seja identificada.

Para o cliente, é importante que essa situação seja tratada como uma validação obrigatória, evitando que pedidos CIF sejam registrados sem que o frete tenha sido devidamente calculado.

== Solução ==
Implementar uma trava no salvamento do pedido para as vendas realizadas com tipo de frete CIF.

No momento em que o usuário tentar salvar o pedido, o GeoSales deverá verificar se foi possível realizar o cálculo do frete conforme as regras configuradas para a operação.

Quando houver uma regra de frete aplicável, o pedido poderá ser salvo normalmente.
Quando não houver regra de frete aplicável e, consequentemente, o cálculo do frete CIF não for realizado, o sistema deverá impedir o salvamento do pedido.
O usuário deverá receber uma mensagem informando que o pedido não pode ser salvo porque não foi encontrada uma regra de frete válida para realização do cálculo do frete CIF.

Dessa forma, a solução atenderá à necessidade do cliente de garantir que nenhum pedido CIF seja salvo sem que o respectivo cálculo de frete tenha sido realizado.

== Implementação ==

A implementação deverá contemplar uma validação no fluxo de salvamento do pedido, considerando a modalidade de frete selecionada.

O GeoSales deverá identificar se o pedido utiliza frete CIF e, nesse cenário, verificar se o processo de cálculo do frete foi executado com sucesso a partir de uma regra de frete aplicável.

O comportamento esperado será:

'''1. Pedido com frete CIF e regra aplicável:''' o cálculo será realizado e o pedido poderá ser salvo normalmente.

'''2. Pedido com frete CIF sem regra aplicável:''' o sistema deverá interromper o processo de salvamento e apresentar uma mensagem orientando o usuário sobre a ausência da regra de frete.

'''Mensagem Sugerida'''

Não foi possível calcular o frete CIF. Não foi encontrada uma regra de frete aplicável a este pedido. Verifique as configurações ou os dados informados antes de salvar o pedido.

'''3. Pedido com modalidade diferente de CIF:''' a nova trava não deverá ser aplicada, mantendo o comportamento atual do sistema.

A implementação deverá utilizar a estrutura e os mecanismos de cálculo de frete já existentes no GeoSales, acrescentando apenas a validação obrigatória para impedir o salvamento quando o cálculo do frete CIF não puder ser realizado.

Resultado esperado: garantir que pedidos CIF não sejam salvos sem que exista uma regra de frete aplicável e sem que o respectivo cálculo tenha sido realizado com sucesso.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Implementar validação no processo de salvamento de pedidos com modalidade de frete CIF.

* Validar se existe uma regra de frete aplicável ao pedido.

* Validar se o cálculo do frete foi realizado com sucesso antes de permitir o salvamento.

* Implementar a trava de salvamento quando não houver regra de frete aplicável.

* Apresentar mensagem informativa ao usuário quando o salvamento for bloqueado.

* Aplicar a validação nos fluxos de inclusão e/ou alteração de pedido em que o cálculo do frete CIF seja executado.

* Garantir que a validação utilize a estrutura de regras de frete já existente no GeoSales.

* Realizar testes dos cenários com regra de frete válida e sem regra de frete aplicável.

=== Escopo Não Incluso ===
* Criação, alteração ou revisão das regras de cálculo de frete já existentes no GeoSales.

* Alteração da metodologia ou fórmula utilizada atualmente para cálculo do frete.

* Criação de novas modalidades de frete.

* Alteração das condições comerciais ou regras de negócio relacionadas ao pedido que não estejam diretamente relacionadas à trava do frete CIF.

* Cadastro automático de regras de frete.

* Alteração das informações de frete no ERP ou em sistemas externos.

* Implementação de novos critérios para determinação do valor do frete.

* Alterações em integrações que não sejam necessárias para atender à validação proposta.

== Atores ==
'''Vendedor/Usuário do GeoSales:''' responsável pela inclusão e salvamento do pedido.

'''GeoSales:''' responsável por validar a existência da regra e realizar o cálculo do frete.

== Pré-condições ==
* Usuário deve estar autenticado no GeoSales.

* Deve existir um pedido em processo de inclusão ou edição.

* O pedido deve possuir a modalidade de frete CIF.

* As regras de cálculo de frete devem estar configuradas na estrutura do GeoSales.

== Regras de Negócio ==

'''[RN1] - Validação do Frete CIF'''

Para pedidos com modalidade de frete CIF, o GeoSales deverá validar, antes do salvamento, se existe uma regra de frete aplicável e se o cálculo do frete foi realizado com sucesso.

'''[RN2] - Bloqueio do Salvamento'''

Caso não seja encontrada uma regra de frete aplicável ao pedido CIF, o GeoSales deverá impedir o salvamento do pedido.

'''[RN3] - Mensagem ao Usuário'''

Ao bloquear o salvamento, o sistema deverá apresentar uma mensagem clara informando que não foi encontrada uma regra de frete válida para o cálculo do frete CIF.

'''Mensagem Sugerida'''

Não foi possível calcular o frete CIF. Não foi encontrada uma regra de frete aplicável a este pedido. Verifique as configurações ou os dados informados antes de salvar o pedido.

'''[RN4] - Pedido com Frete Calculado'''

Quando existir uma regra aplicável e o cálculo do frete for realizado com sucesso, o pedido poderá ser salvo normalmente.

'''[RN5] - Aplicação da Regra'''

A validação deverá utilizar as regras de frete já existentes na estrutura do GeoSales, não sendo objetivo deste caso de uso alterar a lógica atual de cálculo do frete.

'''[RN6] - Ativar comportamento'''

Está validação deve ser ativada a partir de uma ação, uma vez esta ação ativada para o perfil do usuário, o sistema deve realizar validação.

== Fluxograma ==
[[Arquivo:Diagrama_validar_regra_de_frete.drawio_(1).png|1100px]]

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| 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 ||
|-
|}