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

Clientes Ordenados por Atendimento

2018-06-12T20:51:53Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 12/06/2018 || Renato Lima || Criação do Documento
|-
| 12/06/2018 || Marcus Fabio Salviano || Validado pelo desenvolvimento
|-
|}

== Necessidade ==
Ao clicar no botão ‘Atender clientes’, vendedor precisa visualizar esses clientes por ordem de percurso. Essa visualização deve acontecer de forma automática, ou seja, sem que haja intervenção manual.
Atualmente o campo de 'Sequência de atendimento’ pode ser visualizado aleatoriamente, sendo a lista ordenada por cliente.Para que a lista seja ordenada levando em consideração a sequencia de atendimento, o usuário deve clicar no campo ‘Seq.’, ordenando a lista por ordem crescente.Porém, ao sair do aplicativo e entrar novamente em um outro momento, o vendedor deve novamente clicar no campo ‘Seq.’ para ordenar a lista. A Reflexa necessita que essa ordenação seja feita de forma automática, e que, ao invés de ordenar a lista por cliente, seja ordenada por sequência de atendimento, sem que seja necessário o vendedor clicar em nenhum campo.

== Solução ==
Será feita uma customização no GeoSales Mobile, que permita ao vendedor visualizar a lista de clientes ordenada conforme está especificado neste documento.
Essa ordenação se dará, de forma padrão para a Reflexa, por sequência de atendimento.
Ao clicar no botão ‘Atender Clientes’ a tela que contém a grid com a lista de clientes disponíveis será visualizada por ordem de atendimento.

== Implementação ==
A implementação irá acontecer da seguinte maneira:

Será criada uma configuração onde a mesma receberá o valor do nome da coluna da tela inicial de atendimento ao cliente, que servirá para ordenar a lista de clientes.

A Configuração se chamará: '''ID_ORDENA_CLIENTE_ATENDIMENTO'''

A configuração poderá receber os seguintes valores:
*'''CODIGO''' - Ordenará pela coluna codigo
*'''CLIENTE''' - Ordenará pela coluna cliente
*'''SEQUENCIA''' - Ordenará pela coluna sequencia.

Na ausência desta configuração, ou a mesma com o DS_VALOR null, o sistema respeitara o comportamento padrão.

==Regras de Negócio==

'''RN1 - ''' Ao ter a configuração '''ID_ORDENA_CLIENTE_ATENDIMENTO''', o sistema ordenará a lista de cliente do menor para o maior de acordo com o valor inserido no '''DS_VALOR'''.
'''O DS_VALOR poderá receber os seguintes valores:'''
CODIGO - Ordenará pela coluna codigo
CLIENTE - Ordenará pela coluna cliente
SEQUENCIA - Ordenará pela coluna sequencia.

'''RN2 - ''' Com a configuração inserida, o sistema irá ordena do menor para o maior.

'''RN3 - ''' Com o uso da configuração, mas o DS_VALOR Null, o sistema exibirá conforme padrão do sistema.

'''RN4 - ''' A configuração se aplicará apenas para Mobile.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Clientes Ordenados por Atendimento

2018-06-12T20:51:32Z

Marcus.salviano: /* Regras de Negócio */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 12/06/2018 || Renato Lima || Criação do Documento
|-
| XX/XX/XXX || Marcus Fabio Salviano || Validado pelo desenvolvimento
|-
|}

== Necessidade ==
Ao clicar no botão ‘Atender clientes’, vendedor precisa visualizar esses clientes por ordem de percurso. Essa visualização deve acontecer de forma automática, ou seja, sem que haja intervenção manual.
Atualmente o campo de 'Sequência de atendimento’ pode ser visualizado aleatoriamente, sendo a lista ordenada por cliente.Para que a lista seja ordenada levando em consideração a sequencia de atendimento, o usuário deve clicar no campo ‘Seq.’, ordenando a lista por ordem crescente.Porém, ao sair do aplicativo e entrar novamente em um outro momento, o vendedor deve novamente clicar no campo ‘Seq.’ para ordenar a lista. A Reflexa necessita que essa ordenação seja feita de forma automática, e que, ao invés de ordenar a lista por cliente, seja ordenada por sequência de atendimento, sem que seja necessário o vendedor clicar em nenhum campo.

== Solução ==
Será feita uma customização no GeoSales Mobile, que permita ao vendedor visualizar a lista de clientes ordenada conforme está especificado neste documento.
Essa ordenação se dará, de forma padrão para a Reflexa, por sequência de atendimento.
Ao clicar no botão ‘Atender Clientes’ a tela que contém a grid com a lista de clientes disponíveis será visualizada por ordem de atendimento.

== Implementação ==
A implementação irá acontecer da seguinte maneira:

Será criada uma configuração onde a mesma receberá o valor do nome da coluna da tela inicial de atendimento ao cliente, que servirá para ordenar a lista de clientes.

A Configuração se chamará: '''ID_ORDENA_CLIENTE_ATENDIMENTO'''

A configuração poderá receber os seguintes valores:
*'''CODIGO''' - Ordenará pela coluna codigo
*'''CLIENTE''' - Ordenará pela coluna cliente
*'''SEQUENCIA''' - Ordenará pela coluna sequencia.

Na ausência desta configuração, ou a mesma com o DS_VALOR null, o sistema respeitara o comportamento padrão.

==Regras de Negócio==

'''RN1 - ''' Ao ter a configuração '''ID_ORDENA_CLIENTE_ATENDIMENTO''', o sistema ordenará a lista de cliente do menor para o maior de acordo com o valor inserido no '''DS_VALOR'''.
'''O DS_VALOR poderá receber os seguintes valores:'''
CODIGO - Ordenará pela coluna codigo
CLIENTE - Ordenará pela coluna cliente
SEQUENCIA - Ordenará pela coluna sequencia.

'''RN2 - ''' Com a configuração inserida, o sistema irá ordena do menor para o maior.

'''RN3 - ''' Com o uso da configuração, mas o DS_VALOR Null, o sistema exibirá conforme padrão do sistema.

'''RN4 - ''' A configuração se aplicará apenas para Mobile.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Projeto/Reflexa/Documentação/Alerta Validação de controle de limite de credito

2018-06-12T18:02:17Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/05/2018 || Renato Lima || Criação do Documento
|-
| 12/06/2018 || Marcus Fabio Salviano || Validado pelo desenvolvimento
|-
|}

== Necessidade ==
Cliente solicitou que no momento de inserir um item no pedido e que ele tenha excedido o limite de crédito do cliente, seja apresentado alerta ao vendedor apresentando a informação, sem que seja necessário o vendedor venha finalizar o pedido para que o alerta seja apresentado.

== Solução ==
No momento em que o vendedor estiver adicionando os itens do pedido, o sistema validará o limite de credito, antes do vendedor realizar o processo de salvar pedido. Assim o vendedor terá retorno se o limite foi excedido ou não antes de salvar o pedido.

== Implementação ==

O Geosales no momento de inserção dos itens, ao atingir o limite de credito do cliente, apresentará uma mensagem informando que o limite de credito foi atingido.

Será criada a configuração '''ID_VALIDA_LIMITE_CREDITO_ITEM''', que será inserida na tabela de '''Configuracao'''.
A configuração receberá '''S''' ou '''N''' no '''DS_VALOR''' e poderá ser sincronizada, para habilitar a validação no mobile.

Com a configuração inserida e o '''DS_VALOR''' igual a '''S''',o sistema realizará a validação, no momento da inserção do item.
Se o item inserido, fizer com que o valor pedido atinja o limite de credito do cliente disponivel, o sistema apresentará mensagem.

Mensagem:Limite de crédito disponível, foi consumido.

Quando da ausência da configuração ou a mesma estiver com o '''DS_VALOR''' igual a '''N''' ou '''null''',deve-se manter o comportamento original, validando o limite de credito, apenas no momento de salvar o pedido.

==Regras de Negócio==

'''RN1 - ''' Sistema irá validar limite de credito através da inserção do item, quando tiver a configuração '''ID_VALIDA_LIMITE_CREDITO_ITEM'''.

'''RN2 - ''' Quando não tiver a configuração '''ID_VALIDA_LIMITE_CREDITO_ITEM''' ou a mesma estiver igual a N ou null o sistema deve manter a validação no momento de salvar o pedido.

'''RN3 - ''' Validação deverá ser usada, quando o cliente optar em realizar o controle de limite de credito.

'''RN4 - ''' O controle por item pode acontecer, mesmo que tenha o controle de limite de credito ao salvar o pedido.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Aplicação de itens no pedido

2018-06-11T21:04:44Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/05/2018 || Ryvane Maria || Criação do Documento
|-
| 28/05/2018 || Marcus Fábio Salviano || Aprovação do Documento pelo Desenvolvimento
|-
| 28/05/2018 || Jardel Sampaio || Validado pela integração
|-
| 28/05/2018 || Ryvane Maria || Inclusão de novos tipos de movimento
|-
| 11/06/2018 || Marcus Fábio Salviano || Aprovação das Alterações no Documento pelo Desenvolvimento
|-
|}

== Necessidade ==

Ao passo da criação de novos pedidos, podem existir diferentes aplicações para um mesmo produto, em pedidos diferentes ou em um mesmo pedido.

Uma aplicação é definida conforme a destinação daquele produto, ou seja, onde ele será aplicado. Por exemplo, um mesmo produto "Ração" pode ter sua aplicação voltada para bovinos ou suínos. Esta aplicação, por sua vez, interfere no cálculo de imposto daquele produto e na seleção da TES na importação do pedido.

É necessário que seja possível, para um mesmo produto, selecionar aplicações diferentes, com a finalidade de realizar cálculo de imposto e seleção de TES, na importação do pedido, de forma diferenciada, conforme a aplicação do item.

Selecionar a aplicação de cada item do pedido, conforme sua destinação, possibilitando o cálculo diferenciado do imposto e a seleção da TES na importação do pedido.

== Solução ==

Para que isso seja possível, serão adicionados novos tipos de movimento para itens, de forma a categorizar a aplicação de cada item.

Ao inserir um item em um pedido, o usuário deverá selecionar o 'Tipo Item' que definirá a aplicação daquele produto. Desta forma, a partir do tipo de movimento do item, será possível definir, baseando-se em dados que serão manipulados exclusivamente no ERP, a tributação que será utilizada para cada tipo de aplicação.

== Implementação ==

'''- Criação de novos tipos de movimento de itens:'''

Inicialmente, deverão ser criados novos tipos de movimento, com a finalidade de definir a aplicação de cada item, para todos os tipos de movimento utilizados: Venda, Bonificação, Venda a ordem e Venda futura.

{| class="wikitable"
! CD_TIPO
! DS_TIPO
! CD_TIPO_PAI
! ID_MOVIMENTO_ITEM
! ID_UTILIZAVEL
! OBSERVAÇÃO
|-
| A1 || Aves Postura
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| C1 || Aves Corte
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| S1 || Suíno
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| B1 || Bovinos Leite
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| K1 || Bovinos Corte
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| P1 || Pet
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| Q1 || Aquacultura
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| O1 || Outros
| 1
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda'
|-
| A2 || Aves Postura
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| C2 || Aves Corte
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| S2 || Suíno
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| B2 || Bovinos Leite
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| K2 || Bovinos Corte
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| P2 || Pet
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| Q2 || Aquacultura
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| O2 || Outros
| 2
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Bonificação'
|-
| A3 || Aves Postura
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| C3 || Aves Corte
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| S3 || Suíno
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| B3 || Bovinos Leite
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| K3 || Bovinos Corte
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| P3 || Pet
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| Q3 || Aquacultura
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| O3 || Outros
| 3
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda a ordem'
|-
| A4 || Aves Postura
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
| C4 || Aves Corte
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
| S4 || Suíno
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
| B4 || Bovinos Leite
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
| K4 || Bovinos Corte
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
| P4 || Pet
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
| Q4 || Aquacultura
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
| O4 || Outros
| 4
| S
| N
| Destinado a aplicação de itens para pedidos do tipo 'Venda futura'
|-
|}

Cada tipo de movimento de item explicitado acima definirá, no ERP, o cálculo de imposto diferenciado que será aplicado sob o item no ERP, além da TES que será selecionada na importação do pedido.

Para o funcionamento correto da funcoinalidade, os tipos de movimento de pedido existentes devem ser configurados da seguinte forma:

{| class="wikitable"
! CD_TIPO
! DS_TIPO
! ID_MOVIMENTO_ITEM
! ID_UTILIZAVEL
! OBSERVAÇÃO
|-
| 1 || Venda || N || S || Destinado a pedidos do tipo 'Venda'
|-
| 2 || Bonificação || N || S || Destinado a pedidos do tipo 'Bonificação '
|-
| 3 || Venda a ordem || N || S || Destinado a pedidos do tipo 'Venda a ordem'
|-
| 4 || Venda futura || N || S || Destinado a pedidos do tipo 'Venda futura'
|}

'''- Integração dos dados de aplicação do item para o ERP: '''

Para que sejam calculadas as devidas tributações no ERP, é necessário associar cada item ao seu tipo de movimento. Essa associação será feita através do campo CD_TIPO_PEDIDO da tabela ITEM_PEDIDO.

Neste campo deverão ser enviadas as informações do tipo de movimento, para cada item inserido no pedido. Isso será possível salvando neste campo o código do tipo de movimento, que será definido através do campo CD_TIPO da tabela TIPO_MOVIMENTO_PEDIDO. No momento da integração, ao enviar o CD_TIPO, é necessário separar o código, retirando o referencial numérico e salvando no ERP apenas a letra correspondente (A,C,S,B,K,P,Q,O).

'''- Aplicação de impostos referentes a cada tipo de movimento de item no ERP: '''

Com a informação do código do tipo de movimento, será calculado, no ERP, as tributações pertinentes a cada aplicação de item.

==Regras de Negócio==

'''RN1 - ''' As tributações referentes a cada tipo de aplicação de item serão calculadas no ERP, e, para que isso seja possível, será de responsabilidade da GeoSales enviar o tipo de aplicação utilizada para cada item.

'''RN2 - ''' O campo CD_TIPO_PAI deve ser preenchido com o tipo de pedido selecionado para o pedido original.

'''RN3 - ''' O campo ID_MOVIMENTO_ITEM deve ser preenchido com o valor 'S' e o campo ID_UTILIZAVEL deve ser preenchido com o valor 'N'.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Calculo Frete Peso total e ranger -ANHAMBI

2018-06-11T20:31:59Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/05/2018 || Renato Lima || Criação do Documento
|-
| 29/05/2018 || Marcus Fabio || Validado pelo desenvolvimento
|-
| 11/06/2018 || Renato Lima || Criar campo na tabela de cliente, tratar integração do campo e comportamento do calculo do frete.
|-
| 11/06/2018 || Marcus Fabio || Validação das alterações pelo desenvolvimento
|-
|}

== Necessidade ==
Customização do cálculo de frete, utilizando três parâmetros principais, código do cliente, código da loja e peso do pedido, concomitantemente, verificar esta viabilidade no portal GeoSales. Há necessidade de ajustar os atuais parâmetros de cálculo de frete do Portal GeoSales com o padrão de apuração do ERP Protheus, o qual utiliza como dado o peso total do pedido, de outro modo do atual, que se baseia no peso por item no pedido.

== Solução ==
Deverá realizar a criação de uma nova regra de cálculo de frete, em que o sistema GeoSales usará como base as informações do cliente, da loja e do peso total do pedido para calcular o valor do frete.

== Integração ==

O cliente utiliza o '''GFE''' de calculo de Frete do Protheus.

O cliente tem no modulo emitente as informações de Cod do cliente, Loja e Codigo da Cidade do cliente (GU3 TABELA DE EMITENTES),
onde esse pontos irão definir a partir de que rota aquele pedido será atendido.

Na tabela '''GUA''' teremos o cadastro de Regiões x Cidades, a partir dessa tabela iremos montar o nosso cadastro de Região e Praça.
Já as tabelas GV6 e GV1, iremos montar nossas tabelas FRETE e FAIXA_PRECO_FRETE

No momento de integrar o valor do pedido o integrador deve observar a seguinte regra:

Deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.
* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5_X_VFRET
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

O campo '''A1_X_DFRET''' do protheus deve ser integrado a tabela de cliente no novo campo ID_COMPOE_CALC_FRETE que vai receber o valor se acordo com o protheus. Que poderá ser S, N ou NULL

== Implementação ==

O calculo do frete deve ocorrer conforme formula abaixo:

Valor do Frete = (Tarifa Base) x Peso total do pedido
1000
Onde:
Tarifa base será o valor populado no campo VR_PRECO_KG da tabela FAIXA_PRECO_FRETE
Fator de divisão = 1000
Peso do pedido = Peso total do pedido.

Exemplo:

Cliente - 0001
Inseriu pedido com dois itens:
Item 1: 10 unidades pesando 100 quilos cada unidade, total de 1000 quilos.
Item 2: 05 unidades pesando 100 quilos cada unidade, total de 500 quilos.
Total de peso do pedido: 1500 quilos.
Tarifa Base = R$ 163,28
Fator de divisão = 1000
Preço do Frete = R$ 244,92

Ao ter peso total do pedido, será verificado na FAIXA_PRECO_PRODUTO, qual opção de faixa se encaixa, para aquele pedido, de acordo com seu peso, região e praça.

Após realizar o calculo do frete, deve verificar o campo ID_COMPOE_CALC_FRETE da tabela de clientes, se este campo estiver como '''S''' o valor do frente deverá ter os seguintes comportamentos:
* Não deve ser exibido para o vendedor;
* Não deve compor o valor do pedido.

'''Tabelas a serem alteradas:'''

{| class="wikitable"
! colspan="5" | CLIENTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_COMPOE_CALC_FRETE
| CHAR(1)
| NAO
| NAO
| Campo para informar se o valor do frete será exibido e comporá o valor do pedido.
|-
|}

== Regras de integração ==

'''[RI1]''' – No momento de integrar o valor do frete, o sistema deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.

* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5_X_VFRET
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

'''[RI2]''' – O campo '''A1_X_DFRET''' do protheus deve ser integrado a tabela de cliente no novo campo ID_COMPOE_CALC_FRETE

==Regras de Negócio==

'''RN1 - ''' Para realizar o calculo do frete deve ser levado em consideração o Peso total do itens inseridos do pedido.

'''RN2 - ''' Para que o calculo de frete funcione corretamente, todos os produtos cadastrados devem ter seu peso cadastrado.

'''RN3 - ''' Sempre que houver alteração no peso do pedido o valor do frete deve ser atualizado.

'''RN4 - ''' Para que o vendedor consiga visualizar o peso total do pedido, deve habilitar a configuração ID_MOSTRAR_COLUNA_PESO=S.

'''RN5 - ''' Quando o campo ID_COMPOE_CALC_FRETE estiver como '''S''', o valor de frete calculado, não deve ser apresentado para o vendedor e não deverá compor no valor final do pedido.

'''RN6 - ''' Quando o campo ID_COMPOE_CALC_FRETE estiver como '''N''' ou '''NULL''', o valor de frete calculado, deve ser apresentado para o vendedor e deverá compor o valor final do pedido.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Calculo Frete Peso total e ranger -ANHAMBI

2018-06-11T20:31:20Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/05/2018 || Renato Lima || Criação do Documento
|-
| 29/05/2018 || Marcus Fabio || Validado pelo desenvolvimento
|-
| 11/06/2018 || Renato Lima || Criar campo na tabela de cliente, tratar integração do campo e comportamento do calculo do frete.
|-
|}

== Necessidade ==
Customização do cálculo de frete, utilizando três parâmetros principais, código do cliente, código da loja e peso do pedido, concomitantemente, verificar esta viabilidade no portal GeoSales. Há necessidade de ajustar os atuais parâmetros de cálculo de frete do Portal GeoSales com o padrão de apuração do ERP Protheus, o qual utiliza como dado o peso total do pedido, de outro modo do atual, que se baseia no peso por item no pedido.

== Solução ==
Deverá realizar a criação de uma nova regra de cálculo de frete, em que o sistema GeoSales usará como base as informações do cliente, da loja e do peso total do pedido para calcular o valor do frete.

== Integração ==

O cliente utiliza o '''GFE''' de calculo de Frete do Protheus.

O cliente tem no modulo emitente as informações de Cod do cliente, Loja e Codigo da Cidade do cliente (GU3 TABELA DE EMITENTES),
onde esse pontos irão definir a partir de que rota aquele pedido será atendido.

Na tabela '''GUA''' teremos o cadastro de Regiões x Cidades, a partir dessa tabela iremos montar o nosso cadastro de Região e Praça.
Já as tabelas GV6 e GV1, iremos montar nossas tabelas FRETE e FAIXA_PRECO_FRETE

No momento de integrar o valor do pedido o integrador deve observar a seguinte regra:

Deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.
* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5_X_VFRET
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

O campo '''A1_X_DFRET''' do protheus deve ser integrado a tabela de cliente no novo campo ID_COMPOE_CALC_FRETE que vai receber o valor se acordo com o protheus. Que poderá ser S, N ou NULL

== Implementação ==

O calculo do frete deve ocorrer conforme formula abaixo:

Valor do Frete = (Tarifa Base) x Peso total do pedido
1000
Onde:
Tarifa base será o valor populado no campo VR_PRECO_KG da tabela FAIXA_PRECO_FRETE
Fator de divisão = 1000
Peso do pedido = Peso total do pedido.

Exemplo:

Cliente - 0001
Inseriu pedido com dois itens:
Item 1: 10 unidades pesando 100 quilos cada unidade, total de 1000 quilos.
Item 2: 05 unidades pesando 100 quilos cada unidade, total de 500 quilos.
Total de peso do pedido: 1500 quilos.
Tarifa Base = R$ 163,28
Fator de divisão = 1000
Preço do Frete = R$ 244,92

Ao ter peso total do pedido, será verificado na FAIXA_PRECO_PRODUTO, qual opção de faixa se encaixa, para aquele pedido, de acordo com seu peso, região e praça.

Após realizar o calculo do frete, deve verificar o campo ID_COMPOE_CALC_FRETE da tabela de clientes, se este campo estiver como '''S''' o valor do frente deverá ter os seguintes comportamentos:
* Não deve ser exibido para o vendedor;
* Não deve compor o valor do pedido.

'''Tabelas a serem alteradas:'''

{| class="wikitable"
! colspan="5" | CLIENTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_COMPOE_CALC_FRETE
| CHAR(1)
| NAO
| NAO
| Campo para informar se o valor do frete será exibido e comporá o valor do pedido.
|-
|}

== Regras de integração ==

'''[RI1]''' – No momento de integrar o valor do frete, o sistema deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.

* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5_X_VFRET
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

'''[RI2]''' – O campo '''A1_X_DFRET''' do protheus deve ser integrado a tabela de cliente no novo campo ID_COMPOE_CALC_FRETE

==Regras de Negócio==

'''RN1 - ''' Para realizar o calculo do frete deve ser levado em consideração o Peso total do itens inseridos do pedido.

'''RN2 - ''' Para que o calculo de frete funcione corretamente, todos os produtos cadastrados devem ter seu peso cadastrado.

'''RN3 - ''' Sempre que houver alteração no peso do pedido o valor do frete deve ser atualizado.

'''RN4 - ''' Para que o vendedor consiga visualizar o peso total do pedido, deve habilitar a configuração ID_MOSTRAR_COLUNA_PESO=S.

'''RN5 - ''' Quando o campo ID_COMPOE_CALC_FRETE estiver como '''S''', o valor de frete calculado, não deve ser apresentado para o vendedor e não deverá compor no valor final do pedido.

'''RN6 - ''' Quando o campo ID_COMPOE_CALC_FRETE estiver como '''N''' ou '''NULL''', o valor de frete calculado, deve ser apresentado para o vendedor e deverá compor o valor final do pedido.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Calculo Frete Peso total e ranger -ANHAMBI

2018-05-29T20:38:45Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/05/2018 || Renato Lima || Criação do Documento
|-
| 29/05/2018 || Marcus Fabio || Validado pelo desenvolvimento
|-
|}

== Necessidade ==
Customização do cálculo de frete, utilizando três parâmetros principais, código do cliente, código da loja e peso do pedido, concomitantemente, verificar esta viabilidade no portal GeoSales. Há necessidade de ajustar os atuais parâmetros de cálculo de frete do Portal GeoSales com o padrão de apuração do ERP Protheus, o qual utiliza como dado o peso total do pedido, de outro modo do atual, que se baseia no peso por item no pedido.

== Solução ==
Deverá realizar a criação de uma nova regra de cálculo de frete, em que o sistema GeoSales usará como base as informações do cliente, da loja e do peso total do pedido para calcular o valor do frete.

== Integração ==

O cliente utiliza o '''GFE''' de calculo de Frete do Protheus.

O cliente tem no modulo emitente as informações de Cod do cliente, Loja e Codigo da Cidade do cliente (GU3 TABELA DE EMITENTES),
onde esse pontos irão definir a partir de que rota aquele pedido será atendido.

Na tabela '''GUA''' teremos o cadastro de Regiões x Cidades, a partir dessa tabela iremos montar o nosso cadastro de Região e Praça.
Já as tabelas GV6 e GV1, iremos montar nossas tabelas FRETE e FAIXA_PRECO_FRETE

No momento de integrar o valor do pedido o integrador deve observar a seguinte regra:

Deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.
* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5X_VFRETE
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

== Implementação ==

O calculo do frete deve ocorrer conforme formula abaixo:

Valor do Frete = (Tarifa Base) x Peso total do pedido
1000
Onde:
Tarifa base será o valor populado no campo VR_PRECO_KG da tabela FAIXA_PRECO_FRETE
Fator de divisão = 1000
Peso do pedido = Peso total do pedido.

Exemplo:

Cliente - 0001
Inseriu pedido com dois itens:
Item 1: 10 unidades pesando 100 quilos cada unidade, total de 1000 quilos.
Item 2: 05 unidades pesando 100 quilos cada unidade, total de 500 quilos.
Total de peso do pedido: 1500 quilos.
Tarifa Base = R$ 163,28
Fator de divisão = 1000
Preço do Frete = R$ 244,92

Ao ter peso total do pedido, será verificado na FAIXA_PRECO_PRODUTO, qual opção de faixa se encaixa, para aquele pedido, de acordo com seu peso, região e praça.

== Regras de integração ==

'''[RI1]''' – No momento de integrar o valor do frete, o sistema deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.

* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5X_VFRETE
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

==Regras de Negócio==

'''RN1 - ''' Para realizar o calculo do frete deve ser levado em consideração o Peso total do itens inseridos do pedido.

'''RN2 - ''' Para que o calculo de frete funcione corretamente, todos os produtos cadastrados devem ter seu peso cadastrado.

'''RN3 - ''' Sempre que houver alteração no peso do pedido o valor do frete deve ser atualizado.

'''RN4 - ''' Para que o vendedor consiga visualizar o peso total do pedido, deve habilitar a configuração ID_MOSTRAR_COLUNA_PESO=S.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Calculo Frete Peso total e ranger -ANHAMBI

2018-05-29T20:34:49Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/05/2018 || Renato Lima || Criação do Documento
|-
| XX/05/2018 || Marcus Fabio || Validado pelo desenvolvimento
|-
|}

== Necessidade ==
Customização do cálculo de frete, utilizando três parâmetros principais, código do cliente, código da loja e peso do pedido, concomitantemente, verificar esta viabilidade no portal GeoSales. Há necessidade de ajustar os atuais parâmetros de cálculo de frete do Portal GeoSales com o padrão de apuração do ERP Protheus, o qual utiliza como dado o peso total do pedido, de outro modo do atual, que se baseia no peso por item no pedido.

