UI Equivalent: go to Billing → Expenses in the left menu of the platform.
Returns a list of expenses.
Access level: admin, user
Parameter
Type
Required
Value
id
Positive integer
Yes
Unique identifier of the expense.
locale_name
String
Yes
Expense name.
account
String
Yes
Client from whose account the funds were debited.
realdate
Date and time
Yes
Debit date. Format: YYYY-MM-DD.
cdate
Date and time
No
Service provision date (start of period). Format: YYYY-MM-DD.
amount
String
Yes
Debit amount. Monetary value with a period separator. For example, 15.00 USD
notpayd
String
No
Unpaid portion of the expense. For example, 43.00 USD
discountamount
String
No
Discount amount provided upon debit. For example, 75.00 USD
payments
String
Yes
Payment numbers used to pay the expense.
discount
String
No
Provided discount code. Possible values:
personal — personal;
promo — promotional discount;
globaldiscount — global discount.
taxamount
String
No
Tax amount.
Edit expense
Function: expense.edit
Result: successful operation execution or error message
UI Equivalent: go to Billing → Expenses → select expense → click Edit.
Used for viewing, modifying, and creating an expense.
Access level: admin
Parameter
Type
Required
Value
elid
Positive integer
Yes
Unique identifier of the expense
subaccount
Positive integer
Yes
Provider (subaccount) to which the expense belongs.
item
Positive integer
No
service ID for which the expense will be created. For example, 2882.
operation
String
No
Operation on the basis of which the expense will be created.
amount
String
Yes
Expense amount. Monetary value in period-separated format. For example, 15.00 USD
taxrate
String
No
Tax rate in percent. Tax amount is calculated automatically:
AMOUNT - (AMOUNT / ((100 + RATE) / 100)).
postpaid
Flag
No
If the option is set (on), if there are insufficient funds in the account, the expense will be created on credit.
name
String
No
Expense name. If not specified, it is generated automatically based on the operation.
realdate
Date and time
No
Actual debit date. Format: YYYY-MM-DD.
cdate
Date and time
No
Service provision date (start of period). Format: YYYY-MM-DD.
sok
String
Yes
The value ok confirms operation execution. Without this parameter, changes will not be applied.
Delete expense
Function: expense.delete
Result: successful operation execution or error message
UI Equivalent: go to Billing → Expenses → select expense → click Delete.
Deletes the specified expense. Supports deletion of multiple expenses separated by commas. Confirmation via the sok parameter is required.
Access level: admin
Parameter
Type
Required
Value
elid
String (list)
Yes
One or more expense ids separated by commas. For example, 123,456.
sok
String
Yes
The value ok confirms operation execution. Without this parameter, changes will not be applied.
Set client filter
Function: expense.setfilter
Result: successful operation execution or error message
UI Equivalent: go to Billing → Expenses →→ click Filter by client.
Sets a client filter for the list of expenses. Conditions are saved and applied each time the list is displayed until changed or reset.
Access level: admin
Parameter
Type
Required
Value
account
String
No
Client from whose account the funds were debited. Wildcard * is supported. For example, client = *smith will filter expenses of all clients whose names contain smith: Blacksmith, Goldsmith, etc.
sok
String
No
The value ok confirms saving the filter.
Log in to the panel with user privileges
Function: expense.su
Result: successful operation execution or error message
UI Equivalent: go to Billing → Expenses → select expense → click Log in button.
Authorizes the administrator in the control panel with the privileges of the client to whom the expense is assigned.
Access level: admin
Parameter
Type
Required
Value
elid
Positive integer
Yes
Expense id to log in with.
Set filter
Function: expense.filter
Result: successful operation execution or error message
UI Equivalent: go to Billing → Expenses → Filter menu in the expenses list.
Sets an advanced filter. You can specify selection conditions for this list. They will be applied when it is displayed until the filter is changed or cleared.
Access level: admin
Parameter
Type
Required
Value
id
Positive integer
No
Unique identifier of the expense for filtering.
locale_name
String
No
Expense name. Wildcard * is supported. For example, client = *smith will filter expenses of all clients whose names contain smith: Blacksmith, Goldsmith, etc.
account
String
No
Client from whose account the funds were debited.
realdate.from
Date and time
No
Start of the debit date range. Format: YYYY-MM-DD.
Debit amount. Comparison operators are supported. For example, id = >100, client = smith will filter all clients named Smith, except the first 100.
notpayd
String
No
Unpaid portion of the expense.
payments
String
No
Payment numbers used to pay the expense.
taxamount
String
No
Tax amount. For example, 220.00 USD
reset
Flag
No
The value on resets all set filters.
Payments
Allocate expense amount to payments
Function: expense.payment
Result: list of elements
UI Equivalent: go to Billing → Expenses → select expense → click Payments.
Returns a list of expense-to-payment bindings indicating the amount debited from each payment.
Access level: admin, user
Parameter
Type
Required
Value
elid
Positive integer
Yes
Expense id for which to show the allocation.
Create or edit payments
Function: expense.payment.edit
Result: successful operation execution or error message
UI Equivalent: go to Billing → Expenses → select expense → Payments button → click Add.
Allows viewing, modifying, or binding a portion of the expense amount to a specific payment.
Access level: admin
Parameter
Type
Required
Value
plid
Positive integer
Yes
Unique identifier of the expense to which the payment should be bound (the id element from the expense function).
elid
Positive integer
No
Unique identifier of the binding (the payment element from the expense.payment function). Mandatory for modifying an existing record.
payment
Positive integer
Yes
Payment code from which a portion of the expense amount will be debited.
amount
String
Yes
Amount to be debited from the payment. Monetary value in period-separated format. For example, 15.00 USD
sok
String
Yes
The value ok confirms operation execution. Without this parameter, changes will not be applied.
Delete binding
Function: expense.payment.delete
Result: successful operation execution or error message
UI Equivalent: go to Billing → Payments → select payment → click Delete.
Deletes the binding of an expense portion to a payment. Supports deletion of multiple records separated by commas. Confirmation via the sok parameter is required.
Access level: admin
Parameter
Type
Required
Value
elid
String (list)
Yes
One or more binding identifiers (payment) separated by commas. For example, 100,200.
sok
String
Yes
The value ok confirms operation execution. Without this parameter, changes will not be applied.
The article was last updated on May 06, 2026. The article was prepared by technical writers of ISPsystem
En
Es