Function documentationRetention

 

You can use the retention function to remove remuneration from the settlement process and to delay disbursement to the commission recipient.

The retained remuneration can be decreased at a later point, for instance when the commission recipient leaves the company or in the case of recalls, and then settled at this point.

Note Note

Note that the retention function completely replaces the reserve function that was previously integrated in the settlement process. The process has been completely detached from the settlement and it provides more flexibility. The reserve function is now a scenario that is covered by the new retention function. The effects of detaching the retention process from the settlement are described below.

End of the note.

Features

You can use retention in various scenarios, such as:

  • Retention without clearing of recalls (such as the reserve)

  • Retention with clearing of recalls (such as the cancellation reserve)

  • Retention of excess earnings (such as guarantee offsetting)

You can map the various application scenarios with retention rules.

You must define characteristics for the different retention rules within a standard agreement and assign them to standard contracts.

In the master data, the individual parameters of the reserve, such as maximum amount, percentage rate and threshold value, that were originally part of the individual settlement agreement have been transferred to a new individual retention agreement. You will find the new retention agreement on a new Retention tab page.

You can increase or decrease retention in various ways:

Offsetting Retention

The Offset Retention process should be started before each settlement if you require an automated, periodic analysis of the retention. The process checks for each period whether the remuneration available for the settlement leads to an increase or decrease of retention.

Manually Editing Retention

You can also directly edit the retention of a commission contract. This lets you decrease a specific amount and settle this to the commission recipient. You can also create a specific retention amount, assuming there is enough disbursable remuneration available.

Note Note

End of the note.

Note that the retention process:

  • Must be started as the last process before settlement. This means that all disbursable remunerations that were created in the preceding processes can be included in the offsetting.

  • Should not be started after the settlement. Settlement items that were already processed by the settlement are not considered for offsetting.

The retention uses the following technical functions:

Run Administration

You use run administration to check directly in the commission contract which retention runs have already been run or reset. You can navigate from run administration to the retention documents, as well as to the period rules and periods that are used. From run administration, you can also access the user data and reset the retention. Run administration replaces the previous journals in ICM.

Resetting Retention

The leading entity for resetting runs is the run number of run administration. A completed retention run can be reset at any time, independently from the settlement.

Time Control (for Experts)

You can use the time control to influence the effective and/or technical time spot that is used for the configuration, process control and master data of the retention process. For the resetting of retention, the time control only affects the process control.

Delimitation Date

You can use the freely selectable delimitation date to set the upper limit for the selection of periods to be processed. The process processes all periods for which disbursable remuneration exists up to and including the last periods that is completely covered by the delimitation date.

Simulation

You can simulate retention runs. In this case an application log is generated, however the database is not updated.

Application Log

An application log is generated for each run and for each commission contract that is processed. The display function of the application log has been improved. You can use the problem classification of the application log. This lets you influence the number of messages written to the database, thus optimizing performance.

Commission Contract Level

Retention is created on the level of the commission contract, which means that the commission contract is the central lock object.

Parallel Processing

The retention process is integrated in Framework for Parallel Processing (FPP). Retention can be processed in parallel jobs on commission contract level. Parallel processing can be triggered directly at a specific time-spot with a particular transaction, either using SAP Schedule Manager or external job control systems.

Note Note

User Exits

All user exits are implemented with Business Add-Ins (BAdIs) that can be accessed through the IMG.

End of the note.