Symptom
- Unable to add a new item to an existing purchase order via interface using the Purchase Order OData V4 API.
- Material substitution from an external sales order is not reflected in the purchase order when the PO item is linked to a sales order (item category H).
- Attempts to update the existing PO item with a new material via interface are unsuccessful.
- No specific error messages or error codes are returned.
Environment
SAP S/4HANA Cloud Public Edition
Reproducing the Issue
- Create a purchase order with an item linked to a sales order (item category H).
- Trigger material substitution in the external sales order.
- Attempt to add a new item to the existing Purchase Order via the Purchase Order OData V4 API.
- Attempt to update the existing PO item with the substituted material via the interface.
- Observe that the new item is not added and the material update is not reflected, with no error message returned.
Cause
Purchase Order items linked to a Sales Order (item category h) do not permit material substitution on the existing item, so interface updates to replace the material fail.
Resolution
- Use the Purchase Order API service API_PURCHASEORDER_PROCESS_SRV to create a new line item in the existing Purchase Order.
- While creating the new item, do not set account assignment category H, so the item remains independent of the Sales Order linkage.
- If required, delete or mark the original sales-order-linked item for deletion instead of attempting material substitution.
- Refer to the official API documentation: for correct payload structure and endpoints for creating and updating Purchase Order items.
- SAP Business Accelerator Hub
Keywords
purchase order, add new item, odata v4, api_purchaseorder_process_srv, item category h, sales-order linked po, third-party, account assignment h, interface update, material substitution, po item creation, s/4hana cloud public edition, procurement api, po update fails, create po line item , KBA , MM-PUR-PO-2CL , Purchase Orders (Public Cloud) , Problem
Product
SAP S/4HANA Cloud Public Edition all versions
SAP Knowledge Base Article - Public