<h1 class="title">Portugal InvoiceXpress Integration</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Production/Stable" src="https://img.shields.io/badge/maturity-Production%2FStable-green.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/l10n-portugal/tree/16.0/l10n_pt_account_invoicexpress"><img alt="OCA/l10n-portugal" src="https://img.shields.io/badge/github-OCA%2Fl10n--portugal-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/l10n-portugal-16-0/l10n-portugal-16-0-l10n_pt_account_invoicexpress"><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/171/16.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>Generate Portuguese tax authority legal Invoices (&quot;Faturas&quot;) using InvoiceXpress.</p> <p><strong>UPDATE November/2021:</strong></p> <p>Invoices:</p> <ul class="simple"> <li>Added support to the different documents types: Invoice, Invoice Receipt, Simplified Invoice and VAT MOSS. The default document type is set on the Journal, and can be changed on the Invoice form.</li> <li>Use the invoice commercial partner for the name and address, instead of the invoice contact.</li> <li>Added support for the Terms and Conditions/Observations field</li> <li>Added to Credit Notes the link to the source Invoice</li> </ul> <p>InvoiceXpress is a paid service. Visit <a class="reference external" href="https://invoicexpress.com">https://invoicexpress.com</a> for more details.</p> <p>Once the InvoiceXpress connection is configured, the invoice CONFIRM button automatically generates the InvoiceXpress invoice.</p> <p>If the InvoiceXpress Invoice email template is configured, the InvoiceXpress service will also send the invoice by email, using the details in Odoo configured email template.</p> <p>This replaces the Odoo SEND &amp; PRINT button, since only the InvoiceXpress generated document should be used. Having other print layouts for the invoice is not allowed by the Portuguese Tax Authority.</p> <p>Legal transport documents (&quot;Guias de Transporte&quot; e &quot;Guias de Remessa) are also supported through the extension module &quot;l10n_pt_stock_invoicexpress&quot;.</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="#usage" id="id2">Usage</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>To configure:</p> <ul class="simple"> <li>Navigate to Settings/General Settings.</li> <li>In the &quot;General Settings&quot; configuration section, locate the &quot;InvoiceXpress&quot; subsection: There you can set:<ul> <li>InvoiceXpress Account Name</li> <li>InvoiceXpress API Key</li> <li>InvoiceXpress Invoice Email Template</li> </ul> </li> </ul> <p>The email template is used to prepare the details for the email the InvoiceXpress service sends with the invoice:</p> <ul class="simple"> <li>&quot;To&quot; email address</li> <li>&quot;Cc&quot; email address</li> <li>Subject</li> <li>Body</li> </ul> <p>Translations are supported, and the customer language is used to render the email details.</p> <p>The InvoiceXpress configuration is per company, and can also be modified directly on the Company form, if the Developer Mode is enabled.</p> <p>On the Journal form, for sales journals, a flag is available to allow disabling the InvoiceXpress integration. This can be useful for a journal that was used temporarily to import invoice history, for reporting purposes, ond was then disabled, or to allow that journal to use a different legal invoicing system.</p> <p>Note that all invoices generated MUST use a certified invoicing system. For a portuguese company, you cannot have some of the invoices being generated by Odoo itself. So use this option at your own risk, and only in the cases you are sure to be compliant with TPortugues Tax Authority invoicing regulations.</p> <a name="usage"></a> <h2><a class="toc-backref" href="#id2">Usage</a></h2> <p>On an Invoice, the CONFIRM button automatically generates an invoice on the InvoiceXpress service.</p> <p>The &quot;Email InvoiceXpress&quot; button requests the InvoiceXpress service to send an email with a copy of the legal document.</p> <p>The Invoice form shows an &quot;InvoiceXpress&quot; tab containing details for the corresponding InvoiceXpress document.</p> <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/l10n-portugal/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/l10n-portugal/issues/new?body=module:%20l10n_pt_account_invoicexpress%0Aversion:%2016.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>Open Source Integrators</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id6">Contributors</a></h3> <ul class="simple"> <li>Daniel Reis &lt;<a class="reference external" href="mailto:dreis&#64;opensourceintegrators.com">dreis&#64;opensourceintegrators.com</a>&gt;, <a class="reference external" href="https://www.opensourceintegrators.eu">Open Source Integrators</a></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>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p> <p><a class="reference external" href="https://github.com/dreispt"><img alt="dreispt" src="https://github.com/dreispt.png?size=40px" /></a></p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/l10n-portugal/tree/16.0/l10n_pt_account_invoicexpress">OCA/l10n-portugal</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>