Explicativo sobre as integrações de origem RM com destino Protheus Faturamento

Produto:

Protheus

Versões:

A partir da 12.1.33

Ocorrência:

Explicativo sobre todo o processo de integrações RM x Protheus

Ambiente:

Faturamento (SIGAFAT)

aÍndice


0. How To & WEBINAR - Vídeos explicativos (demonstrações)

Explicações de tudo que envolve a rotina/processos utilizando a didática ilustrativa por vídeos com áudio.

00:00 - Conceito

00:15 - Considerações


00:00 - Conceito

00:15 - Considerações




1. Conceito

A integração ocorre via XML ou JSON de outro sistema para o Protheus, por meio da identificação de Tags no envio. É possível utilizar o conceito de mensagem síncrona ou assíncrona (XX4_METODO).

O objetivo da rotina é que ao final da integração seja gerado um registro no Protheus á partir de outro sistema, com cada Tag da mensagem EAI alimentando seu respectivo campo nas tabelas e campos de destino no Protheus.



2. Considerações


2.1 Chave principal e chave secundária (Campos que não precisam de De/Para de Mensagem Unica)

Os campos identificadores (ID) da rotina a ser integrada não necessitam de De/Para de seu "InternalId" geral pois a integração é justamente a criação destes.

  • Todos os outros campos e Tags são considerados chaves secundárias, necessitam de De/Para.

Exemplo no CUSTOMERVENDOR:

Na integração de clientes (Tabela SA1), o código chave principal identificador é o A1_COD.

  • A integração do cliente é justamente a criação de um registro a partir do A1_COD, a Tag geral do XML <InternalId> não precisa ser configurada o De/Para, a integração é justamente sua criação, outros campos secundários como por exemplo o campo (A1_TABELA) necessitam obrigatoriamente.



Exemplo no ORDER:

Na integração de pedidos de venda (Tabela SC5/SC6), o código chave principal identificador é o C5_NUM.

  • A integração do pedido de venda é justamente a criação de um registro a partir do C5_NUM, a Tag geral do XML <InternalId> não precisa ser configurada seu De/Para, a integração é justamente sua criação, outros campos secundários como por exemplo o campo (C6_PRUDUTO e C5_CONDPAG) necessitam obrigatoriamente.


É possível realizar o De/Para dessas Tags "Internas", mas os campos chave são os únicos em que isso não é obrigatório.


2.2 Obrigatoriedade de campos

Um campo ser obrigatório na tabela do Protheus significa que a Tag contendo o valor pra esse campo na integração também é obrigatório.

Explicação: Sucesso na integração pois o campo regrado reconheceu algum valor e o campo é obrigatório na tabela, ou seja, tem de ser colocado algum valor válido.



Explicação: Falha na integração pois o campo regrado não reconheceu algum valor (em branco/vazio) e o campo é obrigatório na tabela, ou seja, tem de ser colocado algum valor válido.



Explicação: Sucesso na integração pois o campo reconheceu algum valor válido,  o campo é obrigatório na tabela, ou seja, teve de ser colocado algum valor válido.



Explicação: Sucesso na integração pois o campo regrado reconheceu algum valor (em branco/vazio) e o campo não é obrigatório na tabela, ou seja, tanto faz o valor na Tag do XML.




2.3 MATA030 ou CRMA980 na integração de Clientes

Fonte integrador: MATI030
Fonte integrado: MATA030/CRMA980

Tanto a rotina MATA030 quanto a CRMA980 utilizam-se do mesmo fonte de integração, o MATI030, isso faz com que possa-se usar no Adapter a Rotina CRMA980 ou MATA030 independente do parâmetro MV_MVCSA1.


2.4 Tipos de campos nas rotinas que recebem dados das Tags

Em uma integração, há 4 tipos de campos:

(1) [LIVRE] - O campo que é totalmente livre

Campo A1_NOME (Campo FreeValue)


É um campo que não possui tabela vinculada, então aceita qualquer valor.



1 - Inserindo Tag contendo carácteres especiais:

Explicação do Resultado: Inserido com sucesso, pois no campo não há validação de exclusividade para valores com carácteres especiais.

2 - Inserindo Tag contendo carácteres alfanuméricos:

Explicação do Resultado: Inserido com sucesso, pois no campo não há validação de exclusividade para valor alfanumérico.

3 - Inserindo Tag contendo carácteres numéricos:

Explicação do Resultado: Inserido com sucesso, pois no campo não há validação de exclusividade para valor numérico.

4 - Inserindo Tag não contendo nexo com validação:

Explicação do Resultado: Inserido com sucesso, pois no campo não há alguma validação.





(2) [DEPENDENTE] - O campo que depende de algumas validações internas ou outros campos

Campo A1_CGC (Campo Dependente)


É um campo que não possui tabela vinculada, então aceita qualquer valor, desde que:

  • Seja um CPF real de acordo com a validação do campo
  • Respeite o tipo do campo, não tendo letras pois este campo é numérico e ao inserir letras o sistema gerará erro.



1 - Inserindo Tag contendo carácteres especiais:

Explicação do Resultado: Não inserido pois no campo há validação de exclusividade para valores numéricos somente.

2 - Inserindo Tag contendo carácteres alfanuméricos:

Explicação do Resultado: Não inserido pois no campo há validação de exclusividade para valores numéricos somente.

3 - Inserindo Tag contendo carácteres numéricos:

Explicação do Resultado: Não inserido, pois apesar de o campo receber pela Tag o tipo de valor correto (numérico), não foi validado por não ter uma síntaxe de CNPJ/CPF correta.

4 - Inserindo Tag não contendo nexo com validação:

Explicação do Resultado: Não inserido, pois apesar de o campo receber pela Tag o tipo de valor correto (numérico), não foi validado por não ter uma síntaxe de CNPJ/CPF correta.

5 - Inserindo Tag contendo nexo com validação:

Explicação do Resultado: Inserido com sucesso, pois no campo foi incluído o tipo numérico (Esperado) e ainda é válido o dado colocado (Existe/síntaxe correta).

6 - Inserindo Tag respeitando a validação da obrigatoriedade:

Explicação do Resultado: Inserido com sucesso, pois no campo não há obrigatoriedade de informação de valor.




(3) [REGRADO SIMPLES] - O campo que recebe obrigatoriamente uma informação fixa sem De/Para 

Campo A1_PESSOA (Campo ListBox)



É um campo que não possui tabela vinculada, mas possui opções de escolhas fixa, então aceita valores desde que alguma condição abaixo seja atendida:

  • Não tenha a Tag desse campo no XML
  • A Tag venha em branco no XML
  • Caso possua a Tag preenchida, que o valor da Tag no XML tenha no fonte um valor que o sistema entenda que é respectivo de alguma opção da lista existente dentre as opções do campo (F / J)
  • Respeite o tipo do campo, sendo uma opção pronta, ao existir números ou letras na Tag que levará informação ao campo não existentes ocasionará erros.


1 - Inserindo Tag contendo carácteres especiais:

Explicação do Resultado: Não inserido, pois no campo há validação para não receber números ou caractéres especiais.

2 - Inserindo Tag contendo carácteres alfanuméricos:

Explicação do Resultado: Não inserido, pois apesar de o conteúdo da Tag ser o tipo esperado (alfanumérico) no campo há validação para receber apenas valores alfanuméricos específicos, para que o sistema entenda que significa uma opção dentre as listas do campo (F - Física  |  J - Jurídica)

3 - Inserindo Tag contendo carácteres numéricos:

Explicação do Resultado: Não inserido, pois no campo há validação para não receber números.

4 - Inserindo Tag não contendo nexo com validação:

Explicação do Resultado: Não inserido, no campo há validação para receber apenas valores alfanuméricos específicos, para que o sistema entenda que significa uma opção dentre as listas do campo (F - Física  |  J - Jurídica).

5 - Inserindo Tag contendo nexo com validação:

Explicação do Resultado: Inserido com sucesso, pois o campo recebeu um valor dentro da Tag que significa alguma opção existente dentro do campo-lista:

  • <EntityType>Company</EntityType>  =  'J - Jurídica' (O fonte entende que o conjunto de valor 'Company' significa a opção "J - Jurídica" no campo A1_PESSOA)
  • <EntityType>Person</EntityType>  =  'F - Física' (O fonte entende que o conjunto de valor exato 'Person' significa a opção "F - Física" no campo A1_PESSOA)






(4) [REGRADO] - O campo que tem uma tabela vínculada (ALIAS), que pode ter seu De/Para cadastrado ou não, mas toda informação colocada será validada se existe ou não seu registro.

Campo A1_TABELA e Campo A1_CONDPAG (Campo ALIAS [X3_F3 preenchido])


             

São campos que possuem tabela vinculada, então qualquer valor colocado será validado no sistema se existe esse registro na tabela (ALIAS) desses campos, só aceitam o valor colocado se:

    • Existir a informação colocada registrada na tabela validadora do campo. (X3_F3)


1 - Inserindo Tag contendo carácteres especiais:

Explicação do Resultado: Não inserido, pois não há na tabela validadora vínculada ao campo (X3_F3) esse registro/conteúdo no índex do Alias (campo de ID Código da tabela vínculada)

2 - Inserindo Tag contendo carácteres alfanuméricos:

Explicação do Resultado: Não inserido, pois não há na tabela validadora vínculada ao campo (X3_F3) esse registro/conteúdo no índex do Alias (campo de ID Código da tabela vínculada)

3 - Inserindo Tag contendo carácteres numéricos:

Explicação do Resultado: Inserido, pois há na tabela validadora vínculada ao campo (X3_F3) esse registro/conteúdo no índex do Alias (campo de ID Código da tabela vínculada)

4 - Inserindo Tag não contendo nexo com validação:

Explicação do Resultado: Não inserido, pois não há na tabela validadora vínculada ao campo (X3_F3) esse registro/conteúdo no índex do Alias (campo de ID Código da tabela vínculada)

5 - Inserindo Tag contendo nexo com validação:


Explicação do Resultado: Inserido, pois há na tabela validadora vínculada ao campo (X3_F3) esse registro/conteúdo no índex do Alias (campo de ID Código da tabela vínculada)

5 - Inserindo Tag contendo valor que está inativo na tabela atrelado ao campo:

Explicação do Resultado: Não inserido, pois na tabela validadora vínculada ao campo (X3_F3) esse registro/conteúdo no índex do Alias (campo de ID Código da tabela vínculada) está desativado/inativo.





2.5 De/Para nas integrações de origem RM

Quando alguma tag no XML à ser integrado conter o nome "Id", significa que é um campo interno e que exigirá o De/Para pois seu valor será inserido em um campo no Protheus com validação de tabela (ALIAS). Esses campos que possuem tabela vínculada só podem ter valores que existam em sua própria tabela,  ao inserir dados no campo o Protheus automaticamente valida se aquele registro existe na tabela, não pertencendo gerará o HELP REGNOIS.

I. Tag <ItemCode> ao integrar pedido de vendas.

  • 1 - O campo que receberá essa tag (C6_PRODUTO) é um campo que possui tabela vínculada, a tabela "SB1 - Produtos". Quaisquer valores colocados nesse campo, serão validados pelo sistema se lógicamente existem na tabela de produtos SB1.
  • 2 - Por essa Tag de inserção de produto no pedido de vendas, não ter no nome "Id", significa que o dado contido na Tag será injetado diretamente no campo do Protheus, sem De/Para para transcrever o valor do RM em um código existente no Protheus.
  • 3 - Por esse motivo, ao integrar com essa Tag é obrigatório que o Protheus tenha um produto com o mesmo valor da Tag para aceitar a inserção, caso contrário gerará o HELP REGNOIS.


