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

Venda por lote

2017-07-26T03:56:20Z

Leonardo: /* 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
|-
| 19/06/2017 || Leonardo Sousa || Documento Aprovado
|}

== 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 afetara 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 como chave 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 com faixa_precco_produto.
O campo cd_lote na tabela item_pedido deve ser preenchido com o código do lote do produto escolhido.
As tabelas estoque_lote e lote devem ser preenchidas com os respectivos produtos.
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 poderá filtrar os lotes do produto no GeoSales Portal através de um campo de texto e um botão de busca onde ele preencherá uma parte ou a totalidade do nome de um produto. Em caso de não preenchimento o GeoSales irá exibir nessa tabela uma listagem dos lotes dos produtos por ordem alfabética limitada a uma quantidade de 100 lotes para efeito de performance.

[[Arquivo:TelaPedidosLote.png]]

A tabela resultante após a busca deverá listar:

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

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.

[[Arquivo:TelaProdutoLote.png]]

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

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 lote deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

=== 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-07-26T03:56:00Z

Leonardo: /* 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
|-
| 19/06/2017 || Leonardo Sousa || Documento Aprovada
|}

== 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 afetara 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 como chave 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 com faixa_precco_produto.
O campo cd_lote na tabela item_pedido deve ser preenchido com o código do lote do produto escolhido.
As tabelas estoque_lote e lote devem ser preenchidas com os respectivos produtos.
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 poderá filtrar os lotes do produto no GeoSales Portal através de um campo de texto e um botão de busca onde ele preencherá uma parte ou a totalidade do nome de um produto. Em caso de não preenchimento o GeoSales irá exibir nessa tabela uma listagem dos lotes dos produtos por ordem alfabética limitada a uma quantidade de 100 lotes para efeito de performance.

[[Arquivo:TelaPedidosLote.png]]

A tabela resultante após a busca deverá listar:

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

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.

[[Arquivo:TelaProdutoLote.png]]

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

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 lote deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

=== 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-07-26T03:55:42Z

Leonardo: /* 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
| 19/06/2017 || Leonardo Sousa || Documento Aprovada
|}

== 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 afetara 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 como chave 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 com faixa_precco_produto.
O campo cd_lote na tabela item_pedido deve ser preenchido com o código do lote do produto escolhido.
As tabelas estoque_lote e lote devem ser preenchidas com os respectivos produtos.
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 poderá filtrar os lotes do produto no GeoSales Portal através de um campo de texto e um botão de busca onde ele preencherá uma parte ou a totalidade do nome de um produto. Em caso de não preenchimento o GeoSales irá exibir nessa tabela uma listagem dos lotes dos produtos por ordem alfabética limitada a uma quantidade de 100 lotes para efeito de performance.

[[Arquivo:TelaPedidosLote.png]]

A tabela resultante após a busca deverá listar:

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

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.

[[Arquivo:TelaProdutoLote.png]]

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

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 lote deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

=== 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-07-26T03:54:49Z

Leonardo: /* Solução */

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/06/2017 || Arielton Nunes || Criação do Documento
|}

== 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 afetara 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 como chave 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 com faixa_precco_produto.
O campo cd_lote na tabela item_pedido deve ser preenchido com o código do lote do produto escolhido.
As tabelas estoque_lote e lote devem ser preenchidas com os respectivos produtos.
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 poderá filtrar os lotes do produto no GeoSales Portal através de um campo de texto e um botão de busca onde ele preencherá uma parte ou a totalidade do nome de um produto. Em caso de não preenchimento o GeoSales irá exibir nessa tabela uma listagem dos lotes dos produtos por ordem alfabética limitada a uma quantidade de 100 lotes para efeito de performance.

[[Arquivo:TelaPedidosLote.png]]

A tabela resultante após a busca deverá listar:

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

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.

[[Arquivo:TelaProdutoLote.png]]

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

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 lote deverá virar um item e exibir a informação do lote selecionado na tela inferior.

[[Arquivo:MobileTelaItemLote.png]]

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

A52 – Máscara no Valor do Pedido

2017-07-26T03:42:04Z

Leonardo: /* Solução */

== Necessidade==
Ter uma facilidade de leitura dos campos de numéricos.

== Solução ==
Aplicar máscara nos campos numéricos (Valores, Quantidade e Peso) na tela do pedido (Portal, Mobile e Supervisor). Essa mudança deverá ser aplicada tando no cadastro como no relatório de pedido.
Aplicar a seguinte mascará 00.000,00
Ex: 1.200,99 e não 1200,99

A52 – Máscara no Valor do Pedido

2017-07-26T03:36:29Z

Leonardo: /* Necessidade */

== Necessidade==
Ter uma facilidade de leitura dos campos de numéricos.

== Solução ==
Criar máscara para o valor dos itens e dos pedidos. Ex: 1.200,99 e não 1200,99

=== Locais ===
1. Grid do item no Portal no momento de fazer o pedido

2. Grid de item do Mobile no momento de fazer o pedido

3. Tela de Histórico de Pedidos do Mobile

A46 – Duplicar Pedido

2017-07-26T03:28:56Z

Leonardo: /* Necessidade */

== Necessidade ==
Os clientes tem a necessidade de configurar quais as informações podem ou não ser duplicada e até qual o tipo de pedido pode ser duplicado. Isto para proporcionar um melhor controle da venda evitando possíveis erros da operação.

== Solução ==
O GeoSales deverá permitir configurar qual o tipo de pedido poderá ser duplicado e quais são as informações que podem ser aplicadas em uma duplicação. Informações que podem ser configuradas para o controle da duplicação:

Adaptar rotina de duplicação de pedidos para obedecer às regras específicas da camil.

*Meio de pagamento
*Condição de pagamento
*Data de entrega
*Descontos
*Preço (Caso o preço não possa ser duplicado o sistema irá praticar o preço atual)

Está configuração será interna da SoftSite, não será disponibilizado tela de configuração para o cliente.

Quando alguma dessas informações tiverem parametrizadas para duplicar o sistema repetirá a mesma do pedido original, mas possibilitará edição, caso não esteja para parametrizado para duplicar o sistema não irá carregar essas informações no pedido duplicado.

== Regras de Negócio ==
*RN1 – Quando alguma dessas informações tiverem parametrizadas para duplicar o sistema repetirá a mesma do pedido original, mas possibilitará edição, caso não esteja para parametrizado para duplicar o sistema não irá carregar essas informações no pedido duplicado.
*RN2 – Os movimentos que não tiverem habilitados para duplicar não terão essa funcionalidade disponibilizada
*RN3 – Caso a data de entrega esteja parametrizado para não duplicar o sistema irá aplicar o calcular da data de entrega, caso esteja parametrizado.
*RN4 – Pedido duplicado seguirá fluxo padrão após o carregamento das informações parametrizadas.

A46 – Duplicar Pedido

2017-07-26T03:27:01Z

Leonardo: /* Solução */

== Necessidade ==
Adequar as regras de preço e data de entrega na funcionalidade de duplicação de pedido.

== Solução ==
O GeoSales deverá permitir configurar qual o tipo de pedido poderá ser duplicado e quais são as informações que podem ser aplicadas em uma duplicação. Informações que podem ser configuradas para o controle da duplicação:

Adaptar rotina de duplicação de pedidos para obedecer às regras específicas da camil.

*Meio de pagamento
*Condição de pagamento
*Data de entrega
*Descontos
*Preço (Caso o preço não possa ser duplicado o sistema irá praticar o preço atual)

Está configuração será interna da SoftSite, não será disponibilizado tela de configuração para o cliente.

Quando alguma dessas informações tiverem parametrizadas para duplicar o sistema repetirá a mesma do pedido original, mas possibilitará edição, caso não esteja para parametrizado para duplicar o sistema não irá carregar essas informações no pedido duplicado.

== Regras de Negócio ==
*RN1 – Quando alguma dessas informações tiverem parametrizadas para duplicar o sistema repetirá a mesma do pedido original, mas possibilitará edição, caso não esteja para parametrizado para duplicar o sistema não irá carregar essas informações no pedido duplicado.
*RN2 – Os movimentos que não tiverem habilitados para duplicar não terão essa funcionalidade disponibilizada
*RN3 – Caso a data de entrega esteja parametrizado para não duplicar o sistema irá aplicar o calcular da data de entrega, caso esteja parametrizado.
*RN4 – Pedido duplicado seguirá fluxo padrão após o carregamento das informações parametrizadas.

A46 – Duplicar Pedido

2017-07-26T03:25:34Z

Leonardo:

== Necessidade ==
Adequar as regras de preço e data de entrega na funcionalidade de duplicação de pedido.

== Solução ==
O GeoSales deverá permitir configurar qual o tipo de pedido poderá ser duplicado e quais são as informações que podem ser aplicadas em uma duplicação. Informações que podem ser configuradas para o controle da duplicação:

Adaptar rotina de duplicação de pedidos para obedecer às regras específicas da camil.

*Meio de pagamento
*Condição de pagamento
*Data de entrega
*Descontos
*Preço (Caso o preço não possa ser duplicado o sistema irá praticar o preço atual)

Quando alguma dessas informações tiverem parametrizadas para duplicar o sistema repetirá a mesma do pedido original, mas possibilitará edição, caso não esteja para parametrizado para duplicar o sistema não irá carregar essas informações no pedido duplicado.

Solução será criar um estrutura dinâmica para identificar poderá ser duplicado.

== Regras de Negócio ==
*RN1 – Quando alguma dessas informações tiverem parametrizadas para duplicar o sistema repetirá a mesma do pedido original, mas possibilitará edição, caso não esteja para parametrizado para duplicar o sistema não irá carregar essas informações no pedido duplicado.
*RN2 – Os movimentos que não tiverem habilitados para duplicar não terão essa funcionalidade disponibilizada
*RN3 – Caso a data de entrega esteja parametrizado para não duplicar o sistema irá aplicar o calcular da data de entrega, caso esteja parametrizado.
*RN4 – Pedido duplicado seguirá fluxo padrão após o carregamento das informações parametrizadas.

Discussão:Sugestão de Venda

2017-04-06T12:41:17Z

Leonardo: /* Aguardando retorno */ nova seção

== Integração ==

Integração[editar]
As informações contidas '''nesses 2 campos''' não precisam ser integradas com o ERP do cliente. Logo nesse primeiro momento não há interação da integração.

Que campos são estes??

== Choque de funcionalidade ==

Essa funcionalidade já existe para Empresa Real Alimentos.
Existe uma diferença na forma do calculo da sugestão com isso precisamos criar um meio da coexistência das duas formas.
Poderia ser criado uma cadastro de parametrização que definirá a forma de calculo, exemplo:

Com base em quantas ultimas vendas?
Linear?
Com base na mesma semana nos meses passados?

Coisa desse tipo.

== Aguardando retorno ==

Como informei funcionalidade já existe para outros clientes.
Precisa se analisar se atende totalmente ou parcialmente a necessidade e a partir do que exite gerar um documento adequando o sistema para atender a demanda.

Discussão:Relatório Agendado X Realizado

2017-04-06T12:36:55Z

Leonardo: /* Origem dados[editar] */ nova seção

== Origem dados[editar] ==

Não tem informações suficientes.
O agendamento tem alguns situações que não estão sendo tratadas no documento.
A forma de intercessão entre o agendado e o realizado não está claro e isto pode gerar desenvolvimento errado da solução.

Discussão:Sugestão de Venda

2017-03-27T12:23:56Z

Leonardo: /* Choque de funcionalidade */ nova seção

Discussão:Sugestão de Venda

2017-03-27T12:15:35Z

Leonardo: /* Integração */ nova seção

Projeto/Rota

2017-03-27T12:01:47Z

Leonardo: /* Histórico de Revisões */

== Histórico de Revisões ==
{| border="1" cellpadding="1"
! Data
! Quem
! Comentários
|-
| 12/01/2017 || Nelson Curcio || Criação do Documento
|-
| 23/03/2017 || Renato Lima || Ajuste Documento
|-
| 23/03/2017 || Leonardo Sousa || Revisado / Aprovado
|}

== Necessidade ==

O cliente solicitou que quando for uma "data especial", a rota dessa data seja enviada para os dias anteriores e/ou
posteriores. Que ele possa fazer essa alteração com antecedência e escolhendo os representantes para que isso
ocorra.

Não existe dia sem rota. Todos os dias,para vendedores que não estiverem na tabela de exceção daquele dia, terão suas rotas carregadas normalmente com os clientes do dia.
Apenas para os vendedores que estiverem com exceção configurada na tabela para o referido dia, o sistema carregará seguindo a informação da tabela de exceção conforme abaixo.

=== Exemplo da necessidade ===

Usando o dia 11/01 como exemplo , que foi uma quarta , o sistema carregaria para todos os vendedores(com exceção dos A,B e C) a rota da própria quarta como acontece atualmente.
Neste mesmo dia, para o vendedor “A”, carregaria as rotas da quarta e quinta , para o vendedor “B” carregaria as rotas da terça e quarta e para o vendedor “C” carregaria as rotas da quarta , quinta e sexta.
Já para o dia 13/01 as exceções seria para os clientes “A” e “D” que carregariam as rotas de sexta e segunda.

No dia 14/01 teríamos apenas o vendedor “C” como exceção que carregaria a rota da sexta.

Conforme tabela abaixo.

[[Arquivo:Rota Sabe1.jpg]]

=Solução=
Deve ser criado no Protheus uma tabela onde serão gravados os seguintes dados:
* Vendedor - O código do Vendedor
* Data - Data em que precisará do tratamento para rota
* Envio rota -
** 0 - Envia para o dia Antes
** 1 - Envia para o dia posterior
** 2 - Envia para dia Antes e posterior

As datas, vendedores que não estiverem nessa tabela, as rotas serão recebidas normalmente por todos os vendedores;

De acordo com as informações que estiverem nessa tabela, através da integração será feito tratamento para disponibilização das rotas para o Geosales.

