Expenses

Managing Expenses

Everything the business spends that is not stock — rent, wages, utilities, transport. Without these, profit is only ever an estimate.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/expenses

Requires subscriptionexpense.view1,000 IQD / month
Requires subscriptionexpense.add2,000 IQD / month

Overview

Expenses are the second half of the profit calculation. Sales less cost of goods gives gross profit; only after expenses do you get the number that matters. An expense recorded here flows straight into profit and loss.

Expenses — Expenses screen
Expenses screen
Expenses screen — The expense list with category filter and date range, and the summary figures above it.

The expense features

Expense module — monthly price
ParameterTypeRequiredDescription
expense.view1,000 IQDOptionalSee the expense list and summary.
expense.add2,000 IQDOptionalAdd and edit expense entries.
expense.delete1,000 IQDOptionalDelete expense entries.
expense.categories1,000 IQDOptionalCreate and manage expense categories.
NoteThese are separate on purpose. A bookkeeper can be given viewing and adding without the ability to delete, so entries cannot quietly disappear.

Categories

A category groups similar costs so the profit and loss breakdown is readable. A starter set is created with the business:

  • Rent
  • Utilities
  • Salaries
  • Transport
  • Marketing
  • Supplies
  • Maintenance
  • Miscellaneous
Requires subscriptionexpense.categories1,000 IQD / month
TipResist adding many categories. The list exists to make the P&L readable — a dozen meaningful groups tell you more than fifty precise ones nobody maintains.
  1. 1

    Open Expenses

    Choose Expenses from the navigation menu.

  2. 2

    Add an expense

    Choose Add Expense to open the form.

  3. 3

    Fill in the details

    Enter the amount and pick a category. The date defaults to today — change it if you are entering something after the fact.

    Expenses — Expense form
    Expense form
    Expense form — Amount, category, date, description and reference number fields.
  4. 4

    Add a reference

    Record the receipt or bill number so the entry can be tied back to paperwork later.

  5. 5

    Save

    The expense appears in the list and in this month's totals immediately.

Expense fields

POST /api/v1/expenses
ParameterTypeRequiredDescription
cat_idintegerOptionalExpense category.
amountdecimalRequiredAmount spent.
expense_datedateOptionalWhen it was incurred. Defaults to today.
descriptionstringOptionalWhat it was for.
reference_nostringOptionalReceipt, bill or voucher number.

Filtering

GET /api/v1/expenses
ParameterTypeRequiredDescription
cat_idintegerOptionalRestrict to one category.
from_datedateOptionalOn or after this date.
to_datedateOptionalOn or before this date.
searchstringOptionalMatch on description or reference number.
pageinteger= 1OptionalPage number.
page_sizeinteger= 50OptionalRows per page.

The summary

GET /api/v1/expenses/summary
ParameterTypeRequiredDescription
total_amountdecimalOptionalTotal spent in the period.
total_countintegerOptionalNumber of entries.
avg_amountdecimalOptionalAverage value of an entry.
top_category_namestringOptionalCategory with the highest total.
top_category_amountdecimalOptionalHow much that category came to.
by_category[]arrayOptionalTotal and count per category.
monthly[]arrayOptionalTotals per month, for trend comparison.
TipThe monthly breakdown is the quickest way to spot a cost that has crept up. A utility bill drifting month on month is far easier to see here than in a list of individual entries.

Voiding an expense

An expense entered in error is voided rather than erased. It keeps its place in the list, marked is_void, and stops counting toward totals and profit.

Requires subscriptionexpense.delete1,000 IQD / month
WarningVoiding changes historical profit figures for the period the expense sat in. If you void something from a closed month, expect that month's reported profit to move.

Expenses raised automatically

Two kinds of expense are created by the system rather than typed in:

  • Damage write-offs — writing off damaged stock posts the value of the loss as an expense, linked to the damage record. It is a loss in profit and loss but not cash going out: the stock left, not the money. See Stock Management.
  • Landed Costs— when customs or transport is added to a purchase whose goods have partly been sold, the share belonging to the sold goods is booked under a “Landed Costs” category. Voiding the purchase later does not remove it; its description is annotated instead. See Landed Costs & Cost Mode.
NoteA voided expense goes to the recycle bin, where the owner can restore it.

Related