Tag origem : <ItemCode>

Valor inserido na Tag: ABC

Campo destino: C6_PRODUTO

Alias do campo destino: Tabela SB1 (Produtos [B1_COD])

Método: Sem De/Para (Pois não contém "Id" no nome como por exemplo, "ItemInternalId")



Explicação Passo 1:

É a Tag do XML da integração de um pedido de venda, na qual tem o valor "43". Como não é uma Tag interna com "Id", não possuirá De/Para, simbolizando que o Produto 43 no RM terá de encontrar no Protheus um produto com o mesmo código 43.


Explicação Passo 2:

A Tag <ItemCode> tem como destino o campo C6_PRODUTO no Protheus (Fonte MATI410), é como uma inserção manual na tela do pedido de vendas, ele colocará o valor informado na Tag, que no exemplo é 43 e "dará Enter", e ocorrerá a validação se o conteúdo colocado existe na própria tabela do campo, que é a tabela de produtos (SB1).


Explicação Passo 3:

Após isso o registro não será incluido com sucesso, pois de acordo com o print acima, na tabela SB1 do ambiente Protheus, não há o produto com o código ABC (B1_COD = ABC) que foi informado na Tag <ItemCode> do XML.



Tag origem: <ItemCode>

Valor inserido na Tag: 43

Campo destino: C6_PRODUTO

Alias do campo destino: Tabela SB1 (Produtos [B1_COD])

Método: Sem De/Para (Pois não contém "Id" no nome como por exemplo, "ItemInternalId")



Explicação Passo 1:

É a Tag do XML da integração de um pedido de venda, na qual tem o valor "43". Como não é uma Tag interna com "Id", não possuirá De/Para, simbolizando que o Produto 43 no RM terá de encontrar no Protheus um produto com o mesmo código 43.


Explicação Passo 2:

A Tag <ItemCode> tem como destino o campo C6_PRODUTO no Protheus (Fonte MATI410), é como uma inserção manual na tela do pedido de vendas, ele colocará o valor informado na Tag, que no exemplo é 43 e "dará Enter", e ocorrerá a validação se o conteúdo colocado existe na própria tabela do campo, que é a tabela de produtos (SB1).


Explicação Passo 3:

Após isso o registro será incluido com sucesso, pois de acordo com o print acima, na tabela SB1 do ambiente Protheus, há o produto com o código 43 (B1_COD = 43) que foi informado na Tag <ItemCode> do XML.





II. Tag <ItemInternalId> ao integrar pedido de vendas.

  • 1 - O campo que receberá essa tag (C6_PRODUTO) é um campo que possui tabela vínculada, a tabela "SB1 - Produtos". Quaisquer valores colocados nesse campo, serão validados pelo sistema se lógicamente existem na tabela de produtos SB1.
  • 2 - Por essa Tag de inserção de produto no pedido de vendas, conter no nome "Id", significa que o produto do RM contido na Tag será transcrito em um produto diferente no Protheus pelo De/Para de Mensagem Única (xxxxxxx) para transcrever o valor do RM em um código existente no Protheus, visto que o mesmo produto pode ter códigos diferentes nos sistemas.
  • 3 - Por esse motivo, ao integrar com essa Tag é obrigatório que o Protheus tenha um De/Para para realizar a conversão com o mesmo valor da Tag para aceitar a inserção, caso contrário exigirá na integração.
  • 4 - 


OBS: Caso o valor colocado no De/Para "XXF_INTVAL" também não exista no Protheus, a transcrição não será efetiva e apresentará o HELP REGNOIS



Ao cadastrar um De/Para para determinada tabela, é obrigatório cadastrar seu Adapter relativo.

  • Exemplo: Ao incluir um De/Para transcrever uma condição de pagamento do RM, é necessário cadastrar um ADAPTER da rotina de condição de pagamento.


  • Caso não use o De/Para e o campo de destino desta Tag seja um campo com tabela vínculada, o conteúdo da Tag do XML de ORIGEM deve ser idêntico ao registro à ser inserido no Protheus, para que no Protheus tenha o mesmo código do conteúdo do XML de origem e receba o registro.





3. Integrações das rotinas

Como integrar no faturamento as tabelas compatíveis RM x Protheus:

Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


A integração de clientes não movimenta a tabela AI0 - Complemento de Clientes.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[CAMPO LIVRE] - A1_COD (Campo mestre da integração)

  • <InternalId></InternalId> e  <Code></Code>



[CAMPO LIVRE] - A1_LOJA

  • <InternalId></InternalId>  e  <Store></Store>

[CAMPO LIVRE] - A1_NOME 

  • <Name></Name>


[CAMPO LIVRE] - A1_END 

  • <Address></Address> e <Number></Number>

[CAMPO LIVRE] - A1_NREDUZ 

  • <ShortName></ShortName>


[CAMPO LIVRE] - A1_MUN

  • <CityDescription></CityDescription>


[CAMPO REGRADO SIMPLES] - A1_TIPO

  • <EntityType></EntityType>


[CAMPO REGRADO] - A1_EST

  • <State>
                  <StateCode></StateCode>
                  <StateDescription></StateDescription>
    </State>


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" de Tag "<CityCode></CityCode>", automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