== Solução ==
Deverá realizar a criação de uma nova regra de cálculo de frete, em que o sistema GeoSales usará como base as informações do cliente, da loja e do peso total do pedido para calcular o valor do frete.

== Integração ==

O cliente utiliza o '''GFE''' de calculo de Frete do Protheus.

O cliente tem no modulo emitente as informações de Cod do cliente, Loja e Codigo da Cidade do cliente (GU3 TABELA DE EMITENTES),
onde esse pontos irão definir a partir de que rota aquele pedido será atendido.

Na tabela '''GUA''' teremos o cadastro de Regiões x Cidades, a partir dessa tabela iremos montar o nosso cadastro de Região e Praça.
Já as tabelas GV6 e GV1, iremos montar nossas tabelas FRETE e FAIXA_PRECO_FRETE

No momento de integrar o valor do pedido o integrador deve observar a seguinte regra:

Deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.
* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5X_VFRETE
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

== Implementação ==

O calculo do frete deve ocorrer conforme formula abaixo:

Valor do Frete = (Tarifa Base) x Peso total do pedido
1000
Onde:
Tarifa base será o valor populado no campo VR_PRECO_KG da tabela FAIXA_PRECO_FRETE
Fator de divisão = 1000
Peso do pedido = Peso total do pedido.

Exemplo:

Cliente - 0001
Inseriu pedido com dois itens:
Item 1: 10 unidades pesando 100 quilos cada unidade, total de 1000 quilos.
Item 2: 05 unidades pesando 100 quilos cada unidade, total de 500 quilos.
Total de peso do pedido: 1500 quilos.
Tarifa Base = R$ 163,28
Fator de divisão = 1000
Preço do Frete = R$ 244,92

Ao ter peso total do pedido, será verificado na FAIXA_PRECO_PRODUTO, qual opção de faixa se encaixa, para aquele pedido, de acordo com seu peso, região e praça.

== Regras de integração ==

'''[RI1]''' – No momento de integrar o valor do frete, o sistema deve verificar o campo '''A1_X_DFRET''' que recebe os valores '''S''' ou '''N'''.

* Quando o campo '''A1_X_DFRET = S''' o valor do frete deve ser integrado no campo C5X_VFRETE
* Quando o '''A1_X_DFRET = N ou NULL''' o valor do frete deve ser integrado no campo C5_FRETE

==Regras de Negócio==

'''RN1 - ''' Para realizar o calculo do frete deve ser levado em consideração o Peso total do itens inseridos do pedido.

'''RN2 - ''' Para que o calculo de frete funcione corretamente, todos os produtos cadastrados devem ter seu peso cadastrado.

'''RN3 - ''' Sempre que houver alteração no peso do pedido o valor do frete deve ser atualizado.

'''RN4 - ''' Para que o vendedor consiga visualizar o peso total do pedido, deve habilitar a configuração ID_MOSTRAR_COLUNA_PESO=S.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Estoque por vendedor

2018-05-28T17:06:41Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 30/04/2018 || Ryvane Maria || Criação do Documento
|-
| 30/04/2018 || Luan Lima || Aprovação do Desenvolvimento
|-
| 25/05/2018 || João Felipe || Atualização do Documento
|-
| 28/05/2018 || Marcus Fábio Salviano || Aprovação da Atualização pelo Desenvolvimento
|-
|}

== Necessidade ==

Atualmente, no GeoSales, a consulta de estoque no mobile ocorre de forma que o estoque de todos os produtos é exibido para o vendedor.

É necessário que os produtos disponibilizados para consulta de estoque no mobile sejam filtrados, de forma que o vendedor só possa consultar estoque dos produtos em que ele tem acesso para venda.

== Solução ==

As informações de controle de estoque podem ser visualizadas clicando no ícone “estoque”, disponível na tela inicial do GeoSales mobile. Porém, nesta tela, são exibidos para consulta de estoque todos os produtos existentes.

Para que sejam exibidos apenas os produtos disponíveis à venda, para aquele vendedor, é necessário carregar nessa tela os produtos associados ao vendedor através da tabela de preço.

== Implementação ==

A filtragem de produtos na consulta de estoque será feita através da configuração ID_EXIBE_ESTOQUE_PRODUTO_VENDA, a partir dela, serão associados os produtos disponíveis à venda para aquele vendedor.

Realizada esta associação, no momento da consulta de estoque no mobile, só serão exibidos ao vendedor os produtos que estão associados a este através da tabela de preço correspondente.

== Regras de negócio ==

'''RN1''' - Serão exibidos para consulta apenas os produtos contidos nas tabelas de preços que está associadas ao 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.

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

Estoque por vendedor

2018-05-28T17:02:36Z

Marcus.salviano: /* Regras de negócio */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 30/04/2018 || Ryvane Maria || Criação do Documento
|-
| 30/04/2018 || Luan Lima || Aprovação do Desenvolvimento
|-
| 25/05/2018 || João Felipe || Atualização do Documento
|-
|}

== Necessidade ==

Atualmente, no GeoSales, a consulta de estoque no mobile ocorre de forma que o estoque de todos os produtos é exibido para o vendedor.

É necessário que os produtos disponibilizados para consulta de estoque no mobile sejam filtrados, de forma que o vendedor só possa consultar estoque dos produtos em que ele tem acesso para venda.

== Solução ==

As informações de controle de estoque podem ser visualizadas clicando no ícone “estoque”, disponível na tela inicial do GeoSales mobile. Porém, nesta tela, são exibidos para consulta de estoque todos os produtos existentes.

Para que sejam exibidos apenas os produtos disponíveis à venda, para aquele vendedor, é necessário carregar nessa tela os produtos associados ao vendedor através da tabela de preço.

== Implementação ==

A filtragem de produtos na consulta de estoque será feita através da configuração ID_EXIBE_ESTOQUE_PRODUTO_VENDA, a partir dela, serão associados os produtos disponíveis à venda para aquele vendedor.

Realizada esta associação, no momento da consulta de estoque no mobile, só serão exibidos ao vendedor os produtos que estão associados a este através da tabela de preço correspondente.

== Regras de negócio ==

'''RN1''' - Serão exibidos para consulta apenas os produtos contidos nas tabelas de preços que está associadas ao 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.

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

Estoque por vendedor

2018-05-28T17:01:57Z

Marcus.salviano: /* Implementação */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 30/04/2018 || Ryvane Maria || Criação do Documento
|-
| 30/04/2018 || Luan Lima || Aprovação do Desenvolvimento
|-
| 25/05/2018 || João Felipe || Atualização do Documento
|-
|}

== Necessidade ==

Atualmente, no GeoSales, a consulta de estoque no mobile ocorre de forma que o estoque de todos os produtos é exibido para o vendedor.

É necessário que os produtos disponibilizados para consulta de estoque no mobile sejam filtrados, de forma que o vendedor só possa consultar estoque dos produtos em que ele tem acesso para venda.

== Solução ==

As informações de controle de estoque podem ser visualizadas clicando no ícone “estoque”, disponível na tela inicial do GeoSales mobile. Porém, nesta tela, são exibidos para consulta de estoque todos os produtos existentes.

Para que sejam exibidos apenas os produtos disponíveis à venda, para aquele vendedor, é necessário carregar nessa tela os produtos associados ao vendedor através da tabela de preço.

== Implementação ==

A filtragem de produtos na consulta de estoque será feita através da configuração ID_EXIBE_ESTOQUE_PRODUTO_VENDA, a partir dela, serão associados os produtos disponíveis à venda para aquele vendedor.

Realizada esta associação, no momento da consulta de estoque no mobile, só serão exibidos ao vendedor os produtos que estão associados a este através da tabela de preço correspondente.

== Regras de negócio ==

'''RN1''' - Serão exibidos para consulta apenas os produtos contidos na tabela de preços que está associado ao 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.

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

Aplicação de itens no pedido

2018-05-28T16:18:19Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/05/2018 || Ryvane Maria || Criação do Documento
|-
| 28/05/2018 || Marcus Fábio Salviano || Aprovação do Documento pelo Desenvolvimento
|-
|}

== Necessidade ==

Ao passo da criação de novos pedidos, podem existir diferentes aplicações para um mesmo produto, em pedidos diferentes ou em um mesmo pedido.

Uma aplicação é definida conforme a destinação daquele produto, ou seja, onde ele será aplicado. Por exemplo, um mesmo produto "Ração" pode ter sua aplicação voltada para bovinos ou suínos. Esta aplicação, por sua vez, interfere no cálculo de imposto daquele produto e na seleção da TES na importação do pedido.

É necessário que seja possível, para um mesmo produto, selecionar aplicações diferentes, com a finalidade de realizar cálculo de imposto e seleção de TES, na importação do pedido, de forma diferenciada, conforme a aplicação do item.

Selecionar a aplicação de cada item do pedido, conforme sua destinação, possibilitando o cálculo diferenciado do imposto e a seleção da TES na importação do pedido.

== Solução ==

Para que isso seja possível, serão adicionados novos tipos de movimento para itens, de forma a categorizar a aplicação de cada item.

Ao inserir um item em um pedido, o usuário deverá selecionar o 'Tipo Item' que definirá a aplicação daquele produto. Desta forma, a partir do tipo de movimento do item, será possível definir, baseando-se em dados que serão manipulados exclusivamente no ERP, a tributação que será utilizada para cada tipo de aplicação.

== Implementação ==

'''- Criação de novos tipos de movimento de itens:'''

Inicialmente, deverão ser criados novos tipos de movimento, com a finalidade de definir a aplicação de cada item, tanto para pedidos de venda, quanto para pedidos de bonificação.

{| class="wikitable"
! CD_TIPO
! DS_TIPO
|-
| 11 || Venda - Aplicação Caprino
|-
| 12 || Venda - Aplicação Bovino
|-
| 13 || Venda - Aplicação Suíno
|-
| 14 || Bonif. - Aplicação Caprino
|-
| 15 || Bonif. - Aplicação Bovino
|-
| 16 || Bonif. - Aplicação Suíno
|-
|}

Cada tipo de movimento de item explicitado acima definirá o cálculo de imposto diferenciado que será aplicado sob o item no ERP, além da TES que será selecionada na importação do pedido.

'''- Integração dos dados de aplicação do item para o ERP: '''

Para que sejam calculadas as devidas tributações no ERP, é necessário associar cada item ao seu tipo de movimento. Essa associação será feita através do campo CD_TIPO_PEDIDO da tabela ITEM_PEDIDO.

Neste campo deverão ser enviadas as informações do tipo de movimento, para cada item inserido no pedido. Isso será possível salvando neste campo o código do tipo de movimento, que será definido através do campo CD_TIPO da tabela TIPO_MOVIMENTO_PEDIDO.

'''- Aplicação de impostos referentes a cada tipo de movimento de item no ERP: '''

Com a informação do código do tipo de movimento, será calculado, no ERP, as tributações pertinentes a cada aplicação de item.

==Regras de Negócio==

'''RN1 - ''' As tributações referentes a cada tipo de aplicação de item serão calculadas no ERP, e, para que isso seja possível, será de responsabilidade da GeoSales enviar o tipo de aplicação utilizada para cada item.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Peso mínimo por região

2018-05-28T16:02:27Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 24/05/2018 || Ryvane Maria || Criação do Documento
|-
| 28/05/2018 || Marcus Fábio Salviano || Aprovação do Documento pelo Desenvolvimento
|-
|}

== Necessidade ==

Validação do peso mínimo do pedido por região. Entende-se por peso do pedido a soma do peso de todos os produtos, de acordo com sua quantidade, inseridos no pedido.

Para que seja salvo, o pedido deve atingir um peso mínimo que é configurado de acordo com a região. Atualmente, no ERP, existem duas regiões, uma define o peso mínimo para os estados de RS e SC, e outra define o peso mínimo para outros estados. Para generalizar esta situação, deverá ser setado, com cadastro no GeoSales, o peso mínimo por estado.

== Solução ==

No GeoSales existe a funcionalidade de Regras do valor mínimo, onde o usuário pode definir um valor mínimo para o pedido em geral, segundo alguns filtros.

Essa funcionalidade será customizada, de forma que o usuário possa definir, também, um peso mínimo para um pedido. Além disso, será incluído um novo filtro chamado “Estado“, para que o usuário defina o peso mínimo do pedido por estado.

Esse cadastro definirá, no momento do cadastro do pedido, o peso mínimo por estado para que o pedido possa ser salvo. Este peso mínimo será definido pela soma do peso de todos os itens inseridos naquele pedido.

== Implementação ==

Para realizar a validação de peso mínimo do pedido por estado, alguns passos devem ser seguidos.

'''- Alteração no cadastro de regras de valor mínimo:'''

Inicialmente, novos campos deverão ser inseridos no cadastro de regras de valor mínimo que já é feito no GeoSales, como pode-se visualizar no protótipo abaixo:

[[Arquivo:Cadastro peso minimo.png]]

Serão adicionados os campos 'estado' e 'peso', com a finalidade de cadastrar o peso mínimo por região.

'''- Salvando as informações cadastradas:'''

Os campos inseridos na tela de cadastro de regra de valor mínimo deverão ser salvos na tabela VALOR_MINIMO.

Para que isso seja possível, é necessário criar dois novos campos nesta tabela, para que os dados de 'peso' e 'estado' possam ser salvos.

{| class="wikitable"
! colspan="5" | VALOR_MINIMO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| PS_MINIMO
| INT
| NAO
| NAO
| Peso mínimo do pedido
|-
| NM_ESTADO
| VARCHAR(2)
| NAO
| NAO
| Estado do cliente
|-
|}

'''- Validar o peso mínimo por estado no momento da criação do pedido:'''

No momento da criação de um pedido, caso haja uma regra de valor mínimo configurada, o sistema deve validar o peso mínimo cadastrado de acordo com o estado do endereço de entrega configurado e com os outros possíveis filtros que podem ser cadastrados na regra de valor mínimo. Sendo assim, só será possível criar um pedido caso a regra de valor mínimo do peso por estado for atendida.

== Regras de Negócio ==

'''RN1''' – O peso mínimo por estado é o mesmo para todos os pedidos exceto para pedidos de bonificação, que não validam peso mínimo.

'''RN2''' – Só é possível salvar um pedido caso o peso mínimo por estado tenha sido atingido.

'''RN3''' – No momento da inserção das regras de valor minimo, é obrigatório o usuário digitar um 'valor' '''ou''' um 'peso'. Caso seja incluído apenas um dos campos, o outro deve ser setado com o valor 0.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Peso mínimo por produto

2018-05-25T20:06:30Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 24/05/2018 || Ryvane Maria || Criação do Documento
|-
| 25/05/2018 || Marcus Fábio Salviano || Aprovação do Documento pelo Desenvolvimento
|-
|}

== Necessidade ==

Validação do peso mínimo de um produto, no momento da criação do pedido.

Atualmente, no ERP, existe um parâmetro que informa o peso mínimo de cada produto, para que este possa ser inserido em um pedido. É necessário que essa informação possa ser configurável no GeoSales, para que, ao inserir um produto em um pedido, o seu peso mínimo seja validado.

== Solução ==

Inicialmente, a informação de peso mínimo deve ser inserida, no ERP do cliente, através de um novo campo na tabela de produtos. Este campo será integrado para o GeoSales.

Ao inserir um produto em um pedido, este só poderá ser adicionado ao pedido caso seu peso mínimo atinja a quantidade informada no campo “peso mínimo venda” na tabela de produto.

Caso o peso mínimo não seja atingido, o sistema deverá informar ao usuário através de uma mensagem de validação.

== Implementação ==

Para realizar a validação de peso mínimo por item, alguns passos devem ser seguidos.

'''- Integrar a informação de peso mínimo cadastrada no ERP para o GeoSales:'''

Os dados referentes ao peso mínimo de cada item serão cadastrados no ERP, e inseridos no campo PS_MINIMO_ITEM da tabela PRODUTO, no GeoSales.

Esses dados deverão ser extraídos do campo B1_PVPSMIN do ERP.

'''- Criar um novo campo na tabela PRODUTO, para salvar o peso mínimo do produto:'''

Para que isso seja possível é necessário criar um novo campo na tabela PRODUTO chamado PS_MINIMO_ITEM, com a finalidade de salvar os dados integrados referentes ao peso mínimo do item.

{| class="wikitable"
! colspan="5" | PRODUTO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| PS_MINIMO_ITEM
| INT
| NAO
| NAO
| Peso mínimo daquele item
|-
|}

'''- Validar o peso mínimo do item no momento da criação do pedido:'''

No momento da criação do pedido, quando o usuário tentar inserir um item, o sistema deverá validar seu peso mínimo, baseando-se na quantidade inserida pelo vendedor, e no peso unitário do item.

Cada item, por sua vez, terá um peso mínimo para que esse item possa ser inserido em um pedido. Caso o peso do item não atinja o peso mínimo especificado, este produto não poderá ser inserido no pedido.

== Regras de Negócio ==

'''RN1''' – Caso o peso do produto não atinja o valor mínimo especificado, este produto não poderá ser inserido no pedido.

'''RN2''' – O peso mínimo é o mesmo para qualquer pedido, porém, para pedidos de bonificação, não há essa validação.

== Aprovação ==

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

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

Data mínima e máxima de entrega

2018-05-24T13:37:36Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/05/2018 || Ryvane Maria || Criação do Documento
|-
| 24/05/2018 || Marcus Fábio Salviano || Aprovação do Documento pelo Desenvolvimento
|-
|}

== Necessidade ==

Atualmente, no ERP, a partir da data de emissão do pedido, calcula-se quantos dias úteis até a data de entrega do pedido. A partir dessa informação, é feita uma validação que não permite que o usuário insira pedidos cuja data de entrega seja inferior a x dias úteis, ou superior a y dias úteis.

É necessário que esses valores sejam cadastrados no Geosales, para que o sistema realize, também, a validação de data mímima e máxima de entrega no momento da criação do pedido.

== Solução ==

Será criado um CRUD no GeoSales, com a finalidade de cadastrar os valores de “mínimo de dias para entrega” e “máximo de dias para entrega”.

Neste cadastro também poderão ser incluídos os seguintes campos: Organização de venda, estado, cidade, quantidade mínima e máxima de itens, mínimo de dias para entrega e máximo de dias para entrega. Sendo obrigatórios apenas o mínimo e máximo de dias para entrega.

O campo referente ao “mínimo de dias para entrega” será salvo no campo NR_LEAD_TIME, e o campo referente ao “máximo de dias para entrega” será salvo no campo NR_LEAD_TIME_MAX (que deverá ser criado na tabela para esta finalidade).

Com essas informações, será possível limitar a data de entrega dos pedidos a quantidade mínima/máxima de dias cadastrados por estado, usando a função Lead Time.

== Implementação ==

'''- Cadastro de informações de data de entrega máxima e mínima:'''

Deverá ser criado um cadastro com a finalidade de incluir informações a respeito da data mínima e máxima de entrega.

Como pode-se ver na imagem abaixo, este cadastro contemplará os campos: Organização de venda, estado e cidade do cliente, quantidade mínima e máxima de itens e quantidade de dias mínimo e máximo de entrega. Destes campos, são obrigatórios a quantidade de dias mínimo e máximo de entrega.

[[Arquivo:Cadastro dias entrega.png]]

'''- Salvando informações cadastradas no GeoSales:'''

As informações inseridas no cadastro descrito acima deverão ser salvas na tabela PARAMETRO_DATA_ENTREGA.

{| class="wikitable"
! colspan="5" | PARAMETRO_DATA_ENTREGA
|-
! style="width:200px" |Cadastro
! style="width:300px" |Campo
|-
| Organização de venda
| CD_ORG_VENDA
|-
| Estado
| DS_ESTADO_DESTINO
|-
| Cidade
| DS_CIDADE_DESTINO
|-
| Quantidade mínima de itens
| QT_MINIMA
|-
| Quantidade máxima de itens
| QT_MAXIMA
|-
| Quantidade minima de dias
| NR_LEAD_TIME
|-
| Quantidade máxima de dias
| NR_LEAD_TIME_MAX
|-
|}

Para que isso seja possível é necessário criar um novo campo na tabela PARAMETRO_DATA_ENTREGA chamado NR_LEAD_TIME_MAX.

{| class="wikitable"
! colspan="5" | PARAMETRO_DATA_ENTREGA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| NR_LEAD_TIME_MAX
| INT
| SIM
| NAO
| Quantidade máxima de dias da data de entrega.
|-
|}

'''- Limitando a data de entrega dos pedidos:'''

Cadastradas e salvas as informações descritas acima, o sistema deve limitar a data de entrega dos pedidos a quantidade mínima e máxima de dias, cadastrados segundo os parâmetros do CRUD que será criado.

== Regras de Negócio ==

'''RN1 - ''' A data mínima e máxima por estado é a mesma para todos os pedidos, exceto para pedidos de bonificação e pedidos de troca, que não validam data de entrega.

'''RN2 - ''' A quantidade de dias úteis mínima/máxima para entrega será contada a partir da data de emissão do pedido.

'''RN3 - ''' As validações de data de entrega serão feitas no momento da criação do pedido, portanto, será usado como parâmetro de validação a data de emissão do pedido.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Rateio de Bonificação

2018-05-23T21:46:35Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/03/2018 || Ryvane Maria || Criação do Documento
|-
| 16/03/2018 || Marcus Fábio Salviano || Aprovação pelo desenvolvimento
|-
| 20/03/2018 || Ryvane Maria || Alteração com retorno de feedbacks
|-
| 20/03/2018 || Marcus Fábio Salviano || Aprovação das alterações pelo desenvolvimento
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Integração adição de como popular a tabela Cliente Tipo rateio.
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Desenvolvimento Criação de tabela Cliente Tipo e sua aplicação.
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Regras Integração adicionado regras RI4 e RI5
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Regras de Negocio adicionado regra RN7
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - adição de documentos vinculados
|-
| 23/05/2018 || Marcus Fábio Salviano || Aprovação das alterações pelo desenvolvimento
|-
|}

== Necessidade ==

Toda bonificação gera um custo para a empresa pois, o valor bonificado, deverá ser arcado de alguma forma.

Para que uma bonificação gere o mínimo possível de despesas, é necessário que no momento em que estiver sendo feito o pedido de bonificação, o sistema atribua a esta bonificação o menor valor de venda possível.

Este valor deverá ser rateado entre verba e comissão do vendedor, caso o valor não seja declarado(rateado) totalmente, o valor restante irá para a verba interna do Cliente e será tratado internamente no ERP.

== Solução ==

Quando estiver sendo feito um pedido de bonificação, a tabela 111 será carregada na tabela PRODUTO_CUSTO, e o pedido de bonificação será feito usando o valor encontrado na tabela PRODUTO_CUSTO. Porém, para fazer o rateio, será criada uma tabela de preço de bonificação, onde o valor a ser rateado se trata do menor valor encontrado para o item vezes a sua quantidade. Essa tabela terá informações provindas do ERP.

== Integração ==

Inicialmente, quando o usuário estiver realizando um pedido do tipo bonificação, será carregada a tabela PRODUTO_CUSTO, que conterá as informações da tabela 111 do ERP.

Para que isso ocorra de forma correta, o parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com o valor 'S'.

Para que o rateio seja feito sob o menor valor possível do pedido de bonificação, deverá ser gerada a tabela de bonificação para este fim. Essa tabela, que é um espelho da tabela de venda, será apontada a partir do campo A1_XTBBON da tabela SA1. Esse campo contém a tabela que consta o menor valor para o item.

''(Por exemplo: Se no campo A1_XTBBON da tabela SA1 tiver o valor 047, significa que o menor valor possível para aquele item será buscado na tabela 047 do ERP.)''

Sendo assim, a partir desta tabela ''(a 047 por exemplo)'' o sistema deverá buscar o menor valor encontrado. É importante salientar que esta tabela é escalonada, ou seja, o menor preço para o produto será aquele aplicado para a maior quantidade possível, é exatamente este preço que o sistema deverá utilizar para o rateio, desconsiderando o escalonamento.

''(Desconsiderar o escalonamento significa que o valor aplicado para 20 unidades por exemplo, será utilizado para o rateio de uma unidade apenas. Desta forma, garantimos que o menor valor possível será utilizado.)''

O integrador deve popular a tabela Cliente Tipo rateio levando em consideração o campo A3_XUSAVM. Quando este campo estiver igual a N, deve ser inserida o CD_CLIENTE e CD_TIPO_DESCONTO que se refere a comissão(2).
Quando o campo A3_XUSAVM estiver igual a S, não precisa informar o CD_CLIENTE E CD_TIPO_DESCONTO na tabela.

== Desenvolvimento ==

Para que o rateio de bonificação seja exibido na tela, é necessário criar uma configuração chamada ID_UTILIZA_RATEIO_BONIFICAO, e, habilitando-a, o sistema exibirá a informação de bonificação para rateio.

O valor a ser rateado será o menor valor possível encontrado na tabela de bonificação vezes a quantidade de itens para aquele valor.

''(Por exemplo, se o vendedor realiza um pedido de bonificação com 10 itens e o valor encontrado na tabela gerada de bonificação é R$12,00, o valor a ser rateado será R$120,00.)''

Feito este tratamento nos valores de bonificação, o valor a ser rateado será enviado para a tela de rateio, onde já é realizado o rateio por valor e por prazo médio, e o rateio por bonificação será incluído. A bonificação a ser rateada, neste caso, é a soma de todos os produtos que estão sendo bonificados , levando em consideração não o valor do PRODUTO_CUSTO ''(que foi usada no pedido de bonificação)'', mas o valor da tabela de bonificação.

Essa situação pode ser visualizada no protótipo abaixo:

[[Arquivo:Rateio bonificacao Tela1.png|400px]]

O usuário poderá escolher ratear o valor especificado para bonificação entre verba e comissão. Clicando no campo 'Tipo Rateio´, é possível escolher o tipo de rateio desejado (verba ou comissão), como pode-ser ver na imagem abaixo:

[[Arquivo:Rateio bonificacao Tela2.png|400px]]

Após selecionar o tipo de rateio desejado, o usuário deve digitar o valor a ser rateado no campo 'Valor Rateio' e clicar no botão 'Inserir' para ratear. É possível também editar, atualizar ou excluir um rateio realizado, como já ocorre atualmente na tela de rateio.

As informações contidas nessa tela serão salvas na tabela PEDIDO_RATEIO_DESCONTO.

Caso um pedido de bonificação não seja totalmente rateado, o valor restante será enviado ao ERP através da tabela PEDIDO_RATEIO_DESCONTO e o campo CD_TIPO_RATEIO_DESCONTO será setado com o valor -1 para esta situação.

O campo CD_TIPO_RATEIO_DESCONTO terá 3 status possíveis:

(1) - Verba;

(2) - Comissão;

(-1) - Restante.

Na tela de rateio somente serão exibidos para seleção os status de Verba e de comissão. O status -1, que determina o valor restante do rateio, será utilizado internamente para enviar esse valor ao ERP. Esse status deverá ser setado com o valor N na coluna TIPO_PEDIDO_RATEIO_DESCONTO.

'''Tabela a ser alterada:'''

{| class="wikitable"
! colspan="5" | TIPO_PEDIDO_RATEIO_DESCONTO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_UTILIZAVEL
| CHAR(1)
| NAO
| NAO
| Flag NULÁVEL que define se o tipo de rateio irá aparecer na tela ou não.
|}

