How to Configure Expense Report in iDempiere

The Expense Report window in iDempiere records employee and store-level expenses such as customer visit costs, petty cash purchases, and travel spending. Retail businesses use it to capture reimbursable expenses at the store level, tag them to a Business Partner, Warehouse, and Price List, and route them through approval. Once approved and processed, expense reports feed into invoicing, reimbursement, and store expense reporting.

Process Flow

TenthPlanet iDempiere ExpenseReport

Business Rules

  • Only Active expense reports are available for entry and processing.
  • Line Amount is calculated automatically from Quantity and Expense Amount.
  • The Invoiced checkbox blocks duplicate reimbursement of a billed expense line.
  • Expense lines can be linked to a Project, Phase, Task, and Activity for cost tracking.
  • Currency conversion applies when Expense Amount currency differs from the base currency.

Prerequisites

  • Business Partner (employee and supplier) configured.
  • Organization (store, e.g. Chennai Store) configured.
  • Warehouse configured and linked to the Organization.
  • Price List (e.g. Standard Sales Price List) configured.
  • Product master data configured for expense items.
  • Currency and Currency Rate configured for non-base currency expenses.
  • Project, Phase, Task, and Activity configured, if cost allocation is required.

Navigation

Menu → Partner Relations → Service → Expense Report

Configuration Steps

Step 1: Create the Expense Report Header

Open a new Expense Report record. Enter Description, select the Business Partner, Report Date, Price List, and Warehouse. Save the record before adding lines.

FieldSample ValueDescription
Business PartnerArun PrakashEmployee or party claiming the expense
Report Date07/21/2026Date the expense report is created
Price ListStandard Sales Price ListPrice list used to value expense products
WarehouseCHN GodownWarehouse tied to the claiming store
DescriptionCustomer Visit ExpensesShort label for the report
TenthPlanet iDempiere PartnerRelation ExpenseReport 1

Step 2: Add Report Lines

In the Report Line tab, select the Product, enter Quantity and Expense Amount, and confirm the Currency. Add a Description for the specific expense. Repeat for each expense item.

FieldSample ValueDescription
ProductBritannia Good Day Butter CookiesItem or expense category purchased
Quantity10Units of the product claimed
Expense Amount200.00Cost per line before conversion
CurrencyINRCurrency of the expense amount
Line Amount2,000.00Total value of the line, calculated automatically
DescriptionRefreshments during customer meetingNote on the specific expense
TenthPlanet iDempiere PartnerRelation ExpenseReport 2

Step 3: Link Reference Details

Expand the Reference section on the Report Line. Select a Business Partner (supplier) if the expense was purchased from a vendor. Set Project, Project Phase, Project Task, and Activity when the expense must be allocated to a specific cost object.

FieldSample ValueDescription
Business PartnerChennai SuppliersSupplier the expense item was purchased from
Project(optional)Project the expense cost is allocated to
Project Phase(optional)Phase within the linked project
Project Task(optional)Task within the project phase
Quantity Reimbursed0Quantity already reimbursed to the employee
Price Reimbursed0.00Amount already reimbursed to the employee
TenthPlanet iDempiere PartnerRelation ExpenseReport 3

Step 4: Approve the Expense Report

Review the Approval Amount against the report total. Check the Approved box once the amount is confirmed by the approving manager.

Step 5: Complete and Process the Document

Click Document Action and select Complete. Confirm Document Status changes to Completed and the Processed checkbox is set.

Note: Once Processed is checked, header and line fields become read-only

Common Issues and Resolutions

IssueCauseResolution
Document will not CompleteMandatory field left blank (Business Partner, Report Date)Fill all fields marked with an asterisk before completing
Warehouse not listed in dropdownWarehouse not linked to the OrganizationAssign the Warehouse to the Organization in Warehouse setup
Product missing from Report LineProduct not present in the selected Price ListAdd the product and price to the Price List
Currency conversion errorNo conversion rate defined for the expense currencySet up a Currency Rate under the Conversion Type

Next Steps

  • Configure Invoice generation from completed Expense Reports.
  • Set up Payment Processing for employee reimbursement.
  • Review Product setup for recurring expense categories.
  • Configure approval limits and Document Action workflow rules.