Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
116 changes: 116 additions & 0 deletions hr_expense_vendor_bill/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
======================
HR Expense Vendor Bill
======================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:a3212290485c41bc5c7bd0a8167fc699612b4a097fdc9e66aa9b3b4f4981a003
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fhr--expense-lightgray.png?logo=github
:target: https://github.com/OCA/hr-expense/tree/18.0/hr_expense_vendor_bill
:alt: OCA/hr-expense
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/hr-expense-18-0/hr-expense-18-0-hr_expense_vendor_bill
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/hr-expense&target_branch=18.0
:alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module extends employee expenses paid with the employee's own
account to automatically create vendor bills grouped by supplier,
register supplier payments, and generate an employee reimbursement bill
that is reconciled with those payments.

**Table of contents**

.. contents::
:local:

Configuration
=============

Before using the module, configure the reimbursement accounts on the
company:

1. Go to *Expenses > Configuration > Settings*.
2. Set the **Employee reimbursement debit account**.
3. Set the **Miscellaneous payables - employees** account.

Optionally, create a bank journal named *Employee payments* to register
supplier payments during expense report posting.

Usage
=====

For expenses paid by the employee:

1. Create an expense and set the **Vendor** on each expense line.
2. Submit and approve the expense report.
3. Post the expense report.

The module will:

- Create one draft vendor bill per supplier found on the expense lines.
- Post those vendor bills and register outbound payments.
- Create and post an employee reimbursement vendor bill.
- Reconcile the reimbursement with the supplier payments.

When resetting an approved expense report to draft, related journal
entries and payments are removed automatically.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/hr-expense/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/hr-expense/issues/new?body=module:%20hr_expense_vendor_bill%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Gray Matter Logic

Contributors
------------

- `Gray Matter Logic <https://www.graymatterlogic.com>`__:

- Diego Vega <dcamacho@opensourceintegrators.com>
- Samuel Macias Oropeza <smacias@opensourceintegrators.com>
- Hector del Reguero <hector.delreguero@graymatterlogic.com>
- Maxime Chambreuil <maxime.chambreuil@graymatterlogic.com>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/hr-expense <https://github.com/OCA/hr-expense/tree/18.0/hr_expense_vendor_bill>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 change: 1 addition & 0 deletions hr_expense_vendor_bill/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import models
26 changes: 26 additions & 0 deletions hr_expense_vendor_bill/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# Copyright 2025 Gray Matter Logic
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).

{
"name": "HR Expense Vendor Bill",
"summary": "Create vendor bills from employee expenses paid on own account",
"author": "Gray Matter Logic, Odoo Community Association (OCA)",
"website": "https://github.com/OCA/hr-expense",
"version": "18.0.1.0.0",
"category": "Human Resources/Expenses",
"depends": ["account", "hr_expense"],
"data": [
"views/res_config_settings_views.xml",
"views/hr_expense_views.xml",
"views/account_move_views.xml",
"views/hr_expense_sheet_inherit_views.xml",
],
"demo": [
"demo/res_company_demo.xml",
"demo/res_partner_demo.xml",
"demo/hr_expense_demo.xml",
],
"installable": True,
"application": False,
"license": "AGPL-3",
}
22 changes: 22 additions & 0 deletions hr_expense_vendor_bill/demo/hr_expense_demo.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
<?xml version="1.0" encoding="utf-8" ?>
<odoo>
<record id="vendor_bill_expense_sheet_demo" model="hr.expense.sheet">
<field name="name">Employee vendor expense (demo)</field>
<field name="employee_id" ref="hr.employee_admin" />
<field name="payment_mode">own_account</field>
</record>

<record id="vendor_bill_expense_line_demo" model="hr.expense">
<field name="name">Hotel paid by employee</field>
<field name="employee_id" ref="hr.employee_admin" />
<field name="sheet_id" ref="vendor_bill_expense_sheet_demo" />
<field
name="product_id"
ref="hr_expense.expense_product_travel_accommodation"
/>
<field name="vendor_id" ref="expense_vendor_demo" />
<field name="payment_mode">own_account</field>
<field name="total_amount_currency" eval="150.0" />
<field name="date" eval="time.strftime('%Y-%m-%d')" />
</record>
</odoo>
15 changes: 15 additions & 0 deletions hr_expense_vendor_bill/demo/res_company_demo.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
<?xml version="1.0" encoding="utf-8" ?>
<odoo>
<record id="base.main_company" model="res.company">
<field
name="hr_expense_reimbursement_debit_account_id"
search="[('account_type', '=', 'expense'), ('company_ids', 'in', [ref('base.main_company')])]"
model="account.account"
/>
<field
name="hr_expense_reimbursement_credit_account_id"
search="[('account_type', '=', 'liability_payable'), ('company_ids', 'in', [ref('base.main_company')])]"
model="account.account"
/>
</record>
</odoo>
7 changes: 7 additions & 0 deletions hr_expense_vendor_bill/demo/res_partner_demo.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<?xml version="1.0" encoding="utf-8" ?>
<odoo>
<record id="expense_vendor_demo" model="res.partner">
<field name="name">Demo Expense Vendor</field>
<field name="supplier_rank">1</field>
</record>
</odoo>
Loading
Loading