01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:SIGAFAT - Faturamento
Função:

FATAPICGC - Cadastro de Clientes x CAROL (Integração via API) 

País:Brasil
Ticket:
Requisito/Story/Issue:DSERFAT-19186


02. SITUAÇÃO/REQUISITO

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

03. SOLUÇÃO

Desenvolvida a API de integração do Cadastro de Clientes do Protheus® com a CAROL. Ela será executada ao se preencher o campo CPF/CNPJ (A1_CGC) no Cadastro de Clientes (via gatilho).
Esta nova integração com a CAROL está parametrizada para que realize somente a pesquisa de pessoas jurídicas, 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), neste caso somente do Release 12.1.27, nos demais terão de ser criados manualmente seguindo os dizeres abaixo, também deverá aplicar o pacote oficial dos programas-fonte da Expedição Contínua do módulo Faturamento (SIGAFAT), cuja data de corte dos mesmos é posterior à 07/02/2021 e, posteriormente, seguir o passo-a-passo 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

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

Na caixa de texto que é apresentada à esquerda da tela, digite MV_APICCGC 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 concluir o processo, e quando retornar ao browser inicial, clique na opção Sair.


   



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

  


Onde:

Campo

Conteúdo

Campo

A1_CGC

Sequência

Utilizar a última sequência disponível em seu ambiente
Cnt. DomínioA1_CGC
Tipo1 - Primário
RegraM030APICGC()
Posiciona2 - Não
CondiçãoGETNEWPAR("MV_APICCGC", .F. )

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

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

Sobre os Dados:



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