O valor padrão para os campos desta coluna é S, caso o valor setado seja S ou null, o tipo de rateio será exibido na tela de rateio. Bem como, por definição, todos os status com valor N nesta tabela não irão ser exibidos na tela de rateio e serão usados apenas internamente.

'''Tabela a ser Criada'''

{| class="wikitable"
! colspan="5" | CLIENTE_TIPO_RATEIO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_CLIENTE
| INT
| NAO
| NAO
| Codigo do cliente
|-
| CD_TIPO_CLIENTE
| INT
| NAO
| NAO
| Codigo tipo pedido rateio desconto
|}

No momento que o vendedor tiver acesso a tela de rateio de desconto excedente, para realizar rateio ou edição, o sistema exibe as opções de verba e comissão, para essa informações serem exibidas, deve ser levado em consideração as informações existentes na tabela CLIENTE_TIPO_RATEIO.

Quando o cliente que o vendedor estiver fazendo o rateio, estiver na tabela CLIENTE_TIPO_RATEIO, deve ser exibido apenas a opção que estiver liberada na tabela, ou seja apenas comissão(CD_TIPO_DESCONTO -2);
Quando o cliente que o vendedor estiver fazendo o rateio, não estiver na tabela, deve exibir as duas opções de rateio verba e comissão para que o vendedor possa usar no momento.

== Regras de integração ==

'''[RI1]''' – Para pedidos de bonificação, a tabela 111 será carregada a partir da tabela PRODUTO_CUSTO e o pedido de bonificação será feito utilizando essa tabela, porém, o rateio será feito utilizando a tabela especificada na RI2 deste documento.

'''[RI2]''' – A Tabela de bonificação que será utilizada para rateio será definida pelo apontamento do campo A1_XTBBON da tabela SA1.

'''[RI3]''' – Deverá ser gerada a tabela de bonificação. Essa tabela será criada a partir de um espelho da tabela de venda, que será apontada no campo A1_XTBBON da tabela SA1, esse campo define qual a tabela de bonificação que será utilizada. Essa tabela de venda é escalonada, ou seja, o preço é reduzido conforme a quantidade de itens aumenta. Porém, o sistema deverá gerar a tabela de bonificação como menor valor da tabela de escalonamento, a partir do preço sugerido, aplicando este valor para um único item.

'''[RI4]''' – Para popular a nova tabela CLIENTE_TIPO_RATEIO, o integrador irá verificar o campo A3_XUSAVM. Quando este campo estiver igual a N, a tabela será populada com o codigo do cliente e o CD_TIPO_DESCONTO da tabela TIPO_PEDIDO_RATEIO_DESCONTO que se refere a Comissão (2);

'''[RI5]''' – Quando o campo A3_XUSAVM estiver como S, não precisará popular a tabela CLIENTE_TIPO_RATEIO com a informação do CD_CLIENTE e CD_TIPO_DESCONTO, já que o vendedor poderá usar as duas opções para rateio.

== Regras de Negócio ==

'''[RN1]''' – Para que a solução proposta seja aplicada corretamente é necessário que o usuário escolha a tabela de preço correta.

'''[RN2]''' – Com a configuração ID_UTILIZA_RATEIO_BONIFICACAO estiver habilitada o sistema exibirá a informação para rateio.

'''[RN3]''' – Quando outras configurações que ativam situações de rateio também estiverem habilitadas, o valor total a ser rateado entre comissão e verba será a soma de todas os valores dessas situações, mostrando cada valor distintamente para seu rateio. Essa informação é genérica para a tela de rateio, e é importante salientar que pedidos de bonificação não geram os outros tipos de rateio, então, para pedidos de bonificação só haverá rateio de bonificação.

'''[RN4]''' – Para pedidos de bonificação, será utilizada a tabela PRODUTO_CUSTO. O parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com 'S' para que o sistema utilize a tabela PRODUTO_CUSTO nesses pedidos.

'''[RN5]''' – O valor sugerido da tabela de bonificação será multiplicado pela quantidade de itens, é esse valor que será rateado.

'''[RN6]''' – Caso o valor especificado para rateio não seja totalmente rateado, o restante deste valor será enviado para o ERP através do campo CD_TIPO_RATEIO_DESCONTO com o status (-1).

'''[RN7]''' – Ao realizar um rateio de desconto excedente, o sistema deve levar em consideração as informações da tabela CLIENTE_TIPO_RATEIO.
Se o cliente em atendimento não tiver seu codigo na tabela, deve exibir as duas opções Verba e Comissão;
Se o cliente em atendimento estiver com seu codigo na tabela, deve exibir apenas o CD_TIPO_DESCONTO liberado na tabela.

== Documentos Vinculados ==

[[Rateio de Prazo Excedido]]

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Rateio de Bonificação

2018-05-23T21:38:45Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/03/2018 || Ryvane Maria || Criação do Documento
|-
| 16/03/2018 || Marcus Fábio Salviano || Aprovação pelo desenvolvimento
|-
| 20/03/2018 || Ryvane Maria || Alteração com retorno de feedbacks
|-
| 20/03/2018 || Marcus Fábio Salviano || Aprovação das alterações pelo desenvolvimento
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Integração adição de como popular a tabela Cliente Tipo rateio.
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Desenvolvimento Criação de tabela Cliente Tipo e sua aplicação.
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Regras Integração adicionado regras RI4 e RI5
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - Regras de Negocio adicionado regra RN7
|-
| 23/05/2018 || Renato Lima || Alteração de Liberação dos tipos de rateio a serem usados - adição de documentos vinculados
|-
| DD/MM/AAAA || Marcus Fábio Salviano || Aprovação das alterações pelo desenvolvimento
|-
|}

== Necessidade ==

Toda bonificação gera um custo para a empresa pois, o valor bonificado, deverá ser arcado de alguma forma.

Para que uma bonificação gere o mínimo possível de despesas, é necessário que no momento em que estiver sendo feito o pedido de bonificação, o sistema atribua a esta bonificação o menor valor de venda possível.

Este valor deverá ser rateado entre verba e comissão do vendedor, caso o valor não seja declarado(rateado) totalmente, o valor restante irá para a verba interna do Cliente e será tratado internamente no ERP.

== Solução ==

Quando estiver sendo feito um pedido de bonificação, a tabela 111 será carregada na tabela PRODUTO_CUSTO, e o pedido de bonificação será feito usando o valor encontrado na tabela PRODUTO_CUSTO. Porém, para fazer o rateio, será criada uma tabela de preço de bonificação, onde o valor a ser rateado se trata do menor valor encontrado para o item vezes a sua quantidade. Essa tabela terá informações provindas do ERP.

== Integração ==

Inicialmente, quando o usuário estiver realizando um pedido do tipo bonificação, será carregada a tabela PRODUTO_CUSTO, que conterá as informações da tabela 111 do ERP.

Para que isso ocorra de forma correta, o parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com o valor 'S'.

Para que o rateio seja feito sob o menor valor possível do pedido de bonificação, deverá ser gerada a tabela de bonificação para este fim. Essa tabela, que é um espelho da tabela de venda, será apontada a partir do campo A1_XTBBON da tabela SA1. Esse campo contém a tabela que consta o menor valor para o item.

''(Por exemplo: Se no campo A1_XTBBON da tabela SA1 tiver o valor 047, significa que o menor valor possível para aquele item será buscado na tabela 047 do ERP.)''

Sendo assim, a partir desta tabela ''(a 047 por exemplo)'' o sistema deverá buscar o menor valor encontrado. É importante salientar que esta tabela é escalonada, ou seja, o menor preço para o produto será aquele aplicado para a maior quantidade possível, é exatamente este preço que o sistema deverá utilizar para o rateio, desconsiderando o escalonamento.

''(Desconsiderar o escalonamento significa que o valor aplicado para 20 unidades por exemplo, será utilizado para o rateio de uma unidade apenas. Desta forma, garantimos que o menor valor possível será utilizado.)''

O integrador deve popular a tabela Cliente Tipo rateio levando em consideração o campo A3_XUSAVM. Quando este campo estiver igual a N, deve ser inserida o CD_CLIENTE e CD_TIPO_DESCONTO que se refere a comissão(2).
Quando o campo A3_XUSAVM estiver igual a S, não precisa informar o CD_CLIENTE E CD_TIPO_DESCONTO na tabela.

== Desenvolvimento ==

Para que o rateio de bonificação seja exibido na tela, é necessário criar uma configuração chamada ID_UTILIZA_RATEIO_BONIFICAO, e, habilitando-a, o sistema exibirá a informação de bonificação para rateio.

O valor a ser rateado será o menor valor possível encontrado na tabela de bonificação vezes a quantidade de itens para aquele valor.

''(Por exemplo, se o vendedor realiza um pedido de bonificação com 10 itens e o valor encontrado na tabela gerada de bonificação é R$12,00, o valor a ser rateado será R$120,00.)''

Feito este tratamento nos valores de bonificação, o valor a ser rateado será enviado para a tela de rateio, onde já é realizado o rateio por valor e por prazo médio, e o rateio por bonificação será incluído. A bonificação a ser rateada, neste caso, é a soma de todos os produtos que estão sendo bonificados , levando em consideração não o valor do PRODUTO_CUSTO ''(que foi usada no pedido de bonificação)'', mas o valor da tabela de bonificação.

Essa situação pode ser visualizada no protótipo abaixo:

[[Arquivo:Rateio bonificacao Tela1.png|400px]]

O usuário poderá escolher ratear o valor especificado para bonificação entre verba e comissão. Clicando no campo 'Tipo Rateio´, é possível escolher o tipo de rateio desejado (verba ou comissão), como pode-ser ver na imagem abaixo:

[[Arquivo:Rateio bonificacao Tela2.png|400px]]

Após selecionar o tipo de rateio desejado, o usuário deve digitar o valor a ser rateado no campo 'Valor Rateio' e clicar no botão 'Inserir' para ratear. É possível também editar, atualizar ou excluir um rateio realizado, como já ocorre atualmente na tela de rateio.

As informações contidas nessa tela serão salvas na tabela PEDIDO_RATEIO_DESCONTO.

Caso um pedido de bonificação não seja totalmente rateado, o valor restante será enviado ao ERP através da tabela PEDIDO_RATEIO_DESCONTO e o campo CD_TIPO_RATEIO_DESCONTO será setado com o valor -1 para esta situação.

O campo CD_TIPO_RATEIO_DESCONTO terá 3 status possíveis:

(1) - Verba;

(2) - Comissão;

(-1) - Restante.

Na tela de rateio somente serão exibidos para seleção os status de Verba e de comissão. O status -1, que determina o valor restante do rateio, será utilizado internamente para enviar esse valor ao ERP. Esse status deverá ser setado com o valor N na coluna TIPO_PEDIDO_RATEIO_DESCONTO.

'''Tabela a ser alterada:'''

{| class="wikitable"
! colspan="5" | TIPO_PEDIDO_RATEIO_DESCONTO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_UTILIZAVEL
| CHAR(1)
| NAO
| NAO
| Flag NULÁVEL que define se o tipo de rateio irá aparecer na tela ou não.
|}

O valor padrão para os campos desta coluna é S, caso o valor setado seja S ou null, o tipo de rateio será exibido na tela de rateio. Bem como, por definição, todos os status com valor N nesta tabela não irão ser exibidos na tela de rateio e serão usados apenas internamente.

'''Tabela a ser Criada'''

{| class="wikitable"
! colspan="5" | CLIENTE_TIPO_RATEIO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_CLIENTE
| INT
| NAO
| NAO
| Codigo do cliente
|-
| CD_TIPO_CLIENTE
| INT
| NAO
| NAO
| Codigo tipo pedido rateio desconto
|}

No momento que o vendedor tiver acesso a tela de rateio de desconto excedente, para realizar rateio ou edição, o sistema exibe as opções de verba e comissão, para essa informações serem exibidas, deve ser levado em consideração as informações existentes na tabela CLIENTE_TIPO_RATEIO.

Quando o cliente que o vendedor estiver fazendo o rateio, estiver na tabela CLIENTE_TIPO_RATEIO, deve ser exibido apenas a opção que estiver liberada na tabela, ou seja apenas comissão(CD_TIPO_DESCONTO -2);
Quando o cliente que o vendedor estiver fazendo o rateio, não estiver na tabela, deve exibir as duas opções de rateio verba e comissão para que o vendedor possa usar no momento.

== Regras de integração ==

'''[RI1]''' – Para pedidos de bonificação, a tabela 111 será carregada a partir da tabela PRODUTO_CUSTO e o pedido de bonificação será feito utilizando essa tabela, porém, o rateio será feito utilizando a tabela especificada na RI2 deste documento.

'''[RI2]''' – A Tabela de bonificação que será utilizada para rateio será definida pelo apontamento do campo A1_XTBBON da tabela SA1.

'''[RI3]''' – Deverá ser gerada a tabela de bonificação. Essa tabela será criada a partir de um espelho da tabela de venda, que será apontada no campo A1_XTBBON da tabela SA1, esse campo define qual a tabela de bonificação que será utilizada. Essa tabela de venda é escalonada, ou seja, o preço é reduzido conforme a quantidade de itens aumenta. Porém, o sistema deverá gerar a tabela de bonificação como menor valor da tabela de escalonamento, a partir do preço sugerido, aplicando este valor para um único item.

'''[RI4]''' – Para popular a nova tabela CLIENTE_TIPO_RATEIO, o integrador irá verificar o campo A3_XUSAVM. Quando este campo estiver igual a N, a tabela será populada com o codigo do cliente e o CD_TIPO_DESCONTO da tabela TIPO_PEDIDO_RATEIO_DESCONTO que se refere a Comissão (2);

'''[RI5]''' – Quando o campo A3_XUSAVM estiver como S, não precisará popular a tabela CLIENTE_TIPO_RATEIO com a informação do CD_CLIENTE e CD_TIPO_DESCONTO, já que o vendedor poderá usar as duas opções para rateio.

== Regras de Negócio ==

'''[RN1]''' – Para que a solução proposta seja aplicada corretamente é necessário que o usuário escolha a tabela de preço correta.

'''[RN2]''' – Com a configuração ID_UTILIZA_RATEIO_BONIFICACAO estiver habilitada o sistema exibirá a informação para rateio.

'''[RN3]''' – Quando outras configurações que ativam situações de rateio também estiverem habilitadas, o valor total a ser rateado entre comissão e verba será a soma de todas os valores dessas situações, mostrando cada valor distintamente para seu rateio. Essa informação é genérica para a tela de rateio, e é importante salientar que pedidos de bonificação não geram os outros tipos de rateio, então, para pedidos de bonificação só haverá rateio de bonificação.

'''[RN4]''' – Para pedidos de bonificação, será utilizada a tabela PRODUTO_CUSTO. O parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com 'S' para que o sistema utilize a tabela PRODUTO_CUSTO nesses pedidos.

'''[RN5]''' – O valor sugerido da tabela de bonificação será multiplicado pela quantidade de itens, é esse valor que será rateado.

'''[RN6]''' – Caso o valor especificado para rateio não seja totalmente rateado, o restante deste valor será enviado para o ERP através do campo CD_TIPO_RATEIO_DESCONTO com o status (-1).

'''[RN7]''' – Ao realizar um rateio de desconto excedente, o sistema deve levar em consideração as informações da tabela CLIENTE_TIPO_RATEIO.
Se o cliente em atendimento não tiver seu codigo na tabela, deve exibir as duas opções Verba e Comissão;
Se o cliente em atendimento estiver com seu codigo na tabela, deve exibir apenas o CD_TIPO_DESCONTO liberado na tabela.

== Documentos Vinculados ==

Rateio de Prazo Excedido

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Cadastro de Sequência de aprovação de pendências

2018-03-21T14:28:41Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/02/2018 || Ryvane Maria || Criação do Documento
|-
| 21/03/2018 || Marcus Fábio Salviano || Aprovação pelo Desenvolvimento
|-
|}

== Necessidade ==

Ao realizar um pedido qualquer, é possível que este pedido fique pendente por vários motivos como por exemplo: descontos aplicados, rentabilidade, frete, verba, bonificação, dentre outros.

Acontece que essas pendências podem, a qualquer momento, ser liberadas pelo supervisor responsável, sem que haja uma ordem a ser seguida para liberação de pendências. Em outras palavras, não há uma sequência sobre o que precisa ser aprovado primeiro.

Essa situação é prejudicial à aprovação do pedido em si pois há algumas pendências que dependem da aprovação de outras. Por exemplo, para que uma pendência do tipo frete seja aprovada pode ser necessário que as pendências de bonificação tenham sido aprovadas anteriormente.

Desta forma, é necessário criar uma sequencia de aprovação de pendências, onde o usuário possa cadastrar uma ordem para liberação de pendências.

== Solução ==

Esta situação será solucionada criando uma nova funcionalidade no portal GeoSales, chamada "ordenação de pendências", onde o usuário poderá setar, para uma determinada lista de pendências disponíveis, um valor para ordenação daquela sequência.

Será feito um CRUD para cadastro da sequência de aprovação de pendências no novo portal.

Nessa nova tela de cadastro será possível selecionar uma dentre as várias pendências existentes e atribuir a ela um número que definirá sua ordem na alçada de aprovação de pendências.

A ordem de pendência poderá ser definida tanto de forma geral, ou seja, para todos os pedidos tirados, quanto pode-se definir sequências de aprovação diferentes por organização de venda e por vendedores.

== Implementação ==

Uma nova tela no GeoSales será implementada, onde o usuário poderá definir a ordem das pendências.

O protótipo sugerido para a tela em questão pode ser visualizado na imagem abaixo:

[[Arquivo:Prototipo sequencia.png|450px]]

O acesso a essa tela será feito através do Menu > Cadastro > Sequência de aprovação de pendências.

Inicialmente o usuário poderá selecionar alguns campos não obrigatórios para o cadastro da sequência de aprovação, que são: organização de venda e vendedor.

Os campos de organização de venda e vendedor não são obrigatórios e, caso o usuário não preencha esses campos, o conteúdo que será cadastrado deverá ser aplicado para todas as organizações de vendas e vendedores.

Após selecionar o vendedor ou a organização de venda, é preciso preencher o campo de 'Pendência', que definirá qual pendência está sendo cadastrada, e a sua ordem, usando o campo 'Sequência', que deverá ter formatação 'select box'. Este campo deverá ser representado de forma numeral e crescente, e a quantidade de opções que será exibida deverá ser igual a quantidade de pendências existentes. ''(Por exemplo: se houverem 5 pendências, o campo deverá conter as opções: 1 2 3 4 e 5).''

É importante salientar que o campo 'Sequência' não é único por pendência, isso significa que duas ou mais sequências diferentes podem ter o mesmo número na ordem de sequência. Caso isso ocorra, as pendências deverão ser liberadas para aprovação ao mesmo tempo.

As sequências de pendências já cadastradas podem ser visualizadas logo abaixo, na lista de pendências. Essa lista mostrará ao usuário qual a ordem atual de pendências já cadastrada. A ordem da sequência de aprovação de pendências será definida de forma crescente, ou seja, primeiro serão liberadas para aprovação as pendências com ordem 1, depois com ordem 2, e assim sucessivamente.

Através da lista da sequência de pendências de aprovação é possível visualizar a ordem das pendências, bem como editar ou excluir uma pendência já cadastrada.

A imagem abaixo exemplifica o protótipo sugerido para a lista de sequência de aprovação de pendências:

[[Arquivo:Prototipo sequencia lista.png|450px]]

== Regras de Negócio ==

'''[RN1]''' – Quando não houver uma sequência definida para uma pendência ou grupo de pendências, essas pendências (sem sequência) poderão ser aprovadas a qualquer momento, sem validação da sequência de aprovação.

'''[RN2]''' – Quando, em um grupo de pendências, houver uma sequência definida para algumas pendências e para outras não, será liberada para aprovação tanto a primeira pendência da ordem, quanto todas as pendências sem uma sequência definida.

'''[RN3]''' – Caso a sequência não tenha uma organização de venda ou um vendedor cadastrados, ela terá vigência para todos os vendedores de todas as organizações de venda.

'''[RN4]''' – O cadastro da sequência de aprovação de pendências será feito exclusivamente pelo GeoSales, e, inicialmente, o usuário não terá acesso a essa tela.

'''[RN5]''' – Quando o usuário cadastrar uma sequência com filtro de organização de venda e de vendedor, será prioritário para sequência o filtro de organização de venda.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Cadastro de Sequência de aprovação de pendências

2018-03-21T14:28:22Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/02/2018 || Ryvane Maria || Criação do Documento
|-
| 21/03/2018 || Ryvane Maria || Aprovação pelo Desenvolvimento
|-
|}

== Necessidade ==

Ao realizar um pedido qualquer, é possível que este pedido fique pendente por vários motivos como por exemplo: descontos aplicados, rentabilidade, frete, verba, bonificação, dentre outros.

Acontece que essas pendências podem, a qualquer momento, ser liberadas pelo supervisor responsável, sem que haja uma ordem a ser seguida para liberação de pendências. Em outras palavras, não há uma sequência sobre o que precisa ser aprovado primeiro.

Essa situação é prejudicial à aprovação do pedido em si pois há algumas pendências que dependem da aprovação de outras. Por exemplo, para que uma pendência do tipo frete seja aprovada pode ser necessário que as pendências de bonificação tenham sido aprovadas anteriormente.

Desta forma, é necessário criar uma sequencia de aprovação de pendências, onde o usuário possa cadastrar uma ordem para liberação de pendências.

== Solução ==

Esta situação será solucionada criando uma nova funcionalidade no portal GeoSales, chamada "ordenação de pendências", onde o usuário poderá setar, para uma determinada lista de pendências disponíveis, um valor para ordenação daquela sequência.

Será feito um CRUD para cadastro da sequência de aprovação de pendências no novo portal.

Nessa nova tela de cadastro será possível selecionar uma dentre as várias pendências existentes e atribuir a ela um número que definirá sua ordem na alçada de aprovação de pendências.

A ordem de pendência poderá ser definida tanto de forma geral, ou seja, para todos os pedidos tirados, quanto pode-se definir sequências de aprovação diferentes por organização de venda e por vendedores.

== Implementação ==

Uma nova tela no GeoSales será implementada, onde o usuário poderá definir a ordem das pendências.

O protótipo sugerido para a tela em questão pode ser visualizado na imagem abaixo:

[[Arquivo:Prototipo sequencia.png|450px]]

O acesso a essa tela será feito através do Menu > Cadastro > Sequência de aprovação de pendências.

Inicialmente o usuário poderá selecionar alguns campos não obrigatórios para o cadastro da sequência de aprovação, que são: organização de venda e vendedor.

Os campos de organização de venda e vendedor não são obrigatórios e, caso o usuário não preencha esses campos, o conteúdo que será cadastrado deverá ser aplicado para todas as organizações de vendas e vendedores.

Após selecionar o vendedor ou a organização de venda, é preciso preencher o campo de 'Pendência', que definirá qual pendência está sendo cadastrada, e a sua ordem, usando o campo 'Sequência', que deverá ter formatação 'select box'. Este campo deverá ser representado de forma numeral e crescente, e a quantidade de opções que será exibida deverá ser igual a quantidade de pendências existentes. ''(Por exemplo: se houverem 5 pendências, o campo deverá conter as opções: 1 2 3 4 e 5).''

É importante salientar que o campo 'Sequência' não é único por pendência, isso significa que duas ou mais sequências diferentes podem ter o mesmo número na ordem de sequência. Caso isso ocorra, as pendências deverão ser liberadas para aprovação ao mesmo tempo.

As sequências de pendências já cadastradas podem ser visualizadas logo abaixo, na lista de pendências. Essa lista mostrará ao usuário qual a ordem atual de pendências já cadastrada. A ordem da sequência de aprovação de pendências será definida de forma crescente, ou seja, primeiro serão liberadas para aprovação as pendências com ordem 1, depois com ordem 2, e assim sucessivamente.

Através da lista da sequência de pendências de aprovação é possível visualizar a ordem das pendências, bem como editar ou excluir uma pendência já cadastrada.

A imagem abaixo exemplifica o protótipo sugerido para a lista de sequência de aprovação de pendências:

[[Arquivo:Prototipo sequencia lista.png|450px]]

== Regras de Negócio ==

'''[RN1]''' – Quando não houver uma sequência definida para uma pendência ou grupo de pendências, essas pendências (sem sequência) poderão ser aprovadas a qualquer momento, sem validação da sequência de aprovação.

'''[RN2]''' – Quando, em um grupo de pendências, houver uma sequência definida para algumas pendências e para outras não, será liberada para aprovação tanto a primeira pendência da ordem, quanto todas as pendências sem uma sequência definida.

'''[RN3]''' – Caso a sequência não tenha uma organização de venda ou um vendedor cadastrados, ela terá vigência para todos os vendedores de todas as organizações de venda.

'''[RN4]''' – O cadastro da sequência de aprovação de pendências será feito exclusivamente pelo GeoSales, e, inicialmente, o usuário não terá acesso a essa tela.

'''[RN5]''' – Quando o usuário cadastrar uma sequência com filtro de organização de venda e de vendedor, será prioritário para sequência o filtro de organização de venda.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Rateio de Bonificação

2018-03-20T17:11:25Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/03/2018 || Ryvane Maria || Criação do Documento
|-
| 16/03/2018 || Marcus Fábio Salviano || Aprovação pelo esenvolvimento
|-
| 20/03/2018 || Ryvane Maria || Alteração com retorno de feedbacks
|-
| 20/03/2018 || Marcus Fábio Salviano || Aprovação das alterações pelo desenvolvimento
|-
|}

== Necessidade ==

Toda bonificação gera um custo para a empresa pois, o valor bonificado, deverá ser arcado de alguma forma.

Para que uma bonificação gere o mínimo possível de despesas, é necessário que no momento em que estiver sendo feito o pedido de bonificação, o sistema atribua a esta bonificação o menor valor de venda possível.

Este valor deverá ser rateado entre verba e comissão do vendedor, caso o valor não seja declarado(rateado) totalmente, o valor restante irá para a verba interna do Cliente e será tratado internamente no ERP.

== Solução ==

Quando estiver sendo feito um pedido de bonificação, a tabela 111 será carregada na tabela PRODUTO_CUSTO, e o pedido de bonificação será feito usando o valor encontrado na tabela PRODUTO_CUSTO. Porém, para fazer o rateio, será criada uma tabela de preço de bonificação, onde o valor a ser rateado se trata do menor valor encontrado para o item vezes a sua quantidade. Essa tabela terá informações provindas do ERP.

== Integração ==

Inicialmente, quando o usuário estiver realizando um pedido do tipo bonificação, será carregada a tabela PRODUTO_CUSTO, que conterá as informações da tabela 111 do ERP.

Para que isso ocorra de forma correta, o parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com o valor 'S'.

Para que o rateio seja feito sob o menor valor possível do pedido de bonificação, deverá ser gerada a tabela de bonificação para este fim. Essa tabela, que é um espelho da tabela de venda, será apontada a partir do campo A1_XTBBON da tabela SA1. Esse campo contém a tabela que consta o menor valor para o item.

''(Por exemplo: Se no campo A1_XTBBON da tabela SA1 tiver o valor 047, significa que o menor valor possível para aquele item será buscado na tabela 047 do ERP.)''

