SAP Knowledge Base Article - Public

2971238 - Background Element upsert 'Two beans have the same order position' error - SAP SuccessFactors HXM Suite OData API


When upserting a background entity (any which has 'Background_' as a prefix), an error message similar to this one is returned in the response:

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.


  • SAP SuccessFactors HXM Suite
    • OData API


  1. This error indicates that the record you're upserting has the same 'bgOrderPos' (order position) value of another record associated to the user. The bgOrderPos field determines the order in which the records are shown in the employee's profile UI portlet, so the value for each record must be different.
    For example, if one user has 2 Background_InsideWorkExperience records, one will have bgOrderPos = 1 and the other will have bgOrderPos = 2. If you try to upsert a third record passing the value bgOrderPos = 2, the error will occur;
  2. You also may be facing this issue due to upserting a 'bgOrderPos' value that is too large. The current limit is around 7 digits, but it will be increased as of the b2011 release (November 2020).


To prevent this, you may pass the value bgOrderPos = -1 in the API call. This will trigger a system function that calculates the next available bgOrderPos for that specific background entity and user, and insert the new record with that value. Going back to the presented 'Background_InsideWorkExperience' example in the section above, the system will attribute bgOrderPos = 3 to the new record.


background element, order, pos, position, fails, failed, not able, can't, Background_, api, insert, add, EDU-16519 , KBA , LOD-SF-INT-ODATA , OData API Framework , LOD-SF-INT , Integrations , Problem


SAP SuccessFactors HXM Suite all versions