OdooWiki OCA HUB

Unique Supplier Invoice Number in Invoice

account_invoice_supplier_ref_unique folder_open OCA/account-invoicing open_in_new
Accounting & Finance License: AGPL-3

This module checks that a supplier invoice/refund is not entered twice. This is important because if you enter twice the same supplier invoice, there is also a risk that you pay it twice !

This module adds a constraint on supplier invoice/refunds to check that (commercial_partner_id, supplier_invoice_number) is unique, without considering the case of the supplier invoice number. To activate that feature:

  • Go to Invoicing/Accounting \> Configuration \> Settings \> Vendor Bills
  • Check the 'Check Unicity on Supplier Invoice Number' box.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Prevents entering the same vendor bill twice by checking that the supplier invoice number is unique per supplier. The check is optional and can be switched on in the accounting settings.

This module helps you avoid recording the same vendor bill or refund twice, which reduces the risk of paying a supplier twice.

  • A new field 'Vendor invoice number' appears on vendor bills and refunds, next to the existing reference field. It is only visible for vendor bills/refunds and can only be edited while the document is still in draft.
  • When you type a vendor invoice number, it is automatically copied into the reference field if that field is still empty.
  • If the option is enabled, Odoo checks that no other vendor bill or refund from the same supplier already uses the same vendor invoice number, ignoring upper/lower case differences. If a duplicate is found, saving is blocked with an error message showing the existing document number and supplier.
  • The check is controlled by a new setting 'Check Unicity on Supplier Invoice Number' under Invoicing/Accounting > Configuration > Settings > Vendor Bills. It is stored per company.
  • When you duplicate a vendor bill, the vendor invoice number is not copied, so the copy does not trigger a duplicate error.
  • When you reverse or cancel a vendor bill, the reference is cleared on the reversal to avoid conflicts.

The module extends the accounting documents (account.move), company settings (res.company) and the settings screen (res.config.settings).

Depends on

account

Required by other modules

account_edi_ubl_cii_supplier_invoice_number
Models and fields (3)
  • res.company · extends an existing modelcheck_invoice_supplier_number
  • account.move · extends an existing modelsupplier_invoice_number (Vendor invoice number)
  • res.config.settings · extends an existing modelcheck_invoice_supplier_number

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 7 confirmed, 2 with no information of 9 versions.

Sources · Odoo 14.0

Confirmed on 2026-11-03 in branch 14.0 of OCA/account-invoicing.

terminal Installation and usage

No verified information

Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.