<TOTVSMessage>
     <MessageInformation version="2.002">
     <UUID>V1n1c105-2003-1234-5678-90abcdefghij</UUID>
     <Type>BusinessMessage</Type>
     <Transaction>CUSTOMERVENDOR</Transaction>
     <StandardVersion>1.000</StandardVersion>
     <SourceApplication>RM</SourceApplication>
     <CompanyId>2</CompanyId>
     <BranchId>1</BranchId>
     <Product name="RM" version="12.1.29.0" />
     <GeneratedOn>2022-11-19T12:34:56</GeneratedOn>
     <DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
     <BusinessEvent>
          <Entity>CUSTOMERVENDOR</Entity>
          <Event>Upsert</Event>
     </BusinessEvent>
     <BusinessContent>
               <RMENTITYNAME>FCFO</RMENTITYNAME>
               <CompanyId>2</CompanyId>
               <Code>000001</Code>
               <StoreId>09</StoreId>
               <InternalId>2|09;C000001</InternalId>
               <ShortName>CLITESTE</ShortName>
               <Name>CLIENTE TESTE</Name>
               <Type>Customer</Type>
               <EntityType>Person</EntityType>
               <RegisterDate>2022-11-19</RegisterDate>
               <RegisterSituation>Active</RegisterSituation>
              <Address>
                  <Address>RUA TESTE</Address>
                  <Number>544</Number>
                  <Complement></Complement>
                  <District>CENTRO</District>
                   <City>
                         <CityDescription>Belo Horizonte MUN</CityDescription>
                    </City>
                   <State>
                         <StateCode>MG</StateCode>
                         <StateDescription>Minas Gerais</StateDescription>
                    </State>
               </Address>
          </BusinessContent>
     </BusinessMessage>
</TOTVSMessage>


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '1 - Sim'/'2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]




XXD_REFER = RM

XXD_COMPA = 2

XXD_BRANCH = 1

XXD_EMPPRO = 99

XXD_FILPRO = 01




O XML de exemplo padrão da rotina cadastro de clientes não contém De/Para pois não contém Tags "InternalId" que não sejam a principal da integração, que por sua vez não necessita de De/Para pois é a chave principal ("<InternalId>").


Retorno do XML Exemplo:


XX3_FILIAL = 01

XX3_CODIGO = 0000000000000000000000140

XX3_UUID = V1n1c105-2003-1234-5678-90abcdefghij

XX3_FUNCOD = CUSTOMERVENDOR

XX3_FUNDES = TOTVSMessage CUSTOMERVENDOR Business Message         

XX3_TRDATA = 19/11/2022      

XX3_TRHORA = 09:34:56

XX3_PRDATA = 02:59:03

XX3_TENTAT = 1

XX3_TRANS (Memo) =

XX3_TPDOC = 1

XX3_TPTRAN = 0

XX3_STATUS = 2

XX3_TMDATA = 19/11/2022

XX3_TMHORA = 02:59:01

XX3_MSGTYP = 20

XX3_CHANEL = 1

XX3_RETURN (Memo) =

XX3_PRODUC = RM

XX3_SOURCE = RM

XX3_VERSAO = 2.002

XX3_EVENT = upsert


Restante dos campos da XX3: Vazios.






Campo(s) destinoValor atribuído pós integração do XML de exemploTag(s) no XML que atribuiu(ram) a informação
A1_FILIAL01<BranchId>1</BranchId> (De/Para de Empresa/Filial envolvido)
A1_COD000001<Code>000001</Code> e <InternalId>2|09;C000001</InternalId>
A1_LOJA09<StoreId>09</StoreId> e <InternalId>2|09;C000001</InternalId>
A1_NOME'CLIENTE TESTE'<Name>CLIENTE TESTE</Name>
A1_PESSOA'F - Fisica'<EntityType>Person</EntityType>
A1_END'RUA TESTE, 544'<Address>RUA TESTE</Address> e <Number>544</Number>
A1_NREDUZ'CLITESTE'<ShortName>CLITESTE</ShortName>
A1_TIPO'F - Cons.Final'<EntityType>Person</EntityType> (por padrão a integração demarca com o tipo 'F - Cons.Final')
A1_ESTMG<StateCode>MG</StateCode>
A1_MUN'BELO HORIZONTE MUN'CityDescription>Belo Horizonte MUN</CityDescription>
A1_MSBLQL'2 - Ativo'<RegisterSituation>Active</RegisterSituation>
A1_MOEDALC/A1_USADDA/A1_REGESIM/A1_TPDP

Esses campos são preenchidos em uma integração porém não tem relação com a mesma.

É padrão do Protheus ao incluir qualquer cliente [Iniciador padrão do campo])

-

   

Campo Tag que levá seu valor/conteúdo ao respectivo campoValores possíveisOnde geralmente está localizada no XMLNecessita de De/Para de Mensagem Única?
A1_COD<Code></Code> e <InternalId></InternalId>

Conteúdo alfanumérico

<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

É a chave primária da integração

A1_LOJA<Store></Store> e <InternalId></InternalId>

Conteúdo alfanumérico


<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

Contém em sua composição a chave primária da integração

A1_NOME<Name></Name>Conteúdo alfanumérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_PESSOA<EntityType>Person</EntityType> ou <EntityType>Company</EntityType>

'F - Fisica' (<EntityType>Person</EntityType>)

'J - Jurídica' (<EntityType>Company</EntityType>)

<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

É um campo regrado simples (Não contém "InternalId" no nome)

A1_END<Address></Address> e <Number></Number>Conteúdo alfanumérico

<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>   
                <Address>   

Não

É um campo livre (Não contém "InternalId" no nome)

A1_NREDUZ<ShortName></ShortName>Conteúdo alfanumérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_TIPO

<EntityType></EntityType>

'F - Cons.Final' (<EntityType>Person</EntityType>)

'R - Revendedor' (<EntityType>Company</EntityType>)

<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

É um campo regrado simples (Não contém "InternalId" no nome)

A1_EST<StateCode></StateCode>Registro válido na tabela do campo A1_EST (ALIAS).<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>
                     <State>
                        

Não

Campo regrado porém essa Tag está passandoo valor direto,

sem necessidade de De/Para.

A1_MUN<CityDescription></CityDescription>Conteúdo alfanumérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>
                     <City>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_MSBLQL<RegisterSituation></RegisterSituation>

