Árvore de páginas

01. DADOS GERAIS

Produto:

TOTVS CRM Automação da Força de Vendas

Linha de Produto:

Linha TOTVS CRM SFA

Módulo:Venda
Função:Pedido
Ticket:
Requisito/Story/Issue:


02. ESCOPO FUNCIONAL

Atualmente, o sistema não possui maneira de realizar distribuição de cotas levando em consideração o histórico de vendas dos usuários associados às cotas.

Agora, deverá ser possível adicionar um novo saldo de cotas de forma a distribuí-lo de maneira proporcional aos valor das vendas em um período determinado de X dias.

Ao realizar a distribuição de cotas proporcional ao histórico de vendas, será possível informar um saldo mínimo que os profissionais deverão conter, garantido que mesmo que profissionais que não contenham vendas em seu histórico recebam uma quantidade mínima de cota.

Atualmente, o sistema não permite visualizar os registros de cota de maneira agrupada, por exemplo, registros de cotas por profissional visualizadas sob a perspectiva de supervisor.

Agora, o sistema deverá possibilitar a configuração de visualização de registros de cota de maneira agrupada, de forma a permitir que seja possível adicionar/deduzir saldos de cota a partir de uma seleção de um agrupamento.

Por exemplo, adicionar saldos de todos os produtos de todos os profissionais cujo supervisor seja o Alberto Silva.

Para isso, o sistema deverá receber as seguintes atualizações

02.01 Criação de novas telas de cota

O sistema contará com novo fluxo de telas de cota, cuja primeira tela será listagem de todos os registros de cotas existentes, exibindo os seus nomes, vigências e se estão ativos/inativos. Além disso, permitirá realizar a visualização do modelo de configuração das cotas, a clonagem dela e a edição de seus registros de controle.

Ao clicar em adicionar/editar configurações, o sistema disponibilizará uma tela com os seguintes atributos:

  • Situação: Ativo/Inativo
  • Descrição: descrição da cota
  • Vigência inicio/fim: datas entre as quais a cota será considerada vigente
  • Modelo de cota: seleção de quais serão as entidades de variação de cotas, por exemplo, pode ser selecionada que a cota será distribuída por produto por profissional, ou por produto, por profissional por filial.
    • Ao selecionar os modelos de cota, deverão ser selecionados quais serão os registros referentes àquela entidade que fará parte da primeira criação da cota. Por exemplo, se profissional, então deverá ser selecionado quais profissionais farão parte daquela cota vigente
    • As opções serão: profissional, produto, filial
  • Agrupadores de cota: seleção de quais serão as perspectivas de agrupamento que o sistema deverá criar para a facilitação do controle/manutenção de cotas vigentes
    • As opções serão: profissional, produto, supervisor, filial

Ao clicar em clonar, o sistema disponibilizará a oportunidade de criar uma nova cota, com os mesmos modelos/agrupamentos da anterior, podendo escolher o que fazer com o saldo disponível, entre:

  • Copiar os saldos iniciais da cota anterior como saldo inicial da nova cota
  • Copiar o saldo disponível da cota anterior como saldo inicial da nova cota
  • Determinar um novo saldo inicial fixo, copiando apenas o modelo de configuração da cota anterior

Ao clicar em editar, caso a configuração da cota estiver finalizada e existir agrupamentos configurados, o sistema deverá exibir tela de agrupadores de cota que conterão os seguintes atributos:

  • Listagem de todos os agrupadores vinculados aos registros criados ao finalizar a configuração, por exemplo, todos os supervisores referentes aos usuários selecionados nos filtros dos modelos de cota.
    • A lista conterá, de maneira agrupada (soma), os dados de saldo inicial, saldo disponível, saldo processado e saldo a processar.
    • A lista conterá botão para visualizar controles de cota, abrindo a tela de controles de cota, já filtrado pelos registros associados ao agrupador do contexto
  • Botão para adicionar/deduzir saldo, abrindo modal previamente filtrada com os registros referentes àquele agrupador, onde será possível informar saldo a ser adicionado/deduzido e selecionar a lógica de distribuição, entre:
    • Dividir igualmente
    • Proporcional ao valor do histórico de vendas, que quando selecionado, solicitará o preenchimento de:
      • Dias de histórico: dias retroativos aos quais a aplicação deverá usar de filtro para determinar a proporcionalidade de vendas associadas às entidades selecionadas no filtro de cotas de destino
      • Saldo mínimo: valor mínimo que o sistema deve respeitar ao realizar a distribuição de cotas, garantido que mesmo que profissionais que não contenham vendas em seu histórico recebam uma quantidade mínima de cotas
  • Botão para visualizar controles de maneira geral, sem filtros.

Ao clicar nos botões de visualização de controles de cota, o sistema deverá exibir tela contendo os seguintes atributos:

  • Listagem de controles de cota, contendo informações de situação do controle, saldo inicial, saldo disponível, saldo processado e saldo a processar referentes às variações do modelo de cota configurado
    • Botão para realizar transferência de saldo de cota, onde o sistema abrirá modal informando saldo disponível para transferência, solicitando do usuário as seguintes informações:
      • Saldo a ser transferido
      • Modelo de distribuição 
      • Filtro de controles de cota de destino
    • Botão para visualizar movimentações de cota referentes ao controle, para fins de auditoria, contendo todas as alterações de cota, desde sua criação, informando as datas, origens e vínculos das movimentações associadas a pedidos quando criado automaticamente e a usuários quando alterados manualmente

