Integração Protheus x RM

Controle de numeração via Tabelas SXE / SXF (MV_TPNRNFS = 2)

Produto:

Microsiga Protheus

Ambiente:

Compras (SIGACOM)

Ocorrência:

Integração Protheus x RM

Neste documento você verá:

Documentação:

Funções e classes utilizáveis no EAI Protheus

Configurar Portais e Webservices

Dicas úteis e dúvidas sobre o EAI Protheus

Manual de Integração PIMS MultiCultivos x Protheus (V.12.1.18)

Como realizar testes de Integrações (Mensagem Unica)

CONFIGURAÇÃO - INTEGRAÇÕES - EAI RM

Criação Webservice
Parâmetros
De/Para Empresas
De/Para Mensagem Única
Configuração Adapter
InternalId
Mensagem única/ SOAP UI
Tabelas EAI
Integração Pedido de Compras (ORDER)
Integração XML Solicitação de compras (REQUEST)

INTEGRAÇÃO

Integração

RM x PROTHEUS

Veja nas abas abaixo o detalhamento de cada opção e procedimentos:

Controle de numeração com uso de SD9 (MV_TPNRNFS = 3)

Deck of Cards

effectDuration	0.5
id	1
effectType	fade

Card

default	true
effectDuration	0.5	id	MSGEAI
label	Criação Webservice

Criação Webservice: Configurar Portais e Webservices

Toda integração deve-se conter um webservice ativo.

Configurado via appserver.ini:

Port = Definir porta

Environment = Ambiente que utiliza o webservice

ResponseJob = Definir um nome de JOB

127.0.0.1 = IP Localhost (facilita para nossos testes)

Obs: Serviço responsabilidade do Framework.

Ao iniciar o appserver, no browse acesse o ip + porta para que veja o webservice no ar (exemplo: 10.173.10.219:8087/ws01), poderá verificar se seu serviço está ativo ao pesquisar e o mesmo constar como "HABILITADO":

Após pesquise por EAISERVICE e clique no link. Esse serviço é o responsável pela comunicação entre os XML:

Clicar no link "Descrição do Serviço (WSDL)", o link que abrir irá utilizar para configurar tanto o Soap quanto o MV_EAIURL2:

Image Added

Caminho selecionado: Utilizar para configurar SoapUi ou caso tenha uma integração Protheus x Protheus configurar no parâmetro MV_EAIURL2:

Image RemovedImage Added

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Parâmetros

Principais parâmetros utilizados:

Parâmetros: PARÂMETROS TOP X PROTHEUS - EAI 1 / EAI 2

MV_EAIURL2: Responsável para a comunicação entre Protheus e o outro sistema. Informar o webservice do outro sistema apenas quando o Protheus for ENVIAR a mensagem única;

MV_EAIWS: Client Service, já vem configurado, porém, quando integrado com o Datasul deve ser alterado;

MV_EAIUSER: Caso o webservice necessite de alguma autenticação de usuário e senha, nesse parâmetro informe o usuário;

MV_EAIPASS: Caso o webservice necessite de alguma autenticação de usuário e senha, nesse parâmetro informe a senha;

MV_PMSITMU: Indica que a integração do módulo SIGAPMS, via mensagem única, está ativada. (necessário ativar para que o sistema busque o usuário preenchido no XML).

Card

default	true
effectDuration	0.5
id	MSGEAI
label	De/Para Empresas

RESTINC: Indica se restringe a inclusão de pedido de compras sem solicitação de compras para usuários não cadastrados como compradores. Conteúdo do parâmetro igual Sim;

MV_SLMPUSR: Define a utilização do usuário enviado pelo TOTVS Obras e Projetos. Este usuário é armazenado no campo C7_USER da tabela de pedidos de compras;

MV_PMSITMU: Indica que a integração do módulo SIGAPMS, via mensagem única, está ativada. (necessário ativar para que o sistema busque o usuário preenchido no XML);

MV_SLMPREP: Define o prefixo dos títulos a pagar;

MV_SLMCOND: Condição de pagamento padrão;

MV_SLMTS: Tipo de Saída (TES) padrão;

MV_SLMNATP: Natureza padrão do Título a Pagar;

MV_SLMNATR: Natureza padrão do Título a Receber;