Sendo assim, a partir desta tabela ''(a 047 por exemplo)'' o sistema deverá buscar o menor valor encontrado. É importante salientar que esta tabela é escalonada, ou seja, o menor preço para o produto será aquele aplicado para a maior quantidade possível, é exatamente este preço que o sistema deverá utilizar para o rateio, desconsiderando o escalonamento.

''(Desconsiderar o escalonamento significa que o valor aplicado para 20 unidades por exemplo, será utilizado para o rateio de uma unidade apenas. Desta forma, garantimos que o menor valor possível será utilizado.)''

== Desenvolvimento ==

Para que o rateio de bonificação seja exibido na tela, é necessário criar uma configuração chamada ID_UTILIZA_RATEIO_BONIFICAO, e, habilitando-a, o sistema exibirá a informação de bonificação para rateio.

O valor a ser rateado será o menor valor possível encontrado na tabela de bonificação vezes a quantidade de itens para aquele valor.

''(Por exemplo, se o vendedor realiza um pedido de bonificação com 10 itens e o valor encontrado na tabela gerada de bonificação é R$12,00, o valor a ser rateado será R$120,00.)''

Feito este tratamento nos valores de bonificação, o valor a ser rateado será enviado para a tela de rateio, onde já é realizado o rateio por valor e por prazo médio, e o rateio por bonificação será incluído. A bonificação a ser rateada, neste caso, é a soma de todos os produtos que estão sendo bonificados , levando em consideração não o valor do PRODUTO_CUSTO ''(que foi usada no pedido de bonificação)'', mas o valor da tabela de bonificação.

Essa situação pode ser visualizada no protótipo abaixo:

[[Arquivo:Rateio bonificacao Tela1.png|400px]]

O usuário poderá escolher ratear o valor especificado para bonificação entre verba e comissão. Clicando no campo 'Tipo Rateio´, é possível escolher o tipo de rateio desejado (verba ou comissão), como pode-ser ver na imagem abaixo:

[[Arquivo:Rateio bonificacao Tela2.png|400px]]

Após selecionar o tipo de rateio desejado, o usuário deve digitar o valor a ser rateado no campo 'Valor Rateio' e clicar no botão 'Inserir' para ratear. É possível também editar, atualizar ou excluir um rateio realizado, como já ocorre atualmente na tela de rateio.

As informações contidas nessa tela serão salvas na tabela PEDIDO_RATEIO_DESCONTO.

Caso um pedido de bonificação não seja totalmente rateado, o valor restante será enviado ao ERP através da tabela PEDIDO_RATEIO_DESCONTO e o campo CD_TIPO_RATEIO_DESCONTO será setado com o valor -1 para esta situação.

O campo CD_TIPO_RATEIO_DESCONTO terá 3 status possíveis:

(1) - Verba;

(2) - Comissão;

(-1) - Restante.

Na tela de rateio somente serão exibidos para seleção os status de Verba e de comissão. O status -1, que determina o valor restante do rateio, será utilizado internamente para enviar esse valor ao ERP. Esse status deverá ser setado com o valor N na coluna TIPO_PEDIDO_RATEIO_DESCONTO.

'''Tabela a ser alterada:'''

{| class="wikitable"
! colspan="5" | TIPO_PEDIDO_RATEIO_DESCONTO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_UTILIZAVEL
| CHAR(1)
| NAO
| NAO
| Flag NULÁVEL que define se o tipo de rateio irá aparecer na tela ou não.
|}

O valor padrão para os campos desta coluna é S, caso o valor setado seja S ou null, o tipo de rateio será exibido na tela de rateio. Bem como, por definição, todos os status com valor N nesta tabela não irão ser exibidos na tela de rateio e serão usados apenas internamente.

== Regras de integração ==

'''[RI1]''' – Para pedidos de bonificação, a tabela 111 será carregada a partir da tabela PRODUTO_CUSTO e o pedido de bonificação será feito utilizando essa tabela, porém, o rateio será feito utilizando a tabela especificada na RI2 deste documento.

'''[RI2]''' – A Tabela de bonificação que será utilizada para rateio será definida pelo apontamento do campo A1_XTBBON da tabela SA1.

'''[RI3]''' – Deverá ser gerada a tabela de bonificação. Essa tabela será criada a partir de um espelho da tabela de venda, que será apontada no campo A1_XTBBON da tabela SA1, esse campo define qual a tabela de bonificação que será utilizada. Essa tabela de venda é escalonada, ou seja, o preço é reduzido conforme a quantidade de itens aumenta. Porém, o sistema deverá gerar a tabela de bonificação como menor valor da tabela de escalonamento, a partir do preço sugerido, aplicando este valor para um único item.

== Regras de Negócio ==

'''[RN1]''' – Para que a solução proposta seja aplicada corretamente é necessário que o usuário escolha a tabela de preço correta.

'''[RN2]''' – Com a configuração ID_UTILIZA_RATEIO_BONIFICACAO estiver habilitada o sistema exibirá a informação para rateio.

'''[RN3]''' – Quando outras configurações que ativam situações de rateio também estiverem habilitadas, o valor total a ser rateado entre comissão e verba será a soma de todas os valores dessas situações, mostrando cada valor distintamente para seu rateio. Essa informação é genérica para a tela de rateio, e é importante salientar que pedidos de bonificação não geram os outros tipos de rateio, então, para pedidos de bonificação só haverá rateio de bonificação.

'''[RN4]''' – Para pedidos de bonificação, será utilizada a tabela PRODUTO_CUSTO. O parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com 'S' para que o sistema utilize a tabela PRODUTO_CUSTO nesses pedidos.

'''[RN5]''' – O valor sugerido da tabela de bonificação será multiplicado pela quantidade de itens, é esse valor que será rateado.

'''[RN6]''' – Caso o valor especificado para rateio não seja totalmente rateado, o restante deste valor será enviado para o ERP através do campo CD_TIPO_RATEIO_DESCONTO com o status (-1).

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Rateio de Bonificação

2018-03-16T13:40:20Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/03/2018 || Ryvane Maria || Criação do Documento
|-
| 16/03/2018 || Marcus Fábio Salviano || Aprovação Desenvolvimento
|-
|}

== Necessidade ==

Toda bonificação gera um custo para a empresa pois, o valor bonificado, deverá ser arcado de alguma forma.

Para que uma bonificação gere o mínimo possível de despesas, é necessário que no momento em que estiver sendo feito o pedido de bonificação, o sistema atribua a esta bonificação o menor valor possível.

Este valor deverá ser rateado entre verba e comissão do vendedor.

== Solução ==

Quando estiver sendo feito um pedido de bonificação, a tabela 111 será carregada na tabela PRODUTO_CUSTO, e o pedido de bonificação será feito usando o valor encontrado na tabela PRODUTO_CUSTO. Porém, para fazer o rateio, será criada uma tabela de preço de bonificação, onde o valor a ser rateado se trata do menor valor encontrado para o item vezes a sua quantidade.

== Integração ==

Inicialmente, quando o usuário estiver realizando um pedido do tipo bonificação, será carregada a tabela PRODUTO_CUSTO, que conterá as informações da tabela 111 do ERP.

Para que isso ocorra de forma correta, o parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com o valor 'S'.

Para que o rateio seja feito sob o menor valor possível do pedido de bonificação, deverá ser gerada a tabela de bonificação para este fim. Essa tabela, que é um espelho da tabela de venda, será apontada a partir do campo A1_XTBBON da tabela SA1. Esse campo contém a tabela que consta o menor valor para o item.

''(Por exemplo: Se no campo A1_XTBBON da tabela SA1 tiver o valor 047, significa que o menor valor possível para aquele item será buscado na tabela 047 do ERP.)''

Sendo assim, a partir desta tabela ''(a 047 por exemplo)'' o sistema deverá buscar o menor valor encontrado. É importante salientar que esta tabela é escalonada, ou seja, o menor preço para o produto será aquele aplicado para a maior quantidade possível, é exatamente este preço que o sistema deverá utilizar para o rateio, desconsiderando o escalonamento.

''(Desconsiderar o escalonamento significa que o valor aplicado para 20 unidades por exemplo, será utilizado para o rateio de uma unidade apenas. Desta forma, garantimos que o menor valor possível será utilizado.)''

== Desenvolvimento ==

Para que o rateio de bonificação seja exibido na tela, é necessário criar uma configuração chamada ID_UTILIZA_RATEIO_BONIFICAO, e, habilitando-a, o sistema exibirá a informação de bonificação para rateio.

O valor a ser rateado será o menor valor possível encontrado na tabela de bonificação vezes a quantidade de itens para aquele valor.

''(Por exemplo, se o vendedor realiza um pedido de bonificação com 10 itens e o valor encontrado na tabela gerada de bonificação é R$12,00, o valor a ser rateado será R$120,00.)''

Feito este tratamento nos valores de bonificação, o valor a ser rateado será enviado para a tela de rateio, onde já é realizado o rateio por valor e por prazo médio, e o rateio por bonificação será incluído. A bonificação a ser rateada, neste caso, é a soma de todos os produtos que estão sendo bonificados , levando em consideração não o valor do PRODUTO_CUSTO ''(que foi usada no pedido de bonificação)'', mas o valor da tabela de bonificação.

Essa situação pode ser visualizada no protótipo abaixo:

[[Arquivo:Rateio bonificacao Tela1.png|400px]]

O usuário poderá escolher ratear o valor especificado para bonificação entre verba e comissão. Clicando no campo 'Tipo Rateio´, é possível escolher o tipo de rateio desejado (verba ou comissão), como pode-ser ver na imagem abaixo:

[[Arquivo:Rateio bonificacao Tela2.png|400px]]

Após selecionar o tipo de rateio desejado, o usuário deve digitar o valor a ser rateado no campo 'Valor Rateio' e clicar no botão 'Inserir' para ratear. É possível também editar, atualizar ou excluir um rateio realizado, como já ocorre atualmente na tela de rateio.

'''Tabelas a serem criadas:'''

{| class="wikitable"
! colspan="5" | PEDIDO_RATEIO_BONIFICACAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PEDIDO_PALM
| INT
| SIM
| SIM
| Código do pedido
|-
| CD_TIPO_RATEIO_BONIFICACAO
| INT
| SIM
| SIM
| Código do rateio da bonificação
|-
| VR_RATEIO_BONIFICACAO
| INT
| SIM
| NÃO
| Valor do rateio da bonificação
|-
|}

== Regras de integração ==

'''[RI1]''' – Para pedidos de bonificação, a tabela 111 será carregada a partir da tabela PRODUTO_CUSTO e o pedido de bonificação será feito utilizando essa tabela, porém, o rateio será feito utilizando a tabela especificada na RI2 deste documento.

'''[RI2]''' – A Tabela de bonificação que será utilizada para rateio será definida pelo apontamento do campo A1_XTBBON da tabela SA1.

'''[RI3]''' – Deverá ser gerada a tabela de bonificação. Essa tabela será criada a partir de um espelho da tabela de venda, que será apontada no campo A1_XTBBON da tabela SA1, esse campo define qual a tabela de bonificação que será utilizada. Essa tabela de venda é escalonada, ou seja, o preço é reduzido conforme a quantidade de itens aumenta. Porém, o sistema deverá gerar a tabela de bonificação como menor valor da tabela de escalonamento, a partir do preço sugerido, aplicando este valor para um único item.

== Regras de Negócio ==

'''[RN1]''' – Para que a solução proposta seja aplicada corretamente é necessário que o usuário escolha a tabela de preço correta.

'''[RN2]''' – Com a configuração ID_UTILIZA_RATEIO_BONIFICACAO estiver habilitada o sistema exibirá a informação para rateio.

'''[RN3]''' – Quando outras configurações que ativam situações de rateio também estiverem habilitadas, o valor total a ser rateado entre comissão e verba será a soma de todas os valores dessas situações, mostrando cada valor distintamente para seu rateio.

'''[RN4]''' – Para pedidos de bonificação, será utilizada a tabela PRODUTO_CUSTO. O parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com 'S' para que o sistema utilize a tabela PRODUTO_CUSTO nesses pedidos.

'''[RN5]''' – O valor sugerido da tabela de bonificação será multiplicado pela quantidade de itens, é esse valor que será rateado.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Rateio de Bonificação

2018-03-16T13:28:15Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/03/2018 || Ryvane Maria || Criação do Documento
|-
|}

== Necessidade ==

Toda bonificação gera um custo para a empresa pois, o valor bonificado, deverá ser arcado de alguma forma.

Para que uma bonificação gere o mínimo possível de despesas, é necessário que no momento em que estiver sendo feito o pedido de bonificação, o sistema atribua a esta bonificação o menor valor possível.

Este valor deverá ser rateado entre verba e comissão do vendedor.

== Solução ==

Quando estiver sendo feito um pedido de bonificação, a tabela 111 será carregada na tabela PRODUTO_CUSTO, e o pedido de bonificação será feito usando o valor encontrado na tabela PRODUTO_CUSTO. Porém, para fazer o rateio, será criada uma tabela de preço de bonificação, onde o valor a ser rateado se trata do menor valor encontrado para o item vezes a sua quantidade.

== Integração ==

Inicialmente, quando o usuário estiver realizando um pedido do tipo bonificação, será carregada a tabela PRODUTO_CUSTO, que conterá as informações da tabela 111 do ERP.

Para que isso ocorra de forma correta, o parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com o valor 'S'.

Para que o rateio seja feito sob o menor valor possível do pedido de bonificação, deverá ser gerada a tabela de bonificação para este fim. Essa tabela, que é um espelho da tabela de venda, será apontada a partir do campo A1_XTBBON da tabela SA1. Esse campo contém a tabela que consta o menor valor para o item.

''(Por exemplo: Se no campo A1_XTBBON da tabela SA1 tiver o valor 047, significa que o menor valor possível para aquele item será buscado na tabela 047 do ERP.)''

Sendo assim, a partir desta tabela ''(a 047 por exemplo)'' o sistema deverá buscar o menor valor encontrado. É importante salientar que esta tabela é escalonada, ou seja, o menor preço para o produto será aquele aplicado para a maior quantidade possível, é exatamente este preço que o sistema deverá utilizar para o rateio, desconsiderando o escalonamento.

''(Desconsiderar o escalonamento significa que o valor aplicado para 20 unidades por exemplo, será utilizado para o rateio de uma unidade apenas. Desta forma, garantimos que o menor valor possível será utilizado.)''

== Desenvolvimento ==

Para que o rateio de bonificação seja exibido na tela, é necessário criar uma configuração chamada ID_UTILIZA_RATEIO_BONIFICAO, e, habilitando-a, o sistema exibirá a informação de bonificação para rateio.

O valor a ser rateado será o menor valor possível encontrado na tabela de bonificação vezes a quantidade de itens para aquele valor.

''(Por exemplo, se o vendedor realiza um pedido de bonificação com 10 itens e o valor encontrado na tabela gerada de bonificação é R$12,00, o valor a ser rateado será R$120,00.)''

Feito este tratamento nos valores de bonificação, o valor a ser rateado será enviado para a tela de rateio, onde já é realizado o rateio por valor e por prazo médio, e o rateio por bonificação será incluído. A bonificação a ser rateada, neste caso, é a soma de todos os produtos que estão sendo bonificados , levando em consideração não o valor do PRODUTO_CUSTO ''(que foi usada no pedido de bonificação)'', mas o valor da tabela de bonificação.

Essa situação pode ser visualizada no protótipo abaixo:

[[Arquivo:Rateio bonificacao Tela1.png|400px]]

O usuário poderá escolher ratear o valor especificado para bonificação entre verba e comissão. Clicando no campo 'Tipo Rateio´, é possível escolher o tipo de rateio desejado (verba ou comissão), como pode-ser ver na imagem abaixo:

[[Arquivo:Rateio bonificacao Tela2.png|400px]]

Após selecionar o tipo de rateio desejado, o usuário deve digitar o valor a ser rateado no campo 'Valor Rateio' e clicar no botão 'Inserir' para ratear. É possível também editar, atualizar ou excluir um rateio realizado, como já ocorre atualmente na tela de rateio.

'''Tabelas a serem criadas:'''

{| class="wikitable"
! colspan="5" | PEDIDO_RATEIO_BONIFICACAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PEDIDO_PALM
| INT
| SIM
| SIM
| Código do pedido
|-
| CD_TIPO_RATEIO_BONIFICACAO
| INT
| SIM
| SIM
| Código do rateio da bonificação
|-
| VR_RATEIO_BONIFICACAO
| INT
| SIM
| NÃO
| Valor do rateio da bonificação
|-
|}

== Regras de integração ==

'''[RI1]''' – Para pedidos de bonificação, a tabela 111 será carregada a partir da tabela PRODUTO_CUSTO e o pedido de bonificação será feito utilizando essa tabela, porém, o rateio será feito utilizando a tabela especificada na RI2 deste documento.

'''[RI2]''' – A Tabela de bonificação que será utilizada para rateio será definida pelo apontamento do campo A1_XTBBON da tabela SA1.

'''[RI3]''' – Deverá ser gerada a tabela de bonificação. Essa tabela será criada a partir de um espelho da tabela de venda, que será apontada no campo A1_XTBBON da tabela SA1, esse campo define qual a tabela de bonificação que será utilizada. Essa tabela de venda é escalonada, ou seja, o preço é reduzido conforme a quantidade de itens aumenta. Porém, o sistema deverá gerar a tabela de bonificação como menor valor da tabela de escalonamento, a partir do preço sugerido, aplicando este valor para um único item.

== Regras de Negócio ==

'''[RN1]''' – Para que a solução proposta seja aplicada corretamente é necessário que o usuário escolha a tabela de preço correta.

'''[RN2]''' – Com a configuração ID_UTILIZA_RATEIO_BONIFICACAO estiver habilitada o sistema exibirá a informação para rateio.

'''[RN3]''' – Quando outras configurações que ativam situações de rateio também estiverem habilitadas, o valor total a ser rateado entre comissão e verba será a soma de todas os valores dessas situações, mostrando cada valor distintamente para seu rateio.

'''[RN4]''' – Para pedidos de bonificação, será utilizada a tabela PRODUTO_CUSTO. O parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com 'S' para que o sistema utilize a tabela PRODUTO_CUSTO nesses pedidos.

'''[RN5]''' – O valor sugerido da tabela de bonificação será multiplicado pela quantidade de itens, é esse valor que será rateado.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Rateio de Bonificação

2018-03-16T13:27:10Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/03/2018 || Ryvane Maria || Criação do Documento
|-
|}

== Necessidade ==

Toda bonificação gera um custo para a empresa pois, o valor bonificado, deverá ser arcado de alguma forma.

Para que uma bonificação gere o mínimo possível de despesas, é necessário que no momento em que estiver sendo feito o pedido de bonificação, o sistema atribua a esta bonificação o menor valor possível.

Este valor deverá ser rateado entre verba e comissão do vendedor.

== Solução ==

Quando estiver sendo feito um pedido de bonificação, a tabela 111 será carregada na tabela PRODUTO_CUSTO, e o pedido de bonificação será feito usando o valor encontrado na tabela PRODUTO_CUSTO. Porém, para fazer o rateio, será criada uma tabela de preço de bonificação, onde o valor a ser rateado se trata do menor valor encontrado para o item vezes a sua quantidade.

== Integração ==

Inicialmente, quando o usuário estiver realizando um pedido do tipo bonificação, será carregada a tabela PRODUTO_CUSTO, que conterá as informações da tabela 111 do ERP.

Para que isso ocorra de forma correta, o parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com o valor 'S'.

Para que o rateio seja feito sob o menor valor possível do pedido de bonificação, deverá ser gerada a tabela de bonificação para este fim. Essa tabela, que é um espelho da tabela de venda, será apontada a partir do campo A1_XTBBON da tabela SA1. Esse campo contém a tabela que consta o menor valor para o item.

''(Por exemplo: Se no campo A1_XTBBON da tabela SA1 tiver o valor 047, significa que o menor valor possível para aquele item será buscado na tabela 047 do ERP.)''

Sendo assim, a partir desta tabela ''(a 047 por exemplo)'' o sistema deverá buscar o menor valor encontrado. É importante salientar que esta tabela é escalonada, ou seja, o menor preço para o produto será aquele aplicado para a maior quantidade possível, é exatamente este preço que o sistema deverá utilizar para o rateio, desconsiderando o escalonamento.

''(Desconsiderar o escalonamento significa que o valor aplicado para 20 unidades por exemplo, será utilizado para o rateio de uma unidade apenas. Desta forma, garantimos que o menor valor possível será utilizado.)''

== Desenvolvimento ==

Para que o rateio de bonificação seja exibido na tela, é necessário criar uma configuração chamada ID_UTILIZA_RATEIO_BONIFICAO, e, habilitando-a, o sistema exibirá a informação de bonificação para rateio.

O valor a ser rateado será o menor valor possível encontrado na tabela de bonificação vezes a quantidade de itens para aquele valor.

''(Por exemplo, se o vendedor realiza um pedido de bonificação com 10 itens e o valor encontrado na tabela gerada de bonificação é R$12,00, o valor a ser rateado será R$120,00.)''

Feito este tratamento nos valores de bonificação, o valor a ser rateado será enviado para a tela de rateio, onde já é realizado o rateio por valor e por prazo médio, e o rateio por bonificação será incluído. A bonificação a ser rateada, neste caso, é a soma de todos os produtos que estão sendo bonificados , levando em consideração não o valor do PRODUTO_CUSTO ''(que foi usada no pedido de bonificação)'', mas o valor da tabela de bonificação.

Essa situação pode ser visualizada no protótipo abaixo:

[[Arquivo:Rateio bonificacao Tela1.png|400px]]

O usuário poderá escolher ratear o valor especificado para bonificação entre verba e comissão. Clicando no campo 'Tipo Rateio´, é possível escolher o tipo de rateio desejado (verba ou comissão), como pode-ser ver na imagem abaixo:

[[Arquivo:Rateio bonificacao Tela2.png|400px]]

Após selecionar o tipo de rateio desejado, o usuário deve digitar o valor a ser rateado no campo 'Valor Rateio' e clicar no botão 'Inserir' para ratear. É possível também editar, atualizar ou excluir um rateio realizado, como já ocorre atualmente na tela de rateio.

'''Tabelas a serem criadas:'''

{| class="wikitable"
! colspan="5" | PEDIDO_RATEIO_BONIFICACAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PEDIDO_PALM
| INT
| SIM
| SIM
| Código do palm
|-
| CD_TIPO_RATEIO_BONIFICACAO
| INT
| SIM
| SIM
| Código do rateio da bonificação
|-
| VR_RATEIO_BONIFICACAO
| INT
| SIM
| NÃO
| Valor da bonificação
|-
|}

== Regras de integração ==

'''[RI1]''' – Para pedidos de bonificação, a tabela 111 será carregada a partir da tabela PRODUTO_CUSTO e o pedido de bonificação será feito utilizando essa tabela, porém, o rateio será feito utilizando a tabela especificada na RI2 deste documento.

'''[RI2]''' – A Tabela de bonificação que será utilizada para rateio será definida pelo apontamento do campo A1_XTBBON da tabela SA1.

'''[RI3]''' – Deverá ser gerada a tabela de bonificação. Essa tabela será criada a partir de um espelho da tabela de venda, que será apontada no campo A1_XTBBON da tabela SA1, esse campo define qual a tabela de bonificação que será utilizada. Essa tabela de venda é escalonada, ou seja, o preço é reduzido conforme a quantidade de itens aumenta. Porém, o sistema deverá gerar a tabela de bonificação como menor valor da tabela de escalonamento, a partir do preço sugerido, aplicando este valor para um único item.

== Regras de Negócio ==

'''[RN1]''' – Para que a solução proposta seja aplicada corretamente é necessário que o usuário escolha a tabela de preço correta.

'''[RN2]''' – Com a configuração ID_UTILIZA_RATEIO_BONIFICACAO estiver habilitada o sistema exibirá a informação para rateio.

'''[RN3]''' – Quando outras configurações que ativam situações de rateio também estiverem habilitadas, o valor total a ser rateado entre comissão e verba será a soma de todas os valores dessas situações, mostrando cada valor distintamente para seu rateio.

'''[RN4]''' – Para pedidos de bonificação, será utilizada a tabela PRODUTO_CUSTO. O parâmetro de configuração ID_BONIFICACAO_VALOR_CUSTO deve ser preenchido com 'S' para que o sistema utilize a tabela PRODUTO_CUSTO nesses pedidos.

'''[RN5]''' – O valor sugerido da tabela de bonificação será multiplicado pela quantidade de itens, é esse valor que será rateado.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Sequência de aprovação de pendências

2018-03-06T13:32:34Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 23/02/2018 || Ryvane Maria || Criação do Documento
|-
| 06/03/2018 || Marcus Fábio Salviano || Aprovação Desenvolvimento
|-
|}

== Necessidade ==

Ao realizar um pedido qualquer, é possível que este pedido fique pendente por vários motivos como por exemplo: descontos aplicados, rentabilidade, frete, verba, bonificação, dentre outros.

Acontece que essas pendências podem, a qualquer momento, ser liberadas pelo supervisor responsável, sem que haja uma ordem a ser seguida para liberação de pendências. Em outras palavras, não há uma sequência sobre o que precisa ser aprovado primeiro.

Essa situação é prejudicial à aprovação do pedido em si pois há algumas pendências que dependem da aprovação de outras. Por exemplo, para que uma pendência do tipo frete seja aprovada pode ser necessário que as pendências de bonificação tenham sido aprovadas anteriormente.

== Solução ==

Será criada uma nova funcionalidade no portal GeoSales chamada "Ordenação de pendências".

Essa funcionalidade irá definir sob qual ordem as pendências poderão ser aprovadas, de acordo com a necessidade do cliente.

== Implementação ==

A aprovação de pendências seguirá a seguinte ordem:

1) Verba comercial, e bonificações comercial e trade;

2) Descontos no preço;

3) Verba frete;

4) Fretes.

É importante salientar o fluxo que a aprovação de pendências seguirá:

Inicialmente poderá ser aprovada as pendências de verba comercial, e bonificações comercial e trade, e somente após a liberação dessas pendências é que as pendências do tipo desconto no preço serão liberadas para aprovação.

Sendo aprovadas as pendências de desconto no preço, é liberada para aprovação a pendência de verba frete.

A última pendência a ser liberada é a pendência de fretes, e poderá ser aprovada após a aprovação das pendências de verba frete.

== Regras de Negócio ==

'''[RN1]''' – As pendências só irão ser liberadas para aprovação na ordem especificada neste documento. Por exemplo a pendência 'Verba frete' só poderá ser liberada quando a pendência 'Descontos no preço' for aprovada.

'''[RN2]''' – As pendências não especificadas neste documento não entrarão em nenhum fluxo sequencial de aprovação e poderão ser aprovadas a qualquer momento.

'''[RN3]''' – O cadastro da sequência de aprovação de pendências será feito exclusivamente pelo GeoSales.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Vendedor Segmentado

2018-03-01T19:38:15Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 26/02/2018 || Ryvane Maria || Criação do Documento
|-
| 28/02/2018 || Marcus Fábio Salviano || Aprovação Desenvolvimento
|-
| 01/03/2018 || Ryvane Maria || Alteração da RN2 e do fluxo da solução.
|-
| 01/03/2018 || Marcus Fábio Salviano || Aprovação modificações Desenvolvimento
|-
|}

== Necessidade ==

Deve-se permitir que um cliente seja atendido por dois vendedores diferentes.

Estes vendedores irão atender o mesmo cliente, porém, vendendo produtos diferentes para cada um.

Terá que ser duplicado, no ERP, o cadastro do cliente, de forma que o mesmo cliente possua dois cadastros diferentes sob a visão do GeoSales; desta forma, aparentemente, dois vendedores atenderão o mesmo cliente com cadastros diferentes.

Apesar do cadastro dos clientes ser duplicado, o controle de inadimplência de títulos deverá ser feito de forma unificada, ou seja, o cliente terá seu controle de inadimplência feito para os seus dois cadastros como se fossem um só. Isso evita que um cliente inadimplente para um vendedor consiga realizar um pedido com outro vendedor.

== Solução ==

No ERP, o cadastro do cliente será duplicado e esse cliente será enxergado pelo GeoSales como sendo dois clientes diferentes, atendidos por dois vendedores diferentes.

Desta forma, o mesmo cliente terá, no GeoSales, dois códigos diferentes onde um código será associado a um vendedor, e outro código a outro vendedor. Cada vendedor só terá acesso aos produtos cadastrados para o seu respectivo código do cliente duplicado.

Apesar de aparentemente existirem dois clientes diferentes, só existe um cliente real, e o controle de inadimplência deve ser unificado para os clientes que foram duplicados, ou seja, ao invés de realizar o controle de inadimplência por código, deverá ser realizada por cliente. Desta forma, o controle de inadimplência irá validar os dois cadastros como um só.

Na visão do GeoSales o cadastro duplicado de vendedores só será enxergado no momento de realizar o controle de inadimplência.

Esse controle é feito através dos títulos em abertos de um determinado cliente. Para realizar este controle, o GeoSales irá atribuir os títulos de um dos cadastros do cliente duplicado a outro, e vice versa.

A solução apresentada está ilustrada no fluxo abaixo:

[[Arquivo:fluxo_vendseg.png|600px]]

1) A primeira etapa cabe ao ERP e se trata da duplicação do cadastro do cliente, ou seja, um cliente A, se transforma para o GeoSales em dois clientes: A1 e A2.

2) A segunda etapa será feita pelo GeoSales, e distribuirá os títulos de um cliente para o outro. O cliente A1 conterá os títulos referentes também ao cliente A2, e vice-versa. É importante salientar que, ao enviar os títulos de um cliente para o outro, o campo VR_TITULO será enviado com o valor R$ 00,00 (zero), isso será feito para que o limite de crédito do cliente A1 não interfira no limite de crédito do cliente A2 e vice-versa.

3) No momento da validação de inadimplência, o sistema validará os títulos do cliente A1 como já é feito atualmente, sem se preocupar com os títulos do cliente A2, pois estes títulos já estarão duplicados em A1, porém com o campo VR_TITULO = 0. É importante salientar que o limite de crédito do cliente A não será compartilhado entre os cadastros de cliente A1 e A2.

== Implementação ==

Quando um dos clientes que foi duplicado tiver um título em atraso, esse título vai ser replicado no seu cliente análogo.

A relação entre os clientes análogos será feita através do CPF/CNPJ desses clientes, que será consultado do campo de CPF/CNPJ da tabela padrão SA1.

Localizando essa informação, os títulos desses clientes serão compartilhados, ou seja, todos os clientes com o mesmo CPF/CNPJ conterão os títulos uns dos outros.

Sempre que o sistema for consultar os títulos de um cliente para realizar a validação de inadimplência o sistema irá, através da integração, visualizar os títulos do outro cliente que está associado ao CPF/CNPJ deste cliente.

Para possibilitar tal situação, será feita uma atribuição na tabela TITULO, onde iremos relacionar para cada cliente seu respectivo CPF/CNPJ.

== Regras de Negócio ==

'''[RN1]''' – A duplicação do cadastro dos clientes será feita exclusivamente no ERP, e nenhuma validação será feita no Geosales a respeito disso.

'''[RN2]''' – O GeoSales irá validar o limite de crédito, como já ocorre atualmente, e os títulos replicados em ambos os cadastros não irão interferir na validação de limite de crédito, pois o campo VR_TITULO será enviado com o valor zero. Desta forma, o GeoSales irá validar o limite de crédito sem considerar os títulos que foram replicados dos outros cadastros do cliente. Isso quer dizer que o cliente não compartilhará o limite de crédito entre seus cadastros.

'''[RN3]''' – Não será enviada ao ERP nenhuma informação que especifique que o cliente é um cliente duplicado

'''[RN4]''' – Será utilizado para essa funcionalidade o CPF/CNPJ completo para validação de clientes.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Vendedor Segmentado

2018-03-01T19:38:01Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 26/02/2018 || Ryvane Maria || Criação do Documento
|-
| 28/02/2018 || Marcus Fábio Salviano || Aprovação Desenvolvimento
|-
| 01/03/2018 || Ryvane Maria || Alteração da RN2 e do fluxo da solução.
|-
| 01/03/2018 || Marcus Fábio Salviano || Aprovação Desenvolvimento modificações
|-
|}

== Necessidade ==

Deve-se permitir que um cliente seja atendido por dois vendedores diferentes.

Estes vendedores irão atender o mesmo cliente, porém, vendendo produtos diferentes para cada um.

Terá que ser duplicado, no ERP, o cadastro do cliente, de forma que o mesmo cliente possua dois cadastros diferentes sob a visão do GeoSales; desta forma, aparentemente, dois vendedores atenderão o mesmo cliente com cadastros diferentes.

Apesar do cadastro dos clientes ser duplicado, o controle de inadimplência de títulos deverá ser feito de forma unificada, ou seja, o cliente terá seu controle de inadimplência feito para os seus dois cadastros como se fossem um só. Isso evita que um cliente inadimplente para um vendedor consiga realizar um pedido com outro vendedor.

== Solução ==

No ERP, o cadastro do cliente será duplicado e esse cliente será enxergado pelo GeoSales como sendo dois clientes diferentes, atendidos por dois vendedores diferentes.

Desta forma, o mesmo cliente terá, no GeoSales, dois códigos diferentes onde um código será associado a um vendedor, e outro código a outro vendedor. Cada vendedor só terá acesso aos produtos cadastrados para o seu respectivo código do cliente duplicado.

Apesar de aparentemente existirem dois clientes diferentes, só existe um cliente real, e o controle de inadimplência deve ser unificado para os clientes que foram duplicados, ou seja, ao invés de realizar o controle de inadimplência por código, deverá ser realizada por cliente. Desta forma, o controle de inadimplência irá validar os dois cadastros como um só.

Na visão do GeoSales o cadastro duplicado de vendedores só será enxergado no momento de realizar o controle de inadimplência.

Esse controle é feito através dos títulos em abertos de um determinado cliente. Para realizar este controle, o GeoSales irá atribuir os títulos de um dos cadastros do cliente duplicado a outro, e vice versa.

A solução apresentada está ilustrada no fluxo abaixo:

[[Arquivo:fluxo_vendseg.png|600px]]

1) A primeira etapa cabe ao ERP e se trata da duplicação do cadastro do cliente, ou seja, um cliente A, se transforma para o GeoSales em dois clientes: A1 e A2.

2) A segunda etapa será feita pelo GeoSales, e distribuirá os títulos de um cliente para o outro. O cliente A1 conterá os títulos referentes também ao cliente A2, e vice-versa. É importante salientar que, ao enviar os títulos de um cliente para o outro, o campo VR_TITULO será enviado com o valor R$ 00,00 (zero), isso será feito para que o limite de crédito do cliente A1 não interfira no limite de crédito do cliente A2 e vice-versa.

3) No momento da validação de inadimplência, o sistema validará os títulos do cliente A1 como já é feito atualmente, sem se preocupar com os títulos do cliente A2, pois estes títulos já estarão duplicados em A1, porém com o campo VR_TITULO = 0. É importante salientar que o limite de crédito do cliente A não será compartilhado entre os cadastros de cliente A1 e A2.

== Implementação ==

Quando um dos clientes que foi duplicado tiver um título em atraso, esse título vai ser replicado no seu cliente análogo.

A relação entre os clientes análogos será feita através do CPF/CNPJ desses clientes, que será consultado do campo de CPF/CNPJ da tabela padrão SA1.

Localizando essa informação, os títulos desses clientes serão compartilhados, ou seja, todos os clientes com o mesmo CPF/CNPJ conterão os títulos uns dos outros.

Sempre que o sistema for consultar os títulos de um cliente para realizar a validação de inadimplência o sistema irá, através da integração, visualizar os títulos do outro cliente que está associado ao CPF/CNPJ deste cliente.

Para possibilitar tal situação, será feita uma atribuição na tabela TITULO, onde iremos relacionar para cada cliente seu respectivo CPF/CNPJ.

== Regras de Negócio ==

'''[RN1]''' – A duplicação do cadastro dos clientes será feita exclusivamente no ERP, e nenhuma validação será feita no Geosales a respeito disso.

'''[RN2]''' – O GeoSales irá validar o limite de crédito, como já ocorre atualmente, e os títulos replicados em ambos os cadastros não irão interferir na validação de limite de crédito, pois o campo VR_TITULO será enviado com o valor zero. Desta forma, o GeoSales irá validar o limite de crédito sem considerar os títulos que foram replicados dos outros cadastros do cliente. Isso quer dizer que o cliente não compartilhará o limite de crédito entre seus cadastros.

'''[RN3]''' – Não será enviada ao ERP nenhuma informação que especifique que o cliente é um cliente duplicado

'''[RN4]''' – Será utilizado para essa funcionalidade o CPF/CNPJ completo para validação de clientes.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Vendedor Segmentado

2018-03-01T19:14:01Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 26/02/2018 || Ryvane Maria || Criação do Documento
|-
| 28/02/2018 || Marcus Fábio Salviano || Aprovação Desenvolvimento
|-
| 01/03/2018 || Marcus Fábio Salviano || 2ª Aprovação Desenvolvimento, após modificações
|-
|}

== Necessidade ==

Deve-se permitir que um cliente seja atendido por dois vendedores diferentes.

Estes vendedores irão atender o mesmo cliente, porém, vendendo produtos diferentes para cada um.

Terá que ser duplicado, no ERP, o cadastro do cliente, de forma que o mesmo cliente possua dois cadastros diferentes sob a visão do GeoSales; desta forma, aparentemente, dois vendedores atenderão o mesmo cliente com cadastros diferentes.

Apesar do cadastro dos clientes ser duplicado, o controle de inadimplência de títulos deverá ser feito de forma unificada, ou seja, o cliente terá seu controle de inadimplência feito para os seus dois cadastros como se fossem um só. Isso evita que um cliente inadimplente para um vendedor consiga realizar um pedido com outro vendedor.

== Solução ==

No ERP, o cadastro do cliente será duplicado e esse cliente será enxergado pelo GeoSales como sendo dois clientes diferentes, atendidos por dois vendedores diferentes.

Desta forma, o mesmo cliente terá, no GeoSales, dois códigos diferentes onde um código será associado a um vendedor, e outro código a outro vendedor. Cada vendedor só terá acesso aos produtos cadastrados para o seu respectivo código do cliente duplicado.

Apesar de aparentemente existirem dois clientes diferentes, só existe um cliente real, e o controle de inadimplência deve ser unificado para os clientes que foram duplicados, ou seja, ao invés de realizar o controle de inadimplência por código, deverá ser realizada por cliente. Desta forma, o controle de inadimplência irá validar os dois cadastros como um só.

Na visão do GeoSales o cadastro duplicado de vendedores só será enxergado no momento de realizar o controle de inadimplência.

Esse controle é feito através dos títulos em abertos de um determinado cliente. Para realizar este controle, o GeoSales irá atribuir os títulos de um dos cadastros do cliente duplicado a outro, e vice versa.

A solução apresentada está ilustrada no fluxo abaixo:

[[Arquivo:fluxo_vendseg.png|600px]]

1) A primeira etapa cabe ao ERP e se trata da duplicação do cadastro do cliente, ou seja, um cliente A, se transforma para o GeoSales em dois clientes: A1 e A2.

2) A segunda etapa será feita pelo GeoSales, e distribuirá os títulos de um cliente para o outro. O cliente A1 conterá os títulos referentes também ao cliente A2, e vice-versa. É importante salientar que, ao enviar os títulos de um cliente para o outro, o campo VR_TITULO será enviado com o valor R$ 00,00 (zero), isso será feito para que o limite de crédito do cliente A1 não interfira no limite de crédito do cliente A2 e vice-versa.

3) No momento da validação de inadimplência, o sistema validará os títulos do cliente A1 como já é feito atualmente, sem se preocupar com os títulos do cliente A2, pois estes títulos já estarão duplicados em A1, porém com o campo VR_TITULO = 0. É importante salientar que o limite de crédito do cliente A não será compartilhado entre os cadastros de cliente A1 e A2.

== Implementação ==

Quando um dos clientes que foi duplicado tiver um título em atraso, esse título vai ser replicado no seu cliente análogo.

A relação entre os clientes análogos será feita através do CPF/CNPJ desses clientes, que será consultado do campo de CPF/CNPJ da tabela padrão SA1.

Localizando essa informação, os títulos desses clientes serão compartilhados, ou seja, todos os clientes com o mesmo CPF/CNPJ conterão os títulos uns dos outros.

Sempre que o sistema for consultar os títulos de um cliente para realizar a validação de inadimplência o sistema irá, através da integração, visualizar os títulos do outro cliente que está associado ao CPF/CNPJ deste cliente.

Para possibilitar tal situação, será feita uma atribuição na tabela TITULO, onde iremos relacionar para cada cliente seu respectivo CPF/CNPJ.

== Regras de Negócio ==

'''[RN1]''' – A duplicação do cadastro dos clientes será feita exclusivamente no ERP, e nenhuma validação será feita no Geosales a respeito disso.

'''[RN2]''' – O GeoSales irá validar o limite de crédito, como já ocorre atualmente, e os títulos replicados em ambos os cadastros não irão interferir na validação de limite de crédito, pois o campo VR_TITULO será enviado com o valor zero. Desta forma, o GeoSales irá validar o limite de crédito sem considerar os títulos que foram replicados dos outros cadastros do cliente. Isso quer dizer que o cliente não compartilhará o limite de crédito entre seus cadastros.

'''[RN3]''' – Não será enviada ao ERP nenhuma informação que especifique que o cliente é um cliente duplicado

'''[RN4]''' – Será utilizado para essa funcionalidade o CPF/CNPJ completo para validação de clientes.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Vendedor Segmentado

2018-02-28T20:03:55Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 26/02/2018 || Ryvane Maria || Criação do Documento
|-
| 28/02/2018 || Marcus Fábio Salviano || Aprovação Desenvolvimento
|-
|}

== Necessidade ==

Deve-se permitir que um cliente seja atendido por dois vendedores diferentes.

Estes vendedores irão atender o mesmo cliente, porém, vendendo produtos diferentes para cada um.

Terá que ser duplicado, no ERP, o cadastro do cliente, de forma que o mesmo cliente possua dois cadastros diferentes sob a visão do GeoSales; desta forma, aparentemente, dois vendedores atenderão o mesmo cliente com cadastros diferentes.

Apesar do cadastro dos clientes ser duplicado, o controle de inadimplência de títulos deverá ser feito de forma unificada, ou seja, o cliente terá seu controle de inadimplência feito para os seus dois cadastros como se fossem um só. Isso evita que um cliente inadimplente para um vendedor consiga realizar um pedido com outro vendedor.

== Solução ==

No ERP, o cadastro do cliente será duplicado e esse cliente será enxergado pelo GeoSales como sendo dois clientes diferentes, atendidos por dois vendedores diferentes.

Desta forma, o mesmo cliente terá, no GeoSales, dois códigos diferentes onde um código será associado a um vendedor, e outro código a outro vendedor. Cada vendedor só terá acesso aos produtos cadastrados para o seu respectivo código do cliente duplicado.

Apesar de aparentemente existirem dois clientes diferentes, só existe um cliente real, e o controle de inadimplência deve ser unificado para os clientes que foram duplicados, ou seja, ao invés de realizar o controle de inadimplência por código, deverá ser realizada por cliente. Desta forma, o controle de inadimplência irá validar os dois cadastros como um só.

Na visão do GeoSales o cadastro duplicado de vendedores só será enxergado no momento de realizar o controle de inadimplência.

Esse controle é feito através dos títulos em abertos de um determinado cliente. Para realizar este controle, o GeoSales irá atribuir os títulos de um dos cadastros do cliente duplicado a outro, e vice versa.

A solução apresentada está ilustrada no fluxo abaixo:

[[Arquivo:fluxo_vendseg.png|600px]]

1) A primeira etapa cabe ao ERP e se trata da duplicação do cadastro do cliente, ou seja, um cliente A, se transforma para o GeoSales em dois clientes: A1 e A2.

2) A segunda etapa será feita pelo GeoSales, e distribuirá os títulos de um cliente para o outro. O cliente A1 conterá os títulos referentes também ao cliente A2, e vice-versa.

3) No momento da validação de inadimplência, o sistema validará os títulos do cliente A1 como já é feito atualmente, sem se preocupar com os títulos do cliente A2, pois estes já estarão duplicados em A1. É importante salientar que o limite de crédito do cliente A será compartilhado entre os cadastros de cliente A1 e A2.

== Implementação ==

Quando um dos clientes que foi duplicado tiver um título em atraso, esse título vai ser replicado no seu cliente análogo.

A relação entre os clientes análogos será feita através do CNPJ desses clientes, que será consultado do campo de CNPJ da tabela padrão SA1.

Localizando essa informação, os títulos desses clientes serão compartilhados, ou seja, todos os clientes com o mesmo CNPJ conterão os títulos uns dos outros.

Sempre que o sistema for consultar os títulos de um cliente para realizar a validação de inadimplência o sistema irá, através da integração, visualizar os títulos do outro cliente que está associado ao CNPJ deste cliente.

Para possibilitar tal situação, será feita uma atribuição na tabela TITULO, onde iremos relacionar para cada cliente seu respectivo CNPJ.

== Regras de Negócio ==

'''[RN1]''' – A duplicação do cadastro dos clientes será feita exclusivamente no ERP, e nenhuma validação será feita no Geosales a respeito disso.

'''[RN2]''' – O GeoSales não irá validar o limite de crédito, ou seja, a partir do momento que os títulos forem replicados para ambos os cadastros do cliente, o limite de crédito de ambos será abatido. Isso quer dizer que o cliente compartilhará o limite de crédito entre seus dois cadastros.

'''[RN3]''' – Não será enviada ao ERP nenhuma informação que especifique que o cliente é um cliente duplicado

'''[RN4]''' – Será utilizado para essa funcionalidade o CNPJ completo para validação de clientes.

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

INFORMAÇÕES FRETE

2017-12-05T17:42:27Z

Marcus.salviano: /* Implementação */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2017 || Renato Lima || Criação do Documento
|-
| 15/09/2017 || Leonardo Sousa || Aprovação do Documento
|-
| 10/10/2017 || Inaldo França || Envio do documento para Mizu
|}

== Necessidade ==

Para otimizar o processo de entrega de seus pedidos junto ao cliente final, de forma que venha facilitar a chegada da informação do local da entrega e repasse de informações de como e quem fará a entrega da compra, o cliente necessita que no momento de lançar o pedido, sejam repassados informações de placa, motorista e obra.

== Solução ==
Implementar rotina para quando selecionar o tipo de frete configurado, ter um local para que o vendedor selecione as informações referente a obra,placa e motorista.

== Implementação ==
Para implementar a inserção de informações ao selecionar um tipo de frete, deve ser criada as seguintes tabelas abaixo.

'''TABELAS A SEREM CRIADAS'''

{| class="wikitable"
! colspan="5" | VEICULO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_VEICULO
| INT
| SIM
| SIM
| Código do veículo
|-
| NM_VEICULO
| VARCHAR(60)
| NÃO
| NÃO
| Modelo veículo
|-
| NM_PLACA
| VARCHAR(7)
| NÃO
| NÃO
| Placa
|-
| MARCA
| VARCHAR(80)
| NÃO
| NÃO
| Marca veiculo
|-
| QT_CAPACIDADE
| DECIMAL(13)
| NÃO
| NÃO
| Capacidade
|-
|}

{| class="wikitable"
! colspan="5" | MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| NM_MOTORISTA
| VARCHAR(100)
| NÃO
| NÃO
| Nome do motorista
|-
| NR_CPF
| VARCHAR(25)
| NÃO
| NÃO
| Numero CPF
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| CD_CLIENTE
| INT
| SIM
| SIM
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| NM_OBRA
| VARCHAR(100)
| NÃO
| NÃO
| Nome da Obra
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| CD_CLIENTE
| INT
| SIM
| SIM
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | TIPO_INFORMACAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_TIPO_INF
| INT
| SIM
| SIM
| Id da informação
|-
| DS_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| NOME DA INFORMAÇÃO
|-
| TP_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| O tipo que será a Informação:
Estruturada - {Motorista},{Veiculo},{Obra}
Livre - Date, Varchar , INT, Char
|-
| Pergunta_informacao
| Varchar(150)
| NÃO
| NÃO
| Informação a ser exibida.
|-
|}

{| class="wikitable"
! colspan="5" | PEDIDO_INFORMACAO_EXTRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PEDIDO_PALM
| BIGINT
| SIM
| SIM
| Código do pedido
|-
| CD_INF
| VARCHAR(100)
| SIM
| SIM
| Nome da informação
|-
| CD_TIPO_INF
| INT
| NÃO
| NÃO
| Código da informaçao estruturada
|-
| DS_LIVRE_INF
| VARCHAR(150)
| NÃO
| NÃO
| Descrição Livre
|-
|}

*As tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra devem ser preenchidas através da integração.

*Para ativar a solicitação de informações, deve ser utilizada as configurações:
'''ID_HABILITA_OBS_FRETE''' -
*CHAVE - ID_HABILITA_OBS_FRETE
**VALOR - S ou N
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''ID_TIPO_FRETE_OBS''' - a configuração receberá o ID_TIPO_FRETE dos fretes que precisam solicitar essas informações, o campo poderá receber um ou mais id_tipo_frete.

*Quando não houver a configuração ou ela estiver inserida, mas com o DS_VALOR null, deve manter o comportamento normal da tela de pedido, sem solicitar informação para o frete selecionado.

*Quando a configuração estiver inserida '''ID_HABILITA_OBS_FRETE''' e a '''ID_TIPO_FRETE_OBS''' tiver o(s) id_tipo_frete (s) preenchido(s) no campo valor. Na tela de pedido ao selecionar o frete que está configurado para pedir mais informações, deve apresentar um alerta informando que o tipo de frete selecionado pede mais informações.

'''DS_OBS_FRETE_PADRAO''' - Será usada quando o tipo de frete exigir informações e esses dados serão inseridos no campo DS_OBS_FATURAMENTO da tabela de pedido, salva apenas como texto no campo.

[[Arquivo:TELA 3.png|600px]]

Na tela de pedido o campo Observação de nota fiscal ficará dentro de DADOS FRETE.
Quando a configuração ID_HABILITA_OBS_FRETE=S estiver inserida, o botão de dados será mostrado, ao clicar o sistema exibirá uma nova tela para inserir os dados.

[[Arquivo:TELA 1.png|600px]]

* Os campos estruturados serão exibidos de acordo com ID_TIPO_INF da tabela TIPO_INFORMACAO.
*O nome do campo será exibido de acordo com o campo '''Pergunta_informacao''' que esta na tela TIPO_INFORMACAO.

*As informações a serem exibidas nos dados estruturados, buscará das tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra.

*As informações selecionadas serão salvas na tabela PEDIDO_INFORMACAO_EXTRA.
**Ao Salvar o pedido o sistema ira verificar o tipo de Informação e irá inserir:
*Codigo do pedido
* Descrição da informação
* Tipo da Informação
**Será inserida no CD_INF_ESTRUT, quando a informação for do tipo {estruturada}
**Será inserida no DS_LIVRE_INF quando a informação for do tipo livre

[[Arquivo:TELA 2.png|600px]]

*Quando o cliente não selecionar a opção de dados estruturados o sistema modificará a tela a ser exibida e mostrar o campo Obs. Frete, que poderá carregar ele vazio ou com descrições de informações que precisam ser preenchidas, referente ao frete.
*Dentro do campo poderá vir um texto determinando, o que precisa é ser utilizada a configuração '''DS_OBS_FRETE_PADRAO''' e inserir as informações que precisam ser exibidas dentro do campo de texto.
*Os dados inseridos nesse campo será salvo em DS_OBS_FATURAMENTO da tabela de pedido.

===Regras de Negócio===

'''RN1''' – Ao abrir a tela, mostrará apenas itens que estejam vinculados ao cliente do pedido, para que seja selecionado.

'''RN2''' – Os dados são obrigatórios para inserção, no momento de salvar o pedido validar se os dados foram selecionados, caso não tenha sido, deve apresentar mensagem ao usuário pedido para informar os dados através do botão dados frete.

'''RN3''' – Na edição de pedido os campos só estarão disponiveis para edição, quando o tipo de frete estiver com permissão para alteração no grupo de permissão.

'''RN4''' – A funcionalidade será ativada quando a configuração estiver inserida através do menu Cadastro>Parametros Configuração

*CHAVE - '''ID_HABILITA_OBS_FRETE'''
*VALOR - '''ID_TIPO_FRETE'''
** '''S''' - Funcionalidade ativada.
** '''N''' - Funcionalidade não ativada.
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

Para obrigar os frentes a pedir a observação a configuração será utilizada.
*CHAVE - '''ID_TIPO_FRETE_OBS'''
*VALOR - '''ID_TIPO_FRETE''' que pedirão observação

*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''RN5''' – Quando a configuração ID_HABILITA_OBS_FRETE Não estiver em Cadastro>Parametros Configuração, não será exibido o botão dados frete.

'''RN6''' – A funcionalidade funcionará para os ambientes que são possíveis realizar pedido, portal e mobile.

== 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
| Gustavo Hand Strey
|
|
|-
| Gerente Projeto
| Inaldo França
|
|
|-
| Gerente Comercial
| Renato César
|
|
|}

INFORMAÇÕES FRETE

2017-11-22T19:20:30Z

Marcus.salviano: /* Implementação */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2017 || Renato Lima || Criação do Documento
|-
| 15/09/2017 || Leonardo Sousa || Aprovação do Documento
|-
| 10/10/2017 || Inaldo França || Envio do documento para Mizu
|}

== Necessidade ==

Para otimizar o processo de entrega de seus pedidos junto ao cliente final, de forma que venha facilitar a chegada da informação do local da entrega e repasse de informações de como e quem fará a entrega da compra, o cliente necessita que no momento de lançar o pedido, sejam repassados informações de placa, motorista e obra.

== Solução ==
Implementar rotina para quando selecionar o tipo de frete configurado, ter um local para que o vendedor selecione as informações referente a obra,placa e motorista.

== Implementação ==
Para implementar a inserção de informações ao selecionar um tipo de frete, deve ser criada as seguintes tabelas abaixo.

'''TABELAS A SEREM CRIADAS'''

{| class="wikitable"
! colspan="5" | VEICULO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_VEICULO
| INT
| SIM
| SIM
| Código do veículo
|-
| NM_VEICULO
| VARCHAR(60)
| NÃO
| NÃO
| Modelo veículo
|-
| NM_PLACA
| VARCHAR(7)
| NÃO
| NÃO
| Placa
|-
| MARCA
| VARCHAR(80)
| NÃO
| NÃO
| Marca veiculo
|-
| QT_CAPACIDADE
| DECIMAL(13)
| NÃO
| NÃO
| Capacidade
|-
|}

