Add capital contribution/distribution transactions

Definition

Capital contribution/distribution transaction group in Quantium CORE allows users to add following types of transactions for investee funds:

Add capital contribution and distribution

📘
Accounting journals
Accounting journals from capital contribution/distribution transactions are generated to fund vehicle general ledgers automatically

	Value
HTTP Method	POST
Path	/api/investeefund/capital/{scopeId}
Request parameter	Scope ID used for verifying access right
Request Body	Please see table below and request body example

Capital contribution/distribution Input Object Model definition

Type name	Data type	Description	Required field
fofName	string	Fund vehicle name	Yes
investeefundName	string	Investee fund name	Yes
investeefundCommitmentSerialNumber	string	Commitment serial number i.e. if 0001 put 0001	Yes
transactionDate	string	Transaction date in "YYYY-MM-DD" format	Yes
type	string	Type of transaction. Please see all types in Transaction types table below.	Yes
allocationRule	string	Allocation rule to investors. \n- Capital commitment \n- Remaining Available Capital, \n- Paid-in capital (due date) \n- Paid-in capital (payment date) \nSystem also support dynamic allocation rule. \nDefault is Capital commitment	No
paymentDate	string	Payment date in "YYYY-MM-DD" format	No
bankAccountName	string	Bank account name	Yes
includeInIrrCalculation	bool	Include in IRR calculation = true, otherwise false. Default is true	No
reference	string	Reference	No
transactionLabel	string	Label	No
subtypes	array of objects	Sub-types list. Please see model in Sub-types table below	Yes

Transaction types

Type name	Data type
Capital contribution	string
Capital distribution	string
Secondary purchase	string
Compensation	string
Return of excess	string
Commitment sale / transfer	string
Deal expense	string
Capitalized expenses	string

Sub-types Input Object Model definition

Type name	Data type	Description	Required field
subtype	string	Sub-type. For all available sub-types, please contact Quantium support team	Yes
amount	number	Amount	Yes
investeeFundAmount	number	Refer to amount in investee fund currency	No
originalAmount	number	Refer to amount in Fund vehicle bank currency	No
commitmentTransferAmount	number	Commitment amount to transfer	If select type Commitment sale / transfer, this field is required.
recallable	bool	If distribution amount can be recycled = true, otherwise false. Default is false.	No
recallableExpirationDate	string	Expired date of recallable distribution. Default is transaction date plus 2 years	No
description	string	Description	No

** Example request body for Capital contribution**

{
	"fofName": "Fund vehicle A",
	"investeefundName": "investee fund 1",
	"investeefundCommitmentSerialNumber": "0005",
	"transactionDate": "2023-01-25",
	"type": "Capital contribution", 
	"allocationRule": "Capital commitment",
	"paymentDate":  "2023-01-26",
	"bankAccountName" : "Fund vehicle A bank (USD)",
	"includeInIrrCalculation": true,
	"reference": "my reference",
	"subtypes": [
		{
			"subtype": "Contribution",
			"amount": 1000000,
			"investeeFundAmount":1252000,
			"originalAmount": 1000000,
			"description": ""
		},
		{
			"subtype": "Investments",
			"amount": 1000000,
			"investeeFundAmount":1252000,
			"originalAmount": 1000000,
			"commitmentTransferAmount": 50000,
			"description": ""
		}
	]
}

** Example request body for Capital distribution**

{
	"fofName": "Fund vehicle A",
	"investeefundName": "investee fund 1",
	"investeefundCommitmentSerialNumber": "0005",
	"transactionDate": "2023-01-25",
	"type": "Capital distribution", 
	"allocationRule": "Capital commitment",
	"paymentDate":  "2023-01-26",
	"bankAccountName" : "Fund vehicle A bank (USD)",
	"includeInIrrCalculation": true,
	"reference": "my reference",
	"subtypes": [
		{
			"subtype": "Capital gain",
			"amount": 1000000,
			"investeeFundAmount":1252000,
			"originalAmount": 1000000,
			"recallable": true,
			"recallableExpirationDate": "2024-01-25",
			"description": ""
		},
		{
			"subtype": "Others",
			"amount": 2000000,
			"investeeFundAmount":2504000,
			"originalAmount": 2000000,
			"recallable": true,
			"recallableExpirationDate": "2024-01-25",
			"description": ""
		},
	]
}

Create multiple Capital contribution/distribution transactions

	Value
HTTP Method	POST
Path	/api/investeefund/capital/multiple/{scopeId}
Request parameter	Scope ID used for verifying access right
Request Body	Please see request body example

Input model is the same as single transaction.

[
	{
		"fofName": "Fund vehicle A",
		"investeefundName": "investee fund 1",
		"investeefundCommitmentSerialNumber": "0005",
		"transactionDate": "2023-01-25",
		"type": "Capital distribution", 
		"allocationRule": "Capital commitment",
		"paymentDate":  "2023-01-26",
		"bankAccountName" : "Fund vehicle A bank (USD)",
		"includeInIrrCalculation": true,
		"reference": "my reference",
		"subtypes": [
			{
				"subtype": "Capital gain",
				"amount": 1000000,
				"investeeFundAmount":1252000,
				"originalAmount": 1000000,
				"recallable": true,
				"recallableExpirationDate": "2024-01-25",
				"description": ""
			},
			{
				"subtype": "Others",
				"amount": 2000000,
				"investeeFundAmount":2504000,
				"originalAmount": 2000000,
				"recallable": true,
				"recallableExpirationDate": "2024-01-25",
				"description": ""
			},
		]
	},
	{
		"fofName": "Fund vehicle A",
		"investeefundName": "investee fund 1",
		"investeefundCommitmentSerialNumber": "0006",
		"transactionDate": "2023-01-26",
		"type": "Capital distribution", 
		"allocationRule": "Capital commitment",
		"paymentDate":  "2023-01-27",
		"bankAccountName" : "Fund vehicle A bank (USD)",
		"includeInIrrCalculation": true,
		"reference": "my reference",
		"subtypes": [
			{
				"subtype": "Capital gain",
				"amount": 1000000,
				"investeeFundAmount":1252000,
				"originalAmount": 1000000,
				"recallable": true,
				"recallableExpirationDate": "2024-01-25",
				"description": ""
			},
			{
				"subtype": "Others",
				"amount": 2000000,
				"investeeFundAmount":2504000,
				"originalAmount": 2000000,
				"recallable": true,
				"recallableExpirationDate": "2024-01-25",
				"description": ""
			},
		]
	},
]