Skip to Content
Technical Articles
Author's profile photo Vutkuri Venkata Sai Charan

Monitoring and Testing Business Partner SOAP Web Services

Introduction:

This blog intends to provide an overview of Monitoring and testing of Business Partner Integration with SOAP Web Services

To integrate Business Partner Master data from SAP S/4 HANA systems, we have the following technologies that are built into standard SAP S/4 HANA System.

  • IDOC
  • OData
  • SOAP Services

IDOC technology is widely used in SAP ERP to integrate or replicate customers and suppliers master data to external systems. DEBMAS and CREMAS are the standard EDIFACT message types which are made available in SAP.

Apart from IDOC, OData and SOAP Web Services are good alternatives to integrate with Cloud based systems. API_BUSSINESS_PARTNER is the OData Service. For more details on technical structure of the service you can refer to the help documentation by SAP linked here.

In this blog, we would be considering SOAP Web Services that are out-of-the box available for usage. The following SOAP Web Services are available in SAP S/4 HANA to replicate the Business Partner master data to external systems.

Outbound Services:

  • BusinessPartnerSUITEBulkReplicateRequest_Out – Technical structure SAP help document here.
  • BusinessPartnerRelationshipSUITEBulkReplicateRequest_Out– Technical structure SAP help document here.
  • BusinessPartnerSUITEBulkReplicateConfirmation_Out – Technical structure SAP help document here.
  • BusinessPartnerRelationshipSUITEBulkReplicateConfirmation_Out – Technical structure SAP help document here.

Inbound Services:

  • BusinessPartnerSUITEBulkReplicateRequest_In – Technical structure SAP help document here.
  • BusinessPartnerRelationshipSUITEBulkReplicateRequest_In – Technical Structure SAP help document here.
  • BusinessPartnerRelationshipSUITEBulkReplicateConfirmation_In – Technical Structure SAP help document here.
  • BusinessPartnerSUITEBulkReplicateConfirmation_In – Technical Structure SAP help document here.

Intuition:

For outbound replication of services, there must be a Business System defined which is the external system that is being integrated. Each external system can be integrated with different objects, which shall be defined by Business Object Type (BO Type) in the system. Business Object can be replicated by different means of channels as mentioned in the Introduction section IDoc via services etc. which shall be defined by Communication Channel. There will be a 1-1 relationship with Communication Channel and Outbound Implementation which serves as the communication structure or format.

 

Replication Model is the vital component which describes the model, what are the services to be used, to which external systems the data must be replicated and the parameters useful for system interfacing.

 

For technical configuration steps, please follow through the detailed blog by Christian Niemann  linked here

 

 

Monitoring:

SAP S/4 HANA sends out the outbound request in real time as soon as the Business Partner is saved. Alternatively, the Web services can also be sent out using transaction DRFOUT. The outbound services are triggered in the background as a separate task once the BP is saved, provided the services are configured to send out. The outbound and Inbound services can be monitored in Message Monitor which is accessed through SRT_MONI.

Based on the selection criteria, the data replicated using web services can be viewed in SRT_MONI on execution

In the Monitor, we could view all the web services that are currently being processed, have been processed or cancelled. By selecting any of the service request in the Monitor, we would able to view the data that is being sent.

 

If the service is of XML, the Message Monitor also provides with a function to view as XML. On selecting Original XML button in the message, which present the message in the xml format as follows.

 

SRT_MONI also provides with an additional tool to debug by restarting when the services are encountered with error.

If unexpected data is being replicated or is in the queue for replication, we would be able to cancel that data replication using SRT_MONI or SRT_MONIS

From SRT_MONI, select the message wanted in view in sequence monitor

 

On SRT_MONIS, define the selections to determine the message to be monitored in sequence.

 

Soft Termination or Hard Termination options are provided to cancel the execution of the messages selected.

 

 

Filtering:

In real time integration of the Business Partner with external systems, we would want to integrate only few Business Partners based on the filter criteria. These filter criteria can be defined in SAP using DRFF .

  • Go to Transaction DRFF

  • Select the Replication Model for which filter needs to be defined and choose create
  • Add the filter criteria and save the filter for the business replication model

 

Please do note that when the replication of the data is being processed manually using webservices through DRFOUT, the configured DRFF filter wouldn’t be considered during replication. DRFF works with system replication settings rather than manual replication. If there is a need to replicate manually using a filter, there is an option provided in DRFOUT to use “Manual Replication Filter Criteria”.

 

Testing :

It is always a good practice to unit test the services, it also useful in presenting and explaining the process flow to the Business.

SAP S/4 HANA without any third party or external applications provides tools to unit test the services within the environment of S/4 HANA, but it would give the basic structural test of the services and data flow of the services. Using external or third-party applications to test the services gives a holistic picture if there are any issues with interfacing or integration or security related issues between the systems.

SPROXY is one such tool which is useful in testing the web services within the environment of SAP S/4 HANA.

To test the services in the system, select the service to test in SPROXY and choose test. Navigate through the tree to the service based on the service you want to test if it is a service provider or service consumer

Test would present with Input options and debugging options to generate a dummy request for analysis or Initial request or to debug the service. It is also possible to import the generated xml request from desktop and test the request.

 

Conclusion

Though this blog provides a direction for Monitoring and testing Business Partner SOAP Web Services in SAP S/4 HANA, this is equally relevant for monitoring and testing any other SOAP Web Services in SAP S/4 HANA.

Assigned Tags

      8 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Harshad Patel
      Harshad Patel

      Nice post...very informative....helped me lot

      Author's profile photo Ashutosh Mishra
      Ashutosh Mishra

      Hi,

      Thank you for this blog. By any chance do you have any blog or information on : - How to create contact person while creating the organization in one change request using Web service.

      Author's profile photo Vutkuri Venkata Sai Charan
      Vutkuri Venkata Sai Charan
      Blog Post Author

      I am assuming you wanted to create the contact person BP , Organization BP and assign the relationship.

      you can refer to the structure of these inbound requests mentioned in the blog

      • BusinessPartnerSUITEBulkReplicateRequest_In – Technical structure SAP help document here.
        • This would create multiple number of BPs sequential based on the node BusinessPartner in one request
      • BusinessPartnerRelationshipSUITEBulkReplicateRequest_In – Technical Structure SAP help document here.
        • This is used for assignment of contact person relationship

      The sequence of the requests must also follow the sequence as mentioned above, first BusinessPartner then BusinessPartnerRelationship

      Author's profile photo Ashutosh Mishra
      Ashutosh Mishra

      Hi,

      Thank you for your input.

      I was checking the service 'BusinessPartnerSUITEBulkReplicateRequest_In' in this we can pass one CATEGORY_CODE at once so how we can create two partners.

      My requirement is in one CR Request create one organization BP and one Person.

       

      Waiting for your input.

      Once again thank you.

      Ashutosh Structure%20image

      Structure image

      Author's profile photo Vutkuri Venkata Sai Charan
      Vutkuri Venkata Sai Charan
      Blog Post Author

      Hello Ashutosh,

      In the request payload you would need to have Multiple BusinessPartner nodes in order to create multiple BPs using single payload or request.

      Author's profile photo Soujanya Puli
      Soujanya Puli

      Hi,

       

      Nice post, thank you for blog.

      We came across the requirement for India rollout where we need to update the IRN E-invoice using webservice "BusinessPartnerSUITEBulkReplicateRequest_In". 

      Here we have added IRNE at Ariba side and enhanced the inbound service adding custom field in S/4 HANA system. We have implemented the BADI to read custom fields. Now we need to map custom IRNE field to output structure of BADI.

      Do you have any idea to which field can we map in output structure for IRNE.

       

      Thanks,

      Soujanya

      Author's profile photo Vutkuri Venkata Sai Charan
      Vutkuri Venkata Sai Charan
      Blog Post Author

      Hello Soujanya,

      Your request seems to be a specific process requirements or process followed at your organization or client. I wouldn't be able to assist you on this platform.

      And to be precise, I am actually not sure of your requirement as IRN E-Invoice is related to Invoice rather than a business partner.

      Author's profile photo Ankit Deshwal
      Ankit Deshwal

      Hi Vutkuri,

       

      Thanks for the awesome blog. Just need one help. We want to capture the field "External BP Number" in the Identification Tab(Business Partner Common Role) to store the legacy number but we couldn't find the field in the payload.