{| class="wikitable"
! colspan="5" | MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| NM_MOTORISTA
| VARCHAR(100)
| NÃO
| NÃO
| Nome do motorista
|-
| NR_CPF
| VARCHAR(25)
| NÃO
| NÃO
| Numero CPF
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| CD_CLIENTE
| INT
| SIM
| SIM
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| NM_OBRA
| VARCHAR(100)
| NÃO
| NÃO
| Nome da Obra
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| CD_CLIENTE
| INT
| SIM
| SIM
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | TIPO_INFORMACAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_TIPO_INF
| INT
| SIM
| SIM
| Id da informação
|-
| DS_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| NOME DA INFORMAÇÃO
|-
| TP_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| O tipo que será a Informação:
Estruturada - {Motorista},{Veiculo},{Obra}
Livre - Date, Varchar , INT, Char
|-
| Pergunta_informacao
| Varchar(150)
| NÃO
| NÃO
| Informação a ser exibida.
|-
|}

{| class="wikitable"
! colspan="5" | PEDIDO_INFORMACAO_EXTRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PEDIDO_PALM
| BIGINT
| SIM
| SIM
| Código do pedido
|-
| DS_TIPO_INF
| VARCHAR(100)
| SIM
| SIM
| Nome da informação
|-
| CD_INF_ESTRUT
| INT
| NÃO
| NÃO
| Código da informaçao estruturada
|-
| DS_LIVRE_INF
| VARCHAR(150)
| NÃO
| NÃO
| Descrição Livre
|-
|}

*As tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra devem ser preenchidas através da integração.

*Para ativar a solicitação de informações, deve ser utilizada as configurações:
'''ID_HABILITA_OBS_FRETE''' -
*CHAVE - ID_HABILITA_OBS_FRETE
**VALOR - S ou N
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''ID_TIPO_FRETE_OBS''' - a configuração receberá o ID_TIPO_FRETE dos fretes que precisam solicitar essas informações, o campo poderá receber um ou mais id_tipo_frete.

*Quando não houver a configuração ou ela estiver inserida, mas com o DS_VALOR null, deve manter o comportamento normal da tela de pedido, sem solicitar informação para o frete selecionado.

*Quando a configuração estiver inserida '''ID_HABILITA_OBS_FRETE''' e a '''ID_TIPO_FRETE_OBS''' tiver o(s) id_tipo_frete (s) preenchido(s) no campo valor. Na tela de pedido ao selecionar o frete que está configurado para pedir mais informações, deve apresentar um alerta informando que o tipo de frete selecionado pede mais informações.

'''DS_OBS_FRETE_PADRAO''' - Será usada quando o tipo de frete exigir informações e esses dados serão inseridos no campo DS_OBS_FATURAMENTO da tabela de pedido, salva apenas como texto no campo.

[[Arquivo:TELA 3.png|600px]]

Na tela de pedido o campo Observação de nota fiscal ficará dentro de DADOS FRETE.
Quando a configuração ID_HABILITA_OBS_FRETE=S estiver inserida, o botão de dados será mostrado, ao clicar o sistema exibirá uma nova tela para inserir os dados.

[[Arquivo:TELA 1.png|600px]]

* Os campos estruturados serão exibidos de acordo com ID_TIPO_INF da tabela TIPO_INFORMACAO.
*O nome do campo será exibido de acordo com o campo '''Pergunta_informacao''' que esta na tela TIPO_INFORMACAO.

*As informações a serem exibidas nos dados estruturados, buscará das tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra.

*As informações selecionadas serão salvas na tabela PEDIDO_INFORMACAO_EXTRA.
**Ao Salvar o pedido o sistema ira verificar o tipo de Informação e irá inserir:
*Codigo do pedido
* Descrição da informação
* Tipo da Informação
**Será inserida no CD_INF_ESTRUT, quando a informação for do tipo {estruturada}
**Será inserida no DS_LIVRE_INF quando a informação for do tipo livre

[[Arquivo:TELA 2.png|600px]]

*Quando o cliente não selecionar a opção de dados estruturados o sistema modificará a tela a ser exibida e mostrar o campo Obs. Frete, que poderá carregar ele vazio ou com descrições de informações que precisam ser preenchidas, referente ao frete.
*Dentro do campo poderá vir um texto determinando, o que precisa é ser utilizada a configuração '''DS_OBS_FRETE_PADRAO''' e inserir as informações que precisam ser exibidas dentro do campo de texto.
*Os dados inseridos nesse campo será salvo em DS_OBS_FATURAMENTO da tabela de pedido.

===Regras de Negócio===

'''RN1''' – Ao abrir a tela, mostrará apenas itens que estejam vinculados ao cliente do pedido, para que seja selecionado.

'''RN2''' – Os dados são obrigatórios para inserção, no momento de salvar o pedido validar se os dados foram selecionados, caso não tenha sido, deve apresentar mensagem ao usuário pedido para informar os dados através do botão dados frete.

'''RN3''' – Na edição de pedido os campos só estarão disponiveis para edição, quando o tipo de frete estiver com permissão para alteração no grupo de permissão.

'''RN4''' – A funcionalidade será ativada quando a configuração estiver inserida através do menu Cadastro>Parametros Configuração

*CHAVE - '''ID_HABILITA_OBS_FRETE'''
*VALOR - '''ID_TIPO_FRETE'''
** '''S''' - Funcionalidade ativada.
** '''N''' - Funcionalidade não ativada.
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

Para obrigar os frentes a pedir a observação a configuração será utilizada.
*CHAVE - '''ID_TIPO_FRETE_OBS'''
*VALOR - '''ID_TIPO_FRETE''' que pedirão observação

*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''RN5''' – Quando a configuração ID_HABILITA_OBS_FRETE Não estiver em Cadastro>Parametros Configuração, não será exibido o botão dados frete.

'''RN6''' – A funcionalidade funcionará para os ambientes que são possíveis realizar pedido, portal e mobile.

== 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
| Gustavo Hand Strey
|
|
|-
| Gerente Projeto
| Inaldo França
|
|
|-
| Gerente Comercial
| Renato César
|
|
|}

INFORMAÇÕES FRETE

2017-11-22T19:19:41Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2017 || Renato Lima || Criação do Documento
|-
| 15/09/2017 || Leonardo Sousa || Aprovação do Documento
|-
| 10/10/2017 || Inaldo França || Envio do documento para Mizu
|}

== Necessidade ==

Para otimizar o processo de entrega de seus pedidos junto ao cliente final, de forma que venha facilitar a chegada da informação do local da entrega e repasse de informações de como e quem fará a entrega da compra, o cliente necessita que no momento de lançar o pedido, sejam repassados informações de placa, motorista e obra.

== Solução ==
Implementar rotina para quando selecionar o tipo de frete configurado, ter um local para que o vendedor selecione as informações referente a obra,placa e motorista.

== Implementação ==
Para implementar a inserção de informações ao selecionar um tipo de frete, deve ser criada as seguintes tabelas abaixo.

'''TABELAS A SEREM CRIADAS'''

{| class="wikitable"
! colspan="5" | VEICULO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_VEICULO
| INT
| SIM
| SIM
| Código do veículo
|-
| NM_VEICULO
| VARCHAR(60)
| NÃO
| NÃO
| Modelo veículo
|-
| NM_PLACA
| VARCHAR(7)
| NÃO
| NÃO
| Placa
|-
| MARCA
| VARCHAR(80)
| NÃO
| NÃO
| Marca veiculo
|-
| QT_CAPACIDADE
| DECIMAL(13)
| NÃO
| NÃO
| Capacidade
|-
|}

{| class="wikitable"
! colspan="5" | MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| NM_MOTORISTA
| VARCHAR(100)
| NÃO
| NÃO
| Nome do motorista
|-
| NR_CPF
| VARCHAR(25)
| NÃO
| NÃO
| Numero CPF
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| CD_CLIENTE
| INT
| SIM
| SIM
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| NM_OBRA
| VARCHAR(100)
| NÃO
| NÃO
| Nome da Obra
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| CD_CLIENTE
| INT
| SIM
| SIM
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | TIPO_INFORMACAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_TIPO_INF
| INT
| NÃO
| NÃO
| Id da informação
|-
| DS_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| NOME DA INFORMAÇÃO
|-
| TP_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| O tipo que será a Informação:
Estruturada - {Motorista},{Veiculo},{Obra}
Livre - Date, Varchar , INT, Char
|-
| Pergunta_informacao
| Varchar(150)
| NÃO
| NÃO
| Informação a ser exibida.
|-
|}

{| class="wikitable"
! colspan="5" | PEDIDO_INFORMACAO_EXTRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PEDIDO_PALM
| BIGINT
| SIM
| SIM
| Código do pedido
|-
| DS_TIPO_INF
| VARCHAR(100)
| SIM
| SIM
| Nome da informação
|-
| CD_INF_ESTRUT
| INT
| NÃO
| NÃO
| Código da informaçao estruturada
|-
| DS_LIVRE_INF
| VARCHAR(150)
| NÃO
| NÃO
| Descrição Livre
|-
|}

*As tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra devem ser preenchidas através da integração.

*Para ativar a solicitação de informações, deve ser utilizada as configurações:
'''ID_HABILITA_OBS_FRETE''' -
*CHAVE - ID_HABILITA_OBS_FRETE
**VALOR - S ou N
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''ID_TIPO_FRETE_OBS''' - a configuração receberá o ID_TIPO_FRETE dos fretes que precisam solicitar essas informações, o campo poderá receber um ou mais id_tipo_frete.

*Quando não houver a configuração ou ela estiver inserida, mas com o DS_VALOR null, deve manter o comportamento normal da tela de pedido, sem solicitar informação para o frete selecionado.

*Quando a configuração estiver inserida '''ID_HABILITA_OBS_FRETE''' e a '''ID_TIPO_FRETE_OBS''' tiver o(s) id_tipo_frete (s) preenchido(s) no campo valor. Na tela de pedido ao selecionar o frete que está configurado para pedir mais informações, deve apresentar um alerta informando que o tipo de frete selecionado pede mais informações.

'''DS_OBS_FRETE_PADRAO''' - Será usada quando o tipo de frete exigir informações e esses dados serão inseridos no campo DS_OBS_FATURAMENTO da tabela de pedido, salva apenas como texto no campo.

[[Arquivo:TELA 3.png|600px]]

Na tela de pedido o campo Observação de nota fiscal ficará dentro de DADOS FRETE.
Quando a configuração ID_HABILITA_OBS_FRETE=S estiver inserida, o botão de dados será mostrado, ao clicar o sistema exibirá uma nova tela para inserir os dados.

[[Arquivo:TELA 1.png|600px]]

* Os campos estruturados serão exibidos de acordo com ID_TIPO_INF da tabela TIPO_INFORMACAO.
*O nome do campo será exibido de acordo com o campo '''Pergunta_informacao''' que esta na tela TIPO_INFORMACAO.

*As informações a serem exibidas nos dados estruturados, buscará das tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra.

*As informações selecionadas serão salvas na tabela PEDIDO_INFORMACAO_EXTRA.
**Ao Salvar o pedido o sistema ira verificar o tipo de Informação e irá inserir:
*Codigo do pedido
* Descrição da informação
* Tipo da Informação
**Será inserida no CD_INF_ESTRUT, quando a informação for do tipo {estruturada}
**Será inserida no DS_LIVRE_INF quando a informação for do tipo livre

[[Arquivo:TELA 2.png|600px]]

*Quando o cliente não selecionar a opção de dados estruturados o sistema modificará a tela a ser exibida e mostrar o campo Obs. Frete, que poderá carregar ele vazio ou com descrições de informações que precisam ser preenchidas, referente ao frete.
*Dentro do campo poderá vir um texto determinando, o que precisa é ser utilizada a configuração '''DS_OBS_FRETE_PADRAO''' e inserir as informações que precisam ser exibidas dentro do campo de texto.
*Os dados inseridos nesse campo será salvo em DS_OBS_FATURAMENTO da tabela de pedido.

===Regras de Negócio===

'''RN1''' – Ao abrir a tela, mostrará apenas itens que estejam vinculados ao cliente do pedido, para que seja selecionado.

'''RN2''' – Os dados são obrigatórios para inserção, no momento de salvar o pedido validar se os dados foram selecionados, caso não tenha sido, deve apresentar mensagem ao usuário pedido para informar os dados através do botão dados frete.

'''RN3''' – Na edição de pedido os campos só estarão disponiveis para edição, quando o tipo de frete estiver com permissão para alteração no grupo de permissão.

'''RN4''' – A funcionalidade será ativada quando a configuração estiver inserida através do menu Cadastro>Parametros Configuração

*CHAVE - '''ID_HABILITA_OBS_FRETE'''
*VALOR - '''ID_TIPO_FRETE'''
** '''S''' - Funcionalidade ativada.
** '''N''' - Funcionalidade não ativada.
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

Para obrigar os frentes a pedir a observação a configuração será utilizada.
*CHAVE - '''ID_TIPO_FRETE_OBS'''
*VALOR - '''ID_TIPO_FRETE''' que pedirão observação

*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''RN5''' – Quando a configuração ID_HABILITA_OBS_FRETE Não estiver em Cadastro>Parametros Configuração, não será exibido o botão dados frete.

'''RN6''' – A funcionalidade funcionará para os ambientes que são possíveis realizar pedido, portal e mobile.

== 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
| Gustavo Hand Strey
|
|
|-
| Gerente Projeto
| Inaldo França
|
|
|-
| Gerente Comercial
| Renato César
|
|
|}

INFORMAÇÕES FRETE

2017-11-22T19:18:37Z

Marcus.salviano: /* Implementação */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/09/2017 || Renato Lima || Criação do Documento
|-
| 15/09/2017 || Leonardo Sousa || Aprovação do Documento
|-
| 10/10/2017 || Inaldo França || Envio do documento para Mizu
|}

== Necessidade ==

Para otimizar o processo de entrega de seus pedidos junto ao cliente final, de forma que venha facilitar a chegada da informação do local da entrega e repasse de informações de como e quem fará a entrega da compra, o cliente necessita que no momento de lançar o pedido, sejam repassados informações de placa, motorista e obra.

== Solução ==
Implementar rotina para quando selecionar o tipo de frete configurado, ter um local para que o vendedor selecione as informações referente a obra,placa e motorista.

== Implementação ==
Para implementar a inserção de informações ao selecionar um tipo de frete, deve ser criada as seguintes tabelas abaixo.

'''TABELAS A SEREM CRIADAS'''

{| class="wikitable"
! colspan="5" | VEICULO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_VEICULO
| INT
| SIM
| SIM
| Código do veículo
|-
| NM_VEICULO
| VARCHAR(60)
| NÃO
| NÃO
| Modelo veículo
|-
| NM_PLACA
| VARCHAR(7)
| NÃO
| NÃO
| Placa
|-
| MARCA
| VARCHAR(80)
| NÃO
| NÃO
| Marca veiculo
|-
| QT_CAPACIDADE
| DECIMAL(13)
| NÃO
| NÃO
| Capacidade
|-
|}

{| class="wikitable"
! colspan="5" | MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| NM_MOTORISTA
| VARCHAR(100)
| NÃO
| NÃO
| Nome do motorista
|-
| NR_CPF
| VARCHAR(25)
| NÃO
| NÃO
| Numero CPF
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_MOTORISTA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_MOTORISTA
| INT
| SIM
| SIM
| Código Motorista
|-
| CD_CLIENTE
| INT
| NÃO
| NÃO
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| NM_OBRA
| VARCHAR(100)
| NÃO
| NÃO
| Nome da Obra
|-
|}

{| class="wikitable"
! colspan="5" | CLIENTE_OBRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_OBRA
| INT
| SIM
| SIM
| Código da obra
|-
| CD_CLIENTE
| INT
| NÃO
| NÃO
| Código do cliente
|-
|}

{| class="wikitable"
! colspan="5" | TIPO_INFORMACAO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| ID_TIPO_INF
| INT
| NÃO
| NÃO
| Id da informação
|-
| DS_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| NOME DA INFORMAÇÃO
|-
| TP_TIPO_INF
| VARCHAR(80)
| NÃO
| NÃO
| O tipo que será a Informação:
Estruturada - {Motorista},{Veiculo},{Obra}
Livre - Date, Varchar , INT, Char
|-
| Pergunta_informacao
| Varchar(150)
| NÃO
| NÃO
| Informação a ser exibida.
|-
|}

{| class="wikitable"
! colspan="5" | PEDIDO_INFORMACAO_EXTRA
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_PEDIDO_PALM
| BIGINT
| SIM
| SIM
| Código do pedido
|-
| DS_TIPO_INF
| VARCHAR(100)
| SIM
| SIM
| Nome da informação
|-
| CD_INF_ESTRUT
| INT
| NÃO
| NÃO
| Código da informaçao estruturada
|-
| DS_LIVRE_INF
| VARCHAR(150)
| NÃO
| NÃO
| Descrição Livre
|-
|}

*As tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra devem ser preenchidas através da integração.

*Para ativar a solicitação de informações, deve ser utilizada as configurações:
'''ID_HABILITA_OBS_FRETE''' -
*CHAVE - ID_HABILITA_OBS_FRETE
**VALOR - S ou N
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''ID_TIPO_FRETE_OBS''' - a configuração receberá o ID_TIPO_FRETE dos fretes que precisam solicitar essas informações, o campo poderá receber um ou mais id_tipo_frete.

*Quando não houver a configuração ou ela estiver inserida, mas com o DS_VALOR null, deve manter o comportamento normal da tela de pedido, sem solicitar informação para o frete selecionado.

*Quando a configuração estiver inserida '''ID_HABILITA_OBS_FRETE''' e a '''ID_TIPO_FRETE_OBS''' tiver o(s) id_tipo_frete (s) preenchido(s) no campo valor. Na tela de pedido ao selecionar o frete que está configurado para pedir mais informações, deve apresentar um alerta informando que o tipo de frete selecionado pede mais informações.

'''DS_OBS_FRETE_PADRAO''' - Será usada quando o tipo de frete exigir informações e esses dados serão inseridos no campo DS_OBS_FATURAMENTO da tabela de pedido, salva apenas como texto no campo.

[[Arquivo:TELA 3.png|600px]]

Na tela de pedido o campo Observação de nota fiscal ficará dentro de DADOS FRETE.
Quando a configuração ID_HABILITA_OBS_FRETE=S estiver inserida, o botão de dados será mostrado, ao clicar o sistema exibirá uma nova tela para inserir os dados.

[[Arquivo:TELA 1.png|600px]]

* Os campos estruturados serão exibidos de acordo com ID_TIPO_INF da tabela TIPO_INFORMACAO.
*O nome do campo será exibido de acordo com o campo '''Pergunta_informacao''' que esta na tela TIPO_INFORMACAO.

*As informações a serem exibidas nos dados estruturados, buscará das tabelas Veiculo, Motorista, Cliente Motorista, Obra, Cliente Obra.

*As informações selecionadas serão salvas na tabela PEDIDO_INFORMACAO_EXTRA.
**Ao Salvar o pedido o sistema ira verificar o tipo de Informação e irá inserir:
*Codigo do pedido
* Descrição da informação
* Tipo da Informação
**Será inserida no CD_INF_ESTRUT, quando a informação for do tipo {estruturada}
**Será inserida no DS_LIVRE_INF quando a informação for do tipo livre

[[Arquivo:TELA 2.png|600px]]

*Quando o cliente não selecionar a opção de dados estruturados o sistema modificará a tela a ser exibida e mostrar o campo Obs. Frete, que poderá carregar ele vazio ou com descrições de informações que precisam ser preenchidas, referente ao frete.
*Dentro do campo poderá vir um texto determinando, o que precisa é ser utilizada a configuração '''DS_OBS_FRETE_PADRAO''' e inserir as informações que precisam ser exibidas dentro do campo de texto.
*Os dados inseridos nesse campo será salvo em DS_OBS_FATURAMENTO da tabela de pedido.

===Regras de Negócio===

'''RN1''' – Ao abrir a tela, mostrará apenas itens que estejam vinculados ao cliente do pedido, para que seja selecionado.

'''RN2''' – Os dados são obrigatórios para inserção, no momento de salvar o pedido validar se os dados foram selecionados, caso não tenha sido, deve apresentar mensagem ao usuário pedido para informar os dados através do botão dados frete.

'''RN3''' – Na edição de pedido os campos só estarão disponiveis para edição, quando o tipo de frete estiver com permissão para alteração no grupo de permissão.

'''RN4''' – A funcionalidade será ativada quando a configuração estiver inserida através do menu Cadastro>Parametros Configuração

*CHAVE - '''ID_HABILITA_OBS_FRETE'''
*VALOR - '''ID_TIPO_FRETE'''
** '''S''' - Funcionalidade ativada.
** '''N''' - Funcionalidade não ativada.
*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

Para obrigar os frentes a pedir a observação a configuração será utilizada.
*CHAVE - '''ID_TIPO_FRETE_OBS'''
*VALOR - '''ID_TIPO_FRETE''' que pedirão observação

*SINCRONIZA MOBILE - S ou N
** '''S''' - Funcionalidade ativada no mobile
** '''N''' - Funcionará apenas no portal.

'''RN5''' – Quando a configuração ID_HABILITA_OBS_FRETE Não estiver em Cadastro>Parametros Configuração, não será exibido o botão dados frete.

'''RN6''' – A funcionalidade funcionará para os ambientes que são possíveis realizar pedido, portal e mobile.

== 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
| Gustavo Hand Strey
|
|
|-
| Gerente Projeto
| Inaldo França
|
|
|-
| Gerente Comercial
| Renato César
|
|
|}

Montagem de Carga

2017-11-14T19:13:39Z

Marcus.salviano: /* Regras de Negócio */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 09/11/2017 || Renato Lima|| Criação do Documento
|-
| 10/11/2017 || Ryvane Maria || Edição do Documento (Solução, implementação e regras de negócio)

|}

== Necessidade ==
Cliente tem a necessidade de uma customização no sistema com a finalidade de auxiliar na montagem, no planejamento e na definição de suas cargas, gerando otimização, desempenho e agilidade no processo de entrega e distribuição dos seus pedidos.

Essa necessidade surge mediante a dificuldade em automatizar o frete manual de cada pedido incluso na carga. Atualmente, o usuário que está definindo a carga a ser enviada deve, de forma manual, calcular e alterar o valor do frete de cada pedido individualmente. Tendo em vista essa situação, o cliente precisa de uma customização que possibilite este planejamento, facilitando a negociação de valores e definindo automaticamente o valor do frete de cada pedido incluso na carga.

== Solução ==

Criação de uma funcionalidade no sistema, onde será permitido ao usuário avaliar as informações dos pedidos disponíveis para montagem de carga, seguindo as regras de negócio contidas neste documento. Através da gestão e movimentação desses pedidos e dos indicadores de totalização, a montagem da carga será realizada de forma mais eficaz, a fim de otimizar a entrega.

Este processo permitirá a montagem de carga, via portal, onde o usuário poderá associar pedidos de forma a compor uma carga mais efetiva antes de enviar os pedidos para entrega.

Logo abaixo observa-se o protótipo inicial da solução da tela de montagem de carga.

[[Arquivo:Tela CadastroDeCarga.png|600px]]

=Implementação=

Será criada uma nova tela, que apresentará os pedidos que estejam disponíveis para montagem de carga, seguindo as regras de negócio deste documento. As cargas serão montadas a partir desta tela, selecionando os pedidos que farão parte da carga em questão.

Inicialmente, a tela apresentará opções para filtros de pedidos. É permitido ao usuário adicionar alguns filtros de pesquisa, como por exemplo: cliente, período de emissão, faixa de peso, UF, cidade, tipo de pedido, frete e organização de venda, sendo este ultimo o único obrigatório, como mostra a imagem abaixo:

[[Arquivo:MontagemCarga_Filtros.png|500px]]

Após a seleção e a pesquisa mediante os filtros desejados, o usuário se depara com uma lista de pedidos prontos para entrega, que necessitam ser alocados em uma carga para então serem integrados ao ERP, como mostra a imagem abaixo:

[[Arquivo:MontagemCarga PedidosDisponiveis.png|500px]]

A partir desta lista é possível visualizar algumas informações importantes a respeito dos pedidos filtrados, como código do pedido, cliente, valor do frete, UF, cidade, data de emissão, peso e quantidade de paletes.

Caso o usuário deseje adicionar um pedido a carga, deve selecionar o campo de check situado a direita das informações do pedido. Caso deseje adicionar todos os pedidos da página o primeiro campo de check pode ser selecionado, preenchendo assim todos os outros campos.

Caso o número de pedidos filtrados exceda a quantidade escolhida de pedidos por página, que pode ser configurada no canto inferior direito da lista de pedidos, é criada uma nova página. A navegação entre as páginas existentes é feita através dos botões 'próxima página' e 'página anterior', também situados no canto inferior direito da lista. Entre estes dois botões o usuário pode visualizar o número da página em que ele se encontra.

Ao selecionar o campo de check, o pedido selecionado será adicionado a lista de pedidos contidos na carga que está sendo criada. Esta lista, com configuração e layout semelhante a lista anterior, contém uma breve visualização da carga que está sendo montada.

Um exemplo da lista de pedidos selecionados pode ser visualizada na imagem abaixo:

[[Arquivo:MontagemCarga PedidosSelecionados.png|500px]]

Para excluir um pedido que já foi adicionado a carga, o usuário deve utilizar o botão ‘lixeira' localizado a direita de cada campo. Ao clicar no botão lixeira, uma confirmação em forma de pop-up será aberta com a finalidade de confirmar a exclusão do pedido.

Logo abaixo da lista de pedidos contidos na carga, o usuário pode tanto selecionar a transportadora desejada, quanto definir manualmente um valor de frete, que será rateado entre os pedidos contidos na carga final, levando em consideração o seu peso. Transportadora e frete manual são selecionados nos campos abaixo:

[[Arquivo:MontagemCarga Transporte.png|500px]]

Toda e qualquer alteração que o usuário realizar na carga, como por exemplo adicionar ou excluir pedidos, mudança de transportadora e de valor de frete, é automaticamente compilado pelo sistema, gerando um breve relatório de montagem de carga.

Este relatório tem como objetivo principal facilitar ao usuário a visualização de dados importantes à montagem da Carga, como por exemplo a organização de venda origem, valor e peso total da carga e quantidade de paletes.

O relatório irá permitir que o usuário realize todos os ajustes necessários a fim de tornar o transporte de cargas mais eficaz, reduzindo os custos e o tempo de entrega. Logo abaixo pode-se visualizar o modelo inicial que o relatório será apresentado:

[[Arquivo:MontagemCarga Relatorio.png|500px]]

Como pode-se ver na imagem acima, o usuário visualiza o relatório de carga gerado e, usando os botões do canto inferior direito, tem a opção de cancelar a operação, que consequentemente apaga todos os dados salvos na carga em questão.

Ao clicar no botão ‘cancelar' um pop-up é exibido na tela a fim de confirmar a operação e alertar o usuário a cerca da perda de todas as informações inclusas na carga.

Além disso, o usuário também pode salvar aquela carga, e depois visualiza-la no histórico de montagem de cargas para posterior fechamento, ou finalizar a Carga, enviando-a para a ERP e iniciando o processo de entrega dos pedidos.

'''Criar as seguintes tabelas.'''

{| class="wikitable"
! colspan="5" | CARGA_DADOS
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_CARGA
| INT
| SIM
| SIM
| Codigo da Carga
|-
| CD_ORG_VENDA
| VARCHAR(20)
| SIM
| NÃO
| Organização venda
|-
| CD_TRANSPORTADORA
| INT
| SIM
| NÃO
| Transportadora informada
|-
| DT_EMISSAO_CARGA
| DATE
| NÃO
| NÃO
| Data de criação da carga
|-
| VR_TOTAL_CARGA
| DECIMAL(18,6)
| NÃO
| NÃO
| Valor total da carga
|-
| PESO_TOTAL_CARGA
| DECIMAL(18,6)
| NÃO
| NÃO
| Peso total da carga
|-
| VR_FRETE_MANUAL
| DECIMAL(18,6)
| NÃO
| NÃO
| Valor total do frete
|-
| QT_PALETE_CARGA
| DECIMAL(18,6)
| NÃO
| NÃO
| Quantidade Total de palete
|-
| CARGA_STATUS
| CHAR
| NÃO
| NÃO
| Status da CARGA
|-
| DT_EXPEDICAO_CARGA
| DATE
| NÃO
| NÃO
| DATA_EXPEDICAO
|-
|}

{| class="wikitable"
! colspan="5" | CARGA_PEDIDO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_CARGA
| INT
| SIM
| SIM
| Codigo da Carga
|-
| CD_PEDIDO_PALM
| BIGINT
| SIM
| NÃO
| Codigo do pedido que pertence a carga
|-
| VR_FRETE_RATEIO_CARGA
| DECIMAL(18,6)
| NÃO
| NÃO
| Valor do frete rateado na carga
|-
|}

==Regras de Negócio==

'''[RN1]''' – Para realizar a integração ao ERP, os pedidos devem, obrigatoriamente, estar autorizados (sem nenhuma pendência), efetivados e dentro de uma carga.

'''[RN2]''' – Os pedidos que serão exibidos para seleção, na tela que irá realizar a composição da Carga:
*ainda não devem estar integrados ao ERP.
*não devem estar cancelados.
*devem estar autorizados ou seja, não devem constar pendências.
*não devem estar compondo outra carga.

'''[RN3]''' – Ao selecionar uma nova transportadora, e consequentemente um novo valor de frete para a carga total, o sistema deverá atualizar os pedidos selecionados a informação do novo valor de frete, sendo este valor calculado para a carga total, rateando entre os pedidos, usando como critério o peso de cada pedido. O cálculo de valor de frete, levando em consideração o peso de cada pedido, é dada pela formula a seguir:

[[Arquivo:calculoDeFretePedido.png|300px]]

'''[RN4]''' – Para realizar a integração ao ERP, as cargas devem, obrigatoriamente, estar com o status de finalizadas.

==Documentos Vinculados ==

Documento de Montagem de carga - [http://10.0.0.32/wiki/index.php/Hist%C3%B3rico_de_Carga]

== 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
! style="width:180px" |Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
| Jean Semedo
|
|
|-
| Gerente Projeto
| Felipe Suppi
|
|
|-
| Gerente Comercial
| Fernanda Gomes
|
|
|}

Venda por lote

2017-09-28T20:35:44Z

Marcus.salviano:

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento.
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações de ortografia e formatação no texto para melhor entendimento.
- Alterações na seção "Aplicação desconto" (texto e estrutura da tabela '''DESCONTO_LOTE''').

- Criação da '''[RN6]'''.
|-
| 27/09/2017 || Renato Lima || Criação da RN7, Mudar o desenhos das telas de mobile e portal, além do desenvolvimentos da funcionalidade tela a tela.
|-
| 27/09/2017 || Marcus Fábio Salviano || Documento aprovado pelo desenvolvimento.
|-
|}

== Necessidade ==
A empresa tem a necessidade do controle de venda por produto lote, para que se possa gerar um rastreamento e uma politica de preço diferenciada.
Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===
'''PORTAL'''

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Qt Estoque''': Quantidade de itens em estoque para aquele lote

