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 |
| 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: | Fábio Sobral |
| Aplicação(s): | Mobile-GS |
Necessidade
Alterar informações cadastrais do cliente no Mobile 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: logradouro/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. Inicialmente, identificamos duas formas buscar essas informações:
- Através de um serviço gratuito chamado ViaCEP (https://viacep.com.br/), cujo a SoftSite não pode garantir seu funcionamento;
- Através de um serviço pago disponível pelos Correios (https://www.correios.com.br/para-voce/consultas-e-solicitacoes/precos-e-prazos/servicos-nacionais_pasta/e-dne), cujo gerará um custo adicional para o cliente.
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.
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
- 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);
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 os dados do endereço do CEP escolhido;
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);
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);
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;
- 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 | 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 |