Updates the default chart of accounts configuration for the business.
POST http:///api/v2/business/{businessId}/chartofaccounts
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| businessId | string | Required |
The request body takes a complete UkChartOfAccountsGroupModel resource, containing the following writable properties:
{
"deductionCategories": [
{
"expenseAccountId": "int32",
"id": "int32",
"liabilityAccountId": "int32",
"name": "string",
"splitByEmployingEntity": "boolean",
"splitByLocation": "boolean"
}
],
"defaultAccounts": {
"defaultExpenseAccountId": "int32",
"defaultExpenseSplitByEmployingEntity": "boolean",
"defaultExpenseSplitByLocation": "boolean",
"defaultLiabilityAccountId": "int32",
"defaultLiabilitySplitByEmployingEntity": "boolean",
"defaultLiabilitySplitByLocation": "boolean",
"employeeExpenseAccountId": "int32",
"employeeExpenseSplitByEmployingEntity": "boolean",
"employeeExpenseSplitByLocation": "boolean",
"employeeNationalInsuranceLiabilityAccountId": "int32",
"employeeNationalInsuranceLiabilitySplitByEmployingEntity": "boolean",
"employeeNationalInsuranceLiabilitySplitByLocation": "boolean",
"employeePensionLiabilityAccountId": "int32",
"employeePensionLiabilitySplitByEmployingEntity": "boolean",
"employeePensionLiabilitySplitByLocation": "boolean",
"employerLiabilityExpenseAccountId": "int32",
"employerLiabilityExpenseSplitByEmployingEntity": "boolean",
"employerLiabilityExpenseSplitByLocation": "boolean",
"employerLiabilityLiabilityAccountId": "int32",
"employerLiabilityLiabilitySplitByEmployingEntity": "boolean",
"employerLiabilityLiabilitySplitByLocation": "boolean",
"employerPensionExpenseAccountId": "int32",
"employerPensionExpenseSplitByEmployingEntity": "boolean",
"employerPensionExpenseSplitByLocation": "boolean",
"employerPensionLiabilityAccountId": "int32",
"employerPensionLiabilitySplitByEmployingEntity": "boolean",
"employerPensionLiabilitySplitByLocation": "boolean",
"nationalInsuranceExpenseAccountId": "int32",
"nationalInsuranceExpenseSplitByEmployingEntity": "boolean",
"nationalInsuranceExpenseSplitByLocation": "boolean",
"nationalInsuranceLiabilityAccountId": "int32",
"nationalInsuranceLiabilitySplitByEmployingEntity": "boolean",
"nationalInsuranceLiabilitySplitByLocation": "boolean",
"payeExpenseAccountId": "int32",
"payeExpenseSplitByEmployingEntity": "boolean",
"payeExpenseSplitByLocation": "boolean",
"payeLiabilityAccountId": "int32",
"payeLiabilityAccountSplitByEmployingEntity": "boolean",
"payeLiabilityAccountSplitByLocation": "boolean",
"paymentAccountId": "int32",
"paymentAccountSplitByEmployingEntity": "boolean",
"paymentAccountSplitByLocation": "boolean",
"postgraduateStudentLoanLiabilityAccountId": "int32",
"postgraduateStudentLoanLiabilitySplitByEmployingEntity": "boolean",
"postgraduateStudentLoanLiabilitySplitByLocation": "boolean",
"studentLoanLiabilityAccountId": "int32",
"studentLoanLiabilitySplitByEmployingEntity": "boolean",
"studentLoanLiabilitySplitByLocation": "boolean"
},
"employeeExpenseCategories": [
{
"expenseAccountId": "int32",
"id": "int32",
"name": "string",
"splitByEmployingEntity": "boolean",
"splitByLocation": "boolean"
}
],
"employerLiabilityCategories": [
{
"expenseAccountId": "int32",
"id": "int32",
"liabilityAccountId": "int32",
"name": "string",
"splitByEmployingEntity": "boolean",
"splitByLocation": "boolean"
}
],
"payCategories": [
{
"expenseAccountId": "int32",
"id": "int32",
"name": "string",
"splitByEmployingEntity": "boolean",
"splitByLocation": "boolean"
}
]
}
| Name | Type | Description |
|---|---|---|
| deductionCategories[] | array | |
| deductionCategories[].expenseAccountId | int32 |
Nullable |
| deductionCategories[].id | int32 | Int32 |
| deductionCategories[].liabilityAccountId | int32 |
Nullable |
| deductionCategories[].name | string | String |
| deductionCategories[].splitByEmployingEntity | boolean |
Nullable |
| deductionCategories[].splitByLocation | boolean | Boolean |
| defaultAccounts | object | UkChartOfAccountsDefaultAccountsModel |
| defaultAccounts.defaultExpenseAccountId | int32 |
Nullable |
| defaultAccounts.defaultExpenseSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.defaultExpenseSplitByLocation | boolean | Boolean |
| defaultAccounts.defaultLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.defaultLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.defaultLiabilitySplitByLocation | boolean | Boolean |
| defaultAccounts.employeeExpenseAccountId | int32 |
Nullable |
| defaultAccounts.employeeExpenseSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.employeeExpenseSplitByLocation | boolean | Boolean |
| defaultAccounts.employeeNationalInsuranceLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.employeeNationalInsuranceLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.employeeNationalInsuranceLiabilitySplitByLocation | boolean | Boolean |
| defaultAccounts.employeePensionLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.employeePensionLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.employeePensionLiabilitySplitByLocation | boolean | Boolean |
| defaultAccounts.employerLiabilityExpenseAccountId | int32 |
Nullable |
| defaultAccounts.employerLiabilityExpenseSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.employerLiabilityExpenseSplitByLocation | boolean | Boolean |
| defaultAccounts.employerLiabilityLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.employerLiabilityLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.employerLiabilityLiabilitySplitByLocation | boolean | Boolean |
| defaultAccounts.employerPensionExpenseAccountId | int32 |
Nullable |
| defaultAccounts.employerPensionExpenseSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.employerPensionExpenseSplitByLocation | boolean | Boolean |
| defaultAccounts.employerPensionLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.employerPensionLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.employerPensionLiabilitySplitByLocation | boolean | Boolean |
| defaultAccounts.nationalInsuranceExpenseAccountId | int32 |
Nullable |
| defaultAccounts.nationalInsuranceExpenseSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.nationalInsuranceExpenseSplitByLocation | boolean | Boolean |
| defaultAccounts.nationalInsuranceLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.nationalInsuranceLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.nationalInsuranceLiabilitySplitByLocation | boolean | Boolean |
| defaultAccounts.payeExpenseAccountId | int32 |
Nullable |
| defaultAccounts.payeExpenseSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.payeExpenseSplitByLocation | boolean | Boolean |
| defaultAccounts.payeLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.payeLiabilityAccountSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.payeLiabilityAccountSplitByLocation | boolean | Boolean |
| defaultAccounts.paymentAccountId | int32 |
Nullable |
| defaultAccounts.paymentAccountSplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.paymentAccountSplitByLocation | boolean | Boolean |
| defaultAccounts.postgraduateStudentLoanLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.postgraduateStudentLoanLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.postgraduateStudentLoanLiabilitySplitByLocation | boolean | Boolean |
| defaultAccounts.studentLoanLiabilityAccountId | int32 |
Nullable |
| defaultAccounts.studentLoanLiabilitySplitByEmployingEntity | boolean |
Nullable |
| defaultAccounts.studentLoanLiabilitySplitByLocation | boolean | Boolean |
| employeeExpenseCategories[] | array | |
| employeeExpenseCategories[].expenseAccountId | int32 |
Nullable |
| employeeExpenseCategories[].id | int32 | Int32 |
| employeeExpenseCategories[].name | string | String |
| employeeExpenseCategories[].splitByEmployingEntity | boolean |
Nullable |
| employeeExpenseCategories[].splitByLocation | boolean | Boolean |
| employerLiabilityCategories[] | array | |
| employerLiabilityCategories[].expenseAccountId | int32 |
Nullable |
| employerLiabilityCategories[].id | int32 | Int32 |
| employerLiabilityCategories[].liabilityAccountId | int32 |
Nullable |
| employerLiabilityCategories[].name | string | String |
| employerLiabilityCategories[].splitByEmployingEntity | boolean |
Nullable |
| employerLiabilityCategories[].splitByLocation | boolean | Boolean |
| payCategories[] | array | |
| payCategories[].expenseAccountId | int32 |
Nullable |
| payCategories[].id | int32 | Int32 |
| payCategories[].name | string | String |
| payCategories[].splitByEmployingEntity | boolean |
Nullable |
| payCategories[].splitByLocation | boolean | Boolean |
The following HTTP status codes may be returned, optionally with a response resource.
| Status code | Description | Resource |
|---|---|---|
| 200 | OK OK |
UkChartOfAccountsModel |
| 400 | Bad Request Bad Request |
ProblemDetails |