Histórico da Página

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Criar nova Nova funcionalidade que permita permite o preenchimento dos principais campos do cadastros cadastro de Fornecedores, utilizando a integração com a TOTVS API CAROL. 

03. SOLUÇÃO

Foi realizada a implementação para o preenchimento dos principais campos do cadastro de Fornecedores, utilizando a integração entre TOTVS API TOTVS CAROL e Protheus, para consultar e carregar preencher os dados do de Fornecedor após informar o número do CNPJ no campo CNPJ/CPF (A2_CGC). 

Será É necessário para utilização deste novo recurso a criação de um novo do parâmetro na (SX6 - Parâmetros) para que ira habilitar a consulta e o preenchimento dos dados do Fornecedor de acordo com o CNPJ informado, e de um novo gatilho (SX7 - Gatilhos), que será utilizado para carregar as informações para os campos, como .

Conforme está sendo demostrado na ilustração abaixo: 

Image Added

*Clique na imagem para ampliar.

Os campos que serão preenchidos automaticamente são: 

Os campos abaixo: Image Removed, continuam com a necessidade do preenchimento manual são:

04. COMO CONFIGURAR

1. Informações:
   
   

   Informações
   Importante: O passo a passo abaixo só

...

1. deve ser realizado, caso o gatilho

...

1. e o parâmetro não

...

1. existam em seu ambiente.  E para o cenário onde já existirem o gatilho e o parâmetro, é necessário somente ativar o parâmetro (MV_APIFOR=.T.).

   
   
   

2. Passo a Passo:
   
   

   Totvs custom tabs box
   tabs Passo 01, Passo 02

...

1. ids passo1,passo2

...

1. Totvs custom tabs box items default yes referencia passo1 Criação do Gatilho: Acessar o Configurador / Dicionário / Base de Dados. Clicar na opção Gatilhos;  Clicar em Incluir;

...

Incluir o gatilho da seguinte forma: 

...

1. Image Modified

...

1. *Clique na imagem para ampliar. Preencher os campos abaixo conforme (Tabela 1); Image Added *Clique na imagem para ampliar. Tabela 1: Campo: Valor: Campo:

1. A2_CGC

...

1. Sequência: Utilizar a ultima sequência

...

1. disponível. Cnt. Domínio: A2_TELEX Tipo: 1 - Primário Regra:

...

1. M020APICGC() Posiciona: 2 - Não

...

1. Clique no botão Salvar. Totvs custom tabs box items default no referencia

...

1. passo2 Criação do Parâmetro:

...

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

...

1. Parâmetros; Clicar em

...

1. Incluir; Image Added *Clique na imagem para ampliar. Preencher os campos abaixo conforme (Tabela 2); Informações: Descrição: Image Added *Clique na imagem para ampliar. Image Added *Clique na imagem para ampliar. Tabela 2: Campo: Aba: Valor: Filial: Informações Preencher este campo,

...

1. caso o controle dos parâmetros seja por

...

1. Filial  Nome var: Informações MV_APIFOR Tipo: Informações 3 - Lógico Conteúdo: Informações .T.

...

1. Descrição

...

1. : Cont. Descriç Cont. Descriç Descrição Habilita preenchimento automático dos campos básicos do cadastro de

...

1. Fornecedores, através da TOTVS API

...

1. CAROL.

Image Removed

...

05. DEMAIS INFORMAÇÕES

...

Não há

05. ASSUNTOS RELACIONADOS

...

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.

Quando os campos de Nome (A2_NOME) / Nome reduzido (A2_NREDUZ) / Bairro (A2_BAIRRO) / Município (A2_MUN) / Endereço (A2_END) não forem carregados ao informar o CNPJ, verifique no dicionário de dados o tamanho dos campos correspondentes e aumente caso haja necessidade.

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.

06. ASSUNTOS RELACIONADOS

• Para o correto funcionamento é necessário liberar o endereço - https://app.carol.ai/api - no firewall da rede.

07. 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: 

Image Added

*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: 

Image Added

*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: 

Image Added

*Clique na imagem para ampliar.

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>