Todos os feriados serão inseridos nesta tabela, informando se precisará enviar rota antes, depois ou ambos e quando necessário poderá ser aplicado por vendedor.

=Implementação=
* A exibição da rota no Geosales será tratada e trazida através da integração, considerando os dados fornecidos na tabela que será criada.

=== Regras de Negócio ===

'''[RN1]''' – Datas e vendedores que não estiverem na tabela criada, suas rotas serão integradas normalmente, respeitando a rota de cada dia.

'''[RN2]''' – Será possível tratar datas de feriados ou datas avulsas em que precise enviar a rota de um dia especifico, mas de uma vez.

'''[RN3]''' – A rota poderá ficar disponível por até três dias consecutivos de acordo com a configuração inserida.

'''[RN4]''' – Será possível aplicar a configuração por data, por vendedor especifico, sendo possível enviar antes ou depois da data.

'''[RN5]''' – Quando NÃO houver o codigo do vendedor na tabela, mas data e configuração que determina o envio antes ou depois, será aplicado a todos vendedores.

'''[RN6]''' – Todos os feriados precisaram ser inseridos na tabela informando se é necessário enviar antes, depois ou ambos.

'''[RN7]''' – Em feriados regionais, além da data do feriado, para vendedores que atendem a localidade, precisa informar o código do vendedor para que
as rotas sejam disponibilizadas de acordo com a configuração.

=== Cenário Feliz ===
====Dados====
Semana: 20/03 a 24/03
*Rota - Quarta
*Vendedor: João
*Não há informações na tabela

==== Operação ====
*Vendedor João acessa o tablet na quarta;
*Vendedor João tem rota da quarta disponível;

==== Assertivas====
*Vendedor João realiza atendimento dos clientes das rotas de quarta.

=== Cenário de Alerta 1 ===
====Dados====
Semana: 20/03 a 24/03
*Rota - Quarta
*Vendedor: João
*Há informações na tabela de configuração
** Vendedor João
** Data de Quarta
** 2 - Antes e Depois

==== Operação ====
*Vendedor João acessa o tablet na terça;
**Vendedor João tem rota de terça e quarta disponível;
*Vendedor João acessa o tablet na Quarta;
**Vendedor João tem rota de quarta disponível;
*Vendedor João acessa o tablet na Quinta;
**Vendedor João tem rota de quarta e Quinta disponível;
*Rota disponibilizadas dessa forma apenas para o vendedor João

==== Assertivas====
*Vendedores realizam atendimento dos clientes das rotas de quarta, na terça, quarta e quinta.

=== Cenário de Alerta 2 ===
====Dados====
Semana: 20/03 a 24/03
*Rota - Quarta
*Vendedor: TODOS
*Há informações na tabela de configuração
** Data de Quarta
** 2 - Antes e Depois

==== Operação ====
*Vendedores acessam o tablet na terça;
**Vendedores tem rota de terça e quarta disponível;
*Vendedores acessam o tablet na Quarta;
**Vendedores tem rota de quarta disponível;
*Vendedores acessam o tablet na Quinta;
**Vendedores tem rota de quarta e Quinta disponível;
*Rota disponibilizadas dessa forma para todos os vendedores.

==== Assertivas====
*Vendedores realizam atendimento dos clientes das rotas de quarta, na terça, quarta e quinta.

=== Cenário de Alerta 3 ===
====Dados====
Semana: 20/03 a 24/03
*Rota - Quarta
*Vendedor: João
*Há informações na tabela de configuração
** Vendedor João
** Data de Quarta
** 0 - Antes

==== Operação ====
*Vendedor João acessa o tablet na terça;
**Vendedor João tem rota de terça e quarta disponível;
*Vendedor João acessa o tablet na Quarta;
**Vendedor João de quarta disponível;
*Rota disponibilizadas dessa forma apenas para o vendedor João

==== Assertivas====
*Vendedor João realiza atendimento dos clientes das rotas de quarta, na terça e quarta.

=== Cenário de Alerta 4 ===
====Dados====
Semana: 20/03 a 24/03
*Rota - Quarta
*Vendedor: João
*Há informações na tabela de configuração
** Vendedor João
** Data de Quarta
** 1 - Posterior

==== Operação ====
*Vendedor João acessa o tablet na Quinta;
**Vendedor João tem rota de quarta e quinta disponível;
*Vendedor João acessa o tablet na Quarta;
**Vendedor João de quarta disponível;
*Rota disponibilizadas dessa forma apenas para o vendedor João

==== Assertivas====
*Vendedores realizam atendimento dos clientes das rotas de quarta, na quarta e quinta.

== Aprovação ==

-------------------------------- ---------------------------------------
Comercial (Sabe) Gerente de Projetos (SoftSite)

Autorização de Preço com validade

