Arithmetic 

Addition
(A1)

Definition
Addition of two values by data type

Description
Result of the lines is the total of both parameters

Parameters

  • First summand
  • Second summand

Prerequisites
The data types of the summands must be compatible.

Final conditions
0 = o.k.

Exceptions

  • Error (incompatible data types)
  • Addition of two values by data type

PKE_F_SUM

Subtraction
(A2)

Definition
Subtraction of two values by data type

Description
Result of the lines is the difference between both parameters

Parameters

  • Subtrahend
  • Subtractor

Prerequisites
The data types of the parameters must be compatible.

Final conditions
0 = o.k.

Exceptions
Error (incompatible data types)

PKE_F_DIFF

Multiplication
(A3)

Definition
Multiplication of two numerical values

Description
Result of the lines is the product of both parameters

Parameters

  • First factor
  • Second factor

Prerequisites
The data types of the factors must be numerical.

Final conditions
0 = o.k.

Exceptions
Error (incompatible data types)

PKE_F_PROD

Division
(A4)

Definition
Division of two numerical values

Description
Result of the lines is the quotient of both parameters

Parameters

  • Dividend
  • Divisor

Prerequisites
The data types of the operands must be numerical.

Final Conditions

  • 0 = o.k.
  • 1 – Division by 0

Exceptions
Error (incompatible data types)

PKE_F_QUOT

 

Difference of two products
(A5)

Definition
Calculation of a term a * b – c * d

Description
Result of the lines is = p1* p2 - p3 + p4, where pj is the jth operation parameter.

Parameters

  • Factor 1
  • Factor 2
  • Factor 3
  • Factor 4

Prerequisites
The data types of all parameters must be numerical.

Final conditions
0 = o.k.

Exceptions

  • Error in first product (incompatible data types)
  • Error in second product (incompatible data types)
  • Error in the difference

PKE_F_DIFF_PROD

Linear interpolation
(A6)

Function value of a 1st grade polynom that is defined by two given markers, to one point

Description
Given markers are s1 = (x1,y1), s2 = (x2,y2), and a current value x. The result of the line is therefore:

y = ((x2 - x) * y1 + (x - x1) * y2) / (x2 - x1)

That is, y is calculated, so that (x,y) lies axis that runs through s1 and s2.

Parameter
x = current value
x1 = x-coordinate of marker 1
y1 = y-coordinate of marker 1
x2 = x-coordinate of marker 2
y2 = y-coordinate of marker 2

Prerequisites
The data types of all parameters must be numerical.

Final conditions
0 – Value has been calculated
1 – Arithmetic error: that is, x1 = x2

Exceptions
None.

PKE_LIN_IPOL

Round up or down to the nearest whole number
(A7)

Definition
Numerical value is rounded up or down to the nearest whole number with a rounding divisor

Description
The value of the current line is rounded to the nearest first parameter, according to the rounding divisor. The rounded value (no decimal point), is divisible by the rounding divisor.

Parameter
– value to be rounded
– rounding divisor

Prerequisites
The value to be rounded must be numerical, the rounding divisor must be a whole number.

Exceptions
Error (data type)

PKE_ROUND

Rounding up
(A8)

Definition
Numerical value is rounded up with a specific rounding divisor

Description
The value of the current line is rounded up to the nearest first parameter, according to the rounding divisor.
The rounded value (no decimal point), is divisible by the rounding divisor.

Parameters

  • Value to be rounded
  • Rounding divisor

Prerequisites
The value to be rounded must be numerical, the rounding divisor must be a whole number.

Final conditions
0 = o.k.

Exceptions
Error (data type)

PKE_ROUND_CL

Rounding down
(A9)

Definition
Numerical value is rounded down with a specific rounding divisor

Description
The value of the current line is rounded down to the nearest first parameter, according to the rounding divisor.
The rounded value (no decimal point), is divisible by the rounding divisor.

Parameter
– value to be rounded
– rounding divisor

Prerequisites
The value to be rounded must be numerical, the rounding divisor must be a whole number.

Final conditions
0 = o.k.

Exceptions
Error (data type)

PKE_ROUND_FL

Complex total
(AA)

Definition
Total for all value types with specific attribute.

Description
Value of the current line is the total of all previously calculated values with a specific value type attribute.

Parameter
– Value attribute

Prerequisites
All values that are to form this total must already be calculated.

Final conditions
0 = o.k.

Exceptions
Error (incompatible data types)

PKE_COMPLEX_SUM

Scale annual value
(AB)

Definition
Reduce by length of a given period.

Description
Value of the current line is the scaled annual value from the start and end of the specified period.

Use the indicator ‘Year with 360 days’ to control whether you calculate exactly (365/366 days), or monthly (360 days).

Result = P1 * (P3 – P2)/360 (or 364)

Parameters
– Annual value
– Start of period
– End of period
– Year with 360 days

Prerequisites
The annual value relates to an entire year, for example, annual salary.

Final conditions
0 = o.k.

Exceptions
None.

PKE_RECALC_TO_PERIOD

Projected credit
(AC)

Definition
Value of age-related credit, at a foreseeable future point.
Contributions and interest calculation are simulated from a given date to the end of the simulation.

Description
Value of the current line is the age-related credit resulting for an (estimated) specified retirement age.
Included in the calculation are:

  1. The previous annual credit (value at start of year)
  2. The contributions to be paid according to the contribution rate (age-dependent)
  3. Already-existing payments in the account as of the start of the year

Parameters
– Credit until the start of the year at the reference date
– Current insured wage
– Interest rate
– Gender
– Date of birth
– End of simulation (generally the retirement date)
– Value type for EE contribution rate
– Value type for ER contribution rate
– Value type attribute for incoming payments
– Reference date: Determines the year when the simulation starts

Work method
The entry date is determined from infotype 0278.
If this is not possible (for example, for applicants), the reference date is used for the entry date.
The previous credit accrues interest for each year at the specified interest rate. In addition, the respective contributions are taken into account, as of the entry date, with the valid contribution rate for the respective age, and relative to the specified insured wage.
In the retirement year, contributions and interest are reduced correspondingly.
The values for the age-related credit are saved for the various ages in the iteration, and can subsequently be read using the operation Projection value.

Prerequisites
The transferred age-related credit is the valid value as of the start of the year of the reference date.

Final conditions
0 = o.k.

Exceptions
None.

PKE_GUTH_PROJ

Interest accumulation
(AD)

Definition
Value accrues interest at given rate until a specific date.

Description
Result of this operation is the amount of interest accumulated on specified capital at an interest rate in one period.
Interest is accrued iteratively over the whole year from the start to the end of the period. The time between the start of the period and the 31.12. of the same year, and between the 1.1. of the year of the end of the period and the end of the period is calculated pro rata temporis.

Parameters

  • Capital
  • Annual interest rate in %
  • Start of the period
  • End of the period

Calculation
Interest payments = '1.00' + interest rate /100.

Incomplete start and end years are proportionately reduced:

Value = Value *('1.00'+ Interest rate/100*scale)

For all other years :

Value = Value * Interest payments

Final conditions
0 = o.k.

Exceptions
None.

PKE_INTEREST

Interest calculation for current posting
(AE)

Definition:
Value of the interest on the current posting from value date until end of the interest calculation.

Description
Result of this operation is the interest on the value of the current posting (processed with the operations Get postings with value type, Get postings with VT attribute or Next Posting) between the value date of this posting and the specified end date for the interest calculation.
If the period from the value date of the posting and the end date of the calculation encompasses several years, the interest is compounded for each whole year.

Parameters

  • Annual interest rate in %
  • Interest accrual until

Prerequisites
A current posting must exist. To do this, use one of the following operations: Get posting with value type, Get posting with VT attribute or Next posting.

Final conditions
0 = o.k.

Exceptions
None.

PKE_INTEREST_ENTRY

Earned benefit (BP) (AF)

Definition
Earned benefit of an insured person’s benefit (Base for leaving benefit in the benefit plan).

Description
The result of this operation is the earned benefit. It scales the maximum number of insured days from the entry to the leaving date, by the actual number of days in this period:

Earned benefit = Insured benefit * (calculable insurance duration/possible insurance duration).

Parameters

  • Insured benefit
    Normally: Retirement pension = Insured wage * Pension rate.
  • Entry date
  • Start of contribution payments (full insurance)
  • Leaving date
  • Retirement date

Prerequisites
The entry date must be prior to the leaving date.

Final Conditions

  • 0 = o.k.
  • 1 = Value is not to be calculated

Exceptions
None.

PKE_ERW_LEIST

Projection value
(AG)

Definition
Age-related credit value at a later age; the projection must have been previously run "over and above this age".

Description
The result is the value of the age-related credit at a (future) age that was previously calculated by the operation Projected credit.

Parameter
Age

Prerequisites
The operation Projected age-related credit must have been called up with a simulation end that at least corresponds to the specified age.

Final Conditions

  • 0 = o.k.
  • 1 = No value found for the specified age

Exceptions
None.

PKE_GUTH_PROJ_VAL

Indicator: Year with 360 days
(AH)

Definition
Controls the reduction of interest for periods of less than one year.

Description
If this indicator is set (default), then period-specific calculations, such as interest, are done on a monthly, rather than a daily basis.
The calculation procedure for daily differences is as follows:

  • Daily
    This procedure uses the daily difference and, if necessary, is related to the number of days until the start date of the next year.
  • Year with 360 days (banking procedure)
    The number of days is determined as 30 x monthly difference, in addition to the difference of the days. This includes the 31st of a month as well as 28 th February. (Leap year: 29.02) is treated as the 30th.
    Example: Start End Daily difference
    01.01.1998 01.01.1998 1
    01.01.1998 02.01.1998 2
    30.01.1998 31.01.1998 1
    27.02.1998 28.02.1998 4
    27.02.1998 01.02.1998 5
    28.02.1998 01.03.1998 2
    27.02.2000 01.03.2000 5
    28.02.2000 01.03.2000 4
    (Leap year)
    28.02.2000 29.02.2000 3
    This value relates to 360 days.

Parameter
Value of the indicator (X or BLANK)

Exceptions
None.

 

Multiplication/Division
(AI)

Definition
Calculation of a * b / c

Description
Result of the lines is = p1* p2 / p3, where pj is the jth operation parameter.

Use: If the values are large, there is the danger of overflow during separate processing (first multiplication, then division). In the opposite case, it is not exact enough. For internal calculations, this operation uses large enough fields, which prevents this problem occurring.

Parameters

  • Factor 1
  • Factor 2
  • Divisor

Prerequisites
All parameters are to two decimal places.

Final conditions
0 = o.k.

Exceptions
None.

PKE_MULT_DIV

Interest accumulation as of Date + 1
(AJ)

Definition
Value accrues interest at given rate until a specific date.

Description
Result of this operation is the amount of interest accumulated on specified capital at an interest rate in one period. Interest is accrued iteratively over the whole year from the start to the end of the period. The time between the start of the period and the 31.12. of the same year, and between the 1.1. of the year of the end of the period and the end of the period is calculated pro rata temporis.
This operation is similar to the interest accumulation operation, but starts accruing interest from the day after the value date.

Parameters

  • Capital
  • Annual interest rate in %
  • Start of the period
  • End of the period

Final conditions
0 = o.k.

PKE_INTEREST_D1

Interest for the current posting date + 1
(AK)

Definition
Value accrues interest at given rate until a specific date.

Description
Result of this operation is the interest on the value of the current posting (processed with the operations Get postings with value type, Get postings with value type attribute or Next Posting) between the value date of this posting and the specified end date for the interest calculation.
If the period from the value date of the posting and the end date of the calculation encompasses several years, the interest is compounded for each whole year.
This operation is similar to the interest calculation for current posting operation, but starts accruing interest from the day after the value date.

Parameters

  • Annual interest rate in %
  • Interest accrual until

Prerequisites
A current posting must exist. To do this, use one of the following operations: Get posting with value type, Get posting with VT attribute or Next posting.

Final conditions
0 = o.k.

Exceptions
None.

PKE_INTERES_ENTRY_D1