SAP Function BAPI_BEN_BUS302902_GET_POS_BEN - Possible beneficiaries for insurance

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

Parameter Reference Type Length Text
RETURN BAPIRETURN1 u 470 Return

Parameter Reference Length Optional Text
INSURANCE_OFFER BAPIBEN_OB 1017 X Insurance plan offer
POSS_BENEFICIARIES BAPIBENOBF 158 X Possible beneficiaries for enrollment

Functionality
This function module is used as the basis for the BAPI methodEmpBenefitInsurePlan.GetPossBeneficiaries.
This method returns a list of the beneficiaries an employee may includein insurance 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 insurance 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.

      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
      Insurance offer

      Value range
      The insurance offer is the list of insurance plans produced by themethod, giving all that the employee is permitted to enroll in orchange elections for. This offer contains all the details of the plansand their options.

      Default

      Description
      Possible beneficiaries

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