SAP HR_PREPARE_NEW_EE Function Module for Transfer Employee Data to SAP System

Search SAP Function Modules

HR_PREPARE_NEW_EE is a standard hr prepare new ee SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Transfer Employee Data to SAP System processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.

See here to view full function module documentation and code listing for hr prepare new ee FM, simply by entering the name HR_PREPARE_NEW_EE into the relevant SAP transaction such as SE37 or SE38.

Function Group: HRAI
Program Name: SAPLHRAI
Main Program: SAPLHRAI
Appliation area: P
Release date: 08-Aug-1997
Mode(Normal, Remote etc): Remote-Enabled
Update:

Function HR_PREPARE_NEW_EE pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.

CALL FUNCTION 'HR_PREPARE_NEW_EE'"Transfer Employee Data to SAP System
  EXPORTING
*  HIREDATE =  "Hiring Date
*  LASTNAME =  "Last Name
*  FIRSTNAME =  "First Name
*  MIDDLENAME =  "Middle Name
*  SECONDNAME =  "Second Name
*  ACADEMICGRADE =  "Academic Title
*  ARISTROCATICTITLE =  "Aristocratic Title
*  SURNAMEPREFIX =  "Name Prefix
*  SECONDACADGRADE =  "Second Title
*  INITIALS =  "Initials
*  KNOWNAS =  "Known as
*  EMPLOYEENUMBER =  "Employee Number (if Internal Applicant)
*  SSN =  "Social Insurance Number (US)
*  FORMOFADDRESS =  "Form of Address
*  GENDER =  "Gender
*  DATEOFBIRTH =  "Date of Birth
*  COUNTRYOFBIRTH =  "Country of Birth
*  STATEOFBIRTH =  "State (Birth)
*  BIRTHPLACE =  "Place of Birth
*  NATIONALITY =  "Nationality
*  NATIONALITY2 =  "Second Nationality
*  NATIONALITY3 =  "Third Nationality
*  PERSONNELAREA =  "Personnel Area
*  CORRESPONDLANGUAGE =  "Correspondence Language
*  MARITALSTATUS =  "Marital Status
*  MARITALSTATUSSINCE =  "Marital Status Valid from
*  NUMBEROFCHILDREN =  "No. of Children
*  CONAME =  "C/O Name
*  STREET =  "Street
*  SCNDADDRESSLINE =  "2nd Address Line
*  CITY =  "City
*  ZIPCODE =  "Postal Code
*  COUNTRY =  "Country
*  PERSONNNELSUBAREA =  "Personnel Subarea
*  STATE =  "State
*  TELEPHONENUMBER =  "Telephone Number
*  BANKKEY =  "Bank Number
*  BANKACCOUNTNUMBER =  "Bank Account Number
*  ETHNICORIGIN =  "Ethnic Origin
*  MILITARYSTATUS =  "Military Status
*  RELIGION =  "Religious Denomination
*  DISABILITY =  "Challenge
*  VETERANSTATUS =  "Veteran Status
*  APPLICANTNUMBER =  "Applicant Number
*  EMPLOYEEGROUP =  "Employee Group
*  ETHNICITY =  "Ethnicity
*  RAC01 =  "Race 1
*  RAC02 =  "Race 2
*  RAC03 =  "Race 3
*  RAC04 =  "Race 4
*  RAC05 =  "Race 5
*  RAC06 =  "Race 6
*  RAC07 =  "Race 7
*  RAC08 =  "Race 8
*  RAC09 =  "Race 9
*  EMPLOYEESUBGROUP =  "Employee Subgroup
*  RAC10 =  "Race 10
*  IBAN =  "IBAN (International Bank Account Number)
*  ORGUNIT =  "Organizational Unit
*  POSITION =  "Position
*  JOB =  "Job

 IMPORTING
   ERROR =  "Error Message

TABLES
*  EDUCATION =  "Education and Training
*  FORMEREMPLOYER =  "Previous Employers

.

IMPORTING Parameters details for HR_PREPARE_NEW_EE

HIREDATE - Hiring Date

Data type: P0000-BEGDA
Optional: Yes
Call by Reference: No ( called with pass by value option)

LASTNAME - Last Name

