Employee Central Compound Employee API - help.sap.com

1 Implementation Guide | PUBLIC. Document Version: 2H 2021 2022-03-03. Employee Central Compound Employee API. 2022 SAP SE or an SAP affiliate company. All rights reserved. THE BEST RUN. Content 1 Introduction to the CompoundEmployee API.. 6. 2 CompoundEmployee API: General Information About Full, Snapshot, and Delta Transmission Modes.. 8. Endpoints, WSDL, and State of Service.. 9. Security and Session Management.. 9. Thresholds and Limits of the CompoundEmployee API.. 10. Performance Recommendations for the CompoundEmployee API.

2 11. API Enhancements and Compatibility.. 12. Audit Log and Metering Details.. 13. Setting Up the CompoundEmployee API.. 13. Provisioning Settings for CompoundEmployee API.. 13. Granting Permissions for Full Access to the CompoundEmployee API.. 16. Granting Permissions for Restricted Access to the CompoundEmployee API.. 17. Granting Permissions for Segment Access to the CompoundEmployee API.. 18. Using the CompoundEmployee API..19. Query and QueryMore.. 19. Query Request.. 20. Query Response.. 36.

3 API Metadata Access.. 73. How the CompoundEmployee API Reacts to Data Purge.. 75. Error Handling in the CompoundEmployee API.. 89. 3 Compound Employee API: Snapshot Mode .. 99. Data Purge Handling in Snapshot Mode..100. 4 CompoundEmployee API: Delta Transmission Mode.. 102. Notation for Examples.. 103. Delta Transmission Query Request.. 103. SELECT Items.. 104. Time-Restricted Delta Transmission Support for MDF Objects.. 105. WHERE Expression..106. Select Condition hiringNotCompleted.. 109. Sorting by Start Date in the WHERE Expression.

4 112. Controlling Parameters for Delta Transmission.. 113. Delta Transmission Query Response.. 116. Query Response for Effective-Dated and Period-Based Delta Transmission..116. Action Codes..119. Employee Central Compound Employee API. 2 PUBLIC Content Previous Fields.. 120. Event Information.. 121. Insert New Job Time Slice with Multiple Events.. 122. Insert New Job Time Slice to Existing Time Slice.. 123. Change Event of a Concurrent Time Slice.. 124. Change Not Event Related Job Field of a Concurrent Time Slice.

5 125. Delete Job Time Slice (Active).. 126. Delete Job Time Slice (In Between).. 127. Effective-Dated and Period-Based Delta Transmission.. 128. Effective-Dated Delta Transmission with the CompoundEmployee API..129. Period-Based Delta Transmission with the CompoundEmployee API.. 142. How the CompoundEmployee API Delta Transmission Mode Handles Foundation Objects.. 152. External Codes..152. How the CompoundEmployee API Delta Transmission Mode Reacts to Data Purge.. 155. Special Handling for the CompoundEmployee API Delta Transmission Mode.

6 157. Segments Supporting Delta Transmission..157. Segments Not Supporting Delta Transmission.. 159. Personal Documents with Duplicate Semantic Key.. 159. Support of Specific Attributes.. 160. Issues When Using Select Conditions in the Delta Transmission Mode.. 160. 5 Appendix.. 163. Transient Fields.. 163. Example: Describe and DescribeEx.. 165. Example: Sample Query Requests.. 167. Example: Sample Query Responses.. 168. Employee Central Compound Employee API. Content PUBLIC 3. Change History Learn about changes to the documentation for Employee Central CompoundEmployee API in recent releases.

7 2H 2021. Type of Change Description More Info New We added new information on permis Granting Permissions for Segment Ac . sions to the Compound Employee API. cess to the CompoundEmployee API. [page 18]. Changed We updated the information on the field Picklists, Foundation Objects, and Ge . non-unique external code in the MDF. neric Objects [page 44]. Picklists topic. Employee Central Application Message Error Codes [page 94]. 1H 2021. Type of Change Description More Info Changed We added sample query code for De Example: Describe and DescribeEx scribe and DescribeEx.

8 [page 165]. 2H 2020. What's New Description More Info We've added the Employee Central It's located in the section called Em CompoundEmployee API: Delta Trans . Compound Employee API: Delta Trans ployee Central Compound Employee mission Mode [page 102]. mission Mode to this guide. API: Delta Transmission Mode. We've rearranged the structure of the Introduction to the CompoundEm . whole guide. ployee API [page 6]. New employment cost assignment seg We've added a new segment Employee Cost Assignment [page 55].

9 Ment EmpCostAssignment. You can use SELECT Clause [page 21]. it to replicate public-sector- specific data like fund, fund center and grant to Query Response Structure [page 38]. payroll systems. Employee Central Compound Employee API. 4 PUBLIC Change History What's New Description More Info New segment in the Purge Status Ob We've added information about the Structure of the Purge Status Overview ject rehiredAtDateTime attribute. Segment [page 76]. entities Supporting Purge Status Over . view [page 79].

10 Employee Central Compound Employee API. Change History PUBLIC 5. 1 Introduction to the CompoundEmployee API. The CompoundEmployee application programming interface (API) for SAP SuccessFactors Employee Central is used to extract Employee data out of Employee Central . The CompoundEmployee API is based on the Simple Object Access Protocol (SOAP). It replicates Employee master data from Employee Central to SAP systems, payroll systems, and benefits systems. Key Features The API returns all requested data of an Employee in a single call providing a hierarchically structured response.