'1 - Inativo' (<RegisterSituation>Inactive</RegisterSituation>)

'2 - Ativo' (<RegisterSituation>Active</RegisterSituation>)

<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

É um campo regrado simples (Não contém "InternalId" no nome)

A_DTNASC<RegisterDate></RegisterDate>Conteúdo data<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Não

Campo dependente, sem necessidade de De/Para.

A1_COMPLEM<Complement></Complement>Conteúdo alfanumérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>
                     

Não

É um campo livre (Não contém "InternalId" no nome)

A1_BAIRRO<District></District>Conteúdo alfanumérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_PAIS<CountryCode></CountryCode>Registro válido na tabela do campo A1_PAIS (ALIAS).<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Country>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_COD_MUN<CityCode></CityCode>Registro válido na tabela do campo A1_COD_MUN (ALIAS).<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_REGIAO<RegionCode></RegionCode>Registro válido na tabela do campo A1_REGIAO (ALIAS).

<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>
                    <Region>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_CEP<ZIPCode></ZIPCode>Conteúdo numérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>

Não

Campo dependente, sem necessidade de De/Para.

A1_SATIV1

(...) Até (...)

A1_SATIV8

<InternalId Name="Segment1" CodeErp="" Description=""></InternalId>)

(...) Até (...)

<InternalId Name="Segment8" CodeErp="" Description=""></InternalId>)

Registro válido na tabela dos campos A1_SATIV1 até A1_SATIV8 (ALIAS).<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Segment>

Sim

Campo regrado (Não contém "InternalId" no nome)

Há a necessidade de De/Para.

A1_TPFRET<FreightTypeCode></FreightTypeCode>

'C=CIF' (<FreightTypeCode>C</FreightTypeCode>)


'F=FOB' (<FreightTypeCode>F</FreightTypeCode>)


'T=Por conta terceiros' (<FreightTypeCode>T</FreightTypeCode>)


'R=Por conta remetente' (<FreightTypeCode>R</FreightTypeCode>)


'D=Por conta destinatário' (<FreightTypeCode>D</FreightTypeCode>)


'S=Sem frete' (<FreightTypeCode>S</FreightTypeCode>)

<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <Address>

Não

Campo dependente, sem necessidade de De/Para.

A1_TRANSP<CarrierInternalId></CarrierInternalId> ou <CodeERP></CodeERP>Registro válido na tabela do campo A1_TRANSP (ALIAS).<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>

Sim

Campo regrado (Não contém "InternalId" no nome)

Há a necessidade de De/Para.

A1_VENCLC<MaturityCreditLimit></MaturityCreditLimit>Conteúdo numérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <CreditInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_INSCR<Id scope="State" name="INSCRICAO ESTADUAL" issueOn="" expiresOn=""></Id>Conteúdo numérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <GovernmentalInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_INSCRM<Id scope="Municipal" name="INSCRICAO MUNICIPAL" issueOn="" expiresOn=""></Id>Conteúdo numérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <GovernmentalInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_SUFRAMA<Id scope="Federal" name="SUFRAMA" issueOn="" expiresOn=""></Id>Conteúdo numérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <GovernmentalInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_CGC

<Id scope="Federal" name="CPF" issueOn="" expiresOn=""></Id>

<Id scope="Federal" name="CNPJ" issueOn="" expiresOn=""></Id>

Conteúdo numérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <GovernmentalInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_INSCRUR<Id scope="State" name="INSCRICAO RURAL" issueOn="" expiresOn=""></Id>Conteúdo numérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <GovernmentalInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_PFISICA<Id scope="Federal" name="RG" issueOn="" expiresOn=""></Id>Conteúdo alfanumérico<TOTVSMessage>
     <BusinessMessage>
           <BusinessContent>
               <GovernmentalInformation>

Não

Campo dependente, sem necessidade de De/Para.

OBS: Só grava se (A1_PFISICA estiver vazio) e (A1_PESSOA = F) ou (A1_EST = EX).

A1_CXPOSTA<POBox></POBox>Conteúdo alfanumérico

<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfCommunicationInformation
           <CommunicationInformation>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_EMAIL<Email></Email>Conteúdo alfanumérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfCommunicationInformation
           <CommunicationInformation>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_TEL<PhoneNumber></PhoneNumber>Conteúdo numérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfCommunicationInformation
           <CommunicationInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_DDD<DiallingCode></DiallingCode>Conteúdo numérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfCommunicationInformation
           <CommunicationInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_DDI<InternationalDiallingCode></InternationalDiallingCode>Registro válido na tabela do campo A1_DDI (ALIAS).<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfCommunicationInformation
           <CommunicationInformation>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_FAX<FaxNumber></FaxNumber>Conteúdo numérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfCommunicationInformation
           <CommunicationInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_ENDCOB<Address></Address>Conteúdo alfanumérico

<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <BillingInformation>
           <Address>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_HPAGE<HomePage></HomePage>Conteúdo alfanumérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfCommunicationInformation
           <CommunicationInformation>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_ENDENT<Address>, <Number> e <Complement>Conteúdo alfanumérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ShippingAddress>

Não

São campos livres (Não contém "InternalId" no nome)

A1_CONTATO

<Name></Name>

ou

<ContactInformationName></ContactInformationName>

Conteúdo alfanumérico

<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ListOfContacts>
          <Contact>

Não

São campos livres (Não contém "InternalId" no nome)

A1_BAIRROC<District></District>Conteúdo alfanumérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <BillingInformation>
           <Address>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_CEPC<ZIPCode></ZIPCode>Conteúdo numérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <BillingInformation>
           <Address>

Não

Campo dependente, sem necessidade de De/Para.

A1_MUNC<CityDescription></CityDescription>Conteúdo alfanumérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <BillingInformation>
           <Address>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_ESTC<StateCode></StateCode>Registro válido na tabela do campo A1_ESTC (ALIAS).<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <BillingInformation>
           <Address>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_CEPE<ZIPCode></ZIPCode>Conteúdo numérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ShippingAddress>
           <Address>

Não

Campo dependente, sem necessidade de De/Para.

A1_BAIRROE<District></District>Conteúdo alfanumérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ShippingAddress>
           <Address>

Não

É um campo livre (Não contém "InternalId" no nome)

A1_ESTE<StateCode></StateCode>Registro válido na tabela do campo A1_ESTE (ALIAS).<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ShippingAddress>
           <Address>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_COMPENT<Complement></Complement>Conteúdo alfanumérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <ShippingAddress>
         

Não

É um campo livre (Não contém "InternalId" no nome)

A1_VEND<Code></Code>Registro válido na tabela do campo A1_VEND (ALIAS).<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <VendorInformation>
          <VendorType>
         

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_LC<CreditLimit></CreditLimit>Conteúdo numérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>
        <CreditInformation>

Não

Campo dependente, sem necessidade de De/Para.

A1_CONTRIB<Taxpayer></Taxpayer>

'1 - Não'

'2 - Não'

<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>

Não

É um campo regrado simples (Não contém "InternalId" no nome)

A1_SALPED<BalanceOfCredit></BalanceOfCredit>Conteúdo numérico<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>

Não

Campo dependente, sem necessidade de De/Para.

A1_CONDPAG<PaymentConditionCode></PaymentConditionCode>Registro válido na tabela do campo A1_CONDPAG (ALIAS).<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

A1_TABELA<PriceListHeaderItemCode></PriceListHeaderItemCode>Registro válido na tabela do campo A1_TABELA (ALIAS).<TOTVSMessage>
   <BusinessMessage>
     <BusinessContent>

Não

Campo regrado porém essa Tag está passando valor direto,

sem necessidade de De/Para.

  • MATA030 ou CRMA980: Fontes destino
  • MATI030: Fonte integrador




Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[*] - A1_COD (Campo mestre da integração)


[*] - A1_LOJA

[*] - A1_NOME 

[*] - A1_END 

[*] - A1_NREDUZ 

[***] - A1_TIPO

[****] - A1_EST

[*] - A1_MUN


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



< imagine a xml message here >


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]





Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


<>


<>


  • MATA030 ou CRMA980: Fontes destino
  • MATI030: Fonte integrador (De ambos acima)




Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[*] - A1_COD (Campo mestre da integração)


[*] - A1_LOJA

[*] - A1_NOME 

[*] - A1_END 

[*] - A1_NREDUZ 

[***] - A1_TIPO

[****] - A1_EST

[*] - A1_MUN


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



< imagine a xml message here >


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]





Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


<>


<>


  • MATA360: Fonte destino
  • MATI360: Fonte integrador



Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[*] - A1_COD (Campo mestre da integração)


[*] - A1_LOJA

[*] - A1_NOME 

[*] - A1_END 

[*] - A1_NREDUZ 

[***] - A1_TIPO

[****] - A1_EST

[*] - A1_MUN


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



< imagine a xml message here >


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]





Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


<>


<>


  • MATA030 ou CRMA980: Fontes destino
  • MATI030: Fonte integrador (De ambos acima)




Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[*] - A1_COD (Campo mestre da integração)


[*] - A1_LOJA

[*] - A1_NOME 

[*] - A1_END 

[*] - A1_NREDUZ 

[***] - A1_TIPO

[****] - A1_EST

[*] - A1_MUN


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



< imagine a xml message here >


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]





Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


<>


<>


  • MATA030 ou CRMA980: Fontes destino
  • MATI030: Fonte integrador (De ambos acima)




Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[CAMPO LIVRE] - A1_COD (Campo mestre da integração)


[CAMPO LIVRE] - A1_LOJA

[CAMPO LIVRE] - A1_NOME 

[CAMPO LIVRE] - A1_END 

[CAMPO LIVRE] - A1_NREDUZ 

[CAMPO DEPENDENTE] - A1_TIPO

[CAMPO REGRADO] - A1_EST

[CAMPO DEPENDENTE] - A1_MUN


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



< imagine a xml message here >


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]





Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


<>


<>


  • MATA030 ou CRMA980: Fontes destino
  • MATI030: Fonte integrador (De ambos acima)




Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[*] - A1_COD (Campo mestre da integração)


[*] - A1_LOJA

[*] - A1_NOME 

[*] - A1_END 

[*] - A1_NREDUZ 

[***] - A1_TIPO

[****] - A1_EST

[*] - A1_MUN


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



< imagine a xml message here >


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]





Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


<>


<>


  • MATA030 ou CRMA980: Fontes destino
  • MATI030: Fonte integrador (De ambos acima)




Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


KCS:


Os campos obrigatórios na tabela de clientes (SA1) serão exigidos também na integração. 


Por padrão os campos obrigatórios (Que por esse motivo devem ter suas tags no XML e que usaremos como base para exemplo):

[*] - A1_COD (Campo mestre da integração)


[*] - A1_LOJA

[*] - A1_NOME 

[*] - A1_END 

[*] - A1_NREDUZ 

[***] - A1_TIPO

[****] - A1_EST

[*] - A1_MUN


OBS 1: Se for colocado o "Cd. Município (A1_COD_MUN)" automaticamente gatilhará o campo "Município* (A1_MUN)" com o nome do município correspondente.

OBS 2: Não é obrigatório a colocação da "Natureza (A1_NATUREZ)" mas é recomendado dependendo da parametrização do MV_1DUPNAT.



< imagine a xml message here >


Tabela: XX4

Rotina: (CFGA020 - Adapter E.A.I.)


XX4_FILEXE = Filial recebedora do Protheus

XX4_UNMESS = '1 - Sim'

XX4_ROTINA = 'CRMA980'/'MATA030'