Data type: P0002-NACHN
Optional: Yes
Call by Reference: No ( called with pass by value option)

FIRSTNAME - First Name

Data type: P0002-VORNA
Optional: Yes
Call by Reference: No ( called with pass by value option)

MIDDLENAME - Middle Name

Data type: P0002-MIDNM
Optional: Yes
Call by Reference: No ( called with pass by value option)

SECONDNAME - Second Name

Data type: P0002-NAME2
Optional: Yes
Call by Reference: No ( called with pass by value option)

ACADEMICGRADE - Academic Title

Data type: P0002-TITEL
Optional: Yes
Call by Reference: No ( called with pass by value option)

ARISTROCATICTITLE - Aristocratic Title

Data type: P0002-TITL2
Optional: Yes
Call by Reference: No ( called with pass by value option)

SURNAMEPREFIX - Name Prefix

Data type: P0002-NAMZU
Optional: Yes
Call by Reference: No ( called with pass by value option)

SECONDACADGRADE - Second Title

Data type: P0002-VORSW
Optional: Yes
Call by Reference: No ( called with pass by value option)

INITIALS - Initials

Data type: P0002-INITS
Optional: Yes
Call by Reference: No ( called with pass by value option)

KNOWNAS - Known as

Data type: P0002-RUFNM
Optional: Yes
Call by Reference: No ( called with pass by value option)

EMPLOYEENUMBER - Employee Number (if Internal Applicant)

Data type: P0000-PERNR
Optional: Yes
Call by Reference: No ( called with pass by value option)

SSN - Social Insurance Number (US)

Data type: P0002-PERID
Optional: Yes
Call by Reference: No ( called with pass by value option)

FORMOFADDRESS - Form of Address

Data type: P0002-ANRED
Optional: Yes
Call by Reference: No ( called with pass by value option)

GENDER - Gender

Data type: P0002-GESCH
Optional: Yes
Call by Reference: No ( called with pass by value option)

DATEOFBIRTH - Date of Birth

Data type: P0002-GBDAT
Optional: Yes
Call by Reference: No ( called with pass by value option)

COUNTRYOFBIRTH - Country of Birth

Data type: P0002-GBLND
Optional: Yes
Call by Reference: No ( called with pass by value option)

STATEOFBIRTH - State (Birth)

Data type: P0002-GBDEP
Optional: Yes
Call by Reference: No ( called with pass by value option)

BIRTHPLACE - Place of Birth

Data type: P0002-GBORT
Optional: Yes
Call by Reference: No ( called with pass by value option)

NATIONALITY - Nationality

Data type: P0002-NATIO
Optional: Yes
Call by Reference: No ( called with pass by value option)

NATIONALITY2 - Second Nationality

Data type: P0002-NATI2
Optional: Yes
Call by Reference: No ( called with pass by value option)

NATIONALITY3 - Third Nationality

Data type: P0002-NATI3
Optional: Yes
Call by Reference: No ( called with pass by value option)

PERSONNELAREA - Personnel Area

Data type: P0001-WERKS
Optional: Yes
Call by Reference: No ( called with pass by value option)

CORRESPONDLANGUAGE - Correspondence Language

Data type: P0002-SPRSL
Optional: Yes
Call by Reference: No ( called with pass by value option)

MARITALSTATUS - Marital Status

Data type: P0002-FAMST
Optional: Yes
Call by Reference: No ( called with pass by value option)

MARITALSTATUSSINCE - Marital Status Valid from

Data type: P0002-FAMDT
Optional: Yes
Call by Reference: No ( called with pass by value option)

NUMBEROFCHILDREN - No. of Children

Data type: P0002-ANZKD
Optional: Yes
Call by Reference: No ( called with pass by value option)

CONAME - C/O Name

Data type: P0006-NAME2
Optional: Yes
Call by Reference: No ( called with pass by value option)

STREET - Street

Data type: P0006-STRAS
Optional: Yes
Call by Reference: No ( called with pass by value option)

SCNDADDRESSLINE - 2nd Address Line

Data type: P0006-LOCAT
Optional: Yes
Call by Reference: No ( called with pass by value option)

CITY - City

Data type: P0006-ORT01
Optional: Yes
Call by Reference: No ( called with pass by value option)

