[MIG] l10n_pt_stock_invoicexpress: Migration to 17.0

l10n_pt_account_invoicexpress/README.rst

@@ -0,0 +1,173 @@
+==================================
+Portugal InvoiceXpress Integration
+==================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:febd884e95a05fac4097689cbe058fd34de64fe248489680016b15ad9852d89f
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/17.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-17-0/l10n-portugal-17-0-l10n_pt_account_invoicexpress
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-portugal&target_branch=17.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Generate Portuguese tax authority legal Invoices ("Faturas") using
+InvoiceXpress.
+
+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 an extension module. For this please ensure
+that "l10n_pt_stock_invoicexpress" is installed.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To configure:
+
+-  Navigate to Settings/General Settings.
+
+-  In the "Invoicing" configuration section, locate the "InvoiceXpress"
+   subsection: There you can set:
+
+   -  InvoiceXpress Account Name
+   -  InvoiceXpress API Key
+   -  InvoiceXpress Invoice Email Template
+
+-  In "Invoicing/Accounting" configuration section, locate the Sales
+   Journals, and set the "InvoiceXpress Doc Type". This is required
+   before invoices before any invoice can be created.
+
+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.
+
+Invoices:
+
+-  Added support to the different documents types: Invoice, Invoice
+   Receipt, Simplified Invoice. 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
+
+The monthly SAF-T file should be downloaded from the InvoiceXpress
+website.
+
+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 to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/l10n-portugal/issues/new?body=module:%20l10n_pt_account_invoicexpress%0Aversion:%2017.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/17.0/l10n_pt_account_invoicexpress>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

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

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": "17.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,
+}

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

l10n_pt_account_invoicexpress/data/mail_template.xml

@@ -0,0 +1,28 @@
+<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 }}</field>
+        <field name="email_to">{{ object.partner_id.email }}</field>
+        <field name="email_cc">{{ object.env.user.email }}</field>
+        <field name="body_html" type="html">
+<p>
+Olá,
+<br />
+Enviamos em anexo a fatura <t t-out="object.name" />
+<t t-if="object.ref">
+    relativa à sua encomenda <t t-out="object.ref" />
+</t>
+.
+<br /><br />
+Obrigado
+<t t-if="user.signature">
+    <br />
+    <t t-out="user.signature or ''" />
+</t>
+</p>
+        </field>
+        <field name="lang">{{ object.partner_id.lang }}</field>
+        <field name="auto_delete" eval="True" />
+    </record>
+</odoo>