Skip to main content
Odoo Community Association

Portugal InvoiceXpress Integration

Production/Stable License: AGPL-3 OCA/l10n-portugal Translate me on Weblate Try me on Runboat

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

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. 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.

Credits

Authors

  • Open Source Integrators

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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:

dreispt

This module is part of the OCA/l10n-portugal project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Release files for odoo-addon-l10n-pt-account-invoicexpress 18.0.2.0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-l10n-pt-account-invoicexpress 18.0.2.0.1.4
File Interpreter ABI Platform
odoo_addon_l10n_pt_account_invoicexpress-18.0.2.0.1.4-py3-none-any.whl Python 3 none any Details

Release files / odoo_addon_l10n_pt_account_invoicexpress-18.0.2.0.1.4-py3-none-any.whl

Download URL odoo_addon_l10n_pt_account_invoicexpress-18.0.2.0.1.4-py3-none-any.whl
Size 235.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
01cd7a122962c7e6eba3d94c51b902822cdbbe5ef8285da2764ec24fb2583637
BLAKE2b-256 checksum
How to use checksums
af5fee1364eb41f2b23f586776f1f3ead9c0726f6ce81ef4cfe7250ff8095081
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page