diff --git a/api-docs/apiLive.htm b/api-docs/apiLive.htm index 789582d7e..c2fa3283c 100644 --- a/api-docs/apiLive.htm +++ b/api-docs/apiLive.htm @@ -509,6 +509,14 @@ Modify a savings application Delete a savings application + + + savingsaccounts/{accountId}?command=updateWithHoldTax + + + Modify savings application withhold tax + + savingsaccounts/{accountId}?command=approve @@ -2168,6 +2176,40 @@ + + Tax Component + taxes/component + Create Tax Component + List Tax Components + + + + + + taxes/component/{taxComponentId} + + Retrieve Tax component + Update Tax Component + + + + + Tax Group + taxes/group + Create Tax Group + List Tax Groups + + + + + + taxes/group/{taxGroupId} + + Retrieve Tax Group + Update Tax Group + + + @@ -19457,6 +19499,13 @@ Content-Type: application/json minRequiredBalance Optional: If provided, sets an indicator of the minimum required balance of the savings account e.g. 5,000 else set the limit as zero. Note that enforceMinRequiredBalance determines if the minimum required balance is enforced + withHoldTax + Optional: If provided, sets an indicator for applying withhold tax on interest posting for savings account + + taxGroupId + Optional: If withhold tax set as true, with hold tax will be applied as per the tax group provided + + @@ -20028,7 +20077,7 @@ Content-Type: application/json
- +
Optional Fields
minRequiredOpeningBalance, lockinPeriodFrequency, lockinPeriodFrequencyType, withdrawalFeeForTransfers, paymentChannelToFundSourceMappings, feeToIncomeAccountMappings, penaltyToIncomeAccountMappings, charges, allowOverdraft, overdraftLimit, minBalanceForInterestCalculation
minRequiredOpeningBalance, lockinPeriodFrequency, lockinPeriodFrequencyType, withdrawalFeeForTransfers, paymentChannelToFundSourceMappings, feeToIncomeAccountMappings, penaltyToIncomeAccountMappings, charges, allowOverdraft, overdraftLimit, minBalanceForInterestCalculation,withHoldTax,taxGroupId
@@ -20466,6 +20515,12 @@ Content-Type: application/json product and the type of the accounting rule to be used Example Values:1=NONE,2=CASH_BASED + withHoldTax + Optional: If provided, sets an indicator for applying withhold tax on interest posting for savings account + + taxGroupId + Optional: If withhold tax set as true, with hold tax will be applied as per the tax group provided +
@@ -20492,7 +20547,7 @@ Content-Type: application/json
- +
Optional Fields
lockinPeriodFrequency, lockinPeriodFrequencyType, maxDepositTerm, maxDepositTermTypeId, inMultiplesOfDepositTerm, inMultiplesOfDepositTermTypeId, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, feeToIncomeAccountMappings, penaltyToIncomeAccountMappings, charges, charts
lockinPeriodFrequency, lockinPeriodFrequencyType, maxDepositTerm, maxDepositTermTypeId, inMultiplesOfDepositTerm, inMultiplesOfDepositTermTypeId, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, feeToIncomeAccountMappings, penaltyToIncomeAccountMappings, charges, charts, , withHoldTax, taxGroupId
@@ -20968,6 +21023,11 @@ Content-Type: application/json product and the type of the accounting rule to be used Example Values:1=NONE,2=CASH_BASED + withHoldTax + Optional: If provided, sets an indicator for applying withhold tax on interest posting for savings account + + taxGroupId + Optional: If withhold tax set as true, with hold tax will be applied as per the tax group provided
@@ -20994,7 +21054,7 @@ Content-Type: application/json
- +
Optional Fields
lockinPeriodFrequency, lockinPeriodFrequencyType, maxDepositTerm, maxDepositTermTypeId, inMultiplesOfDepositTerm, inMultiplesOfDepositTermTypeId, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, feeToIncomeAccountMappings, penaltyToIncomeAccountMappings, charges, charts, minDepositAmount, maxDepositAmount
lockinPeriodFrequency, lockinPeriodFrequencyType, maxDepositTerm, maxDepositTermTypeId, inMultiplesOfDepositTerm, inMultiplesOfDepositTermTypeId, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, feeToIncomeAccountMappings, penaltyToIncomeAccountMappings, charges, charts, minDepositAmount, maxDepositAmount, withHoldTax, taxGroupId
@@ -21480,6 +21540,10 @@ Content-Type: application/json overdraftLimit Optional: If provided, sets the maximum allowed overdraft amount for a savings account e.g. 5,000 else set the limit as zero + + withHoldTax + Optional: If tax group provided at product level, will allow to Enable or disable withhold tax on interest posting for savings account +
@@ -21844,7 +21908,7 @@ Content-Type: application/json
- +
Inherited from Product (if not provided)
nominalAnnualInterestRate, interestCompoundingPeriodType, interestCalculationType, interestCalculationDaysInYearType, minRequiredOpeningBalance, lockinPeriodFrequency, lockinPeriodFrequencyType, withdrawalFeeForTransfers, allowOverdraft, overdraftLimit
nominalAnnualInterestRate, interestCompoundingPeriodType, interestCalculationType, interestCalculationDaysInYearType, minRequiredOpeningBalance, lockinPeriodFrequency, lockinPeriodFrequencyType, withdrawalFeeForTransfers, allowOverdraft, overdraftLimit, withHoldTax
@@ -22564,6 +22628,34 @@ No Request Body: + + +   +
+
+

Modify savings account withhold tax applicability

+

Savings application's withhold tax can be modified when in 'Active' state. Once the application is activated, can modify the account withhold tax to post tax or vice-versa

+
+
+ PUT https://Domain Name/api/v1/savingsaccounts/{accountsId}?command=updateWithHoldTax + PUT savingsaccounts/1?command=updateWithHoldTax +Content-Type: application/json +No Request Body: + { + "withHoldTax": false + } + + + { + "savingsId": 138, + "resourceId": 138, + "changes": { + "withHoldTax": false + } + } + +
+
 
@@ -23652,6 +23744,9 @@ No Request Body: Optional: Must provide when preClosurePenalApplicable is true. Used along with preClosurePenalInterest to decide what should be the applicable interest rate to which penalalty can be applied on Pre-mature closure of accounts. 1=Whole Term, 2=Till Premature withdrawal e.g. “1%” means 1% less than the interest rate applicable till premature withdrawal. + withHoldTax + Optional: If tax group provided at product level, will allow to Enable or disable withhold tax on interest posting for savings account +
@@ -24016,7 +24111,7 @@ No Request Body:
- +
Inherited from Product (if not provided)
interestCompoundingPeriodType, interestCalculationType, interestCalculationDaysInYearType, lockinPeriodFrequency, lockinPeriodFrequencyType, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, charts
interestCompoundingPeriodType, interestCalculationType, interestCalculationDaysInYearType, lockinPeriodFrequency, lockinPeriodFrequencyType, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, charts, withHoldTax
@@ -25116,6 +25211,10 @@ No Request Body: Optional: Must provide when preClosurePenalApplicable is true. Used along with preClosurePenalInterest to decide what should be the applicable interest rate to which penalalty can be applied on Pre-mature closure of accounts. 1=Whole Term, 2=Till Premature withdrawal e.g. “1%” means 1% less than the interest rate applicable till premature withdrawal. + withHoldTax + Optional: If tax group provided at product level, will allow to Enable or disable withhold tax on interest posting for savings account + + @@ -25479,7 +25578,7 @@ No Request Body:
- +
Inherited from Product (if not provided)
interestCompoundingPeriodType, interestCalculationType, interestCalculationDaysInYearType, lockinPeriodFrequency, lockinPeriodFrequencyType, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, charts
interestCompoundingPeriodType, interestCalculationType, interestCalculationDaysInYearType, lockinPeriodFrequency, lockinPeriodFrequencyType, preClosurePenalApplicable, preClosurePenalInterest, preClosurePenalInterestOnTypeId, charts, withHoldTax
@@ -37605,6 +37704,529 @@ No Request Body: + + +   +
+
+

Tax Components

+

This defines the Tax Components

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Field Descriptions
name
Name of the Tax component +
percentage
+ Percentage that should be applied on a amount as tax. +
debitAccountType
+ Debit Account type that should be applicable only for particular cases depending on requirement ex with hold tax doesn't require debit account for the accounting operation. . +
debitAcountId
+ GL Account that should debited when tax applied. used only for particular cases depending on requirement ex with hold tax doesn't require debit account for the accounting operation. . +
+ Credit Account type that should be applicable only for particular cases depending on requirement ex with hold tax require credit account for the accounting operation. . +
debitAcountId
+ GL Account that should credited when tax applied. used only for particular cases depending on requirement ex with hold tax require only credit account for the accounting operation. . +
startDate
+ Start date from which this tax component is applicable. +
+
+
+ +   +
+
+

Create a new Tax Component

+

Creates a new Tax Component

+ + + + + + + + + + +
Mandatory Fields
name
percentage
+ + + + + + + + + + + + + + + + + + + +
Optional Fields
debitAccountType
debitAcountId
creditAccountType
creditAcountId
startDate
+
+
+ + POST https://DomainName/api/v1/taxes/component + + + POST taxes/component + Content-Type: application/json + Request Body: + { + "name": "tax component 1", + "percentage": "10", + "creditAccountType": 2, + "creditAcountId": 4, + "locale": "en", + "dateFormat": "dd MMMM yyyy", + "startDate": "11 April 2016" + } + + + { + "resourceId": 1 + } + +
+
+   +
+
+

List Tax Components

+

List Tax Components/p> +

+
+ + GET https://DomainName/api/v1/taxes/component + + + GET taxes/component + Content-Type: application/json + + + [{ + "id": 1, + "name": "tax component 1", + "percentage": 10.000000, + "creditAccountType": { + "id": 2, + "code": "accountType.liability", + "value": "LIABILITY" + }, + "creditAccount": { + "id": 4, + "name": "ACCOUNT_NAME_7BR9C", + "glCode": "LIABILITY_PA1460364665046" + }, + "startDate": [2016, + 4, + 11], + "taxComponentHistories": [{ + + }] + }, + { + "id": 2, + "name": "tax component 2", + "percentage": 10.000000, + "creditAccountType": { + "id": 2, + "code": "accountType.liability", + "value": "LIABILITY" + }, + "creditAccount": { + "id": 4, + "name": "ACCOUNT_NAME_7BR9C", + "glCode": "LIABILITY_PA1460364665046" + }, + "startDate": [2016, + 4, + 11], + "taxComponentHistories": [{ + + }] + }] + +
+
+   +
+
+

Retrieve Tax Component

+

Retrieve Tax Component

+
+
+ + GET https://DomainName/api/v1/taxes/component/1 + + + GET taxes/component/1 + Content-Type: application/json + + + { + "id": 1, + "name": "tax component 1", + "percentage": 10.000000, + "creditAccountType": { + "id": 2, + "code": "accountType.liability", + "value": "LIABILITY" + }, + "creditAccount": { + "id": 4, + "name": "ACCOUNT_NAME_7BR9C", + "glCode": "LIABILITY_PA1460364665046" + }, + "startDate": [2016, + 4, + 11], + "taxComponentHistories": [{ + + }] + } + +
+
+   +
+
+

Update Tax Component

+

Updates Tax component. Debit and credit account details cannot be modified. + All the future tax components would be replaced with the new percentage.

+
+
+ + PUT https://DomainName/api/v1/taxes/component/1 + + + PUT taxes/component/1 + Content-Type: application/json + Request Body: + { + "name": "tax component 2", + "percentage": "15", + "locale": "en", + "dateFormat": "dd MMMM yyyy", + "startDate": "15 April 2016" + } + + + { + "resourceId": 1, + "changes": { + "percentage": 15, + "name": "tax component 2", + "startDate": [2016, + 4, + 15] + } + } + +
+
+ + + +   +
+
+

Tax Group

+

This defines the Tax Group

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Field Descriptions
name
Name of the Tax Group +
taxComponents
+ Array of tax components to be added part of tax group. +
id
+ Tax group and tax component mapping id. +
taxComponentId
+ Tax component id. +
startDate
+ Start date from which this tax component is applicable. +
endDate
+ End date from which this tax component is applicable. +
+
+
+ +   +
+
+

Create a new Tax Group

+

Creates a new Tax Group

+ + + + + + + + + + +
Mandatory Fields
name
taxComponents
+ + + + + + + +
Mandatory Fields in taxComponents
taxComponentId
+ + + + + + + + + + + + + +
Optional Fields in taxComponents
id
startDate
endDate
+
+
+ + POST https://DomainName/api/v1/taxes/group + + + POST taxes/component + Content-Type: application/json + Request Body: + { + "name": "tax group 1", + "locale": "en", + "taxComponents": [{ + "taxComponentId": 7, + "startDate": "11 April 2016" + }], + "dateFormat": "dd MMMM yyyy" + } + + + { + "resourceId": 1 + } + +
+
+   +
+
+

List Tax Group

+

List Tax Group/p> +

+
+ + GET https://DomainName/api/v1/taxes/group + + + GET taxes/group + Content-Type: application/json + + + [{ + "id": 6, + "name": "Tax_component_Name_PAX65", + "taxAssociations": [{ + "id": 6, + "taxComponent": { + "id": 6, + "name": "Tax_component_Name_FPNXE" + }, + "startDate": [2013, + 1, + 1] + }] + }, + { + "id": 7, + "name": "tax group 1", + "taxAssociations": [{ + "id": 7, + "taxComponent": { + "id": 7, + "name": "tax component 2" + }, + "startDate": [2016, + 4, + 11] + }] + }] + +
+
+   +
+
+

Retrieve Tax Group

+

Retrieve Tax Group

+
+
+ + GET https://DomainName/api/v1/taxes/group/1 + + + GET taxes/group/1 + Content-Type: application/json + + + { + "id": 7, + "name": "tax group 1", + "taxAssociations": [{ + "id": 7, + "taxComponent": { + "id": 7, + "name": "tax component 2" + }, + "startDate": [2016, + 4, + 11] + }] + } + +
+
+   +
+
+

Update Tax Group

+

Updates Tax Group. Only end date can be up-datable and can insert new tax components.

+
+
+ + PUT https://DomainName/api/v1/taxes/group/1 + + + PUT taxes/group/1 + Content-Type: application/json + Request Body: + { + "name": "tax group 2", + "locale": "en", + "taxComponents": [{ + "id": 7, + "taxComponentId": 7, + "endDate": "22 April 2016" + }, + { + "taxComponentId": 6, + "startDate": "14 April 2016" + }], + "dateFormat": "dd MMMM yyyy" + } + + + { + "resourceId": 7, + "changes": { + "addComponents": [6], + "modifiedComponents": [{ + "endDate": "Apr 22, 2016 12:00:00 AM", + "taxComponentId": 7 + }], + "name": "tax group 2" + } + } + +
+
+   @@ -43027,6 +43649,14 @@ No Request Body: Modify a savings application Delete a savings application + + + savingsaccounts/{accountId}?command=updateWithHoldTax + + + Modify savings application withhold tax + + savingsaccounts/{accountId}?command=approve