Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 25

changes.mady.by.user Usuário desconhecido (beraldo)

Gravado em

comparado com

Nova versão 26

changes.mady.by.user Alexandre da Costa

Gravado em

Chave

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

...

02. SITUAÇÃO/REQUISITO

Criar uma a integração API entre o Cadastro de Clientes e a CAROL, visando facilitar o processo do seu cadastramento dos Clientes no Protheus®, onde os . Os campos básicos/obrigatórios padrões do Cadastro de Clientes sejam  devem ser preenchidos automaticamente por meio de uma API.

03. SOLUÇÃO

Desenvolvida a API de integração entre o do Cadastro de Clientes do Protheus® e  com a CAROL que . Ela será executada ao se preencher o campo CPF/CNPJ (A1_CGC) do no Cadastro de Clientes (via gatilho).
A Esta nova integração com a CAROL está parametrizada para que realize somente para a pesquisa de pessoas jurídicas e  , e também não possui pontos de entrada.
Para ativar esta integração em seu ambiente, é necessário aplicar o Pacote de Dicionário (UPDDISTR) e Fonteso pacote oficial dos programas-fonteda Expedição Contínua com a  do módulo Faturamento (SIGAFAT), cuja data de corte dos pacotes mesmos é posterior à 07/02/2021 e  e, posteriormente, seguir o passo-a-passo da configuração abaixo.logo mais abaixo.

A execução da API terá o seguinte comportamento:

• Serão preenchidos automaticamente os seguintes campos:

CampoTítulo
A1_NOMENome
A1_NREDUZN Fantasia
A1_PESSOAFísica/Juríd.
A1_ENDEndereço
A1_MUNMunicípio
A1_BAIRROBairro
A1_ESTEstado
A1_CEPCEP
A1_DDDDDD
A1_TELTelefone
A1_CNAECód. CNAE


• Os campos abaixo continuam com a necessidade do seu preenchimento manual:


CampoDescrição
A1_CODCódigo
A1_LOJALoja
Totvs custom tabs box
tabsPasso 01,Passo 02,Passo 03
idspasso1,passo2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso1

Com a aplicação do pacote de dicionários descrito acima, serão criados os seguintes:

  • Parâmetro MV_APICCGC
  • Gatilho no campo A1_CGC no Dicionário de Dados de Gatilhos (SX7) que será o responsável por executar a integração API com a CAROL. Este gatilho, mesmo criado no ambiente, somente terá efeito se o novo parâmetro MV_APICCGC estiver configurado como ativo (.T.).


Para ativar o parâmetro MV_APICCGC, acesse Acesse o módulo Configurador do ambiente (SIGACFG).
 No menu lateral, acesse Ambiente → Cadastros → Parâmetros. Clique na opção "Parâmetros" na árvore lateral de opções e, no menu superior, clique em "Pesquisar":
Image Removed   

Na caixa de texto que é apresentada à esquerda da tela, digite "MV_APICCGC" e  e clique no botão "Buscar". Após encontrar o parâmetro "MV_APICCGC" , clique no botão "Editar".

 Alterar o conteúdo do parâmetro para verdadeiro (.T.) , conforme as imagens abaixo.  Clique em "Salvar" para  para concluir o processo, e quando retornar ao browser inicial, clique na na opção "Sair".


Image RemovedImage Added   Image Added

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

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

Totvs custom tabs box items
defaultno
referenciapasso2
CampoTítulo
A1_NOMENome
A1_NREDUZN Fantasia
A1_PESSOAFisica/Jurid
A1_ENDEndereco
A1_MUNMunicipio
A1_BAIRROBairro
A1_ESTEstado
A1_CEPCEP
A1_DDDDDD
A1_TELTelefone
A1_CNAECod CNAE
Campo:Descrição:
A1_CODCódigo
A1_LOJALoja
Totvs custom tabs box items
defaultno
referenciapasso3


Card documentos
InformacaoEste passo somente deve ser executado caso o gatilho e o parâmetro não existam em seu ambiente. Caso contrário, será necessário somente a ativação do parâmetro MV_APICCGC com o conteúdo igual a .T.. 
TituloIMPORTANTE!


Importante:

  • O passo a passo abaixo só 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_APICCGC=.T.). 

Criação do Gatilho:
Acesse o menu Base de Dados → Dicionário → Gatilhos:


    

Tabela 1


Onde:

Campo

:

Valor:
Conteúdo

Campo

:

A1_CGC

Sequência

:

Utilizar a
ultima
última sequência disponível
.
em seu ambiente
Cnt. Domínio
:
A1_CGC
Tipo
:
1 - Primário
Regra
:
M030APICGC()
Posiciona
:
2 - Não
Condicao
CondiçãoGETNEWPAR("MV_APICCGC", .F. )

04. DEMAIS INFORMAÇÕES

...

Consulte aqui a documentação do parâmetro MV_APICCGC.

Sobre os Dados:

  • Os dados desta API são os mesmos encontrados no portal da Receita Federal > Dados Públicos CNPJ

...

  • . Consulte aqui.
  • Eles são atualizados a cada

...

  • 03 (três) meses. Ou seja, a resposta para um CNPJ que fora cadastrado dentro de cada um destes intervalos de 03 (três) meses pode ser retornado com o status de "não encontrada".


Templatedocumentos


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>