ZIPCODE - Postal Code

Data type: P0006-PSTLZ
Optional: Yes
Call by Reference: No ( called with pass by value option)

COUNTRY - Country

Data type: P0006-LAND1
Optional: Yes
Call by Reference: No ( called with pass by value option)

PERSONNNELSUBAREA - Personnel Subarea

Data type: P0001-BTRTL
Optional: Yes
Call by Reference: No ( called with pass by value option)

STATE - State

Data type: P0006-STATE
Optional: Yes
Call by Reference: No ( called with pass by value option)

TELEPHONENUMBER - Telephone Number

Data type: P0006-TELNR
Optional: Yes
Call by Reference: No ( called with pass by value option)

BANKKEY - Bank Number

Data type: P0009-BANKL
Optional: Yes
Call by Reference: No ( called with pass by value option)

BANKACCOUNTNUMBER - Bank Account Number

Data type: P0009-BANKN
Optional: Yes
Call by Reference: No ( called with pass by value option)

ETHNICORIGIN - Ethnic Origin

Data type: P0077-RACKY
Optional: Yes
Call by Reference: No ( called with pass by value option)

MILITARYSTATUS - Military Status

Data type: P0077-MILSA
Optional: Yes
Call by Reference: No ( called with pass by value option)

RELIGION - Religious Denomination

Data type: P0077-RELGN
Optional: Yes
Call by Reference: No ( called with pass by value option)

DISABILITY - Challenge

Data type: P0077-DISAB
Optional: Yes
Call by Reference: No ( called with pass by value option)

VETERANSTATUS - Veteran Status

Data type: P0077-VETST
Optional: Yes
Call by Reference: No ( called with pass by value option)

APPLICANTNUMBER - Applicant Number

Data type: APPLICANT-APLNO
Optional: Yes
Call by Reference: No ( called with pass by value option)

EMPLOYEEGROUP - Employee Group

Data type: P0001-PERSG
Optional: Yes
Call by Reference: No ( called with pass by value option)

ETHNICITY - Ethnicity

Data type: P0077-ETHEN
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC01 - Race 1

Data type: P0077-RAC01
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC02 - Race 2

Data type: P0077-RAC02
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC03 - Race 3

Data type: P0077-RAC03
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC04 - Race 4

Data type: P0077-RAC04
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC05 - Race 5

Data type: P0077-RAC05
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC06 - Race 6

Data type: P0077-RAC06
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC07 - Race 7

Data type: P0077-RAC07
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC08 - Race 8

Data type: P0077-RAC08
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC09 - Race 9

Data type: P0077-RAC09
Optional: Yes
Call by Reference: No ( called with pass by value option)

EMPLOYEESUBGROUP - Employee Subgroup

Data type: P0001-PERSK
Optional: Yes
Call by Reference: No ( called with pass by value option)

RAC10 - Race 10

Data type: P0077-RAC10
Optional: Yes
Call by Reference: No ( called with pass by value option)

IBAN - IBAN (International Bank Account Number)

Data type: IBAN
Optional: Yes
Call by Reference: No ( called with pass by value option)

ORGUNIT - Organizational Unit

Data type: P0001-ORGEH
Optional: Yes
Call by Reference: No ( called with pass by value option)

POSITION - Position

Data type: P0001-PLANS
Optional: Yes
Call by Reference: No ( called with pass by value option)

JOB - Job

Data type: P0001-STELL
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXPORTING Parameters details for HR_PREPARE_NEW_EE

ERROR - Error Message

Data type: BAPIRETURN
Optional: No
Call by Reference: No ( called with pass by value option)

TABLES Parameters details for HR_PREPARE_NEW_EE

EDUCATION - Education and Training

Data type: BAPIEDUC
Optional: Yes
Call by Reference: No ( called with pass by value option)

FORMEREMPLOYER - Previous Employers

Data type: BAPIEMPLOY
Optional: Yes
Call by Reference: No ( called with pass by value option)

Copy and paste ABAP code example for HR_PREPARE_NEW_EE Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.

ABAP code using 7.40 inline data declarations to call FM HR_PREPARE_NEW_EE

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

Search for further information about these or an SAP related objects