Histórico da Página

...

Insira o nome do cliente, ou se for empresa insira a razão social:

Image AddedImage Removed
Imagem 1 - Tela do Cadastro de Pessoa

Informe o tratamento, que é o nome como irá tratar a pessoa, pode ser um apelido ou até mesmo somente o primeiro nome. Fica aberto para definir como deseja identificar:

Image AddedImage Removed
Imagem 2 - Tratamento

Defina o tipo de pessoa, se trata de uma pessoal física ou pessoa jurídica:

Image AddedImage Removed
Imagem 3 - Tipo de Pessoa

...

Informe o estado civil da pessoa:

Imagem 6 - Estado Civil

O usuário deve informar primeiramente o CEP A aplicação possui o recurso de busca das informações, utilizando endpoint específico da nova API Conector Dados Globais.
Para habilitar o campo Cidade, agora, será necessário pressionar TAB quando o cursor estiver no campo CEPPara 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.

Imagem 7 - Busca de informações baseado no CEP

Para habilitar o campo Cidade, quando existe uma URL configurada para a API de Conector dados Globais, será necessário pressionar TAB quando o cursor estiver no campo CEP.

Caso o usuário não saiba o CEP, 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.

Imagem 8 - 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.

Imagem 9 - Retorno de vários CEPs para uma mesma Cidade, UF e Logradouro

Importante ressaltar, que as novas implementações só terão efeito se a API Conector Dados Globais estiver devidamente instalada no ambiente do cliente, caso a API não esteja instalada e configurada, o processo padrão anterior existente continuará sendo executado.

Padrão de configuração de CEP, Cidade, Bairro e Logradouro sem as configurações da API Conector Dados Globais, com a comunicação dos CEP´s dos correios.

Informe a cidade. Quando adicionar a cidade a pessoa, os campos UF e CEP serão preenchidos automaticamente. O campo CEP poderá sofrer alteração quando adicionar o bairro e o logradouro:

...

Adicionar o número da residência:

Imagem 13 - Número

Adicione o telefone de contato, poderá adicionar até três números de telefones:

...

Após informar os campos, clique para retornar.

Consulta CNPJ

Foram implementadas na aplicação, recurso para buscar informações de pessoa do tipo Jurídica, através da nova API Conector Dados Globais, com base nos dados da Receita Federal ou Sintegra, em integração à plataforma TOTVS API Services.
Requisitos para uso do recurso de busca de informações de pessoa do tipo Jurídica com base nos dados da Receita Federal ou Sintegra.
Importante: Para utilizar o recurso, é necessário contratar o pacote TOTVS API Services.
Detalhes:

Pacote necessário: TOTVS API Services.
Descrição do Pacote: O TOTVS API Services facilita o serviço de consulta automática à bases de dados públicas e automatiza o preenchimento de registros a partir dessas bases externas. As consultas são realizadas por meio de webservice e não demandam alta infraestrutura.
Como contratar: Entrar em contato diretamente com o ESN responsável pela empresa, e para mais informações, segue o link de contratação https://totvs.store/br/produto/totvs-api-services.html

Antes de prosseguir, certifique-se de que o usuário, utilizado para autenticação de uso na API, está com as devidas permissões no Sistema/Módulo/Aplicações e na empresa desejada. Para isso, acesse o módulo SegurançaWeb > Permissões > Associação de Permissão Usuário / Grupo > Sistemas/Módulo/Aplicações > Sistema Global > Módulo de Aplicações Globais em Web > API Conector Dados Globais.

Image Added Imagem 32 - Permissão de Listar na API de Conector Dados Globais

