Histórico da Página

...

Foram implementadas na aplicação de manutenção Pessoas - GEPES0010, 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.

Para utilização do 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 adquirir um pacote do serviço TOTVS API Services. Isso deve estar claro na documentação, com informação do link destinado à compra (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 > API Conector Dados Globais Módulo de Aplicações Globais em Web > API Conector Dados Globais.

...

Image Added
Imagem 1 - Tela para realizar a permissão das API Conector Dados Globais

...

Foi criada a coluna INDCONSPJAPI na tabela que armazena os dados da Pessoa, esta coluna é o Indicador que demonstra se o CNPJ informado foi validado em consulta via API 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 componeste 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 RemovedImage Added

Imagem 2 - Alteração de Layout na Pessoas - GEPES0010

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 3 - Dialog Pesquisa dados Pessoa Jurídica

Image RemovedImage Added

Imagem 4 - 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
Image RemovedImagem 5 - Mensagm Mensagem sobre campos vazios

Image RemovedImage Added

Imagem 6 - Mensagm Mensagem sobre campos vazios

Image RemovedImage Added

Imagem 7 - Mensagm 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 RemovedImage Added

Imagem 8 - Mensagm 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 ModifiedImagem 9 - Mensagm Mensagem de falha na comunicação com a API.

- Se o CNPJ informado estiver errado ou inválido, será retornada mensagem de alerta:
Image Modified
Imagem 10 - Mensagm 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 RemovedImage Added
Imagem 11 - Tela que será executada caso o CNPJ pesquisado tenha mais de uma Inscrição Estadual. (taja 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;