SAP Knowledge Base Article - Public

2877580 - Error "Please add required properties in payload. Required property externalCode is missing." on Payroll Unified Configuration


You try to editting an object like Pay Statement on Payroll Unified Configuration screen, you get the error below:

System Configuration Error Found
Please add required properties in payload. Required property externalCode is missing. You can check which properties are required for an entity in Admin Center > OData API Data Dictionary or the entity metadata.


  • SAP SuccessFactors HXM Suite

Reproducing the Issue

  1. Open Payroll Unified Configuration
  2. Click on Portlets
  3. Change the name of the Pay Statement field
  4. Click on save
  5. Error message is shown.


  1. Go to Admin Center
  2. Under tools, search for Configure Object Definition
  3. In the first dropdown of Search menu, select "Object Definition" and in the second dropdown select "Payroll System Configuration"
  4. Check the details of "externalCode" field
  5. Change the "Visibility" property to "Not Visible"


successfactors, success factors, sf, sfsf, ec, payroll, mashup, edit, change, update, Payroll Unified Configuration, validation error found for, saving , KBA , LOD-SF-INT-MAS , SAP Payroll Mashups , LOD-SF-INT , Integrations , LOD-SF-INT-EC , Employee Central SFAPI & OData Entities , Problem


SAP SuccessFactors HXM Suite all versions