Odoo 19.0 Community · Persistent

hr.expense: fields, relations and API

The hr.expense model ("Expense") is a persistent model declared by the Expenses module, then extended by 3 other modules. It exposes 84 fields, 50 of them declared directly on the model; 10 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.

View source code Search another model

Model identity

Technical name: hr.expense
Label: Expense
Type: Persistent (models.Model)
SQL table: hr_expense
Origin module: Expenses (hr_expense)
Extended by: project_hr_expense, sale_expense, project_sale_expense
Default order (_order): date desc, id desc
Inherits from (mixins): mail.thread.main.attachment mail.activity.mixin analytic.mixin

Model fields

50 own fields, 28 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

84 of 84 fields shown

Technical name	Label	Type	Details
account_id	Account An expense account is expected	`many2one` → account.account	computed, stored
account_move_id	Journal Entry	`many2one` → account.move	read-only
amount_residual	Amount Due	`monetary`	read-only related: `account_move_id.amount_residual`
approval_date	Approval Date	`datetime`	read-only
approval_state	Approval State	`selection`	read-only Values: `submitted` (Submitted), `approved` (Approved), `refused` (Refused)
attachment_ids	Attachments	`one2many` → ir.attachment	inverse: `res_id`
can_approve	Can Approve	`boolean`	read-onlycomputed
can_be_reinvoiced	Can be reinvoiced	`boolean`	computed added by Sales Expense (`sale_expense`)
can_reset	Can Reset	`boolean`	read-onlycomputed
company_currency_id	Report Company Currency	`many2one` → res.currency	read-only related: `company_id.currency_id`
company_id	Company	`many2one` → res.company	requiredread-only
currency_id	Currency	`many2one` → res.currency	requiredcomputed, stored
currency_rate	Currency Rate	`float`	read-onlycomputed
date	Expense Date	`date`
department_id	Department	`many2one` → hr.department	computed, stored
description	Internal Notes	`text`
duplicate_expense_ids	Duplicate Expense	`many2many` → hr.expense	computed
employee_id	Employee	`many2one` → hr.employee	requiredcomputed, stored
former_sheet_id	Former Report	`integer`
is_editable	Is Editable By Current User	`boolean`	read-onlycomputed
is_multiple_currency	Is currency_id different from the company_currency_id	`boolean`	computed
journal_id	Journal	`many2one` → account.journal	read-only related: `payment_method_line_id.journal_id`
label_currency_rate	Label Currency Rate	`char`	read-onlycomputed
manager_id	Manager	`many2one` → res.users	computed, stored
message_main_attachment_checksum	Message Main Attachment Checksum	`char`	related: `message_main_attachment_id.checksum`
name	Description	`char`	requiredcomputed, stored
nb_attachment	Number of Attachments	`integer`	computed
payment_method_line_id	Payment Method The payment method used when the expense is paid by the company.	`many2one` → account.payment.method.line	computed, stored
payment_mode	Paid By	`selection`	required Values: `own_account` (Employee (to reimburse)), `company_account` (Company)
price_unit	Unit Price	`float`	requiredread-onlycomputed, stored
product_description	Product Description	`html`	computed
product_has_cost	Product Has Cost	`boolean`	computed
product_has_tax	Whether tax is defined on a selected product	`boolean`	computed
product_id	Category	`many2one` → product.product
product_uom_id	Unit	`many2one` → uom.uom	computed, stored
quantity	Quantity	`float`	required
sale_order_id	Customer to Reinvoice If the category has an expense policy, it will be reinvoiced on this sales order	`many2one` → sale.order	computed, stored added by Sales Expense (`sale_expense`)
sale_order_line_id	Sale Order Line	`many2one` → sale.order.line	read-onlycomputed, stored added by Sales Expense (`sale_expense`)
same_receipt_expense_ids	Same Receipt Expense	`many2many` → hr.expense	computed
selectable_payment_method_line_ids	Selectable Payment Method Line	`many2many` → account.payment.method.line	computed
split_expense_origin_id	Origin Split Expense Original expense from a split.	`many2one` → hr.expense
state	Status	`selection`	read-onlycomputed, stored Values: `draft` (Draft), `submitted` (Submitted), `approved` (Approved), `posted` (Posted), `in_payment` (In Payment), `paid` (Paid), `refused` (Refused)
tax_amount	Tax amount Tax amount in company currency	`monetary`	computed, stored
tax_amount_currency	Tax amount in Currency Tax amount in currency	`monetary`	computed, stored
tax_ids	Included taxes Both price-included and price-excluded taxes will behave as price-included taxes for expenses.	`many2many` → account.tax	computed, stored
total_amount	Total	`monetary`	computed, stored
total_amount_currency	Total In Currency	`monetary`	computed, stored
untaxed_amount	Total Untaxed Amount	`monetary`	computed, stored
untaxed_amount_currency	Total Untaxed Amount In Currency	`monetary`	computed, stored
vendor_id	Vendor	`many2one` → res.partner
activity_calendar_event_id	Next Activity Calendar Event	`many2one` → calendar.event	computed inherited from mail.activity.mixin
activity_date_deadline	Next Activity Deadline	`date`	read-onlycomputed inherited from mail.activity.mixin
activity_exception_decoration	Activity Exception Decoration Type of the exception activity on record.	`selection`	computed Values: `warning` (Alert), `danger` (Error) inherited from mail.activity.mixin
activity_exception_icon	Icon Icon to indicate an exception activity.	`char`	computed inherited from mail.activity.mixin
activity_ids	Activities	`one2many` → mail.activity	inverse: `res_id` inherited from mail.activity.mixin
activity_state	Activity State Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	computed Values: `overdue` (Overdue), `today` (Today), `planned` (Planned) inherited from mail.activity.mixin
activity_summary	Next Activity Summary	`char`	related: `activity_ids.summary` inherited from mail.activity.mixin
activity_type_icon	Activity Type Icon	`char`	related: `activity_ids.icon` inherited from mail.activity.mixin
activity_type_id	Next Activity Type	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` inherited from mail.activity.mixin
activity_user_id	Responsible User	`many2one` → res.users	read-onlycomputed inherited from mail.activity.mixin
analytic_distribution	Analytic Distribution	`json`	computed, stored inherited from analytic.mixin
analytic_precision	Analytic Precision	`integer`	inherited from analytic.mixin
distribution_analytic_account_ids	Distribution Analytic Account	`many2many` → account.analytic.account	computed inherited from analytic.mixin
has_message	Has Message	`boolean`	computed inherited from mail.thread
message_attachment_count	Attachment Count	`integer`	computed inherited from mail.thread
message_follower_ids	Followers	`one2many` → mail.followers	inverse: `res_id` inherited from mail.thread
message_has_error	Message Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_has_error_counter	Number of errors Number of messages with delivery error	`integer`	computed inherited from mail.thread
message_has_sms_error	SMS Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_ids	Messages	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
message_is_follower	Is Follower	`boolean`	computed inherited from mail.thread
message_main_attachment_id	Main Attachment	`many2one` → ir.attachment	inherited from mail.thread.main.attachment
message_needaction	Action Needed If checked, new messages require your attention.	`boolean`	computed inherited from mail.thread
message_needaction_counter	Number of Actions Number of messages requiring action	`integer`	computed inherited from mail.thread
message_partner_ids	Followers (Partners)	`many2many` → res.partner	computed inherited from mail.thread
my_activity_date_deadline	My Activity Deadline	`date`	read-onlycomputed inherited from mail.activity.mixin
rating_ids	Ratings	`one2many` → rating.rating	inverse: `res_id` inherited from mail.thread
website_message_ids	Website Messages Website communication history	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
display_name	Display Name	`char`	read-onlycomputedautomatic
id	ID	`integer`	read-onlyautomatic
write_date	Last Updated on	`datetime`	read-onlyautomatic
write_uid	Last Updated by	`many2one` → res.users	read-onlyautomatic

Relations

Models linked from this model

account.account: account_id
account.journal: journal_id
account.move: account_move_id
account.payment.method.line: payment_method_line_id, selectable_payment_method_line_ids
account.tax: tax_ids
hr.department: department_id
hr.employee: employee_id
hr.expense: duplicate_expense_ids, same_receipt_expense_ids, split_expense_origin_id
ir.attachment: attachment_ids
product.product: product_id
res.company: company_id
res.currency: company_currency_id, currency_id
res.partner: vendor_id
res.users: manager_id
sale.order: sale_order_id
sale.order.line: sale_order_line_id
uom.uom: product_uom_id

Fields of other models pointing here

account.move.line: expense_id
account.tax: hr_expense_ids
hr.expense: duplicate_expense_ids, same_receipt_expense_ids, split_expense_origin_id
hr.expense.approve.duplicate: expense_ids
hr.expense.refuse.wizard: expense_ids
hr.expense.split: expense_id
hr.expense.split.wizard: expense_id
sale.order.line: expense_id

Reading this model through the API

Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.

curl

curl -X POST "https://your-instance.odoo.com/json/2/hr.expense/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","company_id","currency_id","employee_id","payment_mode"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}

res = requests.post(
    f"{BASE_URL}/hr.expense/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","company_id","currency_id","employee_id","payment_mode"], "limit": 5},
)
res.raise_for_status()
print(res.json())

External API access requires Odoo's Custom plan.
XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
The access rights and record rules of the key's user apply.

Cite this tool

Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.

<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/hr-expense">hr.expense (Odoo 19.0)</a>

Sources

Data verified on September 23, 2026 · Odoo 19.0 Community

Have an Odoo project, or want to put your ERP to work with AI? Let's talk

Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.