Árvore de páginas

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_BAIRROBairro
A2_CEPCEP
A2_CNAECNAE
A2_DDDDDD
A2_ENDEndereço
A2_ESTEstado
A2_MUNMunicípio
A2_NOMENome
A2_NREDUZNome Reduz
A2_TELTelefone
A2_TIPOTipo


Os campos abaixo, continuam com a necessidade do preenchimento manual:

Campo:

Descrição:

A2_CODCódigo
A2_LOJALoja

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

Pacote release 12.1.27 

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:

https://receita.economia.gov.br/orientacao/tributaria/cadastros/cadastro-nacional-de-pessoas-juridicas-cnpj/dados-publicos-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

  1. Acessar o Configurador / Dicionário / Base de Dados

    1. Clicar na opção Gatilhos
    2. 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.