Documentation View

We are hiring and constantly growing! Have a look through our vacancies to find the right role for you!

/PM0/ABT_SVC_POLHLDR_CHANGE - Change Policyholder

/PM0/ABT_SVC_POLHLDR_CHANGE - Change Policyholder

ROGBILLS - Synchronize billing plans   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

You use this function module to change the Policyholder entity for a specific contract element, such as a contract or coverage.

It lets you update the policyholders of a policy on a defined effective date. You can perform multiple changes in parallel within the selected contract element, for instance, you can add a policyholder, while adding, changing, or deleting other entries at the same time.

  • If you set the Simulation indicator, the system simulates the change of policyholder on the contract version that is valid on the effective date.
  • If you set the Release indicator, the system executes the change to the policyholder and releases the change.
  • If you set the Save indicator, the system saves the current processing version of the application.

The system checks that only one of these three indicators is set.

The system returns the following data:

  • Updated list of all policyholders where changes have been made (parameter ET_RESULT).

Example

The following sample coding demonstrates how a policyholder with the ID SMOKE002y is added to the policy with number 102456 on January 1, 2014. The input parameter IF_SIMULATION has the effect that the system only simulates the change, without releasing it.

DATA:

      lt_polhldr_add    TYPE /pm0/abt_srv_polhldr_crt_t,

      lt_polhldr_add_fm TYPE /pm0/abt_srv_polhldr_crt_fm_t,

      lt_result        TYPE /pm0/abt_srv_polhldr_read_t,

      lt_messages      TYPE bapiret2_t.

lt_polhldr_add    = VALUE #(

                               (

                                polhlder_id= 2

                                pm_id = 'POLHLDR00000'

                                partner_id = 'SMOKE002'

                                addressnumber_id = '0000616020'

                               ) ).

lt_polhldr_add_fm = VALUE #(

                               (

                                polhlder_id = 1

                                pm_id = abap_true

                                partner_id = abap_true

                                addressnumber_id = abap_true

                                 ) ).

CALL FUNCTION '/PM0/ABT_POLHLDR_AMD'

  EXPORTING

    iv_policynr_tt    = '10000082456'

    if_simulation     = 'X'

    it_add            = lt_polhldr_add

    it_add_fm         = lt_polhldr_add_fm

    iv_effective_date = '20140101'

  IMPORTING

    et_result         = lt_result

    et_messages       = lt_messages.

Notes

Further information In-Force Business Management -> Business Transactions -> Role-Based Business Transactions -> Change Policyholder.

Enhancements

To process further data from the calling system, use the Business Add-In (BAdI) BAdI: Change Policyholder (Extension In/Out) (/PM0/ABT_SVC_POLHLDR_BADI). You can use this BAdI to execute your own mapping and to fill the EXTENSIONOUT parameter.

In Customizing for Policy Management, choose Integration -> Services -> Remote-Enabled Function Modules -> Change -> Transfer Business -> BAdI: Change Policyholder (Extension In/Out).





Parameters

EN_ERROR_CODE
ET_EXTENSIONOUT
ET_MESSAGES
ET_PREM
ET_RESULT
EV_APPLNR_CD
EV_SESSION_TOKEN
IF_OPEN_SESSION
IF_RELEASE
IF_SAVE
IF_SIMULATION
IT_ADD_POLICYHOLDER
IT_ADD_POLICYHOLDER_FM
IT_DEL_POLICYHOLDER
IT_EXTENSIONIN
IT_MOD_POLICYHOLDER
IT_MOD_POLICYHOLDER_FM
IV_APPLIN_DT
IV_APPLNR_CD
IV_APPL_DT
IV_CHGREASON_ID
IV_EFFECTIVE_DATE
IV_LOCKKEY_ID
IV_OTHCHGREASON_TT
IV_POLICYNR_TT
IV_SESSION_TOKEN

Exceptions

Function Group

/SAPLABT_SVC_CHANGE

CPI1466 during Backup   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.

Length: 9039 Date: 20211202 Time: 023459     sap01-206 ( 72 ms )