'''- Preco''': Preço do lote

'''- Vencimento''': Data de validade do lote

[[Arquivo:TelaPedidosLote33.png]]

O vendedor ao visualizar a tabela com as opções detalhadas deverá escolher o lote e em seguida clicar em selecionar. O sistema voltará para tela e ao lado do botão lote, vai exibir o nome do lote, do produto selecionado.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.
Caso deseje inserir o mesmo produto de um lote diferente, o usuário fará o mesmo processo.

[[Arquivo:TelaProdutoLote111.png]]

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

'''MOBILE'''

No GeoSales Mobile o vendedor fará a busca do produto, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações de Lote, qt estoque, preco e vencimento.

[[Arquivo:MobileTelaSelecaoLote1.png]]

O vendedor ao Visulizar a tabela com as opções detalhadas deverá escolher o lote e em seguida clicar em selecionar. O sistema voltará para tela e ao lado do botão lote, vai exibir o nome do lote, do produto selecionado. Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar. Caso deseje inserir o mesmo produto de um lote diferente, o usuário fará o mesmo processo.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

Na Tabela de item pedido deve ser inserido o campo cd_lote.

{| class="wikitable"
! colspan="5" | ITEM_PEDIDO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| NAO
| NAO
| Código do lote
|-
|}

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

'''[RN6]''' - O sistema dever ter a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto e assim contemple a aplicação de desconto por lote e demais tipos de descontos existentes.

'''[RN7]''' - O sistema não aceitará um produto de mesmo lote, só poderá ser inserido mesmo produto se possuir lotes diferentes.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T20:28:44Z

Marcus.salviano: /* Regras de Negócio */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento.
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações de ortografia e formatação no texto para melhor entendimento.
- Alterações na seção "Aplicação desconto" (texto e estrutura da tabela '''DESCONTO_LOTE''').

- Criação da '''[RN6]'''.
|}

== Necessidade ==
A empresa tem a necessidade do controle de venda por produto lote, para que se possa gerar um rastreamento e uma politica de preço diferenciada.
Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===
'''PORTAL'''

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Qt Estoque''': Quantidade de itens em estoque para aquele lote

'''- Preco''': Preço do lote

'''- Vencimento''': Data de validade do lote

[[Arquivo:TelaPedidosLote33.png]]

O vendedor ao visualizar a tabela com as opções detalhadas deverá escolher o lote e em seguida clicar em selecionar. O sistema voltará para tela e ao lado do botão lote, vai exibir o nome do lote, do produto selecionado.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.
Caso deseje inserir o mesmo produto de um lote diferente, o usuário fará o mesmo processo.

[[Arquivo:TelaProdutoLote111.png]]

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

'''MOBILE'''

No GeoSales Mobile o vendedor fará a busca do produto, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações de Lote, qt estoque, preco e vencimento.

[[Arquivo:MobileTelaSelecaoLote1.png]]

O vendedor ao Visulizar a tabela com as opções detalhadas deverá escolher o lote e em seguida clicar em selecionar. O sistema voltará para tela e ao lado do botão lote, vai exibir o nome do lote, do produto selecionado. Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar. Caso deseje inserir o mesmo produto de um lote diferente, o usuário fará o mesmo processo.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

Na Tabela de item pedido deve ser inserido o campo cd_lote.

{| class="wikitable"
! colspan="5" | ITEM_PEDIDO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| NAO
| NAO
| Código do lote
|-
|}

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

'''[RN6]''' - O sistema dever ter a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto e assim contemple a aplicação de desconto por lote e demais tipos de descontos existentes.

'''[RN7]''' - O sistema não aceitará um produto de mesmo lote, só poderá ser inserido mesmo produto se possuir lotes diferentes.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T15:08:04Z

Marcus.salviano: /* Cadastro de Pedido */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento.
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações de ortografia e formatação no texto para melhor entendimento.
- Alterações na seção "Aplicação desconto" (texto e estrutura da tabela '''DESCONTO_LOTE''').

- Criação da '''[RN6]'''.
|}

== Necessidade ==
A empresa tem a necessidade do controle de venda por produto lote, para que se possa gerar um rastreamento e uma politica de preço diferenciada.
Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===
'''PORTAL'''

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Qt Estoque''': Quantidade de itens em estoque para aquele lote

'''- Preco''': Preço do lote

'''- Vencimento''': Data de validade do lote

[[Arquivo:TelaPedidosLote33.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá escolher o lote e em seguida clicar em selecionar. O sistema voltará para tela e ao lado do botão lote exibir o lote do produto selecionado.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.
Caso deseje inserir o mesmo produto de um lote diferente, o usuário fará o mesmo processo.

[[Arquivo:TelaProdutoLote111.png]]

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

'''MOBILE'''

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote1.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

Na Tabela de item pedido deve ser inserido o campo cd_lote.

{| class="wikitable"
! colspan="5" | ITEM_PEDIDO
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| NAO
| NAO
| Código do lote
|-
|}

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

'''[RN6]''' - O sistema dever ter a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto e assim contemple a aplicação de desconto por lote e demais tipos de descontos existentes.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:35:27Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento.
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações de ortografia e formatação no texto para melhor entendimento.
- Alterações na seção "Aplicação desconto" (texto e estrutura da tabela '''DESCONTO_LOTE''').

- Criação da '''[RN6]'''.
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

'''[RN6]''' - Deve ser criada a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:34:04Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações no texto: ortografia e formatação, para melhor entendimento.
- Alterações na seção "Aplicação desconto" (texto e estrutura da tabela '''DESCONTO_LOTE''')
- Criação da '''RN6'''
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

'''[RN6]''' - Deve ser criada a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:33:20Z

Marcus.salviano: /* Regras de Negócio */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações no texto: ortografia e formatação, para melhor entendimento.
- Alterações na seção "Aplicação desconto"
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

'''[RN6]''' - Deve ser criada a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:32:33Z

Marcus.salviano: /* Aplicação desconto */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações no texto: ortografia e formatação, para melhor entendimento.
- Alterações na seção "Aplicação desconto"
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:31:40Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações no texto: ortografia e formatação, para melhor entendimento.
- Alterações na seção "Aplicação desconto"
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será necessário também setar a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:28:00Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || - Várias pequenas alterações no texto, gramática e formatação para melhor entendimento.
- Alterações na seção "Aplicação desconto"
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será necessário também setar a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:24:56Z

Marcus.salviano: /* Aplicação desconto */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || Várias pequenas alterações no texto, gramática e formatação para melhor entendimento.
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será necessário também setar a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela '''CONFIGURACAO''' para S para que o sistema use hierarquia de desconto.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Venda por lote

2017-09-28T02:23:44Z

Marcus.salviano: /* Aplicação desconto */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|-
| 25/09/2017 || Renato Lima || Alteração comportamento de inserir produto através do portal e aplicação de desconto por lote.
|-
| 27/09/2017 || Marcus Fábio Salviano || Várias pequenas alterações no texto, gramática e formatação para melhor entendimento.
|}

== Necessidade ==

Atualmente o sistema não controla a venda de itens por lote associando cada lote a uma tabela de preço. Dessa forma o usuário não consegue vender o mesmo item em lotes separados por conta do estado do item e vencimento associados a preços diferentes para o mesmo produto.

== Solução ==
Para que o GeoSales realize a venda por lote, a informação deve ser importada do ERP para o GeoSales, associando o lote ao seu devido produto.
Cada lote terá seu estoque que não afetará no estoque do produto que será controlado de forma individual.
Todo estoque terá uma data de validade. Após a data de validade o estoque deverá ficar indisponível para venda.
O preço será por produto e não por lote, mas o GeoSales terá a opção de desconto por lote permitindo flexibilidade de valores.

== Pré-Requisitos==
- Será necessário utilizar o campo '''NR_ITEM_PEDIDO''' como chave do item do pedido para que possamos ter mais de um item do pedido com o mesmo produto mas de lotes diferentes.

- Será necessário utilizar a tabela '''LISTA_PRODUTO_LOTE''' para diferenciar o sequencial dos produtos nos lotes específicos. Esse sequencial deverá relacionar-se com '''FAIXA_PRECO_PRODUTO''' através da coluna '''CD_SEQUENCIAL'''.

- O campo '''CD_LOTE''' na tabela '''ITEM_PEDIDO''' deve ser preenchido com o código do lote do produto escolhido.

- As tabela e '''LOTE''' deve conter as informações respectivas a cada lote e a tabela '''ESTOQUE_LOTE''' fará a associação do lote com o estoque e conterá a quantidade do item em estoque.

- Os relatórios de pedidos devem contemplar itens com lote e sem lote para evitar agrupamento de itens pelo código do produto, nesse caso deverá ser feita a distinção do agrupamento através da configuração '''ID_UTILIZA_VENDA_POR_LOTE''' dentro da tabela '''CONFIGURACAO''' com valor S.

=== Cadastro de Pedido ===

O vendedor fará a busca do produto no GeoSales Portal através do campo de busca do produto na tela de pedido, ao selecionar o produto do lado do campo quantidade, o sistema exibirá um botão lote.

[[Arquivo:TelaProdutoLote1.png]]

Ao clicar no botão lote o sistema abrirá um modal com as informações:

'''- Cód. Lote''': Código alfanumérico do lote que será selecionado (CAMPO DS_LOTE da tabela lote)

'''- Cód. Produto''': Código do produto selecionado

'''- Produto''': Nome do produto selecionado

'''- Estoque Lote''': Quantidade de itens em estoque para aquele lote

'''- Validade''': Data de validade do lote

[[Arquivo:TelaPedidosLote3.png]]

O vendedor ao receber a tabela com as opções detalhadas deverá clicar no botão de [+] para incluir os dados daquele lote na tela de dados de produto. Que deve trazer os dados de estoque e faixa de preço do lote selecionado.
Após selecionado o produto o sistema deve exibir o lote selecionado ao lado do botão lote.
Todas as validações de preço e estoque devem ser implementadas nas ações de inserir e editar.

O item deverá ser apresentado exibindo o código do lote antes do código do produto.

[[Arquivo:ItemPedidoLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

No GeoSales Mobile o campo qtd deve ser desabilitado e a seleção do lote deverá ser feita através de um botão que abrirá uma tela com as informações do lote.

[[Arquivo:MobileCadastroPedidoLote.png]]

O botão Lote só estará habilitado se existir saldo em estoque nos lotes do produto selecionado.

Havendo estoque a seguinte tela exibindo as informações de código do Lote, qtd em estoque e vencimento deverá ser apresentada.

[[Arquivo:MobileTelaSelecaoLote.png]]

A coluna identificada por quantidade deverá ser responsável pela inserção dos itens. Ao pressionar a área de uma célula um teclado numérico deverá ser exibido.

[[Arquivo:MobileTelaSelecaoQtdLote.png]]

Depois da seleção de lote o mesmo deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

Para edição dos itens, o vendedor vai selecionar o item, após seleciona-lo ao clicar em lote o sistema vai exibir seus lotes, onde o usuário poderá fazer as alterações necessárias.

=== Aplicação desconto ===
Na nossa estrutura de aplicação de desconto, será criada o '''DESCONTO_LOTE''' e na hierarquia de desconto será colocada como prioridade mais alta para que o preço seja aplicado de acordo com que o sistema já oferece, em toda a faixa de preço ou apenas no valor minimo.

Será necessário também setar a configuração '''EXIGE_HIERARQUIA_DESCONTO''' na tabela 'CONFIGURACAO' para S para que o sistema use hierarquia de desconto.

Será criada a tabela DESCONTO_LOTE

{| class="wikitable"
! colspan="5" | DESCONTO_LOTE
|-
! style="width:200px" |Coluna
! Tipo
! style="width:200px" |Obrigatório
! style="width:300px" |Chave Primária
! style="width:300px" |Explicação
|-
| CD_LOTE
| INT
| SIM
| SIM
| Código do lote
|-
| PR_DESCONTO
| DECIMAL
| NÃO
| NÃO
| Percentual desconto
|-
|}

Essas informações poderão vir através de integração ou o desconto poderá ser cadastrado.

[[Arquivo:Desconto Lote.png]]

O preço de tabela será o preço padrão. No caso de ter um preço por lote, no momento de integrar essa diferença de preço será tratado como regra de desconto, cuja diferença será criada em uma regra de desconto para o lote do produto. Ao selecionar o produto de lote especifico, caso tenha alguma regra de desconto o valor do produto será exibido, de acordo com as regras e configurações aplicadas no Geosales.

*'''Cenário'''

Produto A tem seu preço de tabela R$ 100,00.

Para o lote A, existe uma regra de desconto de 10%.

Ao selecionar esse produto que esteja no lote A, o valor do mesmo será exibido com o desconto de 10%, ou seja R$ 90,00.

Ao selecionar um produto que seja do Lote B, o valor do produto será exibido sem o desconto de 10%, ou seja R$ 100,00

=== Relatório ===

O relatório de pedidos necessita ser alterado para exibir a informação do lote do item

[[Arquivo:RelatorioPedidoLote.png]]

== Regras de Negócio ==
'''[RN1]''' – Deve ser criado uma flag no banco de dados que irá alterar a configuração do sistema para utilizar VENDA POR LOTE, sugerimos a flag '''ID_UTILIZA_VENDA_POR_LOTE''', quando configurada como "S" no banco de dados, o GeoSales Mobile irá apresentar na tabela de pedidos toda a estrutura de itens levando em consideração o código do lote. Caso esteja marcado como "N", o sistema irá utilizar a estrutura de itens pelo código do produto como também toda a estrutura de criação de pedidos padrão.

'''[RN2]''' - No GeoSales Mobile Deverá apresentar na tela de pedidos uma primeira seleção com os dados da busca por produto exibindo no campo de estoque os dados da tabela estoque lote caso os lotes tenham o cd_produto do produto selecionado. O campo Qtd não deve ser possível de editar pois as quantidades serão escolhidas na tela de itens de lote que é acessada através de um botão habilitado apenas quando o produto possuir estoque.

'''[RN3]''' - No GeoSales Mobile Na tela de consulta de produtos a quantidade em estoque de produtos deverá conter os dados do estoque do produto vindo do somatório de todas as quantidades de lotes para a organização de venda selecionada.

'''[RN4]''' - No GeoSales Portal Deverá ser alterada a tela de cadastro de pedido para caso a configuração '''ID_UTILIZA_VENDA_POR_LOTE''' esteja com valor "S" a lupa de produto seja substituída por um campo de texto e um botão de busca cujo evento disparado constrói uma tabela com os lotes que possuem data de validade posterior a data atual e estoque na tabela de estoque_lote caso o lote tenha estoque maior que zero.

'''[RN5]''' - No GeoSales Portal quando o usuário selecionar o lote na tabela gerada ele carregará os detalhes de quantidade em estoque e faixa de preço do lote específico.

== 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
|-
| TOTVS
|
|
|
|-
| CLIENTE
|
|
|
|}

Funcionalidade/Relatorio Gerencial

2017-03-13T12:24:18Z

Marcus.salviano: /* Pré Requisitos Para Funcionamento do Relatório */

=Tela=
[[Arquivo:RelatorioGerencial.png|900px]]

=Pré Requisitos Para Funcionamento do Relatório=
*Relatório deve ser executado por um usuário supervisor;

*Usuário supervisor deve estar associado a uma alçada;

*Configuração '''DS_URL_SERVICE''' deve estar setada corretamente;

*Configuração '''DS_URL_REL_GERENCIAL''' deve estar setada corretamente.

Todas as ações do relatório são executadas por webservice acionando o super, por isso é imprescindível que as configurações '''DS_URL_SERVICE''' e '''DS_URL_REL_GERENCIAL''' estejam setadas corretamente.

[[Category:Funcionalidade]]

Alçada de Bonificação

2017-03-08T19:02:45Z

Marcus.salviano: /* Histórico de Revisões */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 14/11/2016 || Leonardo Garcez || Criação do Documento
|-
| 14/11/2016 || Jefferson || Análise da Arquitetura
|-
| 22/12/2016 || Leonardo Garcez || Ajustes Solicitados Pela Arquitetura
|-
| 04/01/2017 || Inaldo França || Alteração no Documento para Contemplar toda regra de Alçada de Bonificação.
|-
| 12/01/2017 || Jefferson || Aprovação da Arquitetura
|-
| 02/02/2017 || Ricardo Kimoto || Solicitação de Ajuste
|-
| 03/02/2017 || Inaldo França || Ajustes solicitados pela CAMIL.
|-
| 06/02/2017 || Roberta || Aprovação do Documento pelo Comercial da CAMIL.
|-
| 21/02/2017 || Inaldo França || Criação da Estrutura de Dados a Pedido do Marcus Fábio e Adição do ponto que informa que o controle da Recorrência será via Micro Serviço.
|-
| 08/03/2017 || Marcus Fábio || Adição da coluna DT_ULT_ATUALIZACAO na tabela SALDO_ALCADA
|}

=Necessidade=

A CAMIL tem a necessidade de ter um modelo de aprovação dos pedidos de Bonificações por Alçadas de Valor e não por percentual, onde cada Nível de Aprovação terá um saldo específico que poderá utilizar para aprovar pedidos desse tipo.
O GeoSales precisa disponibilizar no cadastro de Alçada o Cadastro e o Vinculo de Alçadas por Valor. O Supervisor terá que exibir e controlar o saldo de aprovação que cada Gestor Possui.
O GeoSales também precisa disponibilizar uma forma fácil de cadastro dos saldos de cada Gestor.

=Solução=
===Cadastro de Alçadas===

1. Será modificado a tela de "Alçada de Autorização de Preço" possibilitando o usuário a cadastrar alçadas também por valor. Onde também o componente da tela se tornará mais amigável.
[[Arquivo:cadastro_alcada-1.png]]

2. Será modificado também o componente que faz o vínculo entre Alçadas e Cadastro de Supervisores, o usuário selecionará a Alçada, o Supervisor e clicará no botão "Associar" para associar um determinado supervisor a uma alçada.
[[Arquivo:cadastro_alcada-2.png]]

----

===Cadastro de Saldo===

1. O Saldo será controlado através da Funcionalidade do GeoSales de Conta Corrente, porém o cadastro do Saldo deverá acorrer por Alçada e não por cada usuário, como funciona atualmente na conta corrente.
Será criada uma nova tela chamada "Saldo de Aprovação" Vinculada ao Menu Conta Corrente, Nessa tela será cadastrado a conta corrente e vinculado um saldo por Alçada, Nessa tela terá também o controle de recorrência, se o saldo será atualizado por Dia, Semana ou Mês.
* Exemplo:
** Alçada: Gerente III
** Saldo: 4.000,00
** Recorrência: Mensalmente

Dessa forma, todos os supervisores que estiverem vinculados a Alçada de Gerente III receberão um saldo de 4000,00 válidos mensalmente e renovados no primeiro dia do mês.

[[Arquivo:Saldo_aprovacao_tela.png]]

2. Na tela de "Saldo de Aprovação" após cadastrar o saldo para uma alçada terá uma tela que listará os saldos que cada alçada possui e sua recorrência.

3. Para ser visualizado o Saldo de Aprovação de cada supervisor continuará sendo utilizado o menu: [[Arquivo:pesquisa_conta.png]] Nesse menu as consultas são feitas por usuário.

4. Para ser visualizado as Movimentações do Saldo de Aprovação de cada supervisor continuará sendo utilizado o menu: [[Arquivo:lancamentos_conta.png]] Nesse menu as consultas são feitas por usuário.

5. Para realizar Movimentações de Crédito ou Débito no Saldo de Aprovação de cada supervisor continuará sendo utilizado o menu: [[Arquivo:movimentacao_conta.png]] Nesse menu os lançamentos são feitos por usuário.

6. A recorrência será controlada através de um Micro Serviço.

==== Estrutura da Tabela ====

Tabela: '''SALDO_ALCADA'''

{| class="wikitable"
! DESCRIÇÃO
! TIPO
! CHAVE
! OBRIGATÓRIO
! DESCRIÇÃO
|-
| CD_ALCADA || INT || Sim || Sim || Código da Alçada
|-
| VR_SALDO || Decimal (18,6) || Sim || Sim || Valor do Saldo
|-
| ID_RECORRENCIA || Char (1) || Não || Não || M para Mês, D para dia, A para Ano, Nulo não vai ter recorrência.
|-
| DT_ULT_ATUALIZACAO || Datetime || Não || Não || Data da última atualização de saldo para a alçada.
|}
----

=== Aprovação de Pedidos e Movimentação do Saldo. ===

1. Para o pedido aparecer no supervisor e quando aprovado movimentar o saldo é necessário realizar todas as configurações no Portal

* O Supervisor está devidamente cadastrado no Portal GeoSales
* O Vendedor ter seu supervisor cadastrado no Portal GeoSales
* Cadastrar Alçadas por Valor e Associar os Supervisores a Alçada correta.
* Cadastrar os Saldos de cada Alçada.
* Configurar o tipo do movimento que irá consumir saldo (configuração realizada pela SoftSite)

2. Após o sistema devidamente configurado o pedido de bonificação irá aparecer para o Supervisor correto no Portal do Gestor.

3. A provação ocorrerá não do cabeçalho do pedido e sim por item, a medida que o gestor irá aprovando pedidos o valor de cada item será descontado de seu Saldo de Aprovação. Lembrando que se não houver saldo disponível o sistema exibirá uma mensagem informando.

4. Se o determinado supervisor não tiver saldo o gerente de próximo nível irá poder aprovar o pedido utilizando seu saldo para isso.

== Regras de Negócio ==

* RN1 - Não poderá ser cadastrado alçadas de Valor e Percentual, ou a Alçada é de Valor ou de Percentual.
* RN2 - No menu "Saldo de Aprovação" ao cadastrar um saldo para uma determinada Alçada, cada supervisor que estiver vinculado a Alçada receberá o saldo associado.
* RN3 - Se um novo supervisor for vinculado a uma alçada e a mesma já conter o saldo o supervisor receberá o saldo automático.
* RN4 - Se o supervisor for removido de uma alçada o saldo deve ser removido.
* RN5 - Se a opção de recorrência estiver marcada como "Dia" o saldo será renovado diariamente através de um lançamento automático
* RN6 - Se a opção de recorrência estiver marcada como "Semana" o saldo será renovado sempre aos Domingos através de um lançamento automático
* RN7 - Se a opção de recorrência estiver marcada como "Mês" o saldo será renovado todo dia 01 através de um lançamento automático
* RN8 - Terá uma configuração no Sistema informando qual o tipo de movimento consumirá o saldo de aprovação. Criar coluna ID_SALDO_APROVACAO na tabela TIPO_MOVIMENTO_PEDIDO.
* RN9 - O Saldo para aprovação irá aparecer no portal do Supervisor com o título "Saldo de Aprovação"
* RN10 - O lançamento automático para renovar o saldo será realizado através de um lançamento complementar, será feito um calculo para saber se o lançamento é de débito ou crédito.
* RN11 - A Formula que calcula o Lançamento Complementar será Saldo de Aprovação menos o Saldo Atual
* RN12 - Se o Lançamento Complementar for positivo o lançamento será de Crédito, se for negativo será de débito.

'''Exemplo''':
Saldo De Aprovação: Saldo cadastrado para a alçada
Saldo Atual: Saldo atual que é feito o calculo
SC: Saldo complementar

Saldo Aprovação= 4.000
Saldo Atual= 1.000
SC = (4.000 - 1.000) = 3.000
Será realizado um lançamento de crédito de 3.000 no saldo de aprovação do Gestor.

Saldo Aprovação= 4.000
Saldo Atual = 10.000
SC = (4.000-10.000) = -6.000
Será realizado um lançamento de débito de 6.000 no saldo de aprovação do Gestor

==Cenários==

=== Cadastro de Saldo de Aprovação ===

1. Dados
* Usuário: João
* Supervisores: Carlos, Marcos, Lucas
* Alçada: Gerente II

2. Operação

* João acessará o GeoSales e navegará até o menu Conta Corrente > Saldo de Aprovação
* Na tela de Cadastro preencherá as seguintes informações:
** Alçada: Gerente II
** Saldo: 4.000,00
** Recorrência: Mês
* Após preencher clicará no botão Salvar.

3. Assertivas

* O Sistema criará uma conta para todos os supervisores da Alçada Gerente II
* Cada conta e cada supervisor da Alçada terá um saldo de 4.000,00
* Todo dia 01 de cada mês o Saldo de 4.000,00 será automaticamente renovado através de um saldo complementar.
3.1 Lançamento Complementar
- O Lançamento complementar será composto pela seguinte formula = (Saldo Aprovação - Saldo Atual)
- Será realizado um movimento de crédito na conta de cada supervisor com o resultado dessa formula se for positivo.
- Será realizado um movimento de débito na conta de cada supervisor com o resultado dessa formula se for negativa.
- Exemplo:
Dados
Supervisor: Carlos
Alçada: Gerente II
Saldo Aprovação: 4.000,00
Saldo Atual: 4.000,00
Data Atual: 04/01/2017

Operação
O Supervisor Carlos aprova um pedido de 1.000,00 no dia 10/01/2017

Assertiva
Após a provação do Pedido de 1.000,00 o Sistema atualizará seu Saldo Atual para 3.000,00
No dia 01/02/2017 o Sistema irá calcular o Saldo Complementar, Saldo Aprovação menos o Saldo Atual (4.000,00 - 3.000,00 = 1.000,00)
Após gerar o Saldo Complementar o sistema fará um lançamento de crédito na conta do supervisor Carlos de 1.000,00
O Supervisor Carlos volta a ter 4.000,00 de saldo no início do mês.

----
===Aprovando Pedidos===

1. Dados
* Supervisor: Carlos
* Saldo Aprovação: 4.000,00
* Saldo Atual: 4.000,00

2. Operação
* O Supervisor acessa o portal do supervisor e aprova 2 pedidos
* Pedido 1 no valor de 1.500,00
* Pedido 2 no valor de 300,00

3. Assertivas
* O Sistema informará que os pedidos foram autorizados com sucesso
* O Sistema atualizará o Saldo Atual de Aprovação para 2.200,00

----
===Aprovando Pedidos com Saldo Insuficiente===

1. Dados
* Supervisor: Carlos
* Saldo Aprovação: 4.000,00
* Saldo Atual: 2.200,00

2. Operação
* O Supervisor acessa o portal do supervisor e aprova 1 pedido
* Pedido 3 no valor de 2.300,00

3. Assertivas
* O Sistema exibirá uma mensagem informando que seu saldo é insuficiente.

Alçada de Bonificação

2017-03-08T19:01:31Z

Marcus.salviano: /* Estrutura da Tabela */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 14/11/2016 || Leonardo Garcez || Criação do Documento
|-
| 14/11/2016 || Jefferson || Análise da Arquitetura
|-
| 22/12/2016 || Leonardo Garcez || Ajustes Solicitados Pela Arquitetura
|-
| 04/01/2017 || Inaldo França || Alteração no Documento para Contemplar toda regra de Alçada de Bonificação.
|-
| 12/01/2017 || Jefferson || Aprovação da Arquitetura
|-
| 02/02/2017 || Ricardo Kimoto || Solicitação de Ajuste
|-
| 03/02/2017 || Inaldo França || Ajustes solicitados pela CAMIL.
|-
| 06/02/2017 || Roberta || Aprovação do Documento pelo Comercial da CAMIL.
|-
| 21/02/2017 || Inaldo França || Criação da Estrutura de Dados a Pedido do Marcus Fábio e Adição do ponto que informa que o controle da Recorrência será via Micro Serviço.
|}

