Definition
An interface to create transfer of employees from a source system or file.
Business Context and Use
The web service interface 'Manage Personnel Transfer In' enables you to connect external applications to your SAP Business ByDesign system and to maintain Employee transfer data, and is relevant if your company wants to manage Employee Transfer data from external applications through its operation 'MaintainBundle'.
The following is an example of a simple transfer request in which an employee is transferred from previous organization to new Organization 'MC23300':
<n0:PersonnelTransferBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
<BasicMessageHeader>
<ID >005056AA3D441EE3899ADAB5A4E15025</ID>
<ReferenceID>Token10</ReferenceID>
</BasicMessageHeader>
<PersonnelTransfer actionCode="01">
<ObjectNodeSenderTechnicalID>14</ObjectNodeSenderTechnicalID>
<ChangeStateID></ChangeStateID>
<TransferDate>2015-01-24</TransferDate>
<!-- Employee ID!-->
<EmployeeID>3836</EmployeeID>
<AgreedWorkingHoursRate>
<DecimalValue>38</DecimalValue>
<BaseMeasureUnitCode>WEE</BaseMeasureUnitCode>
</AgreedWorkingHoursRate>
<!-- New Organization Assignment !-->
<OrganisationalCentreID>MC23300</OrganisationalCentreID>
<JobID>MC3000</JobID>
</PersonnelTransfer>
</n0:PersonnelTransferBundleMaintainRequest_sync>
Prerequisites
Personnel Administration should be in scope.
Constraints and Integrity Conditions
This service can only be used for transferring employees once in any system. Hence, only '01 = create' action code is supported in this service. All other action codes are hereby not supported.
More Information
General information
You can find general information about Web services, their structure and consumption in the Web Services documentation. Please open the Web Services document in a new window.
The following is an example of a web service request for employee transfer:
<n0:PersonnelTransferBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
<BasicMessageHeader>
<ID >005056AA3D441EE3899ADAB5A4E15025</ID>
<ReferenceID>Token10</ReferenceID>
</BasicMessageHeader>
<PersonnelTransfer actionCode="01">
<ObjectNodeSenderTechnicalID>14</ObjectNodeSenderTechnicalID>
<ChangeStateID></ChangeStateID>
<TransferDate>2015-01-24</TransferDate>
<!-- Employee ID!-->
<EmployeeID>3836</EmployeeID>
<AgreedWorkingHoursRate>
<DecimalValue>38</DecimalValue>
<BaseMeasureUnitCode>WEE</BaseMeasureUnitCode>
</AgreedWorkingHoursRate>
<!-- New Organization Assignment !-->
<OrganisationalCentreID>MC23300</OrganisationalCentreID>
<JobID>MC3000</JobID>
</PersonnelTransfer>
</n0:PersonnelTransferBundleMaintainRequest_sync>
Definition
To maintain a bundle of transfers of employees.
Business Context and Use
The web service interface 'Manage Personnel Transfer In' enables you to external applications to your SAP Business ByDesign system and to transfer an employee from one organization to another in your system, and is relevant if your company wants to access and manage employee data from external applications.
The request message of the operation MaintainBundle contains a BasicMessageHeader node element as well as PersonnelTransfer node element that contains the employee data to be maintained. The detailed structure of the PersonnelTransfer node will be explained in the following sub-chapters.
The PersonnelTransfer node can occur multiple times in the request message – this means that Personnel Transfer data for multiple employees can be maintained through a single web service request.
The response message type of the operation MaintainBundle contains log items, processing information and an account-specific node with ReferenceObjectNodeSenderTechnicalID, ChangeStateID, as well as employee UUID.
Prerequisites
Personnel Administration should be in scope.
Structure
The structure of operation Maintain Bundle contains general information of employee as well as Work Agreement & Organization Assignment nodes.
The data is visible on Personnel File screen under Personnel Administration work center when Personnel Administration is scoped in the system.
The UUID element is not visible on the user interface but may be known out of the response of a read service.
The following are the details of each node structure of Personnel Transfer maintain bundle:
Work Agreement
Work Agreement node can be used to create work agreement for an employee. In case of transfer, only agreed working hours will be updated against the existing work agreement.
Most commonly used BaseMeasureUnitCode are -
| Base Measure Unit Code |
Description |
| DAY |
Day |
| MON |
Month |
| WEE |
Week |
Organization Assignment
Organization Assignment node carries the employee’s organization assignment as well as job assignment data. SAP Business ByDesign application internally handles position mapping with Organization and Job Assignment data and external applications can only be concerned about providing Organization and Job data in expected format.
An employee's new organization assignment comes into effect from the transfer date provided in the request and existing Organization and Job Assignment data is split with validity dates accordingly.
Example
Example -
The following is an example of an XML snippet which will transfer an employee from his current organization to a new organization on 24 Jan 2015:
<n0:PersonnelTransferBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global">
<BasicMessageHeader>
<ID >005056AA3D441EE3899ADAB5A4E15025</ID>
<ReferenceID>Token10</ReferenceID>
</BasicMessageHeader>
<PersonnelTransfer actionCode="01">
<ObjectNodeSenderTechnicalID>14</ObjectNodeSenderTechnicalID>
<ChangeStateID></ChangeStateID>
<!-- Transfer Date !-->
<TransferDate>2015-01-24</TransferDate>
<!-- Employee ID!-->
<EmployeeID>3836</EmployeeID>
<AgreedWorkingHoursRate>
<DecimalValue>38</DecimalValue>
<BaseMeasureUnitCode>WEE</BaseMeasureUnitCode>
</AgreedWorkingHoursRate>
<!-- New Organization Assignment !-->
<OrganisationalCentreID>MC23300</OrganisationalCentreID>
<JobID>MC3000</JobID>
</PersonnelTransfer>
</n0:PersonnelTransferBundleMaintainRequest_sync>
Constraint
The Manage Personnel Hiring – Maintain Bundle can only be used for internal employees.