Skip to main content
PUT
Update expense service category

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId
string
required

UUID without dashes (32-character hex string)

Pattern: ^[0-9a-fA-F]{32}$
id
string
required

The expense category id

Body

application/json
name
string

Name of the expense category

section
integer

Section order index

classType
string
write-only

The fully qualified Java class name of the category type. Required on create, optional on update.

categoryTemplateId
string

The ID of the category template this category is based on

defaultTaxPercent
number<double>

Default tax percentage for the category

deviantTaxPercent
number<double>

Deviant tax percentage for the category

nonDeductableVat
boolean

Whether the VAT is non-deductable

accountNumberMapping
string

Account number mapping string

accountingNumberId
string

ID of the primary accounting number

accountingNumbers
object[]

List of accounting numbers associated with this category

expenseCodeId
string

ID of the expense code

salaryCodeId
string

ID of the salary code

taxAccountingNumberId
string

ID of the tax accounting number

taxSalaryCodeId
string

ID of the tax salary code

taxExpenseCodeId
string

ID of the tax expense code

budgetAmount
number<double>

Budget amount for the category

budgetName
string

Budget name for the category

budgetStartMonth
integer

The month (1-12) the budget period starts

mccCodes
string[]

List of MCC (Merchant Category Codes) associated with this category

presetValues
object[]

List of preset dimension values for the category

expenseCategoryFilter
string

Filter applied to determine which expenses belong to this category

showAccounting
boolean

Whether accounting fields are shown for this category

showRepresentation
boolean

Whether representation fields are shown for this category

settings
object

Additional category settings as a free-form object

employeeGroupId
string | null

String (32-character hex string). ID of the employee group the category is restricted to. When the organization uses employee groups, per diem categories restricted to a group are only available to users in that group. null or an empty string removes the restriction. An unknown ID returns 404 EMPLOYEE_GROUP_NOT_FOUND.

useAlternatePerDiemRate
boolean | null

Only for per diem categories (SubsistenceAllowanceCategory). Whether the destination's alternate per diem rate is used for users in the category's employee group. Only applies in countries where alternate per diem rates are enabled.

Response

OK

id
string
read-only

The unique external identifier of the expense category

name
string

Name of the expense category

iconUrl
string
read-only

URL to the category icon

section
integer

Section order index

categoryType
enum<string>
read-only

The resolved class type of the expense category

Available options:
SubsistenceAllowanceCategory,
RepresentationExpenseCategory,
OtherExpenseCategory,
MileageExpenseCategory,
FuelBenefitsExpenseCategory,
FoodBenefitsExpenseCategory,
ExpenseCategory,
CongestionBenefitExpenseCategory,
BenefitExpenseCategory,
AbroadPurchaseExpenseCategory
verificationClassType
string
read-only

The verification class type mapped to the new expense type format

categoryTemplateId
string

The ID of the category template this category is based on

dateCreated
string<date-time>
read-only

The date and time the category was created

defaultTaxPercent
number<double>

Default tax percentage for the category

deviantTaxPercent
number<double>

Deviant tax percentage for the category

nonDeductableVat
boolean

Whether the VAT is non-deductable

accountNumberMapping
string

Account number mapping string

accountingNumberId
string

ID of the primary accounting number

accountingNumbers
object[]

List of accounting numbers associated with this category

expenseCodeId
string

ID of the expense code

salaryCodeId
string

ID of the salary code

taxAccountingNumberId
string

ID of the tax accounting number

taxSalaryCodeId
string

ID of the tax salary code

taxExpenseCodeId
string

ID of the tax expense code

budgetAmount
number<double>

Budget amount for the category

budgetName
string

Budget name for the category

budgetStartMonth
integer

The month (1-12) the budget period starts

mccCodes
string[]

List of MCC (Merchant Category Codes) associated with this category

presetValues
object[]

List of preset dimension values for the category

expenseCategoryFilter
string

Filter applied to determine which expenses belong to this category

showAccounting
boolean

Whether accounting fields are shown for this category

showRepresentation
boolean

Whether representation fields are shown for this category

settings
object

Additional category settings as a free-form object

employeeGroupId
string | null

String (32-character hex string). ID of the employee group the category is restricted to. When the organization uses employee groups, per diem categories restricted to a group are only available to users in that group. null or an empty string removes the restriction. An unknown ID returns 404 EMPLOYEE_GROUP_NOT_FOUND.

useAlternatePerDiemRate
boolean | null

Only for per diem categories (SubsistenceAllowanceCategory). Whether the destination's alternate per diem rate is used for users in the category's employee group. Only applies in countries where alternate per diem rates are enabled.