Updates the default chart of accounts configuration for the business.

Request

POST https://api.yourpayroll.co.uk/api/v2/business/{businessId}/chartofaccounts

Path parameters

Parameter name Value Description Additional
businessId string Required

Request body

The request body takes a complete UkChartOfAccountsGroupModel resource, containing the following writable properties:

{
    "deductionCategories": [
        {
            "expenseAccountId": "int32",
            "id": "int32",
            "liabilityAccountId": "int32",
            "name": "string",
            "splitByLocation": "boolean"
        }
    ],
    "defaultAccounts": {
        "defaultExpenseAccountId": "int32",
        "defaultExpenseSplitByLocation": "boolean",
        "defaultLiabilityAccountId": "int32",
        "defaultLiabilitySplitByLocation": "boolean",
        "employeeExpenseAccountId": "int32",
        "employeeExpenseSplitByLocation": "boolean",
        "employeeNationalInsuranceLiabilityAccountId": "int32",
        "employeeNationalInsuranceLiabilitySplitByLocation": "boolean",
        "employeePensionLiabilityAccountId": "int32",
        "employeePensionLiabilitySplitByLocation": "boolean",
        "employerLiabilityExpenseAccountId": "int32",
        "employerLiabilityExpenseSplitByLocation": "boolean",
        "employerLiabilityLiabilityAccountId": "int32",
        "employerLiabilityLiabilitySplitByLocation": "boolean",
        "employerNationalInsuranceLiabilitySplitByLocation": "boolean",
        "employerPensionExpenseAccountId": "int32",
        "employerPensionExpenseSplitByLocation": "boolean",
        "employerPensionLiabilityAccountId": "int32",
        "employerPensionLiabilitySplitByLocation": "boolean",
        "nationalInsuranceExpenseAccountId": "int32",
        "nationalInsuranceExpenseSplitByLocation": "boolean",
        "nationalInsuranceLiabilityAccountId": "int32",
        "nationalInsuranceLiabilitySplitByLocation": "boolean",
        "payeExpenseAccountId": "int32",
        "payeExpenseSplitByLocation": "boolean",
        "payeLiabilityAccountId": "int32",
        "payeLiabilityAccountSplitByLocation": "boolean",
        "paymentAccountId": "int32",
        "paymentAccountSplitByLocation": "boolean",
        "postgraduateStudentLoanLiabilityAccountId": "int32",
        "postgraduateStudentLoanLiabilitySplitByLocation": "boolean",
        "studentLoanLiabilityAccountId": "int32",
        "studentLoanLiabilitySplitByLocation": "boolean"
    },
    "employeeExpenseCategories": [
        {
            "expenseAccountId": "int32",
            "id": "int32",
            "name": "string",
            "splitByLocation": "boolean"
        }
    ],
    "employerLiabilityCategories": [
        {
            "expenseAccountId": "int32",
            "id": "int32",
            "liabilityAccountId": "int32",
            "name": "string",
            "splitByLocation": "boolean"
        }
    ],
    "payCategories": [
        {
            "expenseAccountId": "int32",
            "id": "int32",
            "name": "string",
            "splitByLocation": "boolean"
        }
    ]
}

Properties

Name Type Description
deductionCategories[] array
deductionCategories[].expenseAccountId int32 Nullable
deductionCategories[].id int32 Int32
deductionCategories[].liabilityAccountId int32 Nullable
deductionCategories[].name string String
deductionCategories[].splitByLocation boolean Boolean
defaultAccounts object UkChartOfAccountsDefaultAccountsModel
defaultAccounts.defaultExpenseAccountId int32 Nullable
defaultAccounts.defaultExpenseSplitByLocation boolean Boolean
defaultAccounts.defaultLiabilityAccountId int32 Nullable
defaultAccounts.defaultLiabilitySplitByLocation boolean Boolean
defaultAccounts.employeeExpenseAccountId int32 Nullable
defaultAccounts.employeeExpenseSplitByLocation boolean Boolean
defaultAccounts.employeeNationalInsuranceLiabilityAccountId int32 Nullable
defaultAccounts.employeeNationalInsuranceLiabilitySplitByLocation boolean Boolean
defaultAccounts.employeePensionLiabilityAccountId int32 Nullable
defaultAccounts.employeePensionLiabilitySplitByLocation boolean Boolean
defaultAccounts.employerLiabilityExpenseAccountId int32 Nullable
defaultAccounts.employerLiabilityExpenseSplitByLocation boolean Boolean
defaultAccounts.employerLiabilityLiabilityAccountId int32 Nullable
defaultAccounts.employerLiabilityLiabilitySplitByLocation boolean Boolean
defaultAccounts.employerNationalInsuranceLiabilitySplitByLocation boolean Boolean
defaultAccounts.employerPensionExpenseAccountId int32 Nullable
defaultAccounts.employerPensionExpenseSplitByLocation boolean Boolean
defaultAccounts.employerPensionLiabilityAccountId int32 Nullable
defaultAccounts.employerPensionLiabilitySplitByLocation boolean Boolean
defaultAccounts.nationalInsuranceExpenseAccountId int32 Nullable
defaultAccounts.nationalInsuranceExpenseSplitByLocation boolean Boolean
defaultAccounts.nationalInsuranceLiabilityAccountId int32 Nullable
defaultAccounts.nationalInsuranceLiabilitySplitByLocation boolean Boolean
defaultAccounts.payeExpenseAccountId int32 Nullable
defaultAccounts.payeExpenseSplitByLocation boolean Boolean
defaultAccounts.payeLiabilityAccountId int32 Nullable
defaultAccounts.payeLiabilityAccountSplitByLocation boolean Boolean
defaultAccounts.paymentAccountId int32 Nullable
defaultAccounts.paymentAccountSplitByLocation boolean Boolean
defaultAccounts.postgraduateStudentLoanLiabilityAccountId int32 Nullable
defaultAccounts.postgraduateStudentLoanLiabilitySplitByLocation boolean Boolean
defaultAccounts.studentLoanLiabilityAccountId int32 Nullable
defaultAccounts.studentLoanLiabilitySplitByLocation boolean Boolean
employeeExpenseCategories[] array
employeeExpenseCategories[].expenseAccountId int32 Nullable
employeeExpenseCategories[].id int32 Int32
employeeExpenseCategories[].name string String
employeeExpenseCategories[].splitByLocation boolean Boolean
employerLiabilityCategories[] array
employerLiabilityCategories[].expenseAccountId int32 Nullable
employerLiabilityCategories[].id int32 Int32
employerLiabilityCategories[].liabilityAccountId int32 Nullable
employerLiabilityCategories[].name string String
employerLiabilityCategories[].splitByLocation boolean Boolean
payCategories[] array
payCategories[].expenseAccountId int32 Nullable
payCategories[].id int32 Int32
payCategories[].name string String
payCategories[].splitByLocation boolean Boolean

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK

OK

UkChartOfAccountsModel