Histórico da Página

...

Produto:

Solucoes_totvs

Solucoes_totvs_cross

SolucaoCross	TOTVS Backoffice

Solucoes_totvs_parceiros

SolucaoParceiros

Solucoes_totvs_parceirosexptotvs

SolucaoParcsExpsTOTVS

Linha de Produto:

Linhas_totvs

Linha	Linha Protheus

Segmento:

Segmentos_totvs

Segmento	Backoffice

Módulo:

SIGAFAT - Faturamento

Função:

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

País:

Todos os paísesBrasil

Ticket:

Requisito/Story/Issue:

DSERFAT-19186

...

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 ponto pontos de entrada para inclusão de novos campos para serem preenchidos.
Para ativar esta integração em seu ambiente, é necessário aplicar o Pacote de Dicionário (UPDDISTR) e Fontes da Expedição Contínua com a , 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 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:

Campo	Título
A1_NOME	Nome
A1_NREDUZ	N Fantasia
A1_PESSOA	Física/Juríd.
A1_END	Endereço
A1_MUN	Município
A1_BAIRRO	Bairro
A1_EST	Estado
A1_CEP	CEP
A1_DDD	DDD
A1_TEL	Telefone
A1_CNAE	Cód. CNAE

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

Campo	Descrição
A1_COD	Código
A1_LOJA	Loja

Totvs custom tabs box

tabs	Passo 01,Passo 02,Passo 03,Passo 04
ids	passo1,passo2,passo3,passo4

Totvs custom tabs box items

default	yes
referencia	passo1

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:

Mensagens de inconsistência da integração:
Ao digitar um CNPJ inválido ou não localizado:

Totvs custom tabs box items

default	no
referencia	passo2

Campo

Título

A1_NOME

Nome

A1_NREDUZ

N Fantasia

A1_PESSOA

Fisica/Jurid

A1_END

Endereco

A1_MUN

Municipio

A1_BAIRRO

Bairro

A1_EST

Estado

A1_CEP

CEP

A1_DDD

DDD

A1_TEL

Telefone

A1_CNAE

Cod CNAE

Campo:

Descrição:

A1_COD

Código

A1_LOJA

Loja

Totvs custom tabs box items

default	no
referencia	passo3

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..
Titulo	IMPORTANTE!

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ção

GETNEWPAR("MV_APICCGC", .F. )

Totvs custom tabs box items

default	no
referencia	passo4

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>

Árvore de páginas

Versões comparadas

Versão antiga 23

Nova versão Atual

Chave

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

04. DEMAIS INFORMAÇÕES