Creación Webservice: Configurar portales y Webservices

Toda integración debe contener un webservice activo.

Configurado mediante el appserver.ini:

Puert = Defina el puerto

Puert = Defina el puerto

ResponseJob = Defina un nombre de JOB

127.0.0.1 = IP Localhost (facilita para nuestras pruebas)

Obs: Servicio responsabilidad del Framework.

Al iniciar el appserver, en el browse acceda al ip + puerto para que vea el webservice en el aire (ejemplo: 10.173.10.219:8087/ws01), podrá verificar si su servicio está activo al buscar y este conste como "HABILITADO":

Después, busque por EAISERVICE y haga clic en el enlace. Este servicio es el responsable por la comunicación entre los XML:

Haga clic en el enlace "Descripción del servicio (WSDL)", el enlace que se abra se utilizará para configurar tanto el Soap como el MV_EAIURL2:

Camino seleccionado: Utilice para configurar SoapUi o si tiene una integración Protheus vs. Protheus, configure en el parámetro MV_EAIURL2:

Principales parámetros utilizados:

Parámetros: PARÁMETROS TOP VS. PROTHEUS - EAI 1 / EAI 2

• MV_EAIURL2: Responsable para la comunicación entre el Protheus y el otro sistema. Informe el webservice del otro sistema solo cuando el Protheus sea ENVIAR el mensaje único.

• MV_EAIWS: Client Service, ya viene configurado, pero, se debe modificar cuando se integra al Datasul.

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

• MV_EAIPASS: 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_PMSITMU: Indica que la integración del módulo SIGAPMS, por mensaje único, está activada. (Es necesario activar para que el sistema busque el usuario informado en el XML).

• MV_SLMPREP: Define el prefijo de los títulos por pagar.

• MV_SLMCOND: Condición de pago estándar.

• MV_SLMTS: Tipo de salida (TES) estándar.

• MV_SLMNATP: Origen estándar del título por pagar.

• MV_SLMNATR: Origen estándar del título por cobrar.

• MV_SLMPROP: Producto estándar del gasto minorista (título por pagar).

• MV_SLMCOMP: Define el nombre del usuario comprador estándar para aprobación/WS.

MV_SLMNTPV: Origen estándar del pedido de venta.

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

• Registro para informar el Sistema/Empresa/Sucursal que integrará el Protheus.
• Referencia = Nombre de la empresa que integrará el Protheus <Product:Name>
• Empresa = Código de la empresa <CompanyId>
• Sucursal = Sucursal de la empresa <BranchId>
• Grupo Emp. Protheus = Código de la empresa (99 - Protheus)
• Suc. Protheus = Sucursal de la empresa (01 - Protheus)

De/Para Mensagem Única A Mensaje único - APCFG070  - (SIGACFG->Ambiente>Entorno->Schedule) – Tabela Tabla XXF:

Cadastro onde fica os registro informando a chave única no Registro donde quedan los datos que informan la clave única en el Protheus (Valor Interno) e a chave única no outro interno) y la clave única en el otro sistema (RM – Valor Externoexterno):

Obs:

No cadastro En el registro de Adapter da integração de cadastro de Fornecedores (Rotinade la integració delo registro de proveedores (Rutina: MATA020 - MensagemMensaje: CUSTOMERVENDOR), para que haja integração da informação haya integración de la información de Tipo de Conta Cuenta (campo A2_TIPCTA) do Cadastro do Fornecedor, o XML de ENVIO em questão deve estar em uma versão a partir da del registro del proveedor, el XML de ENVÍO mencionado, debe estar en una versión a partir de la 2.004, bem como os devidos cadastros de Adaptersasí como los debidos registros de los Adapter.

Configuração Configuración Adapter (SIGACFG -> Schedule -> Adapter E.A.I) – Tabela Tabla XX4: Como realizar testes pruebas de Integrações Integraciones (Mensagem UnicaMensaje único)

Mensagem Única Mensaje único = SimSí

Rotina Rutina = rotina rutina de integração integración (MATA010)

Mensagem = Nome da mensagem única (ITEMNombre del mensaje único (ÍTEM)

Envia = Indica se o Protheus envia a mensagem única (antes de exclusão ou após inclusão/alteraçãosi el Protheus envía el mensaje único (antes de eliminar o después de incluir/modificar).

Recebe Recibe = Indica se o Protheus recebe a mensagem únicasi el Protheus recibe el mensaje único.

Método = SíncronaSincrónica (Aguarda resposta – Mesma transação) ou Assíncrona (Não aguarda resposta – Outra transação) do outro sistema.Espera respuesta – Igual transacción) o Asíncrona (No espera respuesta – Otra transacción) del otro sistema.

Condición = Regla para cuando el Protheus enviará el mensaje único Condição = Regra para quando o Protheus enviara a mensagem única (SA2->A2_EST = ‘SP’), somente fornecedores do solamente proveedores del estado de SP que enviam mensagem únicaenvían mensaje único.

Canal Envio Envío = 2 – EAI - REST

XSD = Caminho dos XSD caso o cliente queira validar XSD com Camino de los XSD si el cliente desea validar XSD con XML enviado/recebidorecibido

Versão envio = Versão da mensagem Versión envío = Versión del mensaje (WHOIS)

Alias = Alias da tabelade la tabla

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.

mensajes sincrónicas y asíncronas 

 Las integraciones por Mensagería proponen dos modelos de envío y recepción de mensajes. El modelo Sincrónico y el Asíncrono.

Asíncronas:  En el modelo de mensajes Asíncronas el mensaje se envía y el sistema que envió espera el procesamiento del mensaje por el receptor.

Asíncronas:  Por otro lado, en el modelo Asíncrono el mensaje se envía y el sistema que la envió no espera su procesamiento. Posteriormente el mensaje se procesará en el 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 La tag InternalId, significa que ela é o esta es el identificador único para busca no búsqueda en el sistema de onde está sendo enviado o donde se está enviando el XML.

Quando Cuando dentro da BusinessContent possuir outros de la BusinessContent se tengan otros InternalId, significa que a mensagem possui dependência de outras mensagensel mensaje tiene dependencia de otros mensajes.

-> ITEMÍTEM

-> UNITOFMEASURE

-> WAREHOUSE

Mensagem únicaMensaje único/ SOAP UI: Como Cómo realizar testes pruebas de Integrações Integraciones (Mensagem UnicaMensaje único)

Essa ferramenta Esta herramienta nos auxilia quando é o cuando es el Protheus que recebe a mensagemrecibe el mensaje.

Em En “File -> New SOAP Project” informar o caminho do serviço informe el camino del servicio EAISERVICE

<![CDATA[

"cola o xml aqui""

]]> 

Em En “File -> Import Project” importar arquivo com as mensagens já salvasimporte el archivo con los mensajes ya grabados.

XX0 - Cadastro Registro de agents (Schedule)

XX1 - Agendamento Programación de agenda (Schedule)

XX2 - Agendamento x Programación de agenda vs. Empresa/Filial Sucursal (Schedule)

XX3 - Transações Transacciones EAI

XX4 - Adapter EAI

XX5 - Relação Relación de uso de rotinasrutinas/módulos

XX6 - Catalogo Catálogo de personalizaçõespersonalizaciones

XX7 - Itens Ítems do Catalogo catálogo de personalizaçõespersonalizaciones

XX8 - Configuração Configuración de empresas

XX9 - Itens Ítems de configuração configuración de empresas

XXF XXF - De/Para A EAI

XXD - De-para A de Empresas do del EAI

Simulação Simulación de integração integración de Pedido de Compras (MENSAGEM MENSAJE ORDER):

XML ExemploEjemplo:

Expandir
title XX4 – Adapter EAI
OBS: Cadastrar Registre el UserInternalId como comprador Será necessário estar habilitado o adapterEs necesario que el Adapter este habilitado: MATA120 (Pedido de Comprascompras): MATA010 (Cadastro Registro de Produtoproducto): AGRA045 (Local Lugar de Estoquestock): PMSA200 (ProjetoProyecto): PMSA203 (Tarefas do ProjetoTareas del proyecto):

Expandir
title XXF – De/Para A EAI
Expandir title FornecedorProveedor FORNECEDOR <CustomerInternalId>17|01;F000213</CustomerInternalId> Expandir title Condição Condición de pagamentopago <PaymentConditionInternalId>17|002</PaymentConditionInternalId> Expandir title Moeda ContábilMoneda contable <CurrencyId>R$</CurrencyId> Expandir title ProdutoProducto <ItemInternalId>17|15724</ItemInternalId> Expandir title Unidade Unidad de Medidamedida <UnitOfMeasureInternalId>M2</UnitOfMeasureInternalId> Expandir title Local Lugar de Estoquestock <WarehouseInternalId>17|1|0000017</WarehouseInternalId> Expandir title Centro de Custocosto <CostCenterInternalId>1F8ADAFE-F805-4FC6-9A0C-0E9147C5B898</CostCenterInternalId> Expandir title ProdutoProducto <ItemInternalId>1EDB480E-3A91-42EA-98B5-2DFB1BE5D4A4</ItemInternalId> Expandir title Local Lugar de Estoquestock <WarehouseInternalId>86FF78DB-64CE-4575-8711-359B573D13F7</WarehouseInternalId> Expandir title ProjetoProyecto <ProjectInternalId>1|75</ProjectInternalId> Expandir title Centro de Custocosto <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): En este ejemplo del XML en que las informaciones del Centro de Costo están en el XML en la tag "<ListOfApportionOrderItem>" el Centro de Costo se importará en el Pedido de Compras en la pantalla de Prorrateo del Centro de Costos (tabla SCH): Verificando con el Equipo del Producto, en el programa MATI120 del Compras del Protheus, que recibe el XML del RM, en este ejemplo del XML, cuando recibe la información, se utilizará la tag "<CostCenterInternalId>" dentro de la "<ListOfApportionOrderItem>" el estándar es que esta sea importada para la pantalla de prorrateo (tabla SCH). Aunque sea 1 o más centro de costoVerificando 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 que el Protheus reciba  información del Centro de Costo en el ítem del Pedido en la SC7 las informaciones de este, deben estar contenidos en la tag "<CostCenterInternalId>" dentro da de la "<Item><Ítem>" do arquivo del archivo XML diretamentedirectamente. Se caso, tiver a Si se tuviera la tag dentro do del "ItemÍtem" e também y también dentro do del "ListOfApportationOrderItem", o que vai prevalecer é lo que prevalecerá será lo que esta dentro do del "ListOfApportationOrderItem". Expandir title ProdutoProducto <ItemInternalId>1EDB480E-3A91-42EA-98B5-2DFB1BE5D4A4</ItemInternalId> Expandir title Local Lugar de Estoquestock <WarehouseInternalId>86FF78DB-64CE-4575-8711-359B573D13F7</WarehouseInternalId> Expandir title ProjetoProyecto <ProjectInternalId>1|75</ProjectInternalId> Expandir title Centro de Custocosto <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): En este ejemplo del XML, en que las informaciones del Centro de Costo están en el XML en la tag "<ListOfApportionOrderItem>" el Centro de Costo se importará en el Pedido de Compras en la pantalla de prorrateo del Centro de Costos (tabla SCH): Verificando con el Equipo del Producto, en el programa MATI120 del Compras del Protheus, que recibe el XML del RM, en este ejemplo del XML, cuando recibe la información, se utilizará la tag "<CostCenterInternalId>" dentro de la "<ListOfApportionOrderItem>" el estándar es que esta sea importada para la pantalla de prorrateo (tabla SCH). Aunque sea 1 o más centros de costoVerificando 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 que el Protheus reciba  información del Centro de Costo en el ítem del Pedido en la SC7 las informaciones de este, deben estar contenidos en la tag "<CostCenterInternalId>" dentro da de la "<Item><Ítem>" do arquivo del archivo XML diretamentedirectamente. Se caso, tiver a Si se tuviera la tag dentro do del "ItemÍtem" e também y también dentro do del "ListOfApportationOrderItem", o que vai prevalecer é lo que prevalecerá será lo que esta dentro do del "ListOfApportationOrderItem". Expandir title ProjetosProyectos <ProjectInternalId>17|9</ProjectInternalId> Expandir title Tarefa de ProjetoTarea del proyecto <TaskInternalId>17|9|185|0|0</TaskInternalId> Expandir title Estrutura do ProjetoEstructura del proyecto <SubProjectInternalId>17|9|185|0|0</SubProjectInternalId>

Simulação Simulación de integração integración de Solicitação solicitud de Compras compras (MENSAGEM MENSAJE REQUEST):

XML ExemploEjemplo: