SAP Function BAPI_BEN_BUS302901_GET_POS_DEP - Possible health plan dependents

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

Parameter Reference Type Length Text
RETURN BAPIRETURN1 u 470 Return

Parameter Reference Length Optional Text
HEALTH_OFFER BAPIBEN_OA 1027 X Health plan offer
POSSIBLE_DEPENDENTS BAPIBENODP 154 X Possible dependents for enrollment

Functionality
This function module is used as the basis for the BAPI methodEmpBenefitHealthPlan.GetPossDependents.
This method returns a list of the dependents an employee may include inhealth plan enrollments on a specified date.
The method uses the following algorithm:

  • it ensures that EmployeeBenefit.GetOffer has returned an offer that
    • includes at least one health plan which permits at least one dependent.
    • it then fetches the family/related person records (infotype 0021)
      • stored under the employee's personnel number in HR master data, andlists all possible dependents' names.

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

      Value range
      The health offer is the list of health plans produced by the method,giving all that the employee is permitted to enroll in or changeelections for. This offer contains all the details of the plans andtheir options. &DEFAULT&

      Description
      Possible dependents

      Value range
      This is the list of possible dependents an employee may include in thebenefit plan.