MV_SLMPROP: Produto padrão da despesa avulsa (título a pagar);

MV_SLMCOMP: Define o nome do usuário comprador default para alçada/WS;

MV_SLMNTPV: Natureza padrão do Pedido de Venda.

De/Para Empresas - APCFG050 - (SIGACFG->Ambiente->Schedule) – Tabela XXD:

Image Removed

Cadastro para informar qual Sistema/Empresa/Filial integrará com o Protheus.
Referência = Nome da empresa que integrará com o Protheus <Product:Name>
Empresa = Código da empresa <CompanyId>
Filial = Filial da empresa <BranchId>
Grupo Emp. Protheus = Código da empresa (99 - Protheus)
Fil. Protheus = Filial da empresa (01 - Protheus)

Obs: Utilizar o mesmo que é apresentado para logar no Protheus

Image Removed

Card

default	true
effectDuration	0.5
id	MSGEAI
label	De/Para Mensagem Única Empresas

De/Para Mensagem Única Empresas - APCFG070 APCFG050 - (SIGACFG->Ambiente->Schedule) – Tabela XXFXXD:

Cadastro onde fica os registro informando a chave única no Protheus (Valor Interno) e a chave única no outro sistema (RM – Valor Externo):

Image Removed

Image Added

Cadastro para informar qual Sistema/Empresa/Filial integrará com o Protheus.
Referência = Nome da empresa que integrará com o Protheus <Product:Name>
Empresa = Código da empresa <CompanyId>
Filial = Filial da empresa <BranchId>
Grupo Emp. Protheus = Código da empresa (99 - Protheus)
Fil. Protheus = Filial da empresa (01 - Protheus)

Obs: Utilizar o mesmo que é apresentado para logar no Protheus

Image Added

Configuração Adapter (SIGACFG -> Schedule -> Adapter E.A.I) – Tabela XX4: Como realizar testes de Integrações (Mensagem Unica)

Mensagem Única = Sim

Rotina = rotina de integração (MATA010)

Mensagem = Nome da mensagem única (ITEM)

Envia = Indica se o Protheus envia a mensagem única (antes de exclusão ou após inclusão/alteração).

Recebe = Indica se o Protheus recebe a mensagem única.

Método = Síncrona (Aguarda resposta – Mesma transação) ou Assíncrona (Não aguarda resposta – Outra transação) do outro sistema.

Condição = Regra para quando o Protheus enviara a mensagem única (SA2->A2_EST = ‘SP’), somente fornecedores do estado de SP que enviam mensagem única.

Canal Envio = 2 – EAI - REST

XSD = Caminho dos XSD caso o cliente queira validar XSD com XML enviado/recebido

Versão envio = Versão da mensagem (WHOIS)

Alias = Alias da tabela

Formato = XML

Image Removed

Modelos de mensagens Síncronas e Assíncronas

As integrações via Mensageria propõem dois modelos de envio e recebimento de mensagens. O modelo Síncrono e o Assíncrono.

Síncronas: No modelo de mensagens Síncronas a mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor.Assíncronas: Já no modelo Assíncrono a mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.

Card

default	true
effectDuration	0.5

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Configuração Adapter

De/Para Mensagem Única

De/Para Mensagem Única - APCFG070 - (SIGACFG->Ambiente->Schedule) – Tabela XXF:

Cadastro onde fica os registro informando a chave única no Protheus (Valor Interno) e a chave única no outro sistema (RM – Valor Externo):

Image Added

Obs:

No cadastro de Adapter da integração de cadastro de Fornecedores (Rotina: MATA020 - Mensagem: CUSTOMERVENDOR), para que haja integração da informação de Tipo de Conta (campo A2_TIPCTA) do Cadastro do Fornecedor, o XML de ENVIO em questão deve estar em uma versão a partir da 2.004, bem como os devidos cadastros de Adapters.

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Configuração Adapter

Configuração Adapter (SIGACFG -> Schedule -> Adapter E.A.I) – Tabela XX4: Como realizar testes de Integrações (Mensagem Unica)

Mensagem Única = Sim

Rotina = rotina de integração (MATA010)

Mensagem = Nome da mensagem única (ITEM)

Envia = Indica se o Protheus envia a mensagem única (antes de exclusão ou após inclusão/alteração).

