Skip to Content
Author's profile photo Former Member

SAP PI: Using the B2BADDON EDIXML Convertor Modules – Basics

The B2BADDON EDI<>XML Convertor Modules are used with SAP Process Integration adapters to convert business documents encoded in EDI message standards into XML and vice versa.

These modules are available for the below EDI standards


Ansi X.12




Plain Text

These modules can be used along with the PI transport protocol adapters(Inbound & Outbound) to convert the EDI message standards into EDI- XML and vice versa. To use this feature, the B2BADDON and the required convertor modules must be deployed in to the SAP PI.

The following are the Convertor modules available for the supported EDI standards


The EDI-XML XSDs for the various EDI standards can be generated using the XSD generation option available in the EDI Maintenance GUI



Below is an example for AnsiX12 850 version 004010 EDI-XML schema generation


The generated XSD can be imported to the ESR as external definition and can be used for Message mappings and Service Interface creation


The ANSI X.12 EDI Convertor module configuration in the Sender adapter (File) is as shown below. The convertor module must be mentioned as the first module in the processing sequence


ANSI X.12 EDI 850 document is used in this example as input to the File Sender adapter and the converted result EDI-XML looks like as below. This EDI-XML can be mapped and processed as per the requirement


The same ANSI X.12 EDI Convertor module is used in the Receiver adapter to convert the ANSI X.12 EDI-XML data to the EDI format as shown below. The convertor module must be mentioned as the first module in the processing sequence.


The EDI output file (ANSI X12 850) is generated from the EDI-XML as shown below


In the similar way, the EDI convertor module can be configured for the other EDI standards for the supported adapter types.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Zameer Hamza Farook
      Zameer Hamza Farook

      Hi Arun,

      Thanks for this blog on the new B2B add on Converter Modules.

      Author's profile photo Former Member
      Former Member

      Thx for the blog 😉

      Can this also be setup to map an outbound IDOC from ECC to a EDI flatfile format (the edi format is not currently supported in SAP PI B2B addon)?

      Author's profile photo Former Member
      Former Member

      No, The tool only supports the EDI XML format as input

      Author's profile photo Former Member
      Former Member


      I am wondering what permissions are required to make changes in the webdynpro/dispatcher/ page?

      For instance I access it as J2EE_Admin and get a "Your user has
      Read-Only permissions!
      " error.


      Author's profile photo Former Member
      Former Member

      Dear Thomas,

                 If you are on B2B Addon SP1 could you also add the role

      SAP_XI_B2B_CONFIGURATOR_J2EE ? The additional roles for modification of content are now added in SPI and described in the securty guide on Page 17.

      Author's profile photo Ramesh Gulipalli
      Ramesh Gulipalli

      Hi Arun,

      What are configuration required for  EDI content manger. While testing the EDI ANIS X12 850 convert from EDI to XML in EDI Content Manger. Please find the below error Error occured at X12 document character 431: Can not find segment MTX for CTRL_KEY 1, VERSION 004010 and SET_NAME 850 from segment L_PO1

      Author's profile photo Dimitri Sannen
      Dimitri Sannen

      Hi Ramesh,

      Make sure to have the correct runtime content loaded into the EDI content manager.

      Next, generate an XSD and use that within the ESR.

      Seems that the EDI content manager content <> ESR content

      Kind regards,


      Author's profile photo OH SE WOON
      OH SE WOON


      It's very helpful to me.

      But, because Converter Module name is case-sensitive,

      Could you please change from localejbs/EDIFACTConverterModule to localejbs/EdifactConverterModule in table?

      Kind regards,

      Sewoon Oh

      Author's profile photo Former Member
      Former Member


      its very good information about the configuration.

      we have did the same steps as you mentioned. but we are not getting the field separator

      " * " and  End of line as " ~ " in the X12 file generated.

      Is their any specific settings needs to be done to get the field separator and End of line ?


      Sol man 

      Author's profile photo Yee Loon Khoo
      Yee Loon Khoo

      Hi Solman,

      Please see this link. It is set at message mapping, ISA segment of the X12 message type.

      field separator = D_DATAELEMENTSEPARATOR
      end of line = D_SEGMENTTERMINATOR


      Yee Loon

      Separators in ANSI X12 EDI Message

      Author's profile photo Former Member
      Former Member


      can I also generate new plain 2 xml rules in the B2B addon by a provided existing XSD file?

      This would be really helpful.

      Best regards,


      Author's profile photo Appala Naidu Uppada
      Appala Naidu Uppada

      Yes. We have option to import XSD in EDI Content Manager ->Plain-> Import.

      Author's profile photo Christian Schmitt
      Christian Schmitt



      is it possible to Import an XSD generated of an existing Message Type in ESR?
      If I try this, I always get the error message "Uploaded file is not a valid file. Please choose a valid file."

      ( I need to map something in an Edifact file before sending it to the Converter, so I transformed it to some generic data type. If I write the file to the hard disc using Content Conversion of the FTP Adapter, I can send it to the EDI Converter afterwards using another ICO, but I would like to be able to do this without the FTP step in the module chain.)

      Thank you

      Author's profile photo René Preß
      René Preß

      Hello Christian,

      could you solve the failed XSD import in EDI Content Manager? I am also facing this issue.

      Best regards


      Author's profile photo Christian Schmitt
      Christian Schmitt

      Hi René,

      to be honest - I don't remember. I know I implemented that scenario somehow, and I am pretty sure I did not pursue that approach any more (cause posting a question here is always last resort, and I did not get an answer...).
      Something with an XSLT mapping in MessageTransformBean keeps coming to my mind, but I cannot check, sorry, not working for this customer any more.


      Kind regards




      Author's profile photo René Preß
      René Preß

      Hi Christian,

      thank you anyway, I will proceed trying to get this done somehow!

      Best regards


      Author's profile photo Former Member
      Former Member

      Hi Expert:

      Two years ago I reference this article to import B2B addon. But now for license issue we should remove these B2B Add-on. Could I just remove B2B component from ESR or need any nessary step? Thanks for your help.