2017-03-17T13:34:56Z

Leonardo: /* Histórico de Revisões */

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

=Necessidade=
Ao autorizar um preço de acordo com a alçada cadastrada para cada supervisor, este terá uma opção de informar se a autorização se refere a um único pedido ou a vários pedidos por tempo determinado. Se autorizado para período determinado, supervisor insere data ate quando a condição estará autorizada. Novos pedidos do mesmo cliente, mesmo produto e mesmas condições não serão necessários autorização;

=Solução=
Na nova tela de aprovação de pedido, quando o supervisor for executar a aprovação do pedido pendente, o sistema abrirá um alerta perguntando se o desconto aplicado será utilizado para outros pedidos do mesmo cliente e produto. Caso a afirmação seja positiva o sistema abrirá um campo para o supervisor informar a data de validade deste desconto. Esse desconto será cadastrado na desconto_cliente_produto onde o mesmo será aplicado na faixa de preço.

=Implementação=
* Na tela de aprovação de pedido quando clicar em Aprovar, o sistema apresentará um alerta com a seguinte mensagem: Autorização refere-se a esse único pedido ou a outros pedidos por tempo determinado?

::Exemplo:
::[[Arquivo:ALERTA_1.jpg|250px]]
* Se selecionar NÃO o sistema aprovará o pedido, caso a opçao seja SIM o sistema abrirá um segundo alerta onde será informado uma data de validade.

::Exemplo:
::[[Arquivo:ALERTA2.jpg|250px]]
* Ao informar a data e clicar em OK o sistema deve verificar o percentual aplicado e inserir as informações de produto, cliente, percentual de desconto e data de validade na tabela DESCONTO_PRODUTO_CLIENTE, se cancelar deve apenas aprovar o pedido.
* Na tabela de DESCONTO_PRODUTO_CLIENTE deve ser criado o campo DT_VALIDADE_DESCONTO, onde será gravado a validade do produto.
* Quando o cliente já tiver um desconto cadastrado, com data de validade vigente e for informado um percentual maior,o pedido deve ficar pendente e o sistema deve apresentar as informações da regra para que seja alterada ou mantida a atual. Dessa forma ele podera autoriza apenas aquele pedido ou modificar a regra para os futuros pedidos.

::Exemplo:
::[[Arquivo:Alerta3.jpg|250px]]

* Cliente - Campo apenas para visualização
* Produto - Campo apenas para visualização
* Percentual - Campo que pode ser alterado
* Data de Validade - Campo que pode ser alterado

* Caso o cliente clique na opção ALTERAR o pedido será aprovado e a Regra de desconto será alterada.

* Caso o cliente clique na opção CANCELAR o pedido será aprovado, mas a Regra não será alterada.

* Na tela de cadastro de DESCONTO_PRODUTO_CLIENTE adicionar o campo de data de vencimento para cadastro, visualização e edição.

::Exemplo:
::[[Arquivo:Alerta4.jpg|600px]]

* Na tela de pedido, quando esse desconto for ser aplicado, precisa validar a data de validade.

* Quando o desconto tiver data de validade, já estiver vencida, o sistema deve permitir o cadastro de uma nova regra.

=== Regras de Negócio ===

'''[RN1]''' – O desconto cadastrado na tabela DESCONTO_PRODUTO_CLIENTE será aplicado conforme regra da configuração APLICAR_DESCONTO_TODA_FAIXA, ou seja em toda a faixa ou apenas no valor minimo caso não tenha a configuração.

'''[RN2]''' – O desconto será aplicado se a data de emissão do pedido for menor ou igual a data de validade do desconto.(DT_VALIDADE_DESCONTO)

'''[RN3]''' – O pedido ficará pendente caso a data de emissão do pedido tenha ultrapassado a data de validade do desconto.

'''[RN4]''' – O pedido NÃO ficará pendente caso a data de emissão do pedido seja menor que a data de validade do desconto.

'''[RN5]''' – O DESCONTO_PRODUTO_CLIENTE na hierarquia de desconto deve ter a prioridade maior.

'''[RN6]''' – A Regra cadastrada poderá ser usada por qualquer vendedor que venda o produto e atenda o cliente.

=== Cenário Feliz ===
====Dados====
*Supervisor do Joao
**Alçada: 10%
*Vendedor: João
*Clinte: Pedro
*Produto: Produto A
* Não há regra de desconto cadastrada para produto e cliente

==== Operação ====
*Vendedor João cria o pedido;
*Selecionar o Item: Produto A com desconto
**Desconto:10%
* Cliente: Pedro
*O vendedor salva o Pedido
*Pedido fica pendente
*Supervisor aprovar pedido sem informar data

==== Assertivas====
*Pedido fica autorizado
*Pedido enviado para o ERP com sucesso.

