After scope item 2EL and 2EJ are set up, EDI maintained as the output channel of purchase orders will trigger the creation of corresponding sales order by saving this purchase order. At this time, the following error messages are found in Fiori App 'Message Dashboard'.
- An unexpected exception has been triggered by the application - 601(EDI_SD)
- The text procedure cannot be determined - 029(EDI_SD)
This KBA is only used for Cloud-to-Cloud Integration.
SAP S/4HANA Cloud
Reproducing the Issue
- Scopo Item 2EJ and 2EL are set up in the S/4HANA Cloud system;
- A purchase order with output channel as EDI is created and saved;
- In Fiori App 'Message Dashboard', errors above are displayed for this API request.
The errors are caused by a missing Customer Material record in Fiori App 'Manage Customer Materials'.
The API fills the value of field <BuyerProductID> from the payload into the Customer Material field in the sales order. However no material is found since there is no corresponding entry existing for this sales organization, distribution channel, customer and material.
In other words, for each material that customers order through EDI, a customer material must be maintained. The customer material maps the ID, which the customer uses for the material ordered, to a material.
The determination sequence is as following.
Customer Material field (VBAP-KDMAT) → Material field (VBAP-MATNR) → Item Category field (VBAP-PSTYV) → Text Procedure field (VBAP-TXTGR)
Maintain a Customer Material record with the following fields in Fiori App 'Manage Customer Materials':
- Sales Organization
- Distribution Channel
- Customer number
- Material Number
- Material Number Used by Customer
For more details, please refer to '2.2.8 Maintain Customer Material' of Setting Up Integration of Sales with External Buyers (2EL).
API OrderRequest_In from SAP API Hub
Business Documentation of API OrderRequest_In
Fiori App 'Manage Customer Materials'
Trouble Shooting Blog
SAP Best Practise Explorer - Integration of Procurement with External Suppliers (2EJ)
SAP Best Practise Explorer - Integration of Sales with External Buyers (2EL)
OrderRequest_In, 029(EDI_SD), category_code, CL_EDI_SD_ORDR_ENRICHMENT, IF_EDI_SD_ORDR_ENRICHMENT, VBAP-PSTYV, TVAP-TXTGR, 601(EDI_SD), SAP_COM_0223, IF_EDI_SD_ORDR_ENRICHMENT~READ_ITEM_TEXT_PROCEDURE, tvap~txtgr, CL_EDI_SD_ORDR_API, MANIPULATE_ITEM_TEXT_ID, MATNR, KDMAT, KNMT, Customer Material, Manage Customer Materials, KNMT-VKORG, KNMT-VTWEG, KNMT-KUNNR, KNMT-MATNR, KNMT-KDMAT
, KBA , SD-SLS-EDI , S/4HANA: Sales EDI Messages , SD-SLS-API , API , CA-GTF-AIF , Application Interface Framework , Problem