Rota simulada

A ferramenta TOTVS CRM - SFA possui vários locais para realizar o cadastramento/exibição de coordenadas GPS, sejam elas para demarcar o Ponto sede da propriedade do cliente, o Ponto Central dos Talhões, ou ainda para a demarcação de mapeamentos GPS. Neste requisito foi incluso a demarcação de pontos em um mapa (Ambiente Web), utilizando o GPS do aparelho (Ambiente Android), ou ainda através da inserção manual das informações de latitude e longitude.

Para os lançamento manual das coordenadas, assim como para os casos de visualização das coordenadas previamente cadastradas, o usuário é capaz de escolher a forma que gostaria de visualizar essas coordenadas:

• Graus, Minutos e Segundos;
• Coordenadas decimais.

Para atender às novas necessidades, foram implementadas as seguintes melhorias no SFA:

Criação de ponto de partida e ponto de chegada para as rotas, além de ponto de refeição;

Local - Ponto Sede

Telas de cadastro edição de Ponto sede - GPS

• Cliente > Cliente > Mapeamento do Local 

• Cliente > Cliente > Listar > Editar > Local 
• Cliente > Cliente > Listar > Editar   > Local > GPS - Área   > Botão Ponto Sede   > Botão Ponto GPS  
• Cliente > Local (Toque Longo) > Opção GPS - Sede   > Editar  
• Cliente > Local (Toque Simples) > Aba Cadastro > Local (Toque Longo) > Opção Ponto Sede   > Editar  

Local - Mapeamento do local

Telas de cadastro e edição de Mapeamento do Local

• Cliente > Cliente > Mapeamento do Local > Opção GPS - Área   > Botão Ponto GPS  
• Cliente > Cliente > Listar > Editar   > Local > Opção GPS - Área   > Botão Mapeamento   > Botão Ponto GPS  
• Cliente > Cliente > Listar > Editar   > Local > Opção GPS - Área   > Botão GPS  > Botão Ponto GPS  
• Cliente > Local (Toque Simples) > Aba Cadastro > Local (Toque Longo) > Opção Mapeamento do Local   > Botão Mapeamento GPS   > Botão Menu   > Novo Ponto GPS  

Agrícola - Mapeamento GPS

Telas de cadastro e edição de Mapeamento GPS do Projeto Agrícola

• Agrícola > Projetos Agrícolas > Opção Área Mapeada   > Botão Mapeamento   > Botão Pontos  
• Agrícola > Projetos Agrícolas > Opção Editar   > Botão Mapeamento   > Botão Pontos  
• Cliente > Local (Toque Simples) > Aba Agrícola > Projeto (Toque Simples) > Talhão (Toque Simples) > Aba Mapeamento > Opção Pontos Mapeados   > Botão Novo Ponto GPS  

Bem Patrimonial - Coordenada do Bem

Telas de cadastro e edição de Coordenada dos Bens

• Cliente > Local (Toque Simples) > Aba Bens > Bem Patrimonial (Toque Simples) > Opção Ponto GPS   > Editar  

Parâmetros:

• sim3g.rota: Se ativo, o sistema poderá utilizar pontos adicionais de gps na rota ( pontos de partida e chegada, assim como refeição) assim como o número de refeições.

• sim3g.rota.permite.pontosgpsadicionais:  Se o parâmetro tiver valor 1, a aplicação permitirá pontos adicionais na rota, ponto de partida, ponto de chegada e pontos de refeição.

• sim3g.rota.quantidade.refeicoesnarota: Campo recebe um Valor numérico inteiro, que determina o total de pontos de refeição poderão ser cadastrados, por exemplo, 2 onde, o valor 2 significa que o usuário poderá inserir até 2 pontos de refeição em uma rota diária.

Implementação do cálculo de distância nas rotas, para armazenar o KM de cada uma das rotas;

Este Recurso permite realizar o planejamento das agendas dos profissionais, de forma que seja possível entender a distância planejada para os profissionais em cada um dos dias, e depois essa informação deve ser comparada com o que foi efetivamente realizado pelos profissionais, informação essa que é lançada hoje no módulo de viagem.