=== Cenário de Alerta 1 ===
====Dados====
*Supervisor do Joao
**Alçada: 10%
*Vendedor: João
*Clinte: Pedro
*Produto: Produto A
* Não há regra de desconto cadastrada para produto e cliente

====Operação====
*Vendedor João cria o pedido;
*Selecionar o Item: Produto A com desconto
**Desconto:10%
* Cliente: Pedro
*O vendedor salva o Pedido
*Pedido fica pendente
*Supervisor aprovar pedido e informa data

====Assertivas====
*Pedido fica autorizado
*Pedido enviado para o ERP com sucesso.
* Regra de desconto cadastrada

=== Cenário de Alerta 2 ===
====Dados====
*Supervisor do Joao
**Alçada: 10%
*Vendedor: João
*Clinte: Pedro
*Produto: Produto A
* Com regra de desconto cadastrada para produto e cliente
** Desconto 10%

====Operação====
*Vendedor João cria o pedido;
*Selecionar o Item: Produto A com desconto
**Desconto:10%
* Cliente: Pedro
*O vendedor salva o Pedido

====Assertivas====
*Pedido fica autorizado
*Pedido enviado para o ERP com sucesso.

=== Cenário de Alerta 3===
====Dados====
*Supervisor do Joao
**Alçada: 10%
*Vendedor: João
*Clinte: Pedro
*Produto: Produto A
* Com regra de desconto cadastrada para produto e cliente
** Desconto 10%

====Operação====
*Vendedor João cria o pedido;
*Selecionar o Item: Produto A com desconto
**Desconto:15%
* Cliente: Pedro
*O vendedor salva o Pedido
* Pedido fica pendente
*Supervisor aprovar pedido sem informar data

====Assertivas====
*Pedido fica autorizado
*Pedido enviado para o ERP com sucesso.

=== Cenário de Alerta 4===
====Dados====
*Supervisor do Joao
**Alçada: 10%
*Vendedor: João
*Clinte: Pedro
*Produto: Produto A
* Com regra de desconto cadastrada para produto e cliente
** Desconto 10%

====Operação====
*Vendedor João cria o pedido;
*Selecionar o Item: Produto A com desconto
**Desconto:15%
* Cliente: Pedro
*O vendedor salva o Pedido
* Pedido fica pendente
*Supervisor aprovar pedido e informa data
*Supervisor pode alterar o percentual e data de vencimento do desconto

====Assertivas====
*Pedido fica autorizado
*Pedido enviado para o ERP com sucesso.
*Regra de desconto é alterada.

== Aprovação ==

-------------------------------- ---------------------------------------
Comercial (Hafele) Gerente de Projetos (SoftSite)

Informações de endereço por CEP

2017-02-07T13:15:56Z

Leonardo: /* Histórico de Revisões */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| 07/02/2017 || Leonardo Sousa || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Luan Lima''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta pelo CEP informado;
#O serviço retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema GeoSales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema GeoSales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:11:27Z

Leonardo: /* Criação de Estruturas de Banco */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Luan Lima''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta pelo CEP informado;
#O serviço retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema GeoSales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema GeoSales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:10:20Z

Leonardo: /* Criação de Estruturas de Banco */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Luan Lima''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| id|| INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta pelo CEP informado;
#O serviço retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema GeoSales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema GeoSales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:09:20Z

Leonardo: /* Informações Gerais */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Luan Lima''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta pelo CEP informado;
#O serviço retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema GeoSales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema GeoSales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:07:30Z

Leonardo: /* Assertiva */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Jefferson Quesado''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta pelo CEP informado;
#O serviço retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema GeoSales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema GeoSales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:04:45Z

Leonardo: /* Assertiva */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Jefferson Quesado''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no serviço dos correios pelos dados do CEP informado;
#O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema GeoSales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema GeoSales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:04:22Z

Leonardo: /* Assertiva */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Jefferson Quesado''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no serviço dos correios pelos dados do CEP informado;
#O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema GeoSales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema geosales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:04:05Z

Leonardo: /* Assertiva */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Jefferson Quesado''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido;
#O sistema GeoSales faz uma consulta no serviço dos correios pelos dados do CEP informado;
#O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema GeoSales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema geosales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema geosales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:03:25Z

Leonardo: /* Assertiva */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Jefferson Quesado''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no serviço dos correios pelos dados do CEP informado;
#O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema geosales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema geosales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema geosales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:03:05Z

Leonardo: /* Cenário Happy Day */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Jefferson Quesado''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema GeoSales valida se o CEP é válido
#O sistema GeoSales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema GeoSales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido
#O sistema geosales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no serviço dos correios pelos dados do CEP informado;
#O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema geosales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema geosales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema geosales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Informações de endereço por CEP

