How to Connect InvoiceXpress to EazyAL for Alojamento Local Invoicing

Already use InvoiceXpress for your Alojamento Local business? You can connect your existing account to EazyAL and create invoices from reviewed stays, using the guest and stay details already recorded in EazyAL.

You keep your InvoiceXpress account and choose the invoice series you use. EazyAL does not charge an additional fee for the connection. When you are ready to invoice a stay, review the details, check the invoice lines and confirm. EazyAL checks the total before the invoice is finalised.

Here’s what you need and how to set it up.

Why connect InvoiceXpress to EazyAL?

When you issue an invoice from a stay, EazyAL uses information from its Stay Record, including guest details and the stay’s invoice lines. That saves you from typing the same information into two systems.

Your invoices are issued in your own InvoiceXpress account and in the series you select. You continue to use your existing InvoiceXpress plan, and EazyAL keeps the certified PDF with the stay.

You stay in control of each invoice: review the stay, check the lines and totals, then confirm before it is issued.

Before you start

Have these details ready:

• An InvoiceXpress account. EazyAL connects to your existing account; it does not create one for you.

• Your account name. This is the part before .app.invoicexpress.com in your InvoiceXpress address. For example, if the address is casa-azul.app.invoicexpress.com, the account name is casa-azul.

• Your API key. Find it in InvoiceXpress under Definições › API.

• An invoice series registered with the Portuguese Tax Authority (AT). You can manage series under Definições › Séries in InvoiceXpress. EazyAL will not connect an account that has no invoice series registered with the AT.

• A 0% VAT tax in InvoiceXpress, if you want to include tourist tax or another exempt line on an invoice.

• The right EazyAL permissions. Connecting an invoicing provider requires settings and finance permissions. If you do not have them, ask the workspace owner to connect the account.

Step 1: Choose InvoiceXpress in EazyAL

In EazyAL, open Compliance Hub › Invoices. On the invoicing-provider screen, choose “I already use InvoiceXpress” (or “Já uso o InvoiceXpress”).

This option connects your existing InvoiceXpress account. If you have not opened an account yet, EazyAL also offers a separate invoicing option.

Step 2: Connect your account

Enter your InvoiceXpress account name and API key exactly as they appear in your account. The key field includes a show-and-hide control so you can check what you have entered.

Then fill in the issuer details requested by EazyAL:

• NIF

• Official name

• Official email

• Fiscal address

EazyAL checks the account details before saving them. Your API key is stored encrypted after you connect the account.

If the connection check fails, confirm the account name and key in InvoiceXpress before trying again. The account name is the part before .app.invoicexpress.com; it is not the full web address.

Step 3: Choose your series and payment settings

Once your account is connected, choose the invoice series you want to use. EazyAL lists only series registered with the AT for invoices. The series information also shows which document types are registered for it, such as FT, FR, NC or RC.

Choose your usual payment method. This is a suggested default to speed things up; you can change it when you issue an invoice.

Finally, choose the applicable VAT region: mainland Portugal, the Azores or Madeira. When you have checked these settings, select “Save and start” or “Guardar e começar.”

Step 4: Issue an invoice from a stay

Choose a reviewed stay in EazyAL and check the invoice lines. Depending on the stay, these may include accommodation, cleaning or other recorded charges.

If you have a customer NIF, you can enter it before issuing the invoice. If you leave the field empty, the invoice is issued to a final consumer (consumidor final).

Adding tourist tax

Tourist tax can appear on the same invoice as a VAT-exempt line. In the invoice review, check that the tourist-tax line is present and uses M99 — Não sujeito a IVA. This requires a 0% VAT tax to be set up in InvoiceXpress.

For other exemption reasons, the available codes include M07 (Article 9 of the Portuguese VAT Code) and M10 (the Article 53 regime). An invoice can use only one exemption reason, so check the reason shown for the invoice before confirming it.

Check the total before confirming

Select “Issue in InvoiceXpress” and review the confirmation. Before the invoice is finalised, EazyAL checks that InvoiceXpress calculates the same total as the amount you reviewed in EazyAL.

If the totals do not match, EazyAL stops the process and does not issue the invoice. You can then review the stay lines and settings before trying again. This check helps prevent an invoice from being issued with a different total from the one you approved.

Step 5: Record payment, issue a credit note or send the PDF

After an invoice is issued, you can use the available actions on its record:

• Record payment records full payment and issues a receipt (RC) in InvoiceXpress.

• Credit this invoice in full issues a credit note (NC). You will be asked for a reason, which appears on the credit note.

• Email PDF sends the invoice PDF to the guest.

How the invoices reach Finanças

InvoiceXpress reports invoices to the AT. Depending on your InvoiceXpress setup, this happens through InvoiceXpress’s own communication or through the monthly SAF-T process.

EazyAL does not send invoices directly to the AT. To check a document, go to e-Fatura › Faturação › Emitente › Consultar Documentos.

Because the invoice is issued in your InvoiceXpress account, you do not need to issue a second invoice for the same stay.

Common problems

“InvoiceXpress no longer accepts the saved API key.”
Create or copy a current API key under Definições › API in InvoiceXpress, then update the saved key in EazyAL. Your series and issued invoices remain as they are.

“There are no series communicated to the AT yet.”
Register an invoice series in InvoiceXpress, then return to EazyAL and select “Verify again” or “Verificar de novo.”

The tourist tax is missing from the invoice.
Check that the stay includes a tourist-tax line and that InvoiceXpress has a 0% VAT tax available for it.

“Something went wrong. Nothing was issued.”
EazyAL shows this when the invoice was not issued. Review the stay and connection details, then try again.

Frequently asked questions

Does EazyAL charge for this connection?
No. EazyAL does not charge an additional fee to connect InvoiceXpress.

Do I need a new InvoiceXpress plan?
No. You connect and use your own InvoiceXpress account and existing plan.

Can I switch from Vendus, TOConline or EazyAL?
Yes. Use the “Change invoicing provider” option in EazyAL to choose a different provider.

Will EazyAL create my InvoiceXpress account?
No. You need an InvoiceXpress account before you can connect it.

Connect InvoiceXpress to EazyAL

Open Compliance Hub › Invoices in EazyAL and connect the InvoiceXpress account you already use. Once setup is complete, you can review a stay and issue its invoice without entering the stay and guest details again.