Árvore de páginas

Versões comparadas

Chave

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


01. DADOS GERAIS

Produto:

Solucoes_totvs

Solucoes_totvs_cross
SolucaoCrossTOTVS Backoffice

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVS

Linha de Produto:

Linhas_totvs
LinhaLinha Protheus

Segmento:

Segmentos_totvs
SegmentoBackoffice

Módulo:SIGAFAT - Faturamento
Função:
M030API - Integração com CAROL

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

País:
Todos os Países 
Brasil
Ticket:
Requisito/Story/Issue
(informe o requisito relacionado)
:DSERFAT-19186


02. SITUAÇÃO/REQUISITO

Visando facilitar o processo de cadastro de clientes, surgiu a necessidade de nascer uma integração com o CAROL automatizando o preenchimento dos campos básicos do cadastro de clientes.

...

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-fonteda 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
Totvs custom tabs box
tabsPasso 01,Passo 02, Passo 03, Passo 04
idspasso1,passo2
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 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.


Image Added   Image Added

Totvs custom tabs box items
defaultno
referenciapasso2

...


Card documentos
Informacao

...

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


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

Image Added Image Added Image Added


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:

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