Integración Simplificada con SAP Cloud Integration: Implementación de Servicios API
SAP Cloud Integration ha revolucionado la forma en que las empresas conectan sus aplicaciones locales y en la nube con otras soluciones existentes de SAP, tanto locales como en la nube. Este servicio ofrece una plataforma robusta que procesa mensajes en tiempo real, facilitando la comunicación entre diferentes empresas, organizaciones o departamentos dentro de una misma entidad.
En este documento, nos enfocaremos en exponer un servicio API a partir de un servicio SOAP on-premise expuesto desde SAP. Nuestro objetivo es transformar el formato de contenido a JSON tanto para la solicitud como para la respuesta, permitiendo una integración más ágil y eficiente entre sistemas. A través de este proceso, los usuarios podrán aprovechar al máximo las capacidades de SAP Cloud Integration para optimizar sus flujos de trabajo y mejorar la conectividad entre sus aplicaciones empresariales.
1. Desarrollo Previo al Desarrollo:
Para el desarrollo de la integración tendremos presente los siguientes puntos:
-Se ha expuesto un servicio SOAP a partir de una función para consultar los comprobantes de Pago por sociedad, proveedor y rango de fecha de pago.
-Se ha configurado previamente una credencial de conexión on-premise “CPI_DEV” desde el Manage Security Material del Integration Suite
Desarrollo de Flujo:
Creamos un paquete de integraciones desde la opción “create”.
Ingresamos los detalles del paquete de integración.
Una vez ingresado los detalles del paquete se procede a guardar desde la opción “save”.
Seleccionar el nuevo paquete y elegir la pestaña “Aritfacts”
Seleccionamos la opción “Edit” y luego seleccionamos la opción Add. Para el presente caso se desarrollará a partir de una integración por el cual elegir la opción Integration Flow.
En la ventana “Add Integration Flow” ingresar los detalles de la nueva integración. En este caso se detalla la descripción de consulta de comprobantes para que sea consumido por un portal.
Seleccionar la opción “Add” y aparecerá la ventana de diseño del flujo de integración.
Para iniciar, agregar una conexión de tipo Https desde la opción “connectors” la cual se relaciona directamente al evento de inicio.
Ingresamos los detalles del contexto del API.
Seguidamente, agregar al flujo un elemento de solicitud desde la opción “Call”,”External Call” y “Request Reply” .
Con la misma opción “connectors” configurar el receptor de consulta, desde el Request Reply hacia el Receiver, de tipo “SOAP – 1. *”
Configurar el receptor, para el cual ingresamos los parámetros de nuestro servicio SOAP. Para el caso se ha importado el archivo wsdl desde el local y se ingresó la credencial “CPI_DEV” de autenticación básica previamente configurada. El servicio de consulta de comprobantes SOAP tendrá los elementos de raíz:
Request: ZWSPP_CONSULTA_CPAGO
Response: ZWSPP_CONSULTA_CPAGOResponse/ET_DOCPAGO
En el cual, ET_DOCPAGO es el listado de comprobantes resultante dentro del xml.
Al finalizar la configuración de nuestro receptor SOAP, se procede a guardar para no perder los cambios realizados desde la opción “Save”. Ahora que se tiene el flujo relacionado, nos faltaría la conversión de formatos para nuestro flujo interprete las solicitudes del emisor (JSON) y las respectivas respuestas del receptor (XML), para el cual agregamos para el inicio de la petición el elemento JSON to XML y para la respuesta su elemento inverso XML to Json desde la opción “Message Transformers”, “Converter”.
Adicional al flujo para finalizar anexamos un contenedor de salida para la respuesta con el nuevo formato desde la opción “Message Transformers”.
Para el primer caso de conversión seleccionar el elemento request del wsdl ZWSPP_CONSULTA_CPAGO
Y para la conversión de la respuesta seleccionar el elemento response del wsdl ZWSPP_CONSULTA_CPAGOResponse/ET_DOCPAGO
Finalmente se guarda toda la configuración con la opción “save”, y se procede a ejecutar el flujo de integración con la opción “deploy”
Una vez iniciado el deploy, si todo el flujo no presenta errores de configuración se mostrará como estado “started”
Comprobación del Flujo:
- Utilizando POSTMAN, se prueba una petición según la configuración del remitente API.
2. Desde el Overview/Monitor Message Processing del CPI, podemos visualizar el detalle de la solicitud.
En GRUPO EBIM desarrollamos soluciones TI a la medida de las necesidades de tu empresa. Somos expertos en consultoría SAP, Outsourcing de personal TI, y contamos con un equipo de profesionales dispuestos a brindar Soluciones Digitales escalables para tu negocio. ¡Llena nuestro formulario de contacto y obtén más información sobre los servicios que ofrecemos!