Recebe = Indica se o Protheus recebe a mensagem única.

Método = Síncrona (Aguarda resposta – Mesma transação) ou Assíncrona (Não aguarda resposta – Outra transação) do outro sistema.

Condição = Regra para quando o Protheus enviara a mensagem única (SA2->A2_EST = ‘SP’), somente fornecedores do estado de SP que enviam mensagem única.

Canal Envio = 2 – EAI - REST

XSD = Caminho dos XSD caso o cliente queira validar XSD com XML enviado/recebido

Versão envio = Versão da mensagem (WHOIS)

Alias = Alias da tabela

Formato = XML

Image Added

Modelos de mensagens Síncronas e Assíncronas

As integrações via Mensageria propõem dois modelos de envio e recebimento de mensagens. O modelo Síncrono e o Assíncrono.

Síncronas: No modelo de mensagens Síncronas a mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor.

Assíncronas: Já no modelo Assíncrono a mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.

A tag InternalId, significa que ela é o identificador único para busca no sistema de onde está sendo enviado o XML.

Quando dentro da BusinessContent possuir outros InternalId, significa que a mensagem possui dependência de outras mensagens.

-> ITEM

-> UNITOFMEASURE

-> WAREHOUSE

Image Removed

Card

default	true
effectDuration	0.5
id	MSGEAI
label	InternalId

A tag InternalId, significa que ela é o identificador único para busca no sistema de onde está sendo enviado o XML.

Quando dentro da BusinessContent possuir outros InternalId, significa que a mensagem possui dependência de outras mensagens.

-> ITEM

-> UNITOFMEASURE

-> WAREHOUSE

Image Added

Card

default	true
effectDuration	0.5
id	MSGEAI
label	InternalId

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Criação Webservice

Criação Webservice: Configurar Portais e Webservices

Toda integração deve-se conter um webservice ativo.

Configurado via appserver.ini:

Port = Definir porta

Environment = Ambiente que utiliza o webservice

ResponseJob = Definir um nome de JOB

127.0.0.1 = IP Localhost (facilita para nossos testes)

Image Removed

Obs: Serviço responsabilidade do Framework.

Ao iniciar o appserver, no browse acesse o ip + porta para que veja o webservice no ar (exemplo: 10.173.10.219:8087/ws01), poderá verificar se seu serviço está ativo ao pesquisar e o mesmo constar como "HABILITADO":

Image Removed

Após pesquise por EAISERVICE e clique no link. Esse serviço é o responsável pela comunicação entre os XML:

Image Removed

Caminho selecionado: Utilizar para configurar SoapUi ou caso tenha uma integração Protheus x Protheus configurar no parâmetro MV_EAIURL2:

Image Removed

Principais parâmetros utilizados:

Parâmetros: PARÂMETROS TOP X PROTHEUS - EAI 1 / EAI 2

MV_EAIURL2: Responsável para a comunicação entre Protheus e o outro sistema. Informar o webservice do outro sistema apenas quando o Protheus for ENVIAR a mensagem única;

MV_EAIWS: Client Service, já vem configurado, porém, quando integrado com o Datasul deve ser alterado;

MV_EAIUSER: Caso o webservice necessite de alguma autenticação de usuário e senha, nesse parâmetro informe o usuário;

MV_EAIPASS: Caso o webservice necessite de alguma autenticação de usuário e senha, nesse parâmetro informe a senha;

MV_PMSITMU: Indica que a integração do módulo SIGAPMS, via mensagem única, está ativada. (necessário ativar para que o sistema busque o usuário preenchido no XML).

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Parâmetros

Mensagem única/ SOAP UI

Mensagem única/ SOAP UI: Como realizar testes de Integrações (Mensagem Unica)

Essa ferramenta nos auxilia quando é o Protheus que recebe a mensagem.

Em “File -> New SOAP Project” informar o caminho do serviço EAISERVICE

Image Added

<![CDATA[

"cola o xml aqui""

]]>

Em “File -> Import Project” importar arquivo com as mensagens já salvas.

Image AddedImage Added

Card

default	true
effectDuration	0.5
id	MSGEAI
label	De/Para Empresas	Tabelas EAI

XX0 - Cadastro de agents (Schedule)

XX1 - Agendamento (Schedule)

XX2 - Agendamento x Empresa/Filial (Schedule)

XX3 - Transações EAI

XX4 - Adapter EAI

XX5 - Relação de uso de rotinas/módulos

XX6 - Catalogo de personalizações

XX7 - Itens do Catalogo de personalizações

XX8 - Configuração de empresas

XX9 - Itens de configuração de empresas

XXF - De/Para EAI

XXD - De-para de Empresas do EAI

De/Para Empresas - APCFG050 - (SIGACFG->Ambiente->Schedule) – Tabela XXD:

Image Removed

Cadastro para informar qual Sistema/Empresa/Filial integrará com o Protheus.
Referência = Nome da empresa que integrará com o Protheus <Product:Name>
Empresa = Código da empresa <CompanyId>
Filial = Filial da empresa <BranchId>
Grupo Emp. Protheus = Código da empresa (99 - Protheus)
Fil. Protheus = Filial da empresa (01 - Protheus)

Obs: Utilizar o mesmo que é apresentado para logar no Protheus

Image Removed

De/Para Mensagem Única - APCFG070 - (SIGACFG->Ambiente->Schedule) – Tabela XXF:

Cadastro onde fica os registro informando a chave única no Protheus (Valor Interno) e a chave única no outro sistema (RM – Valor Externo):

Image Removed

Configuração Adapter (SIGACFG -> Schedule -> Adapter E.A.I) – Tabela XX4: Como realizar testes de Integrações (Mensagem Unica)

Mensagem Única = Sim

Rotina = rotina de integração (MATA010)

Mensagem = Nome da mensagem única (ITEM)

Envia = Indica se o Protheus envia a mensagem única (antes de exclusão ou após inclusão/alteração).

Recebe = Indica se o Protheus recebe a mensagem única.

Método = Síncrona (Aguarda resposta – Mesma transação) ou Assíncrona (Não aguarda resposta – Outra transação) do outro sistema.

Condição = Regra para quando o Protheus enviara a mensagem única (SA2->A2_EST = ‘SP’), somente fornecedores do estado de SP que enviam mensagem única.

Canal Envio = 2 – EAI - REST

XSD = Caminho dos XSD caso o cliente queira validar XSD com XML enviado/recebido

Versão envio = Versão da mensagem (WHOIS)

Alias = Alias da tabela

Formato = XML

Image Removed

Modelos de mensagens Síncronas e Assíncronas

As integrações via Mensageria propõem dois modelos de envio e recebimento de mensagens. O modelo Síncrono e o Assíncrono.

Síncronas: No modelo de mensagens Síncronas a mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor.Assíncronas: Já no modelo Assíncrono a mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.

A tag InternalId, significa que ela é o identificador único para busca no sistema de onde está sendo enviado o XML.

Quando dentro da BusinessContent possuir outros InternalId, significa que a mensagem possui dependência de outras mensagens.

-> ITEM

-> UNITOFMEASURE

-> WAREHOUSE

Image Removed

Card

default	true
effectDuration	0.5
id	MSGEAI
label	De/Para Mensagem Única

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Configuração Adapter

Integração Pedido de Compras (ORDER)

Simulação de integração de Pedido de Compras (MENSAGEM ORDER):

Image Added

XML Exemplo:

View file

name	Pedido de Compras.xml
height	250

Expandir

title	XX4 – Adapter EAI

OBS: Cadastrar UserInternalId como comprador

Será necessário estar habilitado o adapter:

MATA120 (Pedido de Compras):

Image Added

MATA010 (Cadastro de Produto):

Image Added

AGRA045 (Local de Estoque):

Image Added

PMSA200 (Projeto):

Image Added

PMSA203 (Tarefas do Projeto):

Image Added

Expandir

title	XXD - (De-para de Empresas do EAI)

Image Added

REFERÊNCIA:

Image Added

EMPRESA/FILIAL XML:

Image Added

PROTHEUS:

Image Added

Expandir

title	XXF – De/Para EAI

Expandir

title	Fornecedor

FORNECEDOR

<CustomerInternalId>17|01;F000213</CustomerInternalId>

Image Added

Image Added

Expandir

title	Condição de pagamento

<PaymentConditionInternalId>17|002</PaymentConditionInternalId>

Image Added

Image Added

Expandir

title	Moeda Contábil

<CurrencyId>R$</CurrencyId>

Image Added

Image Added

Expandir

title	Produto

<ItemInternalId>17|15724</ItemInternalId>

Image Added

Image Added

Expandir

title	Unidade de Medida

<UnitOfMeasureInternalId>M2</UnitOfMeasureInternalId>

Image Added

Image Added

Expandir

title	Local de Estoque

<WarehouseInternalId>17|1|0000017</WarehouseInternalId>

Image Added

Image Added

Expandir

title	Centro de Custo

<CostCenterInternalId>1F8ADAFE-F805-4FC6-9A0C-0E9147C5B898</CostCenterInternalId>

Image Added

Image Added

Expandir

title	Produto

<ItemInternalId>1EDB480E-3A91-42EA-98B5-2DFB1BE5D4A4</ItemInternalId>

Image Added

Image Added

Expandir

title	Local de Estoque

<WarehouseInternalId>86FF78DB-64CE-4575-8711-359B573D13F7</WarehouseInternalId>

Image Added

Image Added

Expandir

title	Projeto

<ProjectInternalId>1|75</ProjectInternalId>

Image Added

Image Added

Expandir

title	Centro de Custo

<CostCenterInternalId>C00160C9-CE4A-4E7E-BD3D-5490C7CD0902</CostCenterInternalId>

Image Added

Image Added

Obs:

Neste exemplo do XML em que as informações do Centro de Custo estão no XML na tag "<ListOfApportionOrderItem>" o Centro de Custo será importado no Pedido de Compras na tela de Rateio de Centro de Custos (tabela SCH):

Verificando junto à Equipe de Produto, no programa MATI120 do Compras do Protheus que recebe o XML do RM, neste exemplo do XML quando recebe a informação e é utilizada a tag "<CostCenterInternalId>" dentro da "<ListOfApportionOrderItem>" o padrão é ela ser importada para a tela de rateio (tabela SCH). Mesmo sendo 1 ou mais centro de custo.

Image Added

Para o Protheus receber informação de Centro de Custo no Item do Pedido na SC7 as informações do mesmo devem estar contidas na tag "<CostCenterInternalId>" dentro da "<Item>" do arquivo XML diretamente.

Se caso, tiver a tag dentro do "Item" e também dentro do "ListOfApportationOrderItem", o que vai prevalecer é que esta dentro do "ListOfApportationOrderItem".

Expandir

title	Produto

<ItemInternalId>1EDB480E-3A91-42EA-98B5-2DFB1BE5D4A4</ItemInternalId>

Image Added

Image Added

Expandir

title	Local de Estoque

<WarehouseInternalId>86FF78DB-64CE-4575-8711-359B573D13F7</WarehouseInternalId>

Image Added

Image Added

Expandir

title	Projeto

<ProjectInternalId>1|75</ProjectInternalId>

Image Added

Image Added

Expandir

title	Centro de Custo

<CostCenterInternalId>C00160C9-CE4A-4E7E-BD3D-5490C7CD0902</CostCenterInternalId>

Image Added

Image Added

Obs:

Neste exemplo do XML em que as informações do Centro de Custo estão no XML na tag "<ListOfApportionOrderItem>" o Centro de Custo será importado no Pedido de Compras na tela de Rateio de Centro de Custos (tabela SCH):

Verificando junto à Equipe de Produto, no programa MATI120 do Compras do Protheus que recebe o XML do RM, neste exemplo do XML quando recebe a informação e é utilizada a tag "<CostCenterInternalId>" dentro da "<ListOfApportionOrderItem>" o padrão é ela ser importada para a tela de rateio (tabela SCH). Mesmo sendo 1 ou mais centro de custo.

Image Added

Para o Protheus receber informação de Centro de Custo no Item do Pedido na SC7 as informações do mesmo devem estar contidas na tag "<CostCenterInternalId>" dentro da "<Item>" do arquivo XML diretamente.

Se caso, tiver a tag dentro do "Item" e também dentro do "ListOfApportationOrderItem", o que vai prevalecer é que esta dentro do "ListOfApportationOrderItem".

Expandir

title	Projetos

<ProjectInternalId>17|9</ProjectInternalId>

Image Added

Image Added

Expandir

title	Tarefa de Projeto

<TaskInternalId>17|9|185|0|0</TaskInternalId>

Image Added

Image Added

Expandir

title	Estrutura do Projeto

<SubProjectInternalId>17|9|185|0|0</SubProjectInternalId>

Image Added

Image Added

Card

default	true
effectDuration	0.5
id	MSGEAI
label	InternalId

Deck of Cards

effectDuration	0.5
id	1
effectType	fade

Criação Webservice: Configurar Portais e Webservices

Toda integração deve-se conter um webservice ativo.

Configurado via appserver.ini:

Port = Definir porta

Environment = Ambiente que utiliza o webservice

ResponseJob = Definir um nome de JOB

127.0.0.1 = IP Localhost (facilita para nossos testes)

Image Removed

Obs: Serviço responsabilidade do Framework.

Ao iniciar o appserver, no browse acesse o ip + porta para que veja o webservice no ar (exemplo: 10.173.10.219:8087/ws01), poderá verificar se seu serviço está ativo ao pesquisar e o mesmo constar como "HABILITADO":

Image Removed

Após pesquise por EAISERVICE e clique no link. Esse serviço é o responsável pela comunicação entre os XML:

Image Removed

Caminho selecionado: Utilizar para configurar SoapUi ou caso tenha uma integração Protheus x Protheus configurar no parâmetro MV_EAIURL2:

Image Removed

Principais parâmetros utilizados:

Parâmetros: PARÂMETROS TOP X PROTHEUS - EAI 1 / EAI 2

MV_EAIURL2: Responsável para a comunicação entre Protheus e o outro sistema. Informar o webservice do outro sistema apenas quando o Protheus for ENVIAR a mensagem única;

MV_EAIWS: Client Service, já vem configurado, porém, quando integrado com o Datasul deve ser alterado;

MV_EAIUSER: Caso o webservice necessite de alguma autenticação de usuário e senha, nesse parâmetro informe o usuário;

MV_EAIPASS: Caso o webservice necessite de alguma autenticação de usuário e senha, nesse parâmetro informe a senha;

MV_PMSITMU: Indica que a integração do módulo SIGAPMS, via mensagem única, está ativada. (necessário ativar para que o sistema busque o usuário preenchido no XML).

De/Para Empresas - APCFG050 - (SIGACFG->Ambiente->Schedule) – Tabela XXD:

Image Removed

Cadastro para informar qual Sistema/Empresa/Filial integrará com o Protheus.
Referência = Nome da empresa que integrará com o Protheus <Product:Name>
Empresa = Código da empresa <CompanyId>
Filial = Filial da empresa <BranchId>
Grupo Emp. Protheus = Código da empresa (99 - Protheus)
Fil. Protheus = Filial da empresa (01 - Protheus)

Obs: Utilizar o mesmo que é apresentado para logar no Protheus

Image Removed

De/Para Mensagem Única - APCFG070 - (SIGACFG->Ambiente->Schedule) – Tabela XXF:

Cadastro onde fica os registro informando a chave única no Protheus (Valor Interno) e a chave única no outro sistema (RM – Valor Externo):

Image Removed

Configuração Adapter (SIGACFG -> Schedule -> Adapter E.A.I) – Tabela XX4: Como realizar testes de Integrações (Mensagem Unica)

Mensagem Única = Sim

Rotina = rotina de integração (MATA010)

Mensagem = Nome da mensagem única (ITEM)

Envia = Indica se o Protheus envia a mensagem única (antes de exclusão ou após inclusão/alteração).

Recebe = Indica se o Protheus recebe a mensagem única.

Método = Síncrona (Aguarda resposta – Mesma transação) ou Assíncrona (Não aguarda resposta – Outra transação) do outro sistema.

Condição = Regra para quando o Protheus enviara a mensagem única (SA2->A2_EST = ‘SP’), somente fornecedores do estado de SP que enviam mensagem única.

Canal Envio = 2 – EAI - REST

XSD = Caminho dos XSD caso o cliente queira validar XSD com XML enviado/recebido

Versão envio = Versão da mensagem (WHOIS)

Alias = Alias da tabela

Formato = XML

Image Removed

Modelos de mensagens Síncronas e Assíncronas

As integrações via Mensageria propõem dois modelos de envio e recebimento de mensagens. O modelo Síncrono e o Assíncrono.

Síncronas: No modelo de mensagens Síncronas a mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor.Assíncronas: Já no modelo Assíncrono a mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.

A tag InternalId, significa que ela é o identificador único para busca no sistema de onde está sendo enviado o XML.

Quando dentro da BusinessContent possuir outros InternalId, significa que a mensagem possui dependência de outras mensagens.

-> ITEM

-> UNITOFMEASURE

-> WAREHOUSE

Image Removed

MessageInformation / BusinessMessage = Framework é o responsável.

MessageInformation (CompanyId / BranchId / Product:Name) = Utilizar no de/para de empresa

Event = Upsert (Inclusão ou Alteração), para definir se é inclusão tag InternalId não deve constar no cadastro de de/para de registros, caso o InternalId for encontrado será uma alteração.

Event = Delete (Exclusão)

BusinessContent = Responsabilidade da squad

Image Removed

XML – Resposta (OK / ERROR)

OK

ReturnContent:ListOfInternalId = Deve conter o nome da mensagem única, a identificador único do Protheus e do outro sistema, para que seja feita a inclusão/exclusão do registro.

Image Removed

ERROR

ReturnContent:ListOfMessages = Conterá a mensagem de erro durante o processamento da mensagem.

Image Removed

Mensagem única/ SOAP UI: Como realizar testes de Integrações (Mensagem Unica)

Essa ferramenta nos auxilia quando é o Protheus que recebe a mensagem.

Em “File -> New SOAP Project” informar o caminho do serviço EAISERVICE

Image Removed

Em “File -> Import Project” importar arquivo com as mensagens já salvas.

Image RemovedImage Removed

Prin

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Criação Webservice

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Parâmetros

Card

default	true
effectDuration	0.5
id	MSGEAI
label	De/Para Empresas

Card

default	true
effectDuration	0.5
id	MSGEAI
label	De/Para Mensagem Única

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Configuração Adapter

Card

default	true
effectDuration	0.5
id	MSGEAI
label	InternalId

Card

default	true
effectDuration	0.5
id	MSGEAI
label	XML

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Mensagem única/ SOAP UI

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Parâmetros

Deck of Cards

effectDuration	0.5
id	1
effectType	fade

Prin

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Parâmetros

Card

default	true
effectDuration	0.5
id	MSGEAI
label	Parâmetros

Prin

Controle de numeração via Tabelas SXE / SXF (MV_TPNRNFS = 2)

Card

label
default	true
effectDuration	0.5
id	MSGEAI

Parâmetros

Card

default	true
effectDuration	0.5
id	2
label	MV_TPNRNFS = 2 - LS

Aviso

title	Atenção

Certifique-se

Expandir

title	Veja mais

uhuihuhi

Card

default	true
effectDuration	0.5
id	3
label	MV_TPNRNFS = 3 - SD9

Dica

title	Observação

Em caso de alterar o conteúdo deste parâmetro após já ter sido criado o Lote de numerações, é necessário executar a rotina de Ajuste de Numeração da tabela SD9: MATA470 mencionada abaixo para exclusão das numerações que ficarão em desuso.

Card

default	true
effectDuration	0.5
id	2
label	MV_TPNRNFS = 2 - LS

Aviso

title	Atenção

Certifique-se

Expandir

title	Veja mais

uhuihuhi

Card

default	true
effectDuration	0.5
id	3
label	MV_TPNRNFS = 3 - SD9

Controle de numeração com uso de SD9 (MV_TPNRNFS = 3)

Dica

title	Observação

Em caso de alterar o conteúdo deste parâmetro após já ter sido criado o Lote de numerações, é necessário executar a rotina de Ajuste de Numeração da tabela SD9: MATA470 mencionada abaixo para exclusão das numerações que ficarão em desuso.

Card

default	true
effectDuration	0.5
id	2
label	MV_TPNRNFS = 2 - LS

Controle de numeração via Tabelas SXE / SXF (MV_TPNRNFS = 2)

Aviso

title	Atenção

Certifique-se

Expandir

title	Veja mais

uhuihuhi

Card

default	true
effectDuration	0.5
id	3
label	MV_TPNRNFS = 3 - SD9

Controle de numeração com uso de SD9 (MV_TPNRNFS = 3)

Dica

title	Observação

Em caso de alterar o conteúdo deste parâmetro após já ter sido criado o Lote de numerações, é necessário executar a rotina de Ajuste de Numeração da tabela SD9: MATA470 mencionada abaixo para exclusão das numerações que ficarão em desuso.

Principais Pontos de Entrada que permitem tratar a Numeração do Documento de Saída

M467FILT - Filtrar séries a serem mostradas (Não é válida para o módulo Loja): https://tdn.totvs.com/x/5IRn

Pode lhe interessar:

Integração XML Solicitação de Compras (REQUEST)

Simulação de integração de Solicitação de Compras (MENSAGEM REQUEST):

Image Added

XML Exemplo:

View file

name	Solicitação de Compras.xml
height	250

Expandir

title	XX4 – Adapter EAI

Será necessário estar habilitado o adapter para a rotina MATA110(Solicitação de Compras):

Image Added

E o adapter pata a rotina MATA105 (Solicitação de Armazém):

Image Added

Expandir

title	XXD - (De-para de Empresas do EAI)

Image Added

REFERÊNCIA:

Image Added

XML:

Image Added

PROTHEUS:

Image Added

Expandir

title	XXF – De/Para EAI

Expandir

title	Produto

<ItemInternalId>1EDB480E-3A91-42EA-98B5-2DFB1BE5D4A4</ItemInternalId>

Image Added

Image Added

Expandir

title	Local de Estoque

<WarehouseInternalId>86FF78DB-64CE-4575-8711-359B573D13F7</WarehouseInternalId>

Image Added

Image Added

Expandir

title	Projeto

<ProjectInternalId>1|75</ProjectInternalId>

Image Added

Image Added

Expandir

title	Centro de Custo

<CostCenterInternalId>C00160C9-CE4A-4E7E-BD3D-5490C7CD0902</CostCenterInternalId>

Image Added

Image Added

Obs:

Neste exemplo do XML em que as informações do Centro de Custo estão no XML na tag "<ListOfApportionOrderItem>" o Centro de Custo será importado no Solicitação de Compras na tela de Rateio de Centro de Custos (tabela SCH):

Verificando junto à Equipe de Produto, no programa MATI120 do Compras do Protheus que recebe o XML do RM, neste exemplo do XML quando recebe a informação e é utilizada a tag "<CostCenterInternalId>" dentro da "<ListOfApportionOrderItem>" o padrão é ela ser importada para a tela de rateio (tabela SCH). Mesmo sendo 1 ou mais centro de custo.

Image Added

Para o Protheus receber informação de Centro de Custo no Item do Pedido na SC7 as informações do mesmo devem estar contidas na tag "<CostCenterInternalId>" dentro da "<Item>" do arquivo XML diretamente.

Se caso, tiver a tag dentro do "Item" e também dentro do "ListOfApportationOrderItem", o que vai prevalecer é que esta dentro do "ListOfApportationOrderItem".

Expandir

title	Tarefa de Projeto

OBS: Caso o XML possuir mais de uma tag <TaskInternalId> com código diferente será necessário cadastrar todas as demais tags

<TaskInternalId>1|75|3|0|0</TaskInternalId>

Image Added

Image Added

Expandir

title	Unidade de Medida

<UnitOfMeasureCode>M3</UnitOfMeasureCode>

Image Added

Image Added

Documentação Complementar:

Configuração de numeração de Notas Fiscais com mais de 6 dígitos: https://tdn.totvs.com/x/NIojDw

Árvore de páginas

Versões comparadas

Versão antiga 4

Nova versão Atual

Chave

Integração Protheus x RM

Neste documento você verá:

INTEGRAÇÃO

RM x PROTHEUS

Principais Pontos de Entrada que permitem tratar a Numeração do Documento de Saída

MP - SIGACOM - Como extrair o XML na Integração EAI (Protheus) ?

XML Formatter

Árvore de páginas

Histórico da Página

Versões comparadas

Chave

Integração Protheus x RM

Neste documento você verá:

INTEGRAÇÃO

RM x PROTHEUS

Principais Pontos de Entrada que permitem tratar a Numeração do Documento de Saída