...
A aplicação possui o recurso de busca das informações, utilizando endpoint específico da nova API Conector Dados Globais. Para isso, deve-se instalar a API no ambiente e configurar a URL de instalação na rotina Parâmetros Gerais, na guia Integrações, no campo URL base de API local.
Observação: Para usar o recurso de busca de logradouro por CEP, com base na API dos Correios, não é necessário nenhuma aquisição ou contrato adicional, apenas instalar a API de dependência e realizar a configuração da URL de instalação, na rotina de Parâmetros Gerais.
Funcionamento do recurso de busca de logradouro por CEP, com base na API dos Correios:
- Consulta Inicial:
- Quando um CEP é informado pela primeira vez, o sistema faz uma chamada à API dos Correios.
- Os dados retornados, incluindo informações de logradouro, são armazenados na base de dados do ERP junto com a data da consulta.
- Verificações
- Ao consultar um CEP já existente:
- O sistema verifica a data da última consulta armazenada.
- Se a consulta foi realizada dentro dos últimos 12 meses, os dados são recuperados diretamente do base de dados sem acionar a API.
- Se a consulta ultrapassou os 12 meses, o sistema faz uma nova chamada à API, atualizando as informações e a data da consulta.
- Quando se tratar de um CEP por logradouro, a aplicação deve carregar as informações de cidade, UF, bairro e logradouro conforme a pesquisa realizada, ficando o cursor no campo Nº. As informações pesquisadas devem serão automaticamente atualizadas nas tabelas pertinentes ao Logradouro.
Image Modified Imagem 3 - Busca de informações baseado no CEP
- Caso o usuário não saiba o CEP, ele poderá sair do campo CEP, automaticamente os campos Cidade, UF e Logradouro são habilitados para que ele possa informá-los, para que assim a rotina faça a busca pela API Conector Dados Globais do CEP e Bairro correspondente a aquelas informações.
Image Modified Imagem 4 - Busca de informações do CEP através da Cidade, Uf e Logradouro
- Quando os dados informados de Cidade, UF e Logradouro, possuírem mais de um CEP vinculado junto aos Correios, será exibida uma dialog com todos os resultados encontrados para que o usuário possa selecionar a informação correta.
Image Modified Imagem 4 - Retorno de vários CEP´s para uma mesma cidade, UF e logradouro
- Quando se tratar de um CEP único por localidade, a aplicação deve carregar as informações de cidade e UF, ficando o cursor no campo Logradouro, para definição pelo usuário.
Imagem 5- CEP único por localidade
Outras abas disponíveis na aplicação Cliente:
II. Contatos
Inserir, modificar ou excluir informações relacionadas as contatos que deseja cadastrar para o cliente (telefones, e-mail, permissões e opções para envio etc.)
Utilize os botões na parte superior da tela para adicionar ou excluir contatos.
...