Skip to Content

I am currently helping out on a customer project where the ByDesign customer wants to send out purchase orders to a supplier.

In this blog post I want to share what I found out during this project of how you can directly connect ByDesign and a third-party application.

I am far away from being an expert in B2B connectivity, nor am I a developer. Therefore please bear with me in case the following information is not complete. I’m happy to hear any corrections or additional information.

I know that a Connectivity Guide is in the works and once finished I will add a link to it here later.


The connection between ByDesign and a third-party system such as a supplier or a customer is primarily defined in the so called Communication Arrangement.

Communication Arrangements can be defined in ByDesign in the Application and User Management work center.

To be able to do that though you need some basic prerequisites.


Business Configuration/Scoping

In the Business Configuration of your system you need to select the business documents that you want to send or receive electronically to or form your business partners.


Screenshot 1: Scoping of electronic exchange of Purchase Order and Purchase Order Acknowledgment

Unique identification numbers of business partners

You need to define unique identifiers to the outside for your business partner and your own company, such as a DUNS number or a Global Location Number

For your customers or suppliers you can define them in the master data:


Screenshot 2: DUNS number or Global Location Number in supplier master

In addition you need to define your identification number at the business partner there:


Screenshot 3: Customer ID at Supplier in supplier master

For your own company you have to edit your organizational structure in the Organizational Management work center:


Screenshot 4: DUNS number and Global Location Number in org structure

Communication Arrangement

Depending on the xml-format you want to share with your business partners there are different ways of how you can set up communication arrangements.

SAP ESD format

To use the SAP ESD xml format create a new communication arrangement from the Communication Arrangements view in the Application and User Management work center.

Select Purchase Order Integration (B2B).

On step two select the business partner (and your own company) that you want to connect to.


Screenshot 5: Business partner selection in communication arrangement

On step three of the guided activity define the host name you want to connect to or click Edit Advanced Settings to be able to even change things like the port number (default is 443). By default the authentification method is a client certificate but you can also change that to a username and password.


Screenshot 6: Technical data of communication arrangement for SAP ESD format

SOAP/Idoc format

In case you want to send your purchase order in an idoc format you can start your communication arrangement definition directly from a supplier master by clickint the Maintain XML Settings button in the Collaboration view. Make sure you select the right business document in the table before you click the button.


Screenshot 7: Where to maintain XML settings for Idoc xml files

Again maintain the technical data such as the host name in the communication arrangement


Screenshot 8: Technical data definition in communication arrangement

Output of business document

Once a communication arrangement has been defined you are finally able to see and select the XML entry as an Output Channel in the supplier master.


Screenshot 9: Output channel selection in supplier master

The next purchase order will automatically be sent via XML but you can always manually change the channel in each purchase order.


Screenshot 10: Success message about sent purchase order

Error Handling

In the Business Communication Monitoring view in the Application and User Management work center you can always have a look at the business communication messages you sent and received. In case something went wrong with a message you can see the error message and also have a look at the xml-file directly by clicking Show Payload.


Screenshot 10: Business Communication Monitoring view


Setting up a direct integration with a supplier or a customer is fairly easy in ByDesign. Even a non-developer like me can do that.

Nevertheless this can be a lot of work especialy if you have to communicate and coordinate with multiple business partners at once because nearly at each business partner a mapping between SAP ESD or Idoc and their own xml format needs to be done. This can take up to several weeks for each business partner. I therefore want to mention two more possibilities here:

  1. SAP also offers services for such an integration including the all new Information Interchange OnDemand solution. This solution already supports a mapping to a lot of business partner systems. You can find more information here:
  2. SAP Business ByDesign partnered with Alligacom to offer our customers more choices to integrate via EDI. Alligacom is fully integrated with ByDesign and works out of the box. For more information check out the SAP Store here.
To report this post you need to login first.


You must be Logged on to comment or reply to a post.

      1. Andreas Eissmann

        Hi Christian, I never configured it before but we have some prospects they are interested in. I think I have to do it in near future :-), so thanks for your blog.

  1. John Kearns

    Christian, this is very helpful.  However, as a point of clarification, I believe this functionality and the related document referenced above are related to integration with other SAP systems.  For integration with a non SAP ERP, you would need to implement EDI such as is offered by Alligicom.

    1. Christian Happel Post author

      Hi John, glad you like the post.

      This is working also for non SAP solutions. In fact the project two years ago connected ByDesign to a non-SAP system.

      Best, Christian

  2. Mikolaj Minczyk

    Hi Christian,


    Thanks for this artilce, it helped me a lot, but also brought some additional questions.

    In the ‘Error Handling’ part You have chosen a SAP ESC payload. I tried to do the same with IDOC, but it’s still in “grey”. Ufortunately I need to see the IDOC payload and don’t know how to do it.

    I wonder if You could share with me some advice or tips to manage with a problem?


    Best regards,

    Mikołaj Mińczyk

    1. Christian Happel Post author

      I’m sorry Mikolaj, I’m not involved in any ByDesign projects anymore since a few years. I hope someone else will be able to help you with your problem.

  3. Akif Farhan



    Thanks for the great article.

    I am facing one issue here.I am using the standard b2b integration scenario of ByD with SAP ERP (S4HANA) And I am getting the following error.

    SOAP:1.023 SRT: Processing error in Internet Communication Framework: (“ICF Error when receiving the response: ICM_HTTP_SSL_ERROR”)

    Clearly it looks like SSL certificate error. I have uploaded the certificate from Communication Arrangement to SAP ERP and also uploaded the certificate from SAP ERP to communication arrangement. But looks like something is still wrong with the certificates. Can you briefly advise which certificates are mandatory for this integration and how to fix this error. Thank you very much


    1. Christian Happel Post author


      I’m sorry Akif. It’s been a couple of years since I moved to other projects at SAP. I suggest you post this as a question in the ByDesign section of the Community.


Leave a Reply