Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Produto:TOTVS Backoffice
Linha de Produto:Linha Protheus 
Segmento:Backoffice 
Módulo:Gestão de Compras 
Função:MATA020 - Cadastro de Fornecedores 
País:Brasil
Ticket:Não há.
Requisito/Story/Issue (informe o requisito relacionado) :DMANMAT02-30222

02. SITUAÇÃO/REQUISITO

Nova funcionalidade que permita permite o preenchimento dos principais campos do cadastros cadastro de Fornecedores, utilizando a integração com 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 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 imagem ilustração abaixo: 

Image RemovedImage Added

*Clique na imagem para ampliar.


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

Campo:Descrição:
A2_NOMENome
A2_NREDUZNome Reduz
A2_ESTEstado
A2_CEPCEP
A2_BAIRROBairro
A2_MUNMunicípio
A2_ENDEndereço
A2_TIPOTipo
A2_CNAECNAE
A2_DDDDDD
A2_TELTelefone


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

Campo:Descrição:
A2_CODCódigo
A2_LOJALoja

04. COMO CONFIGURAR


  1. Informações:

    Informações

    Importante:

    • O passo a passo abaixo

...

    • deve ser realizado, caso o gatilho

...

    •  e o parâmetro não

...

    • 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.)



  1. Passo a Passo:

    Totvs custom tabs box
    tabsPasso 01, Passo 02

...

  1. idspasso1,passo2

...

  1. Totvs custom tabs box items
    defaultyes
    referenciapasso1

    Criação do Gatilho:

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

    1. Clicar na opção Gatilhos
    2. Clicar em Incluir;

...



    1. Image Modified
      *Clique na imagem para ampliar.

...

defaultno
referenciapasso2

    1. Preencher os campos abaixo conforme (Tabela 1);

      Image Added
      *Clique na imagem para ampliar.

      Tabela 1:


    1. Campo:

      Valor:

      Campo:

      A2_CGC

      Sequência:

      Utilizar a ultima sequência 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
    defaultno
    referencia

...

  1. passo2

    Criação do Parâmetro:

...



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

    1. Clicar em

...

    1. Parâmetros;
    2. Clicar em Incluir;

...



    1. Image Added
      *Clique na imagem para ampliar.


    2. 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çõesPreencher este campo, caso o controle dos parâmetros seja por

...

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

      Descrição

...

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

...

    1. Fornecedores, através da TOTVS API

...

    1. CAROL.

05. DEMAIS INFORMAÇÕES

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

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

Image Removed

Image Removed

...

*Clique na imagem para ampliar.

04. DEMAIS INFORMAÇÕES

Não há

05. ASSUNTOS RELACIONADOS

...


  • 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.


HTML
<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>