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
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).
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.
- Remove dependency on base_iban and develop a separate glue module
between this module and base_iban
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.
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.