2824006 - EmpCostDistribution/EmpCostDistributionItem upsert via OData API and possible errors

When performing an UPSERT to EmpCostDistribution (Alternative Cost Distribution) using the OData API, the following error is returned:

• SAP SuccessFactors HCM Suite

• Employee Central

1. Perform an UPSERT request to create/update EmpCostDistribution and EmpCostDistributionItem.
2. The API response returns the error shown in the Symptom section.

The system is not delimiting the existing record before applying the new one.

As a result, the new UPSERT merges with the old data, causing the total allocation percentage to exceed 100%.

Important processing rules:

• A maximum of 12 cost centers can be assigned per employment.
• The sum of all percentages must not exceed 100%.
• If the sum is less than 100%, the remaining percentage is automatically allocated to the employee’s Foundation Object cost center.
• The Foundation Object cost center can also be included explicitly in the Alternative Cost Distribution portlet.

Use the parameter: purgeType=record 

This ensures the system replaces the existing distribution records instead of merging them.

           

Sample UPSERT Request:

URL: https://<API_URL>/odata/v2/upsert?$format=json&purgeType=record

Payload:

{

  "__metadata": {

    "uri": "EmpCostDistribution"

  },

  "usersSysId": "<inform userId>",

  "effectiveStartDate": "/Date(<inform epochTime>)/",

  "items": [

    {

      "__metadata": {

        "uri": "EmpCostDistributionItem(EmpCostDistribution_usersSysId='<inform userId>',EmpCostDistribution_effectiveStartDate=datetime'<inform UTC date>')"

      },

      "costCenter": "<inform costCenterExternalCode>",

      "percentage": "<inform percentage>"

    }

  ]

}