02.02 Protótipo

O protótipo referente ao fluxo de utilização encontra-se presente no seguinte link: https://www.figma.com/proto/PzhfjrWWkjlAhgTXP4Y1GX/Cota-no-SFA?node-id=2-12&t=UC7pzpNZYr75N7GQ-0&scaling=min-zoom&content-scaling=fixed&page-id=0%3A1

03. ESCOPO TÉCNICO

03.01.01 Tabela cotaconfiguracao

Contexto / Gatilho:

  • No ambiente Web, ao clicar sobre o menu Cadastro → Venda → Cota

Lógica:

  • Caso o repositório do cliente tiver implementação da tela de listagem de cotas remodelada (utilizar serviços para obter a informação)

    • O sistema deve encaminhar o usuário para nova tela de listagem de cotas, desenvolvida a partir deste épico
  • As novas telas de cota deverão ser desenvolvida em projeto cliente (pedidoengine)

03.01.01 Endereçamento do usuário para nova tela de cota, se implementada no projeto cliente

Contexto / Gatilho:

  • No ambiente Web, ao clicar sobre o menu Cadastro → Venda → Cota

Lógica:

  • Caso o repositório do cliente tiver implementação da tela de listagem de cotas remodelada (utilizar serviços para obter a informação)

    • O sistema deve encaminhar o usuário para nova tela de listagem de cotas, desenvolvida a partir deste épico
  • As novas telas de cota deverão ser desenvolvida em projeto cliente (pedidoengine)

03.01.02 Tela de listagem de cotas

Contexto / Gatilho:

  • No ambiente Web, ao clicar sobre o menu Cadastro → Venda → Cota, considerando a condição da seção 03.01.01

Lógica:

  • O sistema deve disponibilizar tela conforme as imagens do protótipo a seguir:

  • O sistema deve encaminhar o usuário para a nova tela de listagem de cotas, que deverá conter os seguintes elementos visuais:
  • nomes, vigências e se estão ativos/inativos. Além disso, permitirá realizar a visualização do modelo de configuração das cotas, a clonagem dela e a edição de seus registros de controle.

  • "Cota": Título da página
  • SlickGrid contendo as seguintes colunas:
      • "Descrição": campo textual, editável, representando o valor da coluna cota.descricao
      • "Inicio Vigência": Campo de data, editável, representando o valor da coluna cota.datainiciovigencia
      • "Fim Vigência": Campo de data, editável, representando o valor da coluna cota.datafimvigência
      • "Situação": Texto, editável exibindo Ativo/Inativo quando o campo cota.idnativo estiver com respectivos valores 1/0. Ao editar o campo, o tipo do campo vira check-box marcada/desmarcada quando o campo cota.idnativo estiver com respectivos valores 1/0
      • "Configuração": ícone clicável, que quando clicado, encaminha o usuário para a tela de "Configurações de cota", passando como contexto o identificador da cota selecionada (cota.idcota)
        • Quando o campo cota.idnfinalizado = 0, o ícone deve ser exibido como 
        • Caso contrário, o ícone deve ser exibido como 
      • "Clonar": ícone clicável, já existente na tela de cota do CORE.
        • Quando clicado, deve executar a mesma lógica que executa atualmente, copiando todos os dados das tabelas cota, controlecota, cotaconfiguracao
          • Todos os dados devem ser clonados, com exceção dos seguintes campos que podem ser informados a partir da modal de clonagem, sendo estes:
            • cota.descricao
            • cota.datainiciovigencia
            • cota.datafimvigencia
            • controlecota.saldoinicial
            • controlecota.saldodisponivel
      • "Editar": ícone clicável
        • Deve ser exibido somente quando o campo cota.idnfinalizado = 0
        • Quando clicado,
          • Caso houver agrupamentos selecionados (link para agrupamentos).
            • O sistema deve enviar o usuário para a tela de "Agrupadores de cota"
          • Caso contrário, deve enviar o usuário para a tela de "Controles de cota"
    • A grid deverá ter recurso de adicionar novo registro, disponibilizando botão "Adicionar" que, quando clicado, encaminhará o usuário para tela de "Configurações de cota"
    • A grid deve ter botão "Gravar", para permitir persistir os campos editáveis alterados
      • Caso o usuário deseje cancelar a alteração de um registro não gravado, poderá clicar em botão "Cancelar alteração"
    • A pesquisa rápida deve considerar os campos cota.descricao
    • A pesquisa avançada deverá disponibilizar os seguintes campos:
      • "Descrição": campo texto.
        • Quando preenchido buscará pelo campo cota.descricao



  • Tela de listagem de cotas
    • Listagem de campos
      • Coluna finalizado
      • Coluna para acessar tela de configuração
      • Coluna para acessar agrupamentos de controles de cota, se existirem. Se não existirem, acessar controles de cota
    • Botão adicionar, levando para tela de configuração de cota
  • Sem rótulos