Skip to main content

Portuguese certified invoices using InvoiceXpress

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file odoo_addon_l10n_pt_account_invoicexpress-18.0.1.0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for odoo_addon_l10n_pt_account_invoicexpress-18.0.1.0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f007c1f94b270d732455e8718129b65823a89a7e382859b37d2bccab3b393b0d
MD5 da30749171f9b2f0180fb752333f1850
BLAKE2b-256 e44463b45009c99fb6a86e640bc415f85495c404af14b92e09822f43256f8e46

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page