SAP Knowledge Base Article - Public

3713055 - Parent Segment doesn't show 'CHANGE' when Child Segment has been modified - Compound Employee API

Symptom

When consuming the CompoundEmployee API in delta mode, the integration receives a parent segment (e.g., compensation_information) with an action="NO CHANGE" attribute, even though a child sub-segment (e.g., paycompensation_recurring) has been inserted, updated, or deleted.

Environment

  • SAP SuccessFactors Employee Central
    • Compound Employee API

Reproducing the Issue

Run Compound Employee API call with Delta Transmission Mode

Cause

This behavior is by design and follows the hierarchical processing logic of the SuccessFactors CompoundEmployee API.

  • Segment Independence: Action codes are calculated at the individual segment level. A segment only receives a CHANGE action if a field physically located within that specific segment is modified or the record deleted.
  • Structural Integrity: If a child segment (sub-segment) is modified, the API must include the parent segment (super-segment) in the XML payload to provide the necessary context and hierarchy.
  • Container Logic: If the parent's own fields were not modified, the API returns the parent with action="NO CHANGE" to serve as a "wrapper" for the modified child.

Resolution

Integration logic must be designed to handle "Nested Changes." Do not discard data based solely on the parent action code.

  • Logic Requirement: The middleware should iterate through all sub-segments of a NO CHANGE parent.
  • Effective Change Check: A record should be considered "modified" if:
    • The Parent segment action is CHANGE, INSERT, or DELETE.
    • OR any nested Child segment action is CHANGE, INSERT, or DELETE.
  • Key Fields: Always extract the key fields (like externalCode or start_date) from the NO_CHANGE parent to correctly identify the target record for the child update.
IF YOU CHANGEPARENT ACTIONCHILD ACTION
Only a Parent fieldCHANGENO CHANGE
Only a Child fieldNO CHANGECHANGE
Delete a ChildNO CHANGEDELETE
Both Parent and Child fieldsCHANGECHANGE

Keywords

compound employee api, pay component changes, compensation information, action code change, action code no change, test environment, successfactors, api response, pay component deletion, compensation interface , KBA , LOD-SF-INT-CE , Compound Employee API , Problem

Product

SAP SuccessFactors HCM Suite all versions