OCA · aktiv-heli-kantawala · May 24, 2021 · Jun 12, 2021 · Jun 12, 2021 · Jun 15, 2021
diff --git a/l10n_pt_account_invoicexpress/README.rst b/l10n_pt_account_invoicexpress/README.rst
@@ -0,0 +1,166 @@
+==================================
+Portugal InvoiceXpress Integration
+==================================
+
+.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Production/Stable
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--portugal-lightgray.png?logo=github
+    :target: https://github.com/OCA/l10n-portugal/tree/14.0/l10n_pt_account_invoicexpress
+    :alt: OCA/l10n-portugal
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/l10n-portugal-14-0/l10n-portugal-14-0-l10n_pt_account_invoicexpress
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
+    :target: https://runbot.odoo-community.org/runbot/171/14.0
+    :alt: Try me on Runbot
+
+|badge1| |badge2| |badge3| |badge4| |badge5| 
+
+Generate Portuguese tax authority legal Invoices ("Faturas") using InvoiceXpress.
+
+**UPDATE November/2021:**
+
+Invoices:
+
+- 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.
+
+- Use the invoice commercial partner for the name and address,
+  instead of the invoice contact.
+
+- Added support for the Terms and Conditions/Observations field
+
+- Added to Credit Notes the link to the source Invoice
+
+
+InvoiceXpress is a paid service.
+Visit https://invoicexpress.com for more details.
+
+Once the InvoiceXpress connection is configured,
+the invoice CONFIRM button automatically generates the InvoiceXpress invoice.
+
+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.
+
+This replaces the Odoo SEND & 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.
+
+Legal transport documents ("Guias de Transporte" e "Guias de Remessa) are also supported
+through the extension module "l10n_pt_stock_invoicexpress".
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To configure:
+
+- Navigate to Settings/General Settings.
+- In the "General Settings" configuration section, locate the "InvoiceXpress" subsection:
+  There you can set:
+
+  - InvoiceXpress Account Name
+  - InvoiceXpress API Key
+  - InvoiceXpress Invoice Email Template
+
+The email template is used to prepare the details for the email the InvoiceXpress
+service sends with the invoice:
+
+- "To" email address
+- "Cc" email address
+- Subject
+- Body
+
+Translations are supported, and the customer language is used to render
+the email details.
+
+The InvoiceXpress configuration is per company,
+and can also be modified directly on the Company form,
+if the Developer Mode is enabled.
+
+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.
+
+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.
+
+Usage
+=====
+
+On an Invoice, the CONFIRM button automatically generates
+an invoice on the InvoiceXpress service.
+
+The "Email InvoiceXpress" button requests the InvoiceXpress service to send an email with a
+copy of the legal document.
+
+The Invoice form shows an "InvoiceXpress" tab containing details for
+the corresponding InvoiceXpress document.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-portugal/issues>`_.
+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
+`feedback <https://github.com/OCA/l10n-portugal/issues/new?body=module:%20l10n_pt_account_invoicexpress%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+~~~~~~~
+
+* Open Source Integrators
+
+Contributors
+~~~~~~~~~~~~
+
+* Daniel Reis <dreis@opensourceintegrators.com>, `Open Source Integrators <https://www.opensourceintegrators.eu>`_
+
+Maintainers
+~~~~~~~~~~~
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+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.
+
+.. |maintainer-dreispt| image:: https://github.com/dreispt.png?size=40px
+    :target: https://github.com/dreispt
+    :alt: dreispt
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-dreispt| 
+
+This module is part of the `OCA/l10n-portugal <https://github.com/OCA/l10n-portugal/tree/14.0/l10n_pt_account_invoicexpress>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
diff --git a/l10n_pt_account_invoicexpress/__init__.py b/l10n_pt_account_invoicexpress/__init__.py
@@ -0,0 +1,4 @@
+# Copyright (C) 2021 Open Source Integrators
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from . import models
diff --git a/l10n_pt_account_invoicexpress/__manifest__.py b/l10n_pt_account_invoicexpress/__manifest__.py
@@ -0,0 +1,28 @@
+# Copyright (C) 2021 Open Source Integrators
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Portugal InvoiceXpress Integration",
+    "summary": "Portuguese certified invoices using InvoiceXpress",
+    "version": "15.0.1.0.0",
+    "author": "Open Source Integrators, Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "website": "https://github.com/OCA/l10n-portugal",
+    "category": "Accounting/Localizations/EDI",
+    "maintainers": ["dreispt"],
+    "development_status": "Production/Stable",
+    "depends": ["l10n_pt_vat", "account"],
+    "data": [
+        "views/res_config_settings.xml",
+        "views/account_journal_view.xml",
+        "views/account_tax_view.xml",
+        "views/account_move_view.xml",
+        "views/res_company_view.xml",
+        "views/res_country_view.xml",
+        "data/mail_template.xml",
+        "data/res.country.csv",
+    ],
+    "images": ["static/description/cover.png"],
+    "application": True,
+    "installable": True,
+}
diff --git a/l10n_pt_account_invoicexpress/data/country_mapping.txt b/l10n_pt_account_invoicexpress/data/country_mapping.txt
@@ -0,0 +1,43 @@
+Odoo country list was mapped to the InvoiceXpress names as documented at
+https://invoicexpress.com/api-v2/documentation/appendix
+
+These InvoiceXpress country names found no macth in Odoo:
+
+Burma
+Canton and Enderbury Islands
+Dronning Maud Land
+East Timor
+International Monetary Fund
+Ivory Coast
+Johnston Island
+Kampuchea
+Midway Islands
+Netherlands Antilles
+Samoa (America)
+Tahiti
+Upper Volta
+Vatican
+Wake Island
+Western Samoa
+Zaïre
+
+These Odoo countries found no match in the InvoiceXpress list:
+
+id,name
+base.aq,Antarctica
+base.bq,Bonaire, Sint Eustatius and Saba
+base.bv,Bouvet Island
+base.tf,French Southern Territories
+base.va,Holy See (Vatican City State)
+base.xk,Kosovo
+base.bl,Saint Barthélémy
+base.mf,Saint Martin (French part)
+base.pm,Saint Pierre and Miquelon
+base.sx,Sint Maarten (Dutch part)
+base.gs,South Georgia and the South Sandwich Islands
+base.ss,South Sudan
+base.tk,Tokelau
+base.to,Tonga
+base.um,USA Minor Outlying Islands
+base.vi,Virgin Islands (USA)
+base.ax,Åland Islands
diff --git a/l10n_pt_account_invoicexpress/data/mail_template.xml b/l10n_pt_account_invoicexpress/data/mail_template.xml
@@ -0,0 +1,29 @@
+<odoo noupdate="1">
+    <record id="email_template_invoice" model="mail.template">
+        <field name="name">InvoiceXpress: Send Invoice by Email</field>
+        <field name="model_id" ref="account.model_account_move" />
+        <field name="subject">Sua Fatura ${object.name | safe}</field>
+        <field name="email_to">${object.partner_id.email | safe}</field>
+        <field name="email_cc">${object.env.user.email | safe}</field>
+        <field name="body_html" type="html">
+            <p>
+                Olá,
+                <br />
+                Enviamos em anexo a fatura ${object.name | safe}
+                % if object.ref:
+                relativa à sua encomenda ${object.ref | safe}
+                % endif
+                .
+                <br />
+                <br />
+                Obrigado
+                % if user.signature:
+                <br />
+                ${user.signature | safe}
+                % endif
+            </p>
+        </field>
+        <field name="lang">${object.partner_id.lang}</field>
+        <field name="auto_delete" eval="True" />
+    </record>
+</odoo>