Account Invoice Import
This module has been started by lazy accounting users who hate enter they vendor bills manually in Odoo. Almost all companies have several vendor bills to enter regularly in the system from the same vendors: phone bill, electricity bill, Internet access, train tickets, etc. Most of these invoices are available as PDF. If we are able to automatically extract from the PDF the required information to enter the invoice as vendor bill in Odoo, then this module will create it automatically. To know the full story behind the development of this module, read this blog post.
In order to reliably extract the required information from the invoice, two international standards exists to describe an Invoice in XML:
CII (Cross-Industry Invoice) developped by UN/CEFACT (United Nations Centre for Trade Facilitation and Electronic Business),
UBL (Universal Business Language) which is an ISO standard (ISO/IEC 19845) developped by OASIS (Organization for the Advancement of Structured Information Standards).
The Factur-X invoice standard embeds a CII XML file inside the PDF invoice: this is the concept of hybrid invoice.
This module has native support for UBL XML, CII XML and Factur-X. You can install additional modules (for example account_invoice_import_simple_pdf) to support other invoice formats.
Here is how the module works:
the user starts a wizard and uploads the PDF or XML invoice,
if it is an XML file, Odoo will parse it to create the invoice
if it is a PDF file with an embedded XML file in Factur-X/CII format, Odoo will extract the embedded XML file and parse it to create the invoice,
if there is already a draft supplier invoice for this supplier with the same invoice number, Odoo will display a warning,
otherwise, Odoo will create a new draft vendor bill and attach the PDF or XML invoice file to it.
This module also works with vendor refunds.
Table of contents
Configuration
Go to the form view of the suppliers and configure it with the following parameters:
the VAT Number (this field is used by default when searching the supplier in the Odoo partner database)
in the Accounting tab, set the Invoice Import Configuration.
You can configure a mail gateway to import invoices from an email:
Go to the menu Settings > Technical > Email > Incoming Mail Servers and setup the access (POP or IMAP) to the mailbox that will be used to receive the invoices,
In the section Actions to perform on incoming mails, set the field Create a new record to Wizard to import supplier invoices/refunds (model account.invoice.import).
If you are in a multi-company setup, you also have to go to the menu Invoicing > Configuration > Settings: in the section Invoice Import, enter the email of the mailbox used to import invoices in the field Mail Gateway: Destination E-mail (it will be used to import the invoice in the proper company).
Usage
Go to the menu Invoicing > Vendors > Import Vendor Bill and follow the instructions of the wizard. You can also start the wizard from the Accounting Dashboard: on the purchase journal, click on the Upload button.
You can upload several invoice file at the same time.
Known issues / Roadmap
Remove dependency on base_iban and develop a separate glue module between this module and base_iban
Bug Tracker
Bugs are tracked on GitHub 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.
Do not contact contributors directly about support or help with technical issues.
Credits
Contributors
Alexis de Lattre <alexis.delattre@akretion.com>
Andrea Stirpe <a.stirpe@onestein.nl>
Nicolas JEUDY <https://github.com/njeudy>
Yannick Vaucher <yannick.vaucher@camptocamp.com>
Ronald Portier <ronald@therp.nl>
Simone Orsi <simone.orsi@camptocamp.com>
Michael Tietz (MT Software) <mtietz@mt-software.de>
Maintainers
This module is maintained by the OCA.
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.
Current maintainer:
This module is part of the OCA/edi project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Metadata
Release files for odoo-addon-account-invoice-import 18.0.2.0.0.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| odoo_addon_account_invoice_import-18.0.2.0.0.13-py3-none-any.whl | Python 3 | none | any | Details for odoo_addon_account_invoice_import-18.0.2.0.0.13-py3-none-any.whl |
Release files / odoo_addon_account_invoice_import-18.0.2.0.0.13-py3-none-any.whl
| Download URL | odoo_addon_account_invoice_import-18.0.2.0.0.13-py3-none-any.whl |
|---|---|
| Size | 473.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7e64cd29e44a1b3ca806e9615090a71f5b9879e3fa06f20a334280a93f656c6f
|
|
BLAKE2b-256 checksum How to use checksums |
bd5c1293cae8c060eb10fdc32418f6162af1619fad44bd71bf2e889eb37e1cb6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for odoo-addon-account-invoice-import 18.0.2.0.0.13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.