Atualmente, a Cooxupé utiliza uma ferramenta externa para realizar o planejamento dos profissionais, pois o módulo de rotas não atende a todas as necessidades da Cooxupé, uma vez que ainda não tem cálculo de distância, e não tem como determinar pontos de partida e de chegada, se limitando apenas a traçar uma sequência de clientes para atendimentos. Dessa forma, hoje não está sendo possível realizar um De>Para entre o planejado e o realizado para os profissionais.

Implementação de ponto GPS para as filiais/empresas, que poderão ser usados como ponto de partida e de chegada, juntamente com a implementação de uma tela para visualização das filiais cadastradas no sistema, onde será possível cadastrar essas informações de ponto GPS;

Cadastro de Filial

Tela para visualizar e editar o cadastros das empresas/filiais no SFA, a qual ficará no novo menu Cadastro > Geral > Filial.
Essa tela não permitirá o cadastro de novas empresas/filiais, uma vez que este cadastro sempre deve vir do ERP via integração.
Além disso, não será possível editar o cadastro da empresa nessa tela, pois essa edição também deve partir do ERP.
O único cadastro que será possível realizar nessa tela, é o cadastro de ponto sede para a empresa/filial, o qual será utilizado posteriormente no módulo de rotas.
O acesso a essa tela depende do perfil de acesso do usuário, pois somente aqueles usuários que tenham o acesso liberado a essa tela, poderão visualizá-la.
Na parte superior da Grid, haverá campos de busca, para que seja possível filtrar os registros de filiais que estão sendo apresentados na tela. Estará disponível um campo de pesquisa rápida, para filtrar pelos campos que estão na grid, e haverá um botão de pesquisa avançada, para que seja possível filtrar por campos específicos, sendo eles:

CNPJ, Endereço, Número, Complemento, CEP, País, Unidade Federativa, Cidade e Situação.
Na grid, serão apresentadas as seguintes informações das empresas/filiais:
Descrição, CNPJ, Endereço, Número, Complemento, CEP, Cidade, Unidade Federativa, País, Situação, Ponto GPS (ícone de casa).

Nesta tela foi incluso a funcionalidade de cadastrar/visualizar/editar um ponto GPS para as empresas/filiais cadastradas no SFA
Nessa tela que será criada, o usuário poderá realizar o cadastro e a edição do Ponto GPS das filiais, o qual será utilizado posteriormente no módulo de rotas.
A popup de cadastro de ponto sede das filiais será copiada da tela de cadastro de ponto sede dos clientes, de forma que a popup apresente as mesmas funcionalidades:

O Acesso a pop-up de cadastro de pontos gps  será controlado por perfil de acesso, regra detalhada no requisito (3.1.6.1 - Ajustes perfil de acesso - Cadastro de empresas e usuários  Web - Escopo técnico Aplicação)

Título da pop-up: Mapeamento da filial - [PARCEIRO.NOMEPARCEIRO - LOCAL.DESCRICAO]

• Visualização do ponto previamente cadastrado;
• Permite cadastrar novo ponto;
• Permite visualizar as coordenadas do ponto GPS, em Graus decimais e em Graus, Minutos e Segundos;
• Permite alterar as Coordenadas GPS

Implementação de ponto GPS para os usuários.

Será necessário realizar ajustes nos cadastros de usuários, para ter a possibilidade de cadastrar o Ponto GPS do usuário, e assim poder apresentar e utilizar essa informação no módulo de rotas.
Será criada uma nova opção na tela de cadastro de usuários, chamada “Ponto GPS”, o qual será utilizado para visualizar e dar manutenção no cadastro de ponto GPS dos usuários.
Ao clicar sobre o botão “Ponto GPS”, será apresentada uma popup, a qual será copiada da tela de cadastro de ponto sede dos clientes, de forma que a popup apresente as mesmas funcionalidades: 

• Visualização do ponto previamente cadastrado;
• Permite cadastrar novo ponto;
• Permite visualizar as coordenadas do ponto GPS, em Graus decimais e em Graus, Minutos e Segundos;
• Permite alterar as Coordenadas GPS.

Na tela de cadastro de usuário “Cadastro” > “Profissional” > “Profissional” deverá ser adicionado o botão “Ponto GPS” conforme protótipo abaixo:

O Acesso a pop-up de cadastro de pontos gps  será controlado por perfil de acesso, regra detalhada no requisito (3.1.6.1 - Ajustes perfil de acesso - Cadastro de empresas e usuários  Web - Escopo técnico Aplicação)

Ao clicar sobre o botão “Ponto GPS”, será apresentada uma popup, a qual será copiada da tela de cadastro de ponto sede dos clientes, de forma que a popup apresente as mesmas funcionalidades: 

• Visualização do ponto previamente cadastrado;
• Permite cadastrar novo ponto;
• Permite visualizar as coordenadas do ponto GPS, em Graus decimais e em Graus, Minutos e Segundos;
• Permite alterar as Coordenadas GPS.

Detalhamento técnico - Desenvolvimento

Novos Parâmetros

Será criado um novo parâmetro para definir se é possível ou não realizar a edição (considerando também o cenário de cadastro do registro) do campo de Unidade de Medida das telas:

• Agricola - Produtos Recomendados
• Agrícola - Produtos Aplicados

Será criado um novo parâmetro para definir qual modelo de busca que os campos de Unidade de medida do agrícola devem respeitar:

Será criado um novo parâmetro para definir qual modelo de busca que os campos de Unidade de medida das telas de Bens Patrimoniais devem respeitar:

• Agrícola - Produtos Recomendados

A tela de lançamento de “Produtos Recomendados”, dentro do módulo agrícola, será alterada para que o campo Unidade de Medida do produto passe a respeitar o comportamento definido nos parâmetros PermiteEditarUnidMedAgricola e FormaBuscaUnidMedAgricola, levando em consideração também o cadastro de Unidades de Medida -> Disponível para Agrícola;

A validação de preenchimento/seleção da unidade de medida será aplicada nos ambientes Web e Andoird da aplicação.

O preenchimento do campo Unidade de Medida continua sendo obrigatório nessa tela.

Detalhamento técnico - Desenvolvimento Web e Android

Para as telas de Produtos Recomendados deve considerar os dois parâmetros criados no tópico anterior. Primeiramente verificar se o parâmetro de chave “sim3g.agricola.PermiteEditarUnidMedAgricola” deve ou não permitir editar o campo Unidade de medida. Se sim, o campo ficará habilitado, se não este campo ficará com a edição desabilitada.

Depois, deve verificar qual será o modelo de busca das unidades de medida parametrizadas na chave “sim3g.agricola.FormaBuscaUnidMedAgricola”. Sendo que, se o valor for:

• 1 - (Apresentar somente unidades de medida vinculadas ao produto)

• 2 - (Apresentar somente unidades de medida permitidas para Agrícola e ativas)

• 3 - (Apresentar somente unidades de medida ativas)

Durante o lançamento de novas Recomendações, quando o parâmetro “sim3g.agricola.FormaBuscaUnidMedAgricola” estiver configurado com as opções 2 ou 3, o campo de Unidade de Medida dessas telas deve vir com a opção “Selecione” previamente selecionada, para que o usuário tenha que informar depois qual deve ser a unidade de medida desejada para aquele registro.

A seguir o protótipo de telas de onde se espera o ajuste no campo:

• Agrícola - Produtos Aplicados

A tela de lançamento de “Produtos Aplicados”, dentro do módulo agrícola, será alterada para que o campo Unidade de Medida do produto passe a respeitar o comportamento definido nos parâmetros PermiteEditarUnidMedAgricola e FormaBuscaUnidMedAgricola, levando em consideração também o cadastro de Unidades de Medida -> Disponível para Agrícola;

O preenchimento do campo Unidade de Medida continua sendo obrigatório nessa tela.

Detalhamento técnico - Desenvolvimento Web e Android

Para as telas de Produtos Aplicados deve considerar os dois parâmetros criados no tópico anterior. Primeiramente verificar se o parâmetro de chave “sim3g.agricola.PermiteEditarUnidMedAgricola” deve ou não permitir editar o campo Unidade de medida. Se sim, o campo ficará habilitado, se não este campo ficará com a edição desabilitada.

Depois, deve verificar qual será o modelo de busca das unidades de medida parametrizadas na chave “sim3g.agricola.FormaBuscaUnidMedAgricola”. Sendo que, se o valor for: