Symptom
When testing and implementing the Service Contract (A2X) API (CE_SERVICECONTRACT_0001), an error is encountered when assigning pricing element directly to the service contract item category SCN2 (Service Contract Item for Price Adaptation): "Omit _ Pricing Element entity for item category SCN2".
Environment
SAP S/4HANA Cloud Public Edition
Cause
According to the below two Help Portal documentations, for SCN2 (Service Contract Item for Price Adaptation), pricing can only be done on the billing request line level, instead of the item level:
(1) Differences in Item Categories:
Property |
Service Contract Item for Ad Hoc Billing |
Service Contract Item for Price Adaptation |
Service Contract Item |
Price Details in item |
Available to add, edit, and delete Note
For a contract item created by copying, you must carry out repricing to activate the condition type Cumulation Condition (PCUM). |
Not available |
Available to add, edit, and delete Note
For a contract item created by copying, you must carry out repricing to activate the condition type Cumulation Condition (PCUM). |
Price Details in billing request line |
Not available |
Available to add, edit, and delete |
Available only for display |
(2) Price Adaptation for Service Contracts:
"For scenarios that require flexible pricing, price adaptation for service contracts offers two methods of achieving this: One is to set a pricing date rule within a billing request line as the pricing date of a service contract item, so that varying prices can be determined according to varying pricing dates. The other method is to maintain the prices of service contract items manually at billing request line level".
Resolution
As per explained in the "Cause" section, to add pricing elements to the billing request line(s) of the SCN2 item using the Service Contract (A2X) API, the solution consists of the below two steps:
- Create the service contract, SCN2 service contract item(s), and the billing request line(s) using deep insert.
Example deep insert request can be found from Service Contract (A2X) - Create Service Contract.
All available properties are listed in Service Contract, which can be added into the payload according to the business requirement. - Create price element(s) to the billing request line(s).
Example request can be found from Service Contract (A2X) - Create Price Element for a Specific Billing Request Line.
Keywords
Service Contract, A2X, API, CE_SERVICECONTRACT_0001, SCN2, Item Category, OData, Error, External Price Adoption, Pricing Element, Pricing Condition, Service Contract Item for Price Adaptation, Billing Request Line , KBA , CRM-S4-SRV-CTR-2CL , S4CRM: Service Contract (Public Cloud) , Problem