Árvore de páginas

Versões comparadas

Chave

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

01. DADOS GERAIS

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

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: 

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 abaixoImage Removed, 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;

...

Incluir o gatilho da seguinte forma: 

...



    1. Image Modified

...

defaultno
referenciapasso2
    1. *Clique na imagem para ampliar.

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

...

    1. Incluir;

      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,

...

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

...


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

Image Removed

...

05DEMAIS INFORMAÇÕES

...

Card documentos
InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
TituloIMPORTANTE!

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

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

05. ASSUNTOS RELACIONADOS

...


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>