Conforme mostra a imagem abaixo, foram adicionados dois novos componentes à tela, sendo eles o botão Consulta CNPJ, e no fim da tela, uma mensagem onde o conteúdo alerta ao usuário como proceder para realizar a consulta do CNPJ e que tipo de consulta será feita, importante ressaltar que:
Que os novos componentes inseridos na tela somente serão exibidos se, na rotina Parâmetro Geral, aba Integrações, do módulo Parâmetro, se a URL base de API Local estar preenchida, a opção Utiliza integração com TOTVS API Services estar marcada e a Chave de autenticação TOTVS API estar preenchida;
A mensagem deverá retornar de acordo com a opção selecionada na opção Fonte para pesquisa de informações para dados de pessoa jurídica, na rotina Parâmetro Geral, aba Integrações, do módulo Parâmetro:
Se a opção marcada for Receita Federal, a mensagem será: Para buscar dados cadastrais de pessoa jurídica junto à Receita Federal, utilize o botão Consulta CNPJ.
Se a opção marcada for Sintegra, a mensagem será: Para buscar dados cadastrais de pessoa jurídica junto à Sintegra, utilize o botão Consulta CNPJ.
Se a opção marcada foi Ambos, a mensagem será: Para buscar dados cadastrais de pessoa jurídica junto à Receita Federal e Sintegra, utilize o botão Consulta CNPJ.

Image Added Imagem 33 - Layout no cadastro de pessoa - Botão Consulta CNPJ

Ao clicar no botão Consulta CNPJ, será exibida a tela, conforme imagem abaixo, onde:
Caso a opção de pesquisa seja Receita Federal, o campo CNPJ obrigatoriamente preenchido, e o campo UF é opcional;
Se a opção for Sintegra ou Ambos, os campos CNPJ e UF são obrigatórios;
Se o usuário não informar os campos na rotina Pessoas - GEPES0010, os campos estarão vazios e editáveis para que o usuário possa informar;
Se o usuário informar os campos na rotina Pessoas - GEPES0010, os campos estarão previamente preenchidos e não editáveis;

Image Added
Imagem 34 - Dialog Pesquisa dados Pessoa Jurídica

Image Added

Imagem 34 - Exemplo de utilização da Consulta CNPJ

Se os campos CNPJ e UF estiverem vazios, deverá ser exibida mensagem de alerta ao usuário;
Se a opção marcada for Receita Federal, o campo CNPJ é obrigatório.
Se a opção marcada for Sintegra ou Ambos, o campo CNPJ e UF são obrigatórios.

Image Added
Imagem 35 - Mensagem sobre campos vazios

Image Added
Imagem 36 - Mensagem sobre campos vazios

Image Added
Imagem 37 - Mensagem sobre campos vazios

Ao informar um CNPJ, e este já encontra-se inserido no banco de dados, a rotina retornará avisando se o usuário deseja realmente realizar a pesquisa:

Image Added
Imagem 38 - Mensagem sobre CNPJ já cadastrado.

Se os dados informados estiverem prontos para ser realizada a pesquisa sobre determinado CNPJ, ao clicar no botão com o símbolo de check, a consulta será iniciada, e então a TOTVS API Services, irá buscar e validar os dados:
Se houver algum problema na comunicação da API, será retornada a mensagem abaixo:
Image AddedImagem 39 - Mensagem de falha na comunicação com a API.

Se o CNPJ informado estiver errado ou inválido, será retornada mensagem de alerta:
Image Added
Imagem 40 - Mensagem de dados não encontrado.

Se o CNPJ informado estiver correto, e para ele houver mais de uma Inscrição Estadual, será aberta uma tela para que o usuário escolha qual a Inscrição Estadual deseja vincular ao cadastro da Pessoa, o exemplo da imagem abaixo exibi apenas uma Inscrição Estadual, apenas de modo ilustrativo para demonstração da tela.

Image Added
Imagem 41 - Tela que será executada caso o CNPJ pesquisado tenha mais de uma Inscrição Estadual. (tarja em vermelho para preservar os dados pesquisados)

Se os CNPJ informado estiver correto, será exibida uma tela com todos os dados resultantes da pesquisa;
No fim da tela, haverá dois botões, um para confirmar os dados e outro para cancelar a busca dos registros:
Se o usuário clicar no botão que confirma os dados, será então preenchida a rotina Pessoas - GEPES0010;
Se o usuário opte por não confirmar os dados, a tela será fechada e voltará a tela de Pesquisa dados de Pessoa Jurídica;

Image Added
Imagem 42 - Retorno da API quando os dados são encontrados. (tarja em vermelho para preservar os dados pesquisados)