Informações de endereço por CEP

Histórico de Revisões

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

Cliente:	Rio Mix	Projeto:	Rio Mix
Gerente/Sponsor:	Dolavale	Gerente SoftSite:	Liliana Carrha
Analista SoftSite:	Anderson Gomes	Arquiteto SoftSite:	Jefferson Quesado
Aplicação(s):	Mobile-GS

Necessidade

Alterar informações cadastrais do cliente no Mobile e Portal e essas informações serem atualizadas no Protheus. Um dos pontos mais importantes para o cliente é o sistema atualizar as informações de endereço baseado no CEP, ele deseja que o sistema busque no site dos correios os dados a partir do CEP.

Exemplo

O vendedor cadastrará um novo cliente, ao digitar o CEP a aplicação Mobile-GS deve trazer as informações do endereço. Além de incluir um novo cliente, também deve ser possível alterar o cadastro do cliente da mesma forma.

Solução

Ao digitar o CEP na aplicação Mobile-GS, 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 através de um serviço gratuito chamado ViaCEP (https://viacep.com.br/), cujo a SoftSite não pode garantir seu funcionamento, pois trata-se de um serviço de terceiro. 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

• Liste aqui as regras de negócios necessárias para a funcionalidade. (Quando se aplicam)

Regras de Exceções

• Liste aqui as regras de exceções necessárias para a funcionalidade. (Quando se aplicam)

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

1. Cliente: João
2. Usuário: Pedro

Operação

1. Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
2. Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual(60813670);

Assertiva

1. O sistema geosales valida se o CEP é válido
2. O sistema geosales faz uma consulta no serviço dos correios pelos dados do CEP informado;
3. O serviço dos correios retorna os dados do endereço do CEP escolhido;

Cenário de Fluxo de Exceção

CEP inválido

Dados

1. Cliente: João
2. Usuário: Pedro

Operação

1. Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
2. Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (00000);

Assertiva

1. O sistema geosales valida se o CEP é válido
2. 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

1. Cliente: João
2. Usuário: Pedro

Operação

1. Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
2. Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (99999000);

Assertiva

1. O sistema geosales valida se o CEP é válido;
2. O sistema geosales faz uma consulta no serviço dos correios pelos dados do CEP informado;
3. O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados;
4. 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

1. Cliente: João
2. Usuário: Pedro

Operação

1. Pedro escolhe na listagem de clientes o cliente João e clica no botão detalhes;
2. Pedro preenche o campo CEP da aba "Clien. Cont." com o CEP atual (60813670);

Assertiva

1. O sistema geosales valida se o CEP é válido;
2. O sistema geosales faz uma consulta no serviço dos correios pelos dados do CEP informado;
3. O serviço dos correios retorna que o CEP escolhido não consta na sua base de dados;
4. 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;

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.

Setor	Aprovado Por	E-Mail	Data	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