XX4_MODEL = 'CUSTOMERVENDOR'

XX4_DESCRI = Usuário escolhe

XX4_SENDER = '2 - Não'

XX4_RECEIV = '1 - Sim'

XX4_METODO = '2 - Assíncrono'

XX4_TPOPER = '1 - Todas'

XX4_CHANEL = 3

XX4_SNDVER = ('2.005+') [Mais atualizada gatilhada automaticamente]

XX4_FORMAT = 'XML'

XX4_SAVLOG = '1 - Sim'

XX4_ROUTE: Definida preenchida ou não na implantação da integração


Restante dos campos da XX4: Vazios (não obrigatórios)






Tabela: XXD

Rotina: (APCFG050 - De/para Empresas Mensagem Unica)



XXD_REFER = Conteúdo da Tag do XML <ProductName> (RM)

XXD_COMPA = Conteúdo da Tag do XML <CompanyId>

XXD_BRANCH = Conteúdo da Tag do XML <BranchId> [Se estiver vazia no XML, o campo fica vazio.]

XXD_EMPPRO = Empresa do Protheus recebedora

XXD_FILPRO = Filial no Protheus recebedor [Dentro da empresa]





Nesse carrossel de opções (0/1/2/3/4/5), há todo o conteúdo necessário para a integração de um cliente RM no Protheus por mensagem EAI.


<>


<>


  • MATA030 ou CRMA980: Fontes destino
  • MATI030: Fonte integrador (De ambos acima)









4. Caminhos, Campos e Tabelas

Nesse menu interativo há o caminho das rotinas, todos os campos e tabelas envolvidos na integração de faturamento no Protheus recebendo do RM.


  • Caminho até o Schedule: Ambiente Configurador (SIGACFG) → Ambiente → Schedule → Schedule [CFGA010]

  • I. Caminho até o Adapter: Ambiente Configurador (SIGACFG) → Ambiente → Schedule → Adapter E.a.i. [CFGA020]

  • II. Caminho até o De/Para Mensagem Unica: Ambiente Configurador (SIGACFG) → Ambiente → Schedule → De/para de Mensagem Única [ACFG070]

  • III. Caminho até o De/Para de Empresa/Filial: Ambiente Configurador (SIGACFG) → Ambiente → Schedule → Emp.filial Mensagem Única [ACFG050]



  • "Filial (XX4_FILIAL)" = Filial de registro do dado

  • "Filial Execução (XX4_FILEXE) = Filial recebedora do Protheus

  • "Mensagem Unica (XX4_UNMESS)" = '1 - Sim'/'2 - Não'

  • "Rotina* (XX4_ROTINA)" = Rotina que será o destino da integração

  • "Mensagem* (XX4_MODEL)" = Mensagem EAI da integração

  • "Descrição* (XX4_DESCRI) = Usuário escolhe o nome do registro

  • "Envia (XX4_SENDER)" = '1 - Não'/'2 - Não'

  • "Recebe (XX4_RECEIV)" = '1 - Não'/'2 - Não'

  • "Método (XX4_METODO) = '1 - Síncrono'/'2 - Assíncrono'

  • "Operação (XX4_TPOPER) = '1 - Todas'/'2 - Atualização'/'3 - Exclusão'

  • "Canal Envio (XX4_CHANEL)" = '1 - ESB'/'2 - EAI - SOAP'/'3 - EAI - PAD. APP.'

  • "Salva log (XX4_SNDVER)" = Versão do adapter (gatilhada automaticamente ao incluir a rotina [XX4_ROTINA])

  • "Formato (XX4_FORMAT)" = 'XML'/'JSON'

  • "Salva log (XX4_SAVLOG)" = '1 - Sim'/'2 - Nao'



  • "Rota padrão (XX4_ROUTE)" = Definida preenchida ou não na implantação da integração

  • "Condição (XX4_EXPFIL)" = Definida a expressão de filtro para envio

  • "Compl.Recep. (XX4_LOADRE)" = Definido o nome da rotina de complemento na recepção da mensagem

  • "Compl.Envio. (XX4_LOADSE)" = Definido o nome da rotina de complemento no envio da mensagem

  • "XSD (XX4_XSD)" = Definido o caminho do arquivo XSD de validação do XML

  • "Manipulação XML (XX4_CHGXML)" = Definido o modo de manipulação XML

  • "Alias (XX4_ALIASP)" = Alias da tabela a ser integrada



  • "Referência (XXF_REFER)" = Nome da aplicação origem

  • "Tabela* (XXF_TABLE)" = Tabela destino no Protheus + Empresa filial recebedora 

  • "Alias* (XXF_ALIAS)" = Tabela destino No Protheus (ALIAS)


  • "Campo* (XXF_FIELD)" = Campo Mestre da tabela destino no Protheus

  • "Valor Externo (XXF_EXTVAL)" = Conteúdo da Tag á ser transcrita na mensagem EAI origem

  • "Valor Interno (XXF_INTVAL)" = Empresa + Filial + Registro no Protheus



  • "Mensagem Única (XXF_UNMESS)" = Definido a mensagem única da integração



  • "Referência* (XXD_REFER)" = Nome da aplicação origem

  • "XXD_COMPA" = Empresa na aplicação origem


  • "XXD_BRANCH" = Filial na aplicação origem


  • "XXD_EMPPRO" = Empresa do Protheus recebedora


  • "XXD_FILPRO" = Filial no Protheus recebedora [Dentro da empresa]




  • XX3_FILIAL

 



  • XX3_CODIGO


  • XX3_UUID


  • XX3_FUNCOD 


  • XX3_FUNDES     


  • XX3_TRDATA       


  • XX3_TRHORA 


  • XX3_PRDATA 


  • XX3_TENTAT


  • XX3_TNDATA


  • XX3_TNHORA 


  • XX3_TRANS (Memo) 


  • XX3_TRAN2 (Memo) 


  • XX3_TPDOC 


  • XX3_TPTRAN


  • XX3_STATUS


  • XX3_TMDATA 


  • XX3_TMHORA


  • XX3_RECPDT 


  • XX3_RECPHR 


  • XX3_RESPDT 


  • XX3_RESPHR 


  • XX3_MSGTYP


  • XX3_CHANEL 


  • XX3_REFER 


  • XX3_URL 


  • XX3_WBSER


  • XX3_RETURN (Memo) 


  • XX3_PROUTE 


  • XX3_SROUTE 



  • XX3_ORUUID 



  • XX3_PRODUC 


  • XX3_SOURCE 


  • XX3_VERSAO 


  • XX3_EVENT 


  • XX3_UUIDLT 


  • XX3_TIPOLT




    • XX3 - Campos do Schedule (Retorno da Integração)

    • I. XX4 - Adapters

    • II. XXF - De/Para de Mensagens Únicas

    • III. XXD - De/Para de Empresas e Flilais


  • Clientes: CUSTOMERVENDOR

    • (SA1) - Cadastro de Cliente


  • Pedidos de Venda: ORDER
      • (SC5) - Cabeçalho do Pedido de Venda
      • (SC6) - Itens do Pedido de Venda


  • Condições de Pagamento: PAYMENTCONDITION
      • (SE4) - Condições de Pagamento


  • Regras de Negócio: COMMERCIALFAMILY
      • (ACU) - Categorias de Produto (XXXXXXXXX)


  • Vendedores: SELLER
      • (SA3) - Cadastro de Vendedores


  • Transportadoras: CARRIER
      • (SA4) - Cadastro de Transportadoras


  • Documentos de Saída: INVOICE
      • (SD2) - Itens dos Documentos de Saída
      • (SF2) - Cabeçalhos dos Documentos de Saída


  • Tabelas de Preço: PRICELISTHEADERITEM
      • (DA0) - Cabeçalhos das Tabelas de Preço
      • (DA1) - Itens das Tabelas de Preço