2017-02-07T13:02:13Z

Leonardo: /* Solução */

{|
|-
|
| style="width:100%; text-align:right;" | [[Arquivo:Logo geosales.png]]
|}

== Histórico de Revisões ==
{| class="wikitable"
! Data !! Revisor !! Comentário
|-
| 01/02/2017 || Anderson Gomes || Criação do Documento
|-
| 06/02/2017 || Leonardo Sousa || Solicitação de correção
|-
| dd/mm/aaaa || || Análise e Aprovação da Arquitetura
|-
|}

==Informações Gerais==
{|
|-
| style="width:150px; text-align:left;" | '''Cliente:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
| style="width:150px; text-align:left;" | '''Projeto:'''
| style="width:300px; text-align:left;" | ''Rio Mix''
|-
| | '''Gerente/Sponsor:'''
| | ''Dolavale''
| | '''Gerente SoftSite:'''
| | ''Liliana Carrha''
|-
| | '''Analista SoftSite:'''
| | ''Anderson Gomes''
| | '''Arquiteto SoftSite:'''
| | ''Jefferson Quesado''
|-
| | '''Aplicação(s):'''
| | ''Mobile-GS''
| |
| |
|}

==Necessidade==
''Durante a alteração/cadastro de informações de cliente no GeoSales (Mobile e Portal) ser possível após a inserção de um determinado CEP que o sistema preencha os dados do endereço de forma automática caso existam informações para o CEP. e essas informações serem atualizadas no Protheus. Também é preciso que o sistema atualize as informações de endereço baseado no CEP.''

==Exemplo==
''O vendedor cadastrará um novo cliente, ao digitar o CEP o GeoSales deverá trazer as informações do endereço. Além de incluir um novo cliente, também deverá ser possível alterar o cadastro de um cliente já existente.''

==Solução==
''Ao digitar o CEP no GeoSales e clicar em um botão de pesquisa de endereço, na inclusão ou alteração de um cliente, o sistema deve buscar o endereço através do CEP digitado. Os seguintes campos devem ser preenchidos: endereço, bairro, cidade e estado. Esses campos devem permanecer editáveis, pois se o vendedor não possuir conexão ativa com a rede de dados, o sistema deve permitir que o usuário digite manualmente. Além disso, o usuário precisará digitar também as informações complementares, como número, bloco e etc.''

As informações serão buscadas de um Web Service da SoftSite que buscará as informações de outros provedores desse serviço, cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro.''

Para acessar o Web Service o sistema GeoSales deve mandar na requisição o nome da empresa/usuário/senha para se autenticar. Devido a isso o sistema deverá ter comunicação com a base de dados que contém essas informações.

Para cada empresa existirá um limite mensal de requisições, definido por configuração. Entretanto, a cada requisição a resposta é salva na base durante um intervalo de tempo que garanta a validade da informação, definido por configuração. Caso o dado (CEP) consultado conste nessa base não será contado como requisição.

==Criação de Estruturas de Banco==

Deverá ser criado um novo banco de dados específico para o Web Service. Ele terá as seguintes estruturas para controlar as requisições e para salvar os endereços pesquisados a fim de otimizar as consultas mais frequentes.

*ENDERECO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_ENDERECO || INT || NOT NULL || TRUE || TRUE
|-
| CEP || VARCHAR(8) || NOT NULL || FALSE || FALSE
|-
| ESTADO || VARCHAR(2) || NULL || FALSE || FALSE
|-
| CIDADE || VARCHAR(50) || NULL || FALSE || FALSE
|-
| DS_ENDERECO || VARCHAR(70) || NULL || FALSE || FALSE
|-
| BAIRRO || VARCHAR(40) || NULL || FALSE || FALSE
|-
| DT_VALIDADE || DATETIME || NULL || FALSE || FALSE
|-
|}

*EMPRESA_UTILIZACAO
{| class="wikitable"
! NOME DO CAMPO !! TIPO !! ANULÁVEL !! CHAVE !! AUTO INCREMENT
|-
| CD_EMPRESA_UTILIZACAO || INT || NOT NULL || TRUE || TRUE
|-
| NM_EMPRESA || VARCHAR(55) || NOT NULL || FALSE || FALSE
|-
| COMPETENCIA || VARCHAR(7) || NULL || FALSE || FALSE
|-
| CONTADOR || INT || NULL || FALSE || FALSE
|-
|}

'' A solução deve ser implementada para permitir que a mudança da origem de busca das informações seja de simples alteração.''

==Pré-Requisitos==
*''Para que essa customização funcione é preciso que a conexão de rede de dados esteja ativa no dispositivo do usuário e que o serviço utilizado para consultas as informações do endereço esteja funcionando.''

==Regras de Negócios==
*Para a validação do CEP as seguintes regras devem ser analisadas
**O CEP deve ter 8 caracteres
**O CEP deve conter somente números

==Regras de Exceções==
*O Web Service retornará o JSON {"erro": "true"} quando um CEP analisado não foi encontrado na análise;
*Para o erro de limite de requisições será retornado o erro 403;

==Protótipos==
''Inclua protótipos que facilite a visualização da funcionalidade. (Quando se aplicam)''

==Cenários==
''Inclua os cenários deseja atingir, a começar pelo caminho feliz.''

===Cenário Happy Day===
''Usuário edita o endereço de um cliente já cadastrado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service retorna os dados do endereço do CEP escolhido;
#O sistema geosales interpreta as informações retornadas e atualiza os campos correspondentes

===Cenário de Fluxo de Exceção===
''CEP inválido''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido
#O sistema geosales manda a mensagem que o CEP digitado é inválido e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''CEP não existente na base de dados''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no serviço dos correios pelos dados do CEP informado;
#O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados mandando o json de retorno da seguinte forma {"erro": "true"};
#O sistema geosales manda a mensagem que o CEP digitado é não consta na base de dados pesquisada e não preenche os dados do endereço;

===Cenário de Fluxo de Exceção===
''Serviço de consulta de informações não está funcionando''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service não envia resposta dentro do tempo limite estipulado ou retorna erro 404
#O sistema geosales manda a mensagem que o serviço está indisponível no momento;

===Cenário de Fluxo de Exceção===
''Limite de requisições alcançado''

====Dados====
#Cliente: João
#Usuário: Pedro

====Operação====
#Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
#Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670) e clica no botão de pesquisar endereço;

====Assertiva====
#O sistema geosales valida se o CEP é válido;
#O sistema geosales faz uma consulta no web service pelos dados do CEP informado;
#O web service verifica o contador de requisições da empresa solicitante e verifica que o limite foi alcançado e retorna o código de erro 403.
#O sistema geosales manda a mensagem que o limite de requisições foi alcançado;

==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"
! Setor
! Aprovado Por
! E-Mail
! Data
! style="width:300px" |Assinatura
|-
| '''''Tecnologia da Informação'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|-
| '''''Comercial'''''
| ''Nome do Aprovador''
| ''Email do Aprovador''
| ''Data da Aprovação''
| ''Assinatura do Aprovador''
|}

