...
- Para utilização do 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 (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 > Comercial Web Sistema Global > API Conector Dados Globais > API Dados Globais.
![Exibindo image.png](https://chat.google.com/u/0/api/get_attachment_url?url_type=FIFE_URL&content_type=image%2Fpng&attachment_token=AOo0EEXHTwAnEUG8%2BIZSWkTDtOIXRo679WXuBqTu7nAgfxb0%2BitomWh2iBY3w2jWPeH%2BPV9WdBLpbzEKj1Cv86WRKIWPFQ13RxB4mcllPvVZ64GKmqOvk5bZ0p84gXyy0KmKzEi51sR%2BPGMwct8RggLhpO81gkLGAItCxxrb2BOCTLAOUekGjdkJgQ4B2Kt9wwITjzDAB8qdIDwzmL9RdvUGQdG6Y4QbZg6fBa8nxMAffApLMBRhbLXO9EGLwOQT%2B%2BxTKe1lz3khLV1Cg7J8IG7bMZJ0XShzZ0PkKyTe33qUtKIEdsHlzrH2O7%2FTG2Qyjb6bUCimqB93y4duQs365Pj%2B7%2Bqqp%2F%2F%2Fp0TOY%2Fn%2Fg4PPFGFDZ25MTD1a59GsRqyC1SY%2FOos2wPD7%2BbymMFKU%2FBgLx0VRMnIDXJbUc1esnNgmML4wcZ558LU8CNTqM5LXEhsL81Fpg607WQR50MNVAEVLO8BPSqZMgSKpw7ivaydSNHEvDmX4uYeQp7bMcVSpJykiGR5CDtDKqfhmzp2E7R%2Bjaa4WZmRnSoFfHDKVsbsFn6anemcQ2uQx2c80nqVM1tE%3D&sz=w1920-h987)
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.
...