<h1 class="title">Account Invoice Import</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/edi/tree/12.0/account_invoice_import"><img alt="OCA/edi" src="https://img.shields.io/badge/github-OCA%2Fedi-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/edi-12-0/edi-12-0-account_invoice_import"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/226/12.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>This module has been started by lazy accounting users who hate enter they supplier invoices manually in Odoo. Almost all companies have several supplier invoices to enter regularly in the system from the same suppliers: phone bill, electricity bill, Internet access, train tickets, etc. Most of these invoices are available as PDF. We dream that we would be able to automatically extract from the PDF the required information to enter the invoice as supplier invoice in Odoo. To know the full story behind the development of this module, read this <a class="reference external" href="http://www.akretion.com/blog/akretions-christmas-present-for-the-odoo-community">blog post</a>.</p> <p>In the future, we believe we will have structured information embedded inside the metadata of PDF invoices. There are 2 main standards for electronic invoicing:</p> <ul class="simple"> <li><a class="reference external" href="http://tfig.unece.org/contents/cross-industry-invoice-cii.htm">CII</a> (Cross-Industry Invoice) developped by <a class="reference external" href="http://www.unece.org/cefact">UN/CEFACT</a> (United Nations Centre for Trade Facilitation and Electronic Business),</li> <li><a class="reference external" href="http://ubl.xml.org/">UBL</a> (Universal Business Language) which is an ISO standard (<a class="reference external" href="http://www.iso.org/iso/catalogue_detail.htm?csnumber=66370">ISO/IEC 19845</a>) developped by <a class="reference external" href="https://www.oasis-open.org/">OASIS</a> (Organization for the Advancement of Structured Information Standards).</li> </ul> <p>For example, there is already a standard in Germany called <a class="reference external" href="http://www.pdflib.com/knowledge-base/pdfa/zugferd-invoices/">ZUGFeRD</a> which is based on CII.</p> <p>This module doesn't do anything useful by itself ; it requires other modules to work: each modules adds a specific invoice format.</p> <p>Here is how the module works:</p> <ul class="simple"> <li>the user starts a wizard and uploads the PDF or XML invoice,</li> <li>if it is an XML file, Odoo will parse it to create the invoice (requires additional modules for specific XML formats, such as the module <em>account_invoice_import_ubl</em> for the UBL format),</li> <li>if it is a PDF file with an embedded XML file in ZUGFeRD/CII format, Odoo will extract the embedded XML file and parse it to create the invoice (requires the module <em>account_invoice_import_zugferd</em>),</li> <li>otherwise, Odoo will use the <em>invoice2data</em> Python library to try to interpret the text of the PDF (requires the module <em>account_invoice_import_invoice2data</em>),</li> <li>if there is already some draft supplier invoice for this supplier, Odoo will propose to select one to update or create a new draft invoice,</li> <li>otherwise, Odoo will directly create a new draft supplier invoice and attach the PDF to it.</li> </ul> <p>This module also works with supplier refunds.</p> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li> <li><a class="reference internal" href="#known-issues-roadmap" id="id2">Known issues / Roadmap</a></li> <li><a class="reference internal" href="#bug-tracker" id="id3">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id4">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id5">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id6">Contributors</a></li> <li><a class="reference internal" href="#maintainers" id="id7">Maintainers</a></li> </ul> </li> </ul> </div> <a name="configuration"></a> <h2><a class="toc-backref" href="#id1">Configuration</a></h2> <p>Go to the form view of the suppliers and configure it with the following parameters:</p> <ul class="simple"> <li><em>is a Company ?</em> is True</li> <li><em>Supplier</em> is True</li> <li>the <em>TIN</em> (i.e. VAT number) is set (the VAT number is used by default when searching the supplier in the Odoo partner database)</li> <li>in the <em>Accounting</em> tab, create one or several <em>Invoice Import Configurations</em>.</li> </ul> <p>You can configure a mail gateway to import invoices from an email:</p> <ul class="simple"> <li>Go to the menu <em>Settings &gt; Technical &gt; Email &gt; Incoming Mail Servers</em> and setup the access (POP or IMAP) to the mailbox that will be used to received the invoices,</li> <li>In the section <em>Actions to perform on incoming mails</em>, set the field <em>Create a new record</em> to <em>Wizard to import supplier invoices/refunds</em> (model <em>account.invoice.import</em>). The field <em>Server Action</em> should be left empty.</li> <li>If you are in a multi-company setup, you also have to go to the menu <em>Accounting &gt; Configuration &gt; Settings</em>: in the section <em>Invoice Import</em>, enter the email of the mailbox used to import invoices in the field <em>Mail Gateway: Destination E-mail</em> (it will be used to select the right company to import the invoice in).</li> </ul> <a name="known-issues-roadmap"></a> <h2><a class="toc-backref" href="#id2">Known issues / Roadmap</a></h2> <ul class="simple"> <li>Remove dependency on <em>base_iban</em> and develop a separate glue module between this module and <em>base_iban</em></li> <li>Enhance the update of an existing invoice by analysing the lines (lines are only available when the invoice has an embedded XML file)</li> <li>Add a mail gateway to be able to forward the emails that we receive with PDF invoices to a dedicated address ; the gateway would detach the PDF invoice from the email and create the draft supplier invoice in Odoo.</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id3">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/edi/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed <a class="reference external" href="https://github.com/OCA/edi/issues/new?body=module:%20account_invoice_import%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id4">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id5">Authors</a></h3> <ul class="simple"> <li>Akretion</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id6">Contributors</a></h3> <ul class="simple"> <li>Alexis de Lattre &lt;<a class="reference external" href="mailto:alexis.delattre&#64;akretion.com">alexis.delattre&#64;akretion.com</a>&gt;</li> <li>Andrea Stirpe &lt;<a class="reference external" href="mailto:a.stirpe&#64;onestein.nl">a.stirpe&#64;onestein.nl</a>&gt;</li> <li>Nicolas JEUDY &lt;<a class="reference external" href="https://github.com/njeudy">https://github.com/njeudy</a>&gt;</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id7">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <p>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.</p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/edi/tree/12.0/account_invoice_import">OCA/edi</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>