[[Category:Funcionalidade]]

Discussão:Complemento de saldo de conta corrente

2016-11-01T12:37:30Z

Leonardo: /* Solução */

'''
== Necessidade ==
'''
Cliente precisa estabelecer um saldo complementar para o usuário que utilizará a conta corrente para aprovar pedidos de bonificação. Esse saldo precisa ser atualizado todo primeiro dia útil do mês.
'''

== Solução ==
'''
*Criar um campo no cadastro da conta corrente para inserir o Saldo Complementar do Usuário

*Criar rotina para complementar saldo da conta corrente no primeiro dia de cada mês
'''

A solução está voltada apenas para a necessidade da Camil.

Precisa possibilitar parametrizar a periodicidade para está funcionalidade, permitir também múltiplas parametrização.

A parte da rotina também precisa ser melhor descrita.

== Cenários ==

'''Cenário 1'''

*Usuário João possui Saldo Complementar de 2000 e no dia 31/10/2016 ele possui um saldo de conta corrente de 1500, no dia 01/11/2016 será feito um lançamento complementar automático de 500,00

'''Cenário 2'''

*Usuário João possui Saldo complementar de 2000 e no dia 31/10/2016 ele possui zero de saldo de conta corrente, no dia 01/11/2016 será realizado um lançamento complementar automático de 2000 em sua conta corrente

'''Cenário 3'''

*Usuário João possui Saldo complementar de 2000 e no dia 31/10/2016 ele possui 2000 de saldo de conta corrente, no dia 01/11/2016 não será realizado saldo complementar pois seu saldo atual já é igual ao saldo complementar
'''

----

----

New Sync "TamoJunto"

2016-10-27T21:03:27Z

Leonardo: /* TamoJunto */

== TamoJunto ==
Marcação Horizontal 
Envio de dados em formato Json 
Otimização de escrita

New Sync "TamoJunto"

2016-10-27T21:02:40Z

Leonardo: Criou página com ' == TamoJunto == Marcação Horizontal Envio de dados em formato Json Otimização de escrita'

== TamoJunto ==
Marcação Horizontal
Envio de dados em formato Json
Otimização de escrita

Arquitetura

2016-10-27T21:01:51Z

Leonardo: Criou página com 'New Sync "TamoJunto"'

[[New Sync "TamoJunto"]]