SAP Function BAPI_BEN_BUS302907_GET_POS_BEN - Possible beneficiaries for stock purchase plans

Parameter Reference Type Length Default Optional Text
DATEOFVALIDITY BAPIBEN_OF-VALID_DATE D 8 Validity Date
EMPLOYEENUMBER BAPIBEN_OF-PERSON_NO N 8 Employee's personnel number
PLANTYPE BAPIBEN_OF-PLAN_TYPE C 4 Plan type

Parameter Reference Type Length Text
RETURN BAPIRETURN1 u 470 Return

Parameter Reference Length Optional Text
POSS_BENEFICIARIES BAPIBENOBF 158 X Possible beneficiaries for enrollment
STOCKP_OFFER BAPIBEN_OF 1174 X Stock puchase offer

Functionality
This function module is used as the basis for the BAPI methodEmpBenefitStockpPlan.GetPossBeneficiaries.
This method returns a list of the beneficiaries an employee may includein stock purchase plan enrollments on a specified date.
The method uses the following algorithm:

  • it ensures that EmployeeBenefits.GetOffer has returned an offer that
    • includes at least one stock purchase plan which permits at least onebeneficiary.
    • it then fetches the persons' and organizations' names stored for the
      • employee in HR master data, and lists them as possible beneficiaries.

      Notes
      Messages are returned in the RETURN parameter. You will find the returncodes and their definitions in the documentation for this parameter.

      Further information

      Description
      Message type

      Value range
      You can find information about the Message type in the correspondingdata element: message type

      Default

      Description
      Validity date

      Value range
      You can find information about the Validity date in the correspondingdata element: validity date.

      Default

      Description
      Employee personnel number

      Value range
      You can find information about the Employee personnel number in thecorresponding data element: personnel number.

      Default

      Description
      Benefit plan type

      Value range
      You can find information about the Benefit plan type in thecorresponding data element: benefit plan type.

      Default

      Description
      Possible beneficiaries

      Value range
      This is the list of possible beneficiaries an employee may include inthe benefit plan.

      Default

      Description
      Stock purchase offer

      Value range
      The stock purchase offer is the list of stock purchase plans producedby the method, giving all that the employee is permitted to enroll inor change elections for. This offer contains all the details of theplans and their options.