=Necessidade=

A CAMIL tem a necessidade de ter um modelo de aprovação dos pedidos de Bonificações por Alçadas de Valor e não por percentual, onde cada Nível de Aprovação terá um saldo específico que poderá utilizar para aprovar pedidos desse tipo.
O GeoSales precisa disponibilizar no cadastro de Alçada o Cadastro e o Vinculo de Alçadas por Valor. O Supervisor terá que exibir e controlar o saldo de aprovação que cada Gestor Possui.
O GeoSales também precisa disponibilizar uma forma fácil de cadastro dos saldos de cada Gestor.

=Solução=
===Cadastro de Alçadas===

1. Será modificado a tela de "Alçada de Autorização de Preço" possibilitando o usuário a cadastrar alçadas também por valor. Onde também o componente da tela se tornará mais amigável.
[[Arquivo:cadastro_alcada-1.png]]

2. Será modificado também o componente que faz o vínculo entre Alçadas e Cadastro de Supervisores, o usuário selecionará a Alçada, o Supervisor e clicará no botão "Associar" para associar um determinado supervisor a uma alçada.
[[Arquivo:cadastro_alcada-2.png]]

----

===Cadastro de Saldo===

1. O Saldo será controlado através da Funcionalidade do GeoSales de Conta Corrente, porém o cadastro do Saldo deverá acorrer por Alçada e não por cada usuário, como funciona atualmente na conta corrente.
Será criada uma nova tela chamada "Saldo de Aprovação" Vinculada ao Menu Conta Corrente, Nessa tela será cadastrado a conta corrente e vinculado um saldo por Alçada, Nessa tela terá também o controle de recorrência, se o saldo será atualizado por Dia, Semana ou Mês.
* Exemplo:
** Alçada: Gerente III
** Saldo: 4.000,00
** Recorrência: Mensalmente

Dessa forma, todos os supervisores que estiverem vinculados a Alçada de Gerente III receberão um saldo de 4000,00 válidos mensalmente e renovados no primeiro dia do mês.

[[Arquivo:Saldo_aprovacao_tela.png]]

2. Na tela de "Saldo de Aprovação" após cadastrar o saldo para uma alçada terá uma tela que listará os saldos que cada alçada possui e sua recorrência.

3. Para ser visualizado o Saldo de Aprovação de cada supervisor continuará sendo utilizado o menu: [[Arquivo:pesquisa_conta.png]] Nesse menu as consultas são feitas por usuário.

4. Para ser visualizado as Movimentações do Saldo de Aprovação de cada supervisor continuará sendo utilizado o menu: [[Arquivo:lancamentos_conta.png]] Nesse menu as consultas são feitas por usuário.

5. Para realizar Movimentações de Crédito ou Débito no Saldo de Aprovação de cada supervisor continuará sendo utilizado o menu: [[Arquivo:movimentacao_conta.png]] Nesse menu os lançamentos são feitos por usuário.

6. A recorrência será controlada através de um Micro Serviço.

==== Estrutura da Tabela ====

Tabela: '''SALDO_ALCADA'''

{| class="wikitable"
! DESCRIÇÃO
! TIPO
! CHAVE
! OBRIGATÓRIO
! DESCRIÇÃO
|-
| CD_ALCADA || INT || Sim || Sim || Código da Alçada
|-
| VR_SALDO || Decimal (18,6) || Sim || Sim || Valor do Saldo
|-
| ID_RECORRENCIA || Char (1) || Não || Não || M para Mês, D para dia, A para Ano, Nulo não vai ter recorrência.
|-
| DT_ULT_ATUALIZACAO || Datetime || Não || Não || Data da última atualização de saldo para a alçada.
|}
----

=== Aprovação de Pedidos e Movimentação do Saldo. ===

1. Para o pedido aparecer no supervisor e quando aprovado movimentar o saldo é necessário realizar todas as configurações no Portal

* O Supervisor está devidamente cadastrado no Portal GeoSales
* O Vendedor ter seu supervisor cadastrado no Portal GeoSales
* Cadastrar Alçadas por Valor e Associar os Supervisores a Alçada correta.
* Cadastrar os Saldos de cada Alçada.
* Configurar o tipo do movimento que irá consumir saldo (configuração realizada pela SoftSite)

2. Após o sistema devidamente configurado o pedido de bonificação irá aparecer para o Supervisor correto no Portal do Gestor.

3. A provação ocorrerá não do cabeçalho do pedido e sim por item, a medida que o gestor irá aprovando pedidos o valor de cada item será descontado de seu Saldo de Aprovação. Lembrando que se não houver saldo disponível o sistema exibirá uma mensagem informando.

4. Se o determinado supervisor não tiver saldo o gerente de próximo nível irá poder aprovar o pedido utilizando seu saldo para isso.

== Regras de Negócio ==

* RN1 - Não poderá ser cadastrado alçadas de Valor e Percentual, ou a Alçada é de Valor ou de Percentual.
* RN2 - No menu "Saldo de Aprovação" ao cadastrar um saldo para uma determinada Alçada, cada supervisor que estiver vinculado a Alçada receberá o saldo associado.
* RN3 - Se um novo supervisor for vinculado a uma alçada e a mesma já conter o saldo o supervisor receberá o saldo automático.
* RN4 - Se o supervisor for removido de uma alçada o saldo deve ser removido.
* RN5 - Se a opção de recorrência estiver marcada como "Dia" o saldo será renovado diariamente através de um lançamento automático
* RN6 - Se a opção de recorrência estiver marcada como "Semana" o saldo será renovado sempre aos Domingos através de um lançamento automático
* RN7 - Se a opção de recorrência estiver marcada como "Mês" o saldo será renovado todo dia 01 através de um lançamento automático
* RN8 - Terá uma configuração no Sistema informando qual o tipo de movimento consumirá o saldo de aprovação. Criar coluna ID_SALDO_APROVACAO na tabela TIPO_MOVIMENTO_PEDIDO.
* RN9 - O Saldo para aprovação irá aparecer no portal do Supervisor com o título "Saldo de Aprovação"
* RN10 - O lançamento automático para renovar o saldo será realizado através de um lançamento complementar, será feito um calculo para saber se o lançamento é de débito ou crédito.
* RN11 - A Formula que calcula o Lançamento Complementar será Saldo de Aprovação menos o Saldo Atual
* RN12 - Se o Lançamento Complementar for positivo o lançamento será de Crédito, se for negativo será de débito.

'''Exemplo''':
Saldo De Aprovação: Saldo cadastrado para a alçada
Saldo Atual: Saldo atual que é feito o calculo
SC: Saldo complementar

Saldo Aprovação= 4.000
Saldo Atual= 1.000
SC = (4.000 - 1.000) = 3.000
Será realizado um lançamento de crédito de 3.000 no saldo de aprovação do Gestor.

Saldo Aprovação= 4.000
Saldo Atual = 10.000
SC = (4.000-10.000) = -6.000
Será realizado um lançamento de débito de 6.000 no saldo de aprovação do Gestor

==Cenários==

=== Cadastro de Saldo de Aprovação ===

1. Dados
* Usuário: João
* Supervisores: Carlos, Marcos, Lucas
* Alçada: Gerente II

2. Operação

* João acessará o GeoSales e navegará até o menu Conta Corrente > Saldo de Aprovação
* Na tela de Cadastro preencherá as seguintes informações:
** Alçada: Gerente II
** Saldo: 4.000,00
** Recorrência: Mês
* Após preencher clicará no botão Salvar.

3. Assertivas

* O Sistema criará uma conta para todos os supervisores da Alçada Gerente II
* Cada conta e cada supervisor da Alçada terá um saldo de 4.000,00
* Todo dia 01 de cada mês o Saldo de 4.000,00 será automaticamente renovado através de um saldo complementar.
3.1 Lançamento Complementar
- O Lançamento complementar será composto pela seguinte formula = (Saldo Aprovação - Saldo Atual)
- Será realizado um movimento de crédito na conta de cada supervisor com o resultado dessa formula se for positivo.
- Será realizado um movimento de débito na conta de cada supervisor com o resultado dessa formula se for negativa.
- Exemplo:
Dados
Supervisor: Carlos
Alçada: Gerente II
Saldo Aprovação: 4.000,00
Saldo Atual: 4.000,00
Data Atual: 04/01/2017

Operação
O Supervisor Carlos aprova um pedido de 1.000,00 no dia 10/01/2017

Assertiva
Após a provação do Pedido de 1.000,00 o Sistema atualizará seu Saldo Atual para 3.000,00
No dia 01/02/2017 o Sistema irá calcular o Saldo Complementar, Saldo Aprovação menos o Saldo Atual (4.000,00 - 3.000,00 = 1.000,00)
Após gerar o Saldo Complementar o sistema fará um lançamento de crédito na conta do supervisor Carlos de 1.000,00
O Supervisor Carlos volta a ter 4.000,00 de saldo no início do mês.

----
===Aprovando Pedidos===

1. Dados
* Supervisor: Carlos
* Saldo Aprovação: 4.000,00
* Saldo Atual: 4.000,00

2. Operação
* O Supervisor acessa o portal do supervisor e aprova 2 pedidos
* Pedido 1 no valor de 1.500,00
* Pedido 2 no valor de 300,00

3. Assertivas
* O Sistema informará que os pedidos foram autorizados com sucesso
* O Sistema atualizará o Saldo Atual de Aprovação para 2.200,00

----
===Aprovando Pedidos com Saldo Insuficiente===

1. Dados
* Supervisor: Carlos
* Saldo Aprovação: 4.000,00
* Saldo Atual: 2.200,00

2. Operação
* O Supervisor acessa o portal do supervisor e aprova 1 pedido
* Pedido 3 no valor de 2.300,00

3. Assertivas
* O Sistema exibirá uma mensagem informando que seu saldo é insuficiente.

Inserção Motivo de Cadastro de Pedidos

2017-03-03T19:09:06Z

Marcus.salviano: /* Regras de Negócio */

==Necessidade==

O cliente quer criar uma forma de auditorar a aprovação dos pedidos de bonificação, pois da forma como está os vendedores estão bonificando muito e sem uma forma de controle. É necessário que todos os pedidos de bonificação fiquem pendentes de aprovação. Também é preciso que exista uma forma de auditorar a aprovação desses pedidos cadastrando um motivo de aprovação para a pedido entre alguns motivos pré cadastrados. Para gerenciar essas aprovações é preciso que exista um relatório mostrando o código do pedido, o motivo da aprovação, o tipo de pedido, o cliente, o valor, o supervisor, vendedor e data aprovação. Isso vai permitir quantificar e auditorar esse processo de bonificação.

==Pré Detalhes da Solução Imperativa==

Deverá ser criado uma tela aonde possa ser cadastrado os motivos para aprovação ou cancelamento no portal. Esse motivo será vinculado a um tipo de pedido tornando a funcionalidade aplicável a todos os tipos de pedidos. Nessa tela deverá ser possível fazer as operações de exclusão, edição, inserção e listagem para esses motivos. Deverá ser inserido na tela de cadastro de pedido, por configuração (ID_UTILIZA_MOTIVO_PEDIDO), um select box que tenha todos os motivos para ser anexado a aprovação do pedido. Deve ser criado um relatório mostrando o código do pedido, o motivo da aprovação, o tipo de pedido, o cliente, o valor, o supervisor, vendedor e data aprovação que possa ser retirado por um intervalo de tempo. Esse relatório deverá ser exportado em xlsx para que seja possível trabalhar os dados do relatório.

===Regras de Negócio===

*[RN1] - Quando o vendedor for cadastrar um pedido de bonificação deve ser mostrada uma listagem de motivos para tiragem do pedido de bonificação. Nesse caso será obrigatório a seleção de um desses motivos para cadastro do pedido.

*[RN2] - Todos os pedidos de bonificação devem ficar pendentes de aprovação (Regra deve ser configurada no cadastro do tipo de pedido bonificação).

*[RN3] - A informação do motivo de cadastro da bonificação deve ser integrada também a base do ERP do cliente.

* Deve ser criado um campo de seleção na tela de cabeçalho do pedido que seja preenchido com os motivos de aprovação de pedidos cadastrados. Esses dados devem ser cadastradas numa tabela a parte. Esse campo deve ser inserido tanto no portal como no mobile.
* Deve ser criado um relatório que possibilite a visualização dos motivos de criação dos pedidos de bonificação. Nesse relatório os seguintes dados devem ser mostrados:
# Código do pedido
# Motivo da aprovação
# Tipo de pedido
# Cliente
# Valor do Pedido
# Supervisor
# Vendedor
# Data aprovação(Caso o pedido não tenha sido aprovado ainda este campo ficará vazio)
* Adicionar o código do motivo de aprovação para ser persistido para o ERP no web service server.

* O cadastro do motivo deve ser atrelado a um tipo qualquer de pedido, não limitando a solução somente a pedidos de bonificação. Deverão ser criadas 2 tabelas, isso servirá para evitar a duplicação de registros:

Tabela: '''MOTIVO_PEDIDO'''

{| class="wikitable"
! NOME COLUNA
! TIPO
! CHAVE
! OBRIGATÓRIO
! DESCRIÇÃO
|-
| CD_MOTIVO_PEDIDO || INT || Sim || Sim || Código do Motivo do Pedido
|-
| DS_MOTIVO_PEDIDO || VARCHAR(200) || Não || Sim || Descrição do Motivo do Pedido
|}

Tabela: '''MOTIVO_PEDIDO_TIPO_PEDIDO'''

{| class="wikitable"
! NOME COLUNA
! TIPO
! CHAVE
! OBRIGATÓRIO
! DESCRIÇÃO
|-
| CD_MOTIVO_PEDIDO || INT || Sim || Sim || Código do Motivo do Pedido
|-
| CD_TIPO_PEDIDO || VARCHAR(4) || Sim || Sim || Código do Tipo do Pedido
|}

* O cadastro do motivo deve ser persistido na tabela PEDIDO salvando o CD_MOTIVO_PEDIDO. Segue a estrutura das nova coluna:

Tabela: '''PEDIDO'''

{| class="wikitable"
! NOME COLUNA
! TIPO
! CHAVE
! OBRIGATÓRIO
! DESCRIÇÃO
|-
| CD_MOTIVO_PEDIDO || INT || Não || Não || Código do Motivo do Pedido
|}

==Integração==
A nova coluna CD_MOTIVO_PEDIDO na tabela de PEDIDO deve ser integrada ao ERP. Com isso é necessário efetuar ajustes no web service para que o mesmo interprete a nova coluna.

==Cenários==

===Cenário feliz===

O vendedor João cadastra um pedido de bonificação.

====Dado====

# Vendedor João
# Todos os pedidos de bonificação ficam pendentes de aprovação
# Motivos de Cadastro do Pedido de Bonificação
## Aprovação da diretoria
## Bonificação vantajosa
## Bônus por grande compra
# Lista de clientes a serem atendidos
## Cliente A
## Cliente B
## Cliente C
# O tipo de pedido de bonificação tem em seu cadastro que todo pedido feito desse tipo irá ficar pendente de aprovação

====Operação====

# João inicia o atendimento ao Cliente A.
# João seleciona o tipo de pedido bonificação.
# João insere o motivo do cadastro do pedido "Aprovação da Diretoria" e clica em inserir itens.
# João insere as informações necessárias e finaliza o cadastro do pedido.

====Assertivas====

# É cadastrado o pedido D do tipo bonificação pelo vendedor João para o cliente A.
# O pedido de bonificação D fica com o status igual a pendente de aprovação.
# No cadastro do pedido D é salvo o motivo de cadastro "Aprovação da Diretoria".

===Cenário cadastro de pedido sem motivo===

O vendedor João cadastra um pedido de bonificação.

====Dado====

# Vendedor João
# Todos os pedidos de bonificação ficam pendentes de aprovação
# Motivos de Cadastro do Pedido de Bonificação
## Aprovação da diretoria
## Bonificação vantajosa
## Bônus por grande compra
# Lista de clientes a serem atendidos
## Cliente A
## Cliente B
## Cliente C
# O tipo de pedido de bonificação tem em seu cadastro que todo pedido feito desse tipo irá ficar pendente de aprovação

====Operação====

# João inicia o atendimento ao Cliente B.
# João seleciona o tipo de pedido bonificação.
# João não insere o motivo do cadastro do pedido e clica em inserir itens.
# João insere as informações necessárias com exceção do motivo e finaliza o cadastro do pedido.

====Assertivas====

# É mostrada uma mensagem de erro avisando que o pedido não pode ser cadastrado sem o motivo.

Inserção Motivo de Cadastro de Pedidos

2017-03-03T19:08:45Z

Marcus.salviano: /* Pré Detalhes da Solução Imperativa */

Inserção Motivo de Cadastro de Pedidos

2017-03-03T19:06:04Z

Marcus.salviano: /* Regras de Negócio */

==Necessidade==

O cliente quer criar uma forma de auditorar a aprovação dos pedidos de bonificação, pois da forma como está os vendedores estão bonificando muito e sem uma forma de controle. É necessário que todos os pedidos de bonificação fiquem pendentes de aprovação. Também é preciso que exista uma forma de auditorar a aprovação desses pedidos cadastrando um motivo de aprovação para a pedido entre alguns motivos pré cadastrados. Para gerenciar essas aprovações é preciso que exista um relatório mostrando o código do pedido, o motivo da aprovação, o tipo de pedido, o cliente, o valor, o supervisor, vendedor e data aprovação. Isso vai permitir quantificar e auditorar esse processo de bonificação.

==Pré Detalhes da Solução Imperativa==

Deverá ser criado uma tela aonde possa ser cadastrado os motivos para aprovação ou cancelamento no portal. Esse motivo será vinculado a um tipo de pedido tornando a funcionalidade aplicável a todos os tipos de pedidos. Nessa tela deverá ser possível fazer as operações de exclusão, edição, inserção e listagem para esses motivos. Deverá ser inserido na tela de cadastro de pedido, por configuração (ID_UTILIZA_MOTIVO_PEDIDO), um select box que tenha todos os motivos para ser anexado a aprovação do pedido. Deve ser criado um relatório mostrando o código do pedido, o motivo da aprovação, o tipo de pedido, o cliente, o valor, o supervisor, vendedor e data aprovação que possa ser retirado por um intervalo de tempo. Esse relatório deverá ser exportado em xlsx para que seja possível trabalhar os dados do relatório.

===Regras de Negócio===

*[RN1] - Quando o vendedor for cadastrar um pedido de bonificação deve ser mostrada uma listagem de motivos para tiragem do pedido de bonificação. Nesse caso será obrigatório a seleção de um desses motivos para cadastro do pedido.

*[RN2] - Todos os pedidos de bonificação devem ficar pendentes de aprovação (Regra deve ser configurada no cadastro do tipo de pedido bonificação).

*[RN3] - A informação do motivo de cadastro da bonificação deve ser integrada também a base do ERP do cliente.

* Deve ser criado um campo de seleção na tela de cabeçalho do pedido que seja preenchido com os motivos de aprovação de pedidos cadastrados. Esses dados devem ser cadastradas numa tabela a parte. Esse campo deve ser inserido tanto no portal como no mobile.
* Deve ser criado um relatório que possibilite a visualização dos motivos de criação dos pedidos de bonificação. Nesse relatório os seguintes dados devem ser mostrados:
# Código do pedido
# Motivo da aprovação
# Tipo de pedido
# Cliente
# Valor do Pedido
# Supervisor
# Vendedor
# Data aprovação(Caso o pedido não tenha sido aprovado ainda este campo ficará vazio)
* Adicionar o código do motivo de aprovação para ser persistido para o ERP no web service server.

* O cadastro do motivo deve ser atrelado a um tipo qualquer de pedido, não limitando a solução somente a pedidos de bonificação. Deverão ser criadas 2 tabelas, isso servirá para evitar a duplicação de registros:

Tabela: '''MOTIVO_PEDIDO'''

{| class="wikitable"
! NOME COLUNA
! TIPO
! CHAVE
! OBRIGATÓRIO
! DESCRIÇÃO
|-
| CD_MOTIVO_PEDIDO || INT || Sim || Sim || Código do Motivo do Pedido
|-
| DS_MOTIVO_PEDIDO || VARCHAR(200) || Não || Sim || Descrição do Motivo do Pedido
|}

Tabela: '''MOTIVO_PEDIDO_TIPO_PEDIDO'''

{| class="wikitable"
! NOME COLUNA
! TIPO
! CHAVE
! OBRIGATÓRIO
! DESCRIÇÃO
|-
| CD_MOTIVO_PEDIDO || INT || Sim || Sim || Código do Motivo do Pedido
|-
| CD_TIPO_PEDIDO || VARCHAR(4) || Sim || Sim || Código do Tipo do Pedido
|}

* O cadastro do motivo deve ser persistido na tabela PEDIDO salvando o CD_MOTIVO_PEDIDO. Segue a estrutura das nova coluna:

<table border="1" cellpadding="5">
<caption>PEDIDO</caption>
<tr><th>Nome Coluna</th> <th>Tipo</th> <th>Nullable</th> <th>PK</th></tr>
<tr><td>CD_MOTIVO_PEDIDO <td>INT</td> <td>NULL</td> <td>N</td></tr>
</table>

==Integração==
A nova coluna CD_MOTIVO_PEDIDO na tabela de PEDIDO deve ser integrada ao ERP. Com isso é necessário efetuar ajustes no web service para que o mesmo interprete a nova coluna.

==Cenários==

===Cenário feliz===

O vendedor João cadastra um pedido de bonificação.

====Dado====

# Vendedor João
# Todos os pedidos de bonificação ficam pendentes de aprovação
# Motivos de Cadastro do Pedido de Bonificação
## Aprovação da diretoria
## Bonificação vantajosa
## Bônus por grande compra
# Lista de clientes a serem atendidos
## Cliente A
## Cliente B
## Cliente C
# O tipo de pedido de bonificação tem em seu cadastro que todo pedido feito desse tipo irá ficar pendente de aprovação

====Operação====

# João inicia o atendimento ao Cliente A.
# João seleciona o tipo de pedido bonificação.
# João insere o motivo do cadastro do pedido "Aprovação da Diretoria" e clica em inserir itens.
# João insere as informações necessárias e finaliza o cadastro do pedido.

====Assertivas====

# É cadastrado o pedido D do tipo bonificação pelo vendedor João para o cliente A.
# O pedido de bonificação D fica com o status igual a pendente de aprovação.
# No cadastro do pedido D é salvo o motivo de cadastro "Aprovação da Diretoria".

===Cenário cadastro de pedido sem motivo===

O vendedor João cadastra um pedido de bonificação.

====Dado====

# Vendedor João
# Todos os pedidos de bonificação ficam pendentes de aprovação
# Motivos de Cadastro do Pedido de Bonificação
## Aprovação da diretoria
## Bonificação vantajosa
## Bônus por grande compra
# Lista de clientes a serem atendidos
## Cliente A
## Cliente B
## Cliente C
# O tipo de pedido de bonificação tem em seu cadastro que todo pedido feito desse tipo irá ficar pendente de aprovação

====Operação====

# João inicia o atendimento ao Cliente B.
# João seleciona o tipo de pedido bonificação.
# João não insere o motivo do cadastro do pedido e clica em inserir itens.
# João insere as informações necessárias com exceção do motivo e finaliza o cadastro do pedido.

====Assertivas====

# É mostrada uma mensagem de erro avisando que o pedido não pode ser cadastrado sem o motivo.