Criação Creación Webservice: Configurar Portais e portales y Webservices

Toda integração deve-se conter um webservice ativointegración debe contener un webservice activo.

Configurado via mediante el appserver.ini:

Port = Definir porta

Environment = Ambiente que utiliza o webservice

Puert = Defina el puerto

Puert = Defina el puerto

ResponseJob = Defina un nombre ResponseJob = Definir um nome de JOB

127.0.0.1 = IP Localhost (facilita para nossos testesnuestras pruebas)

Obs: Serviço responsabilidade do Servicio responsabilidad del Framework.

Ao Al iniciar o el appserver, no browse acesse o en el browse acceda al ip + porta puerto para que veja o webservice no ar (exemplovea el webservice en el aire (ejemplo: 10.173.10.219:8087/ws01), poderá verificar se seu serviço está ativo ao pesquisar e o mesmo constar podrá verificar si su servicio está activo al buscar y este conste como "HABILITADO":

Após pesquise por EAISERVICE e clique no link. Esse serviço é o responsável pela comunicação entre os Después, busque por EAISERVICE y haga clic en el enlace. Este servicio es el responsable por la comunicación entre los XML:

Clicar no link "Descrição do Serviço Haga clic en el enlace "Descripción del servicio (WSDL)", o link que abrir irá utilizar el enlace que se abra se utilizará para configurar tanto o el Soap quanto o como el MV_EAIURL2:

Caminho selecionadoCamino seleccionado: Utilizar Utilice para configurar SoapUi ou caso tenha uma integração Protheus x Protheus configurar no parâmetro o si tiene una integración Protheus vs. Protheus, configure en el parámetro MV_EAIURL2:

Principais parâmetros Principales parámetros utilizados:

Parámetros: 

PARÁMETROS TOP

VS. PROTHEUS - EAI 1 / EAI 2

• MV_EAIURL2: Responsável Responsable para a comunicação la comunicación entre Protheus e o outro el Protheus y el otro sistema. Informar o webservice do outro sistema apenas quando o Protheus for ENVIAR a mensagem única;Informe el webservice del otro sistema solo cuando el Protheus sea ENVIAR el mensaje único.

• MV_EAIWS: Client Service, já vem ya viene configurado, porém, quando integrado com o Datasul deve ser alterado;pero, se debe modificar cuando se integra al Datasul.

• MV_EAIUSER: Caso o webservice necessite de alguma autenticação de usuário e senha, nesse parâmetro informe o usuário;Si el webservice necesita alguna autenticación de usuario y contraseña, informe el usuario en este parámetro.

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

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

• Si el webservice necesita alguna autenticación de usuario y contraseña, informe el usuario en este parámetro.

• MV_RESTINC:Indica si restringe la inclusión de un pedido de compras sin una solicitud de compras para los usuarios no registrados como compradores. Contenido del parámetro igual Sí.

• MV_SLMPUSR: Define la utilización del usuario enviado por el TOTVS Obras y Proyectos. Este usuario se almacena en el campo C7_USER de la tabla de pedidos de compras.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 la integración del módulo SIGAPMS, via mensagem única por mensaje único, está ativadaactivada. (necessário ativar Es necesario activar para que o el sistema busque o usuário preenchido no el usuario informado en el XML);.

• MV_SLMPREP: Define o prefixo dos títulos a pagar;el prefijo de los títulos por pagar.

• MV_SLMCOND: Condição de pagamento padrão;Condición de pago estándar.

• MV_SLMTS: Tipo de Saída salida (TES) padrão;estándar.

• MV_SLMNATP: Natureza padrão do Título a Pagar;Origen estándar del título por pagar.

• MV_SLMNATR: Natureza padrão do Título a Receber;Origen estándar del título por cobrar.

• MV_SLMPROP: Produto padrão da despesa avulsa Producto estándar del gasto minorista (título a por pagar);.

• MV_SLMCOMP: Define o nome do usuário comprador default para alçada/WS;el nombre del usuario comprador estándar para aprobación/WS.

MV_SLMNTPV:

 Origen estándar del pedido de venta.

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

• Cadastro Registro para informar qual el Sistema/Empresa/Filial Sucursal que integrará com o el Protheus.
• Referência = Nome da Referencia = Nombre de la empresa que integrará com o el Protheus <Product:Name>
• Empresa = Código da de la empresa <CompanyId>
• Filial = Filial da Sucursal = Sucursal de la empresa <BranchId>
• Grupo Emp. Protheus = Código da de la empresa (99 - Protheus)
• FilSuc. Protheus = Filial da Sucursal de la empresa (01 - Protheus)

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

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.

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

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

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

<![CDATA[

"cola o xml aqui""

]]> 

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

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

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

XML Exemplo:

Expandir
title XX4 – Adapter EAI
OBS: Cadastrar UserInternalId como comprador Será necessário estar habilitado o adapter: MATA120 (Pedido de Compras): MATA010 (Cadastro de Produto): AGRA045 (Local de Estoque): PMSA200 (Projeto): PMSA203 (Tarefas do Projeto):

Expandir
title XXF – De/Para EAI
Expandir title Fornecedor FORNECEDOR <CustomerInternalId>17|01;F000213</CustomerInternalId> Expandir title Condição de pagamento <PaymentConditionInternalId>17|002</PaymentConditionInternalId> Expandir title Moeda Contábil <CurrencyId>R$</CurrencyId> Expandir title Produto <ItemInternalId>17|15724</ItemInternalId> Expandir title Unidade de Medida <UnitOfMeasureInternalId>M2</UnitOfMeasureInternalId> Expandir title Local de Estoque <WarehouseInternalId>17|1|0000017</WarehouseInternalId> Expandir title Centro de Custo <CostCenterInternalId>1F8ADAFE-F805-4FC6-9A0C-0E9147C5B898</CostCenterInternalId> Expandir title Produto <ItemInternalId>1EDB480E-3A91-42EA-98B5-2DFB1BE5D4A4</ItemInternalId> Expandir title Local de Estoque <WarehouseInternalId>86FF78DB-64CE-4575-8711-359B573D13F7</WarehouseInternalId> Expandir title Projeto <ProjectInternalId>1|75</ProjectInternalId> Expandir title Centro de Custo <CostCenterInternalId>C00160C9-CE4A-4E7E-BD3D-5490C7CD0902</CostCenterInternalId> 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. 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> Expandir title Local de Estoque <WarehouseInternalId>86FF78DB-64CE-4575-8711-359B573D13F7</WarehouseInternalId> Expandir title Projeto <ProjectInternalId>1|75</ProjectInternalId> Expandir title Centro de Custo <CostCenterInternalId>C00160C9-CE4A-4E7E-BD3D-5490C7CD0902</CostCenterInternalId> 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. 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> Expandir title Tarefa de Projeto <TaskInternalId>17|9|185|0|0</TaskInternalId> Expandir title Estrutura do Projeto <SubProjectInternalId>17|9|185|0|0</SubProjectInternalId>

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

XML Exemplo: