Temenos Transact
Updated On 08 October 2024 | Min(s) read

Tax

The Tax Property Class is used by all products, and it primarily controls the taxes applicable for the arrangement. Taxes can be calculated for Interest, Charges, Periodic charges, Account property amount (that is made-due or paid), and activities.

Product Lines

The following Product Lines use the Tax Property Class:

  • Accounts
  • Agent
  • Asset Finance
  • Bundle
  • Deposits
  • Facility
  • Lending
  • Safe Deposit Box
  • Subscriptions

Property Class Type

The Tax Property Class (optional) uses the following Property Class Types:

  • Currency Optional
  • Dated
  • Enable External
  • Enable External Financial
  • Multiple
  • Tracking

Property Type

The property type associated with this property class are explained in this section.

Tax on Activities

Tax can be calculated on the transaction amount, balance or on the total bill amount when specific activities are triggered. This is configured using Container and Transaction property type options in AA property.

  • Container - Container is a parent type of tax which can include multiple transaction (or child) type of taxes. At the product level, only a container tax is attached to a product. There are no accounting entries or balances raised for this tax property.
  • Transaction – These are transaction taxes or child tax properties which are configured in the Tax condition and are attached to the Container tax. These taxes can be pre-configured at the product level and added or removed at the arrangement level. The accounting entries and balances are raised for the transaction tax properties only.

A set of multi value fields are available in AA property to configure tax calculation on the bill amount or balance.

  • Trans Activity field is used for configuring the activity on which Tax has to be collected. Only activities with activity class type Process.Tax are allowed to be input in this field. This field is mandatory for transaction type of Tax property. For example, tax can be calculated on:
    • The bill amount while issuing the bill for the repayment.
    • The contract balance while creating a new arrangement.
    • Transaction amount when withdrawing from an account/deposit.
  • Trans Bill Type is used for configuring the type of bill on which the Tax is to be calculated while triggering an activity mentioned in the Trans Activity field. The value in this field needs to be a valid record from AA.BILL.TYPE table. It is mandatory when Trans Source Type is Bill.Amount.
  • Trans Source Type is used for configuring the source type for the calculation details. This field is mandatory for transaction type of Tax property. The value in this field needs to be a valid record from AA.SOURCE.CALC.TYPE table.
  • Trans Source Balance is used for configuring the source balance on which the tax is to be applied.
  • Trans Payment Type is used for configuring the payment type to be used for the bill generated for the transaction tax. The value in this field needs to be a valid record from AA.PAYMENT.TYPE table.

Example screenshots of Container type and Transaction type taxes are provided below. The transaction tax is configured to calculate and process tax during deposit partial withdrawal, full redemption, and generation of deposit interest bill.

  • For deposit redemption and deposit interest bill creation, the tax is calculated on the bill amount.
  • For deposit withdrawal, the tax is calculated on the withdrawal amount (that is, transaction amount).

  • The functionality of handling and processing tax on activities is applicable for Accounts, Lending, Deposits, and Asset Finance product lines.
  • Although tax property is of Type Multiple, defining multiple container tax properties within a product is not supported.

At the product level, only the container tax property is included. The accounting for the taxes calculated across transaction tax properties within the container is based on the Accounting definition for the container tax property. However, at the bill level, the amounts are updated at transaction tax property level.

Transaction tax can be set to either Due or Capitalise by defining the Property Payment Method field in the Tax condition of the Container tax property. When the tax is set to Due, the user can settle the transaction tax bill. The payment rules condition must have the Tax Settlement field set as Pro.rate or the user can set this field as Separate and define the transaction tax property in the Property field. When Tax Settlement is set as:

  • Pro.rate - The tax amount is settled when the corresponding properties or property classes or balances defined in the sequence of the payment rules is settled.
  • Separate - The transaction tax amount is settled separately based on the order defined in the payment rules. In this case, repayment of the tax amount is not associated with other properties or property classes or balances defined in the sequence of the payment rules.

It is recommended to define a separate payment rule condition that is used to repay only the transaction tax property and does not have any other properties or balances in the repay rule. This is to avoid a scenario where taxation gets into a never-ending loop especially when transaction tax is defined for Apply Payment-Payment rules activity which is also used to repay the tax amount.

Automatic settlement of the Due transaction tax can be achieved by using the TRANSACTION.TAX payment type in the settlement condition. However, automatic settlement of transaction tax is applicable only in cases where the primary activity refers to the settlement condition such as DEPOSITS-WITHDRAW-PAYOUT.RULES, DEPOSITS-REDEEM-ARRANGEMENT and so on. This is not applicable in cases where the primary activity does not refer to the settlement condition such as transactions initiated from a payment system (like DEPOSITS-APPLYPAYMENT-PAYOUT.RULES/PAYMENT.RULES, ACCOUNTS-DEBIT-ARRANGEMENT and so on).

Balance Prefix and Suffix

The Tax Property Class is associated with the below listed Balance Prefix:

  • Lending - Due, Aged, Invoice
  • Deposits - Due, Aged, Invoice
  • Accounts - Invoice

For a deposit contract, the due tax balance reflects the amount of tax calculated. The due tax is identified with a prefix of DUE.

Calculation of Split Tax Amount

Tax engine is also used to calculate the split tax amount based on the tax liability percentage defined in the customer condition.

Customer 1 – 50% Customer 2 – 50%

Interest capitalization amount: $1000.

Tax percentage for Customer 1 is 10% and for Customer 2 is 0% (since the customer is minor).

Now, the tax can be calculated by applying 10% on $500 and 0% on $500. So the net tax amount is $50 for which tax accounting is raised.

Tax on Pro-rata basis

Tax is calculated on pro-rata method based on the repaid amount. The adjustment of balance and the corresponding tax calculation is represented with an example as given below:

If the Interest Amount is 50$

and Tax Rate is 10.00%

Then Tax Amount is 5$

Amount Repaid is 40$

Interest Repaid is 36.36$

Tax Paid (on Pro-Rata basis) is 3.64$

Proportional Tax Calculation

  • Regulatory requirements require proportional calculation of tax which is enabled using Temenos Transact Tax engine and AA. System allows the user to configure such that the system can calculate Proportional Tax.
  • The user can perform this configuration at the Tax Code level.
  • After configuration, when the Tax Engine detects a change in the Tax Rate during the current Interest Payment period, then it splits the Interest earnings by Tax Rate Change periods and calculates the Tax proportional to the Interest earned within each of those periods.
  • Given below is an illustration of how the tax can be calculated.

Tax Split in Arrangements

Customer Relationship can define the percentage split of income or tax amongst the primary and joint customer. Tax splits are calculated between the various joint holders based on the tax types linked to them. Tax Type to have the Apply Split field as Yes and Tax parameter to be available.

AA enables the tax calculation based on the customer relation for a customer having a portfolio reference. Temenos Transact splits the tax calculated on an income for a primary customer amongst the primary and joint customers in a pre-defined percentage as indicated in the Customer Relationship.

ST.CUST.RELATIONSHIP.DATES includes the list of dates for a customer relationship record. ID being customer relationship ID without the date

ST.TAX.REPORT.DETAILS includes Tax report file to store customer-wise tax details against a single transaction

Tax Split between Customers is possible using AA.CUSTOMER.ROLE. Read the Customer Property Class for more information.

Add Tax Property to Existing Arrangements

The financial institutions can add the Tax property to the existing arrangements of the Accounts, Deposits, and Lending product lines using the Add New Property, New Prop Avl, and New Prop Avl Date fields in AA.PRODUCT.MANAGER.

Read Add New Property for more information on the configuration.

Periodic Attribute Classes

There are no periodic attribute classes associated with Tax Property Class.

Actions

The Tax Property Class supports the following actions.

Action Name Action
ADJUST.BILL Used to adjust the bills for the applicable charges.
ADJUST.INFO.BILL Used to adjust in the information on the generated bills.
AGE.BILLS Used in aging the bills to calculate the applicable charges.
CAPITALISE Used to capitalise the tax amount.
CAPTURE.BILL Used to capture the tax details on the bills.
CHARGEOFF Used in the charge-off action on the tax component of interest and charges property.
DATA.CAPTURE Used in capturing the information while migrating from Legacy to AA.
MAKE.DUE The due action applies the amount of tax due to be repaid to the MAKEDUE tax property. The amount to be made due is determined from the associated BILL that is being made due.
PAYOFF.CAPITALISE Used for the calculating the tax payoff to be capitalised.
REPAY Used during the repayment of charges.
UPDATE The UPDATE action is initiated manually and allows the user to change any of the Tax attributes. This action can be initiated as part of the NEW-ARRANGEMENT and UPDATE-TAX activities.

Accounting Events

The MAKEDUE action generates accounting events as defined in Accounting field.

Limits Interaction

Actions associated with the Tax Property Class don’t have an impact on the Limits.

Copyright © 2020- Temenos Headquarters SA

Published on :
Tuesday, September 2, 2025 2:37:54 PM IST