Skip to main content

How to Connect InvoiceXpress

Learn how to connect InvoiceXpress with Ventrata.

Updated this week

Overview

In Portugal, strict fiscal regulations require businesses to issue certified invoices for every transactions—whether online or in person.

InvoiceExpress is a government-certified invoicing platform used to issue legal invoices that comply with the rules set out by the Portuguese Tax Authority. These include:

  • Correct use of tax codes

  • Proper invoice sequencing

  • Collection of customer tax identification numbers (NIFs)

  • Automatic communication of each issued invoice to the Portuguese Tax Authority (Autoridade Tributária)

When connected with Ventrata, InvoiceExpress allows sellers to automatically issue compliant invoices at the time of booking, saving time and ensuring legal accuracy.

📗 TIP

Learn more about InvoiceXpress.


InvoiceXpress Document Types

InvoiceXpress issues three types of documents:

Invoice (Fatura)

A fiscal document stating the product sold and the amount charged.

Receipt (Recibo)

A fiscal document confirming that the transaction was completed.

Credit Note (Nota de Crédito)

A fiscal document indicating that the original invoice was voided.


📒 NOTE

Any time the booking is updated, including customer information, the original invoice is voided and a new invoice is generated with the updated information.

Each document includes details that tie the Ventrata booking and customer to the InoviceXpress document.

  • V/ Ref. - must match the Ventrata order reference

  • Contributor (Contribuinte) - the customer's tax ID (NIF), if provided and valid

InvoiceExpress Invoice

Ventrata Booking Level - Order Reference

Ventrata Backoffice Checkout - Tax ID


Link InvoiceXpress with Ventrata

Prerequisites:

  • Create and set up an InvoiceXpress account

  • Configure your ATCUD (Código de Validação e Numeração Sequencial de Documentos - a unique document validation and numbering code)


    📗 TIP

    A banner on every page of your InvoiceXpress account prompts you to configure an ATCUD. Follow the steps in the app.


  • Generate an API key in InvoiceExpress, see below

  • Set up tax rates in InvoiceXpress

  • Create the corresponding tax rates in your Ventrata dashboard


Generate API key in InvoiceXpress

  1. In your InvoiceXpress account, go to My profile.

    My profile

  2. Under Integrations in the right-hand navigation, select API.

    Integrations - API

  3. Press the Generate API Key button.

    Generate API Key

  4. Copy the following details:

    • Account Name

    • API Key

    Account Name & API Key


    📒 NOTE

    You need this information to create a connection between InvoiceXpress and Ventrata.


Create InvoiceXpress Registry in Ventrata

  1. In the Ventrata dashboard, go to Supplier Settings > Registries.

    Registries

  2. Press the + New Registry button.

    New Registry

  3. Select the 'InvoiceXpress' option.

    InvoiceXpress

  4. Enter a name for the registry.

    Name

  5. (Optional) Select one or more destination(s) if you are using destinations.

    Destinations

  6. Paste your 'Account Name' and 'API Key' as copied from InvoiceExpress.

    Account Name & API Key

  7. Press the Create Invoice Xpress Registry button to save your settings.

    Create Invoice Xpress Registry

Did this answer your question?