5. Perguntas mais usuais (F.A.Q.)

  • Clientes: CUSTOMERVENDOR

    • (SA1) - Cadastro de Cliente


  • Pedidos de Venda: ORDER
      • (SC5) - Cabeçalho do Pedido de Venda
      • (SC6) - Itens do Pedido de Venda


  • Condições de Pagamento: PAYMENTCONDITION
      • (SE4) - Condições de Pagamento


  • Regras de Negócio: COMMERCIALFAMILY
      • (ACU) - Categorias de Produt
  • Vendedores: SELLER
      • (SA3) - Cadastro de Vendedores


  • Transportadoras: CARRIER
      • (SA4) - Cadastro de Transportadoras


  • Documentos de Saída: INVOICE
      • (SD2) - Itens dos Documentos de Saída
      • (SF2) - Cabeçalhos dos Documentos de Saída


  • Tabelas de Preço: PRICELISTHEADERITEM
      • (DA0) - Cabeçalhos das Tabelas de Preço
      • (DA1) - Itens das Tabelas de Preço








6. Como passar a integrar as rotinas de faturamento do RM no Protheus

1 - Configurar o WS (WebServices) (https://tdn.totvs.com/x/apk4E).

  • Dúvidas nessa etapa, contate a equipe Protheus Framework.


2 - Seguir passo a passo a rotina que deseja incluir no tópico 3 dessa documentação.




7. HELPS

  • Clientes: CUSTOMERVENDOR

    • (SA1) - Cadastro de Cliente


  • Pedidos de Venda: ORDER
      • (SC5) - Cabeçalho do Pedido de Venda
      • (SC6) - Itens do Pedido de Venda


  • Condições de Pagamento: PAYMENTCONDITION
      • (SE4) - Condições de Pagamento


  • Regras de Negócio: COMMERCIALFAMILY
      • (ACU) - Categorias de Produto


  • Vendedores: SELLER
      • (SA3) - Cadastro de Vendedores


  • Transportadoras: CARRIER
      • (SA4) - Cadastro de Transportadoras


  • Documentos de Saída: INVOICE
      • (SD2) - Itens dos Documentos de Saída
      • (SF2) - Cabeçalhos dos Documentos de Saída


  • Tabelas de Preço: PRICELISTHEADERITEM
      • (DA0) - Cabeçalhos das Tabelas de Preço
      • (DA1) - Itens das Tabelas de Preço





8. Parâmetros

Os parâmetros podem ser inclusive os mesmos como em uso manual do Protheus, porém a integração é uma entrada de dados ordenados automaticamente.

  • MV_1DUPNAT
  • MV_VALCNPJ
  • MV_VALCPF
  • MV_1DUPNAT


















9. Pontos de Entrada

Sessão que exibe os pontos de entrada de cada Integração específica (Adapter).


MATI410B


MATI410 (.XML)


MATI411 (EDI de Pedidos de Venda)

KCS: Cross Segmento - TOTVS Backoffice (Linha Protheus) - SIGAFAT - Pontos de Entrada da rotina MATA411



  • Não há pontos de entrada para Integração de Clientes via XML.
  • Não há pontos de entrada para Integração de Condições de Pagamento via XML.


  • Não há pontos de entrada para Integração de Categorias de Produtos via XML.


  • Não há pontos de entrada para Integração de Vendedores via XML.


  • Não há pontos de entrada para Integração de Transportadoras via XML.


  • Não há pontos de entrada para Integração de Documentos de Saída via XML.


  • Não há pontos de entrada para Integração de Tabelas de Preço via XML.





10. ExecAuto()

Não há esquematização de integração nos moldes de ExecAuto(), a integração EAI já é um modelo de execução automática.



Sugestões

Gostaria de sugerir uma implementação diferente ou uma melhoria nessa documentação? Abra um ticket para nós, a Equipe Faturamento (SIGAFAT)!