Nova funcionalidade que permite o preenchimento dos principais campos do cadastro de Fornecedores, utilizando a integração com TOTVS API CAROL.
Para carregar os dados do Fornecedor automaticamente, basta informar o número do CNPJ no campo CNPJ/CPF (A2_CGC). Funcionalidade apenas disponível para CNPJ.
Para ativa-la, será necessário configurar o parâmetro MV_APIFOR = T.
Abaixo, segue uma demonstração desta nova funcionalidade.
*Clique na imagem para ampliar.
Os campos que serão preenchidos automaticamente são:
Campo: | Descrição: |
---|---|
Campo: | Descrição: |
A2_BAIRRO | Bairro |
A2_CEP | CEP |
A2_CNAE | CNAE |
A2_DDD | DDD |
A2_END | Endereço |
A2_EST | Estado |
A2_MUN | Município |
A2_NOME | Nome |
A2_NREDUZ | Nome Reduz |
A2_TEL | Telefone |
A2_TIPO | Tipo |
Os campos abaixo, continuam com a necessidade do preenchimento manual:
Campo: | Descrição: |
---|---|
A2_COD | Código |
A2_LOJA | Loja |
Informação
Esta funcionalidade somente estará disponível a partir do release 12.1.27, sendo que será disponibilizada no pacote de expedição contínua do módulo de Compras e com a aplicação do pacote/patch mencionado no link abaixo:
Pacotes de Atualização - Compras
Vale informar que não existe custo adicional para utilizar essa funcionalidade, pois a tecnologia da Carol foi embarcada no Protheus.
Sobre os Dados:
Os dados desta API são os mesmos encontrados no portal da Receita Federal > Dados Públicos CNPJ:
Eles são atualizados a cada 3 meses, ou seja, dados de respostas para CNPJs que foram cadastrados antes deste período podem não ser encontrados.
Guia passo a passo
Acessar o Configurador / Dicionário / Base de Dados
- Clicar na opção Gatilhos;
- Clicar em Incluir;
Incluir o gatilho da seguinte forma:
Campo: | Valor |
---|---|
Campo: | A2_CGC |
Sequência: | Utilizar a ultima sequência disponível |
Tipo: | Primário |
Regra: | M020APICGC() |
Posiciona: | Não |
2. Criação do Parâmetro:
a. Clicar em Parâmetro;
b. Clicar em Incluir;
Campo: | Valor: |
---|---|
Filial: | Preencher este campo caso o controle dos parâmetros seja por filial |
Nome var: | MV_APIFOR |
Conteúdo: | .T. |
Descrição do parâmetro: | Habilita preenchimento automático dos campos básicos do cadastro de fornecedores, através da API TOTVS CAROL. |
3. Para o correto funcionamento é necessário liberar o endereço - https://app.carol.ai/api - no firewall da rede.
Importante
Ao digitar um CNPJ que não exista na base de dados da TOTVS API CAROL, será apresentada uma mensagem, conforme a imagem abaixo:
*Clique na imagem para ampliar.
- Caso ocorra queda de conexão entre a TOTVS API CAROL e o Protheus, será apresentada a mensagem de erro abaixo:
*Clique na imagem para ampliar.
- Caso a função APIFORCLI responsável pela comunicação com a TOTVS API CAROL, não esteja compilada, será apresentada a mensagem abaixo:
*Clique na imagem para ampliar.