Exibir código-fonte para Previsao inicial

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem 
! Comentários 
|-
|  03/10/2017  ||  Renato Lima    ||  Criação do Documento 
|}

== Necessidade ==
Cliente necessita que o seu vendedor faça o cadastro de informações da previsão de vendas do mês posterior offline, através da plataforma mobile, de forma que o processo de cadastro de previsão de vendas e planejamento da rota se torne mais ágil e cômodo para o vendedor.

Atualmente este processo é feito através do proteus, em plataforma web. Porém, só pode ser realizado online, o que gera vários problemas de conectividade para o vendedor, visto que, em algumas visitas a clientes, este vendedor não tem conexão com a internet. 

O cadastro de previsão de vendas, se realizado offline, possibilitará ao vendedor [...] 

A demanda deverá resolver o problema de conectividade do vendedor, visto que o GeoSales funciona offline, facilitando assim o cadastro das as informações pelo vendedor, mesmos sem internet.

== Solução ==

Será implementado o processo dentro do Geosales Mobile, para que o vendedor consiga consultar e informar os dados necessários para o cadastro de previsão de vendas e, através da integração, esses dados cheguem ao ERP.

== Implementação ==
Para ativar a funcionalidade  será criada uma configuração '''ID_CADASTRA_PREVISAO''' que fará com que o botão possa ser exibido no topo da tela do mobile após acessar o cadastro do cliente. Para que o vendedor acesse e realize o cadastro de previsão de vendas.

O sistema vai disponibilizar o cabeçalho onde o mesmo precisa informar dados relacionados a visita e solicitação de ações para o cliente.

O sistema vai disponibilizar os dados para que ele possa informar proposta, bonificação e bonif nota fiscal.

[[Arquivo:Tela 1.png|200px]]

O botão '''PV''' no topo da tela, representa que esse cliente precisa receber informações de previsão de vendas e estará disponível quando o cliente estiver na tabela '''cliente previsão'''.

[[Arquivo:Tela 2.png|200px]]

Na tela o sistema já exibirá o mes e ano da previsão a ser cadastrada. Exibirá sempre o mês seguinte em relação ao mês atual e que o vendedor precisa informar os dados de previsão de vendas.

O campo sequencia visita será informando de forma sequencia onde o vendedor não poderá repetir, caso já tenha informado aquele valor na data selecionada.

O campo Compoe Prev, sempre que estiver desmarcado que representará não o campo observação será obrigatório para preenchimento. 

[[Arquivo:Tela 3.png|200px]]

*Na aba de ações o vendedor poderá informar valor e uma breve descrição de ação que o mesmo fará naquele cliente.

*O vendedor poderá digitar quantas ações quiser.

[[Arquivo:Previsao4.png|200px]]

As colunas a serem exibidas estão na tabela DADOS_PREVIÇAO. Esta tabela será populada atraves de integração.

Os campos abaixa ao selecionar uma linha, poderão ser preenchidos e estarão disparando calculos para atualizar campos abaixos informados.  

*VR_PROPOSTA  -> DEVERÁ SER DIGITADO PELO O USUARIO 
*PC_BONIFICACAO -> DEVERÁ SER DIGITADO PELO O USUARIO
*PC_DESC EM NF     -> DEVERÁ SER DIGITADO PELO O USUARIO

*Assim que o usuário inserir informações no campo VR_PROPOSTA, os campos abaixo deverão realizar a seguinte conta:
**VR_VOLUME = VR_PROPOSTA * NR_LITROS
**VR_RECEITA = VR_PROPOSTA * PC UNITARIO

*Assim que o usuário inserir informações no campo PC_BONIFICACAO e o campo VR_PROPOSTA for maior que zero, os campos abaixo deverão realizar a seguinte conta:

**PC_COND_TOTAL  =	(((100 - PC_BONIFICACAO%)- VR_RECEITA%)-100) = RESULTADO) ESTE RESULTADO É PERCENTUAL
**VR_VERBA = (VR_RECEITA - PC_BONIFICACAO) - VR_RECEITA% = RESULTADO) ESTE CAMPO É VALOR
**VERBA BONIFI = (PC_BONIFICACAO * VR_RECEITA) / 100

*Assim que o usuário inserir informações no campo PC_DESC EM NF e o campo VR_PROPOSTA for maior que zero, os campos abaixo deverão realizar a seguinte conta:
**VR_VERBA = VR_VERBA + (PC_DESC EM NF * VR_RECEITA) / 100
**VERBA DESC = (PC_BONIFICACAO * VR_RECEITA) / 100


'''Para os campos da Bússola usar as seguintes regras:'''

'''Volume:''' Realizar a soma referente a coluna “Volume” dos produtos que foram digitados.

'''BudGet Geral:''' Soma total do campo VERBA + total do campo AÇÃO dividido pela soma total do campo RECEITA * 100.

'''BudGet Desc:''' Soma total do campo VERBA DESC dividido pela soma total do campo RECEITA * 100.

'''BudGet Bonificação:''' Soma total do campo VERBA BONIF dividido pela soma total do campo RECEITA * 100.

'''BudGet Ação:''' Total do campo AÇÃO dividido pela soma total do campo RECEITA * 100.

'''Verba Bonificação:''' Soma total do campo VERBA BONIF.


[[Arquivo:Tela 5.png|200px]]

Opção ficará no topo da tela que permitirá o usuario realizar filtros para ajudar na seleção e preenchimento dos campos.


Obs.: Todas as imagens acima, no momento do desenvolvimento pode sofrer alguma alteração, em virtude de viabilidade técnica.

'''Tabelas a serem criadas.'''

{| class="wikitable"
! colspan="5"  | CLIENTE_PREVISAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|- 
| CD_PREVISAO
| INT
| NAO
| NAO
| Código da previsao
|- 
| CD_CLIENTE
| INT
| NAO
| NAO
| Código do cliente
|- 
| MES_ANO_PREVISAO
| DATETIME
| NAO
| NAO
| Mes/Ano Previsão
|-
|}


{| class="wikitable"
! colspan="5"  | PREVISAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|- 
| CD_PREVISAO
| INT
| NAO
| NAO
| Código da previsao
|- 
| CD_VENDEDOR
| INT
| NAO
| NAO
| Código do vendedor
|-
| CD_ST_PREVISAO
| INT
| SIM
| NAO
| Status da Previsão
|-
| DT_PREV_VISITA
| DATETIME
| NAO
| NAO
| Data de visita
|-
| NR_SEQ_VISITA
| INT
| NAO
| NAO
| Data de visita
|-
| ID_COMPOE_PREV
| VARCHAR
| NAO
| NAO
| Compoe previsão
|-
| DS_OBS_COMPOE_PREV
| VARCHAR
| NAO
| NAO
| Observação do compoe prev
|-
| ID_EFETIVADO
| VARCHAR
| NAO
| NAO
| Controla efetivação da previsao
|-
|}




{| class="wikitable"
! colspan="5"  | ACAO_PREVISAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|- 
| CD_ACAO
| INT
| NAO
| NAO
| Código da ação
|- 
| DS_DESCRICAO_ACAO
| VARCHAR
| NAO
| NAO
| Descrição para ação
|-
| VR_ACAO
| DECIMAL
| NAO
| NAO
| Valor da Ação
|-
| CD_CLIENTE
| INT
| NAO
| NAO
| Código do cliente
|-  
| CD_VENDEDOR
| INT
| NAO
| NAO
| Código do vendedor
|-   
| MES_ANO_ACAO
| DATETIME
| NAO
| NAO
| Código do cliente
|- 
| CD_PREVISAO
| INT
| NAO
| NAO
| Código da previsao 
|- 
|}



{| class="wikitable"
! colspan="5"  | DADOS_PREVISAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PREVISAO
| INT
| NAO
| NAO
| Código da previsao
|-
| CD_CLIENTE
| INT
| NAO
| NAO
| Código do cliente.
|-  
| DS_DESCRICAO
| VARCHAR
| NAO
| NAO
| Descrição da familia 
|- 
| DS_LINHA
| VARCHAR
| NAO
| NAO
| Linha
|- 
| DS_UNIDADE
| VARCHAR
| NAO
| NAO
| Unidade
|-
| NR_LITROS
| DECIMAL
| NAO
| NAO
| Litros
|-
| QT_PROP_MES ANT
| DECIMAL
| NAO
| NAO
| Proposta do mes anterior
|-
| QT_REALIZADO
| DECIMAL
| NAO
| NAO
| Realizado no mes
|-
| VR_BON. MÊS ANT
| DECIMAL
| NAO
| NAO
| Bon Mes ant
|-
| PC_DESC MÊS ANT
| DECIMAL
| NAO
| NAO
| desc Mes Ant
|-
| COND MÊS ANT
| DECIMAL
| NAO
| NAO
| Código do Mes ant
|-
| MEDIA TRIMES
| DECIMAL
| NAO
| NAO
| Media Trimestre
|-
| VR_PROPOSTA
| DECIMAL
| NAO
| NAO
| Proposta
|-
| VR_VOLUME
| DECIMAL
| NAO
| NAO
| Volume
|-
| PC_BONIFICACAO
| DECIMAL
| NAO
| NAO
| Bonificação
|-
| PC_DESC EM NF
| DECIMAL
| NAO
| NAO
| Desc em NF
|-
| PC_COND_TOTAL
| DECIMAL
| NAO
| NAO
| COND. TOTAL
|-
| PC UNITARIO
| DECIMAL
| NAO
| NAO
| Prc Unitario
|-
| VR_RECEITA
| DECIMAL
| NAO
| NAO
| Receita(R$)
|-
| VR_VERBA
| DECIMAL
| NAO
| NAO
| Verbas(R$)
|-
| REGRA NEG
| INT
| NAO
| NAO
| Regra Neg
|-
| VERBA DESC
| DECIMAL
| NAO
| NAO
| Verba Desc
|-
| VERBA BONIFI
| DECIMAL
| NAO
| NAO
| Verba Bonifi
|-
| CD_TABELA PRC
| INT
| NAO
| NAO
| Tabela prc
|-
| PC_TABELA
| DECIMAL
| NAO
| NAO
| PRC.TABELA
|-
| VP COMPOE
| DECIMAL
| NAO
| NAO
| VP COMPOE
|-
| VP NCOMPOE
| DECIMAL
| NAO
| NAO
| VP NCOMPOE
|-
| ALIAS WT
| VARCHAR
| NAO
| NAO
| ALIAS WT
|-
| CD_RECNO WT
| VARCHAR
| NAO
| NAO
| RECNO WT
|-
|}



{| class="wikitable"
! colspan="5"  | PREVISÃO STATUS
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|- 
| CD_ST_PREVISAO
| INT
| SIM
| NAO
| Código do lote
|- 
| DS_ST_PREVISAO
| VARCHAR
| NAO
| NAO
| Código do lote
|- 
|}

==Regras de Negócio==

'''RN1''' - O vendedor informará sempre a previsão de venda do mês seguinte ao mês vigente.


'''RN2''' - A ordem de visita será única no dia, uma vez a ordem usada naquele dia, ela não poderá repetir.


'''RN3''' - Sempre que o valor Vr_proposta for informando os campos em que existe calculo com esse campo, precisam ser atualizados.


'''RN4''' - Na ausência da configuração '''ID_CADASTRA_PREVISAO''', o sistema terá o comportamento de DS_VALOR igual a "N"


'''RN5''' - Quando o campo compoe prev estiver como não é obrigatório o preenchimento de observação.


'''RN6''' - Após a previsão está efetivada,não será possivel realizar modificação na mesma.

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

{| class="wikitable"
! style="width:200px" |Setor 
! Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|- 
| Gerente TI
| 
|
|
|- 
| Gerente Projeto
| 
|
|
|- 
| Gerente Comercial
| 
|
|
|}