3771047 - Error PRC_RAP/032 when creating header condition via Preliminary Billing Document API - SAP S/4HANA Cloud Public Edition

Error message: PRC_RAP/032 "CONDITIONRATEAMOUNT must not be changed due to configuration of the condition type." occurs when trying to create a condition record at the Preliminary Billing Document (PBD) header level using the Preliminary Billing Document API.

Example Payload:

{

 "ConditionType": "ZADM",
 "ConditionRateAmount": 8.88

} 

SAP S/4HANA Cloud Public Edition

The issue is driven by the calculation type configuration of the custom condition type used; it is configured with calculation type A (percentage). For percentage-based condition types, the SAP Pricing Engine RAP framework expects the rate value to be provided as a ratio percentage, not as a flat currency amount; using 'ConditionRateAmount' causes the validation error.

1. Replace 'ConditionRateAmount' in the POST payload with 'ConditionRateRatio' to pass the percentage value.
2. Provide the percentage units explicitly by setting 'ConditionRateRatioISOUnit' to 'P1' and ConditionRateRatioSAPUnit to '%'.

Example Payload:

{
  "ConditionType": "ZADM",
  "ConditionRateRatio": 8.88,
  "ConditionRateRatioISOUnit": "P1",
  "ConditionRateRatioSAPUnit": "%"
}

prc_rap/032, preliminarybillingdocument api, pbd header condition, pricingdocumentelement, condition type percentage, calculation type a, conditionrateamount, conditionrateratio, percentage unit p1, odata v4, rap pricing engine, preliminary billing document, header condition error, s/4hana cloud public edition , KBA , SD-MD-CM-2CL , Conditions and Condition Maintenance (Public Cloud) , Problem