How to Connect TOConline to EazyAL for Alojamento Local Invoicing
If your Alojamento Local company already uses TOConline, you can connect that company to EazyAL and issue stay documents there. Your invoices remain in the TOConline company where your records are already kept. EazyAL uses the guest and stay details in a reviewed Stay Record, so you do not have to enter them again.
You choose and confirm each document. EazyAL does not issue invoices automatically or on a schedule. There is no additional EazyAL fee for connecting TOConline, and EazyAL keeps the certified PDF with the stay.
This guide explains how to get the TOConline API values, connect your company, choose document series and issue a document from a stay.
Why connect TOConline to EazyAL?
You keep your existing TOConline company and its invoice series. Guest details and accommodation and cleaning lines come from the reviewed Stay Record in EazyAL. After issuing a document, you can find its PDF alongside the stay in EazyAL.
The stay picker also flags stays that have already been invoiced in TOConline. Check that status before creating a document, so you do not invoice the same stay twice.
EazyAL helps prepare and issue the stay document. Your existing TOConline setup remains responsible for reporting documents to the Portuguese Tax Authority (AT).
Before you start
Make sure you have:
Access to the company’s Empresário account in TOConline. You need this account to request the API values.
At least one series communicated to the AT for invoices (FT) or invoice-receipts (FR). Series for credit notes (NC) and receipts (RC) are optional.
The company’s issuer details: NIF, official name, official email and fiscal address.
An EazyAL role with settings and finance permissions. If you do not have them, EazyAL will ask you to have the workspace owner connect TOConline.
Step 1: Get your API values from TOConline
Sign in to TOConline using the company’s Empresário account. Open Empresa › Configurações › Dados API.
Enter your own details as the integrator. TOConline will email you a link to retrieve the API values. The link is valid for 72 hours, so open it before it expires.
Copy all four values shown on the page:
Client ID
Secret
OAuth URL
API URL
The OAuth and API addresses include an app number, such as app10 or api10. That number can differ between companies. Copy both URLs exactly as TOConline displays them; do not use the examples in this guide as your company’s values.
Leave the redirect address as it is.
Step 2: Choose TOConline in EazyAL and connect
In EazyAL, open Compliance Hub › Invoices and choose “I already use TOConline” (or “Já uso o TOConline”).
Paste the Client ID, Secret, OAuth URL and API URL you copied. Then enter the company’s NIF, official name, email and fiscal address.
EazyAL tests the connection and reads the available series before saving the setup. Your credentials are stored encrypted. There is no sign-in page inside EazyAL: you request the values in TOConline and enter them in EazyAL.
Step 3: Choose your series and payment settings
Choose the series you want EazyAL to use for each document type:
FT: invoice
FR: invoice-receipt
NC: credit note
RC: receipt
You need a communicated FT or FR series to issue stay documents. NC and RC series are optional. If you do not use one of those document types, mark it “Não usar” (“Not used”).
Choose your usual payment method for invoice-receipts and receipts. You can change it when recording a payment. The available options are cash, Multibanco reference, bank transfer, debit card, credit card and direct debit.
Finally, choose the VAT region: mainland Portugal, the Azores (PT-AC) or Madeira (PT-MA). Check the selections, then click “Save and start” or “Guardar e começar.”
[Screenshot 5: The series and payment settings screen, including the “Não usar” option.]
Step 4: Issue a document from a stay
Choose a reviewed stay in EazyAL. Accommodation and cleaning lines are prefilled at the reduced VAT rate, and you can edit the lines before issuing the document.
Choose the document type:
Select Fatura (FT) for an invoice.
Select Paga já (FR) when the guest has already paid and you want an invoice-receipt.
You can enter the customer’s NIF. If you leave it blank, the document is issued to a final consumer (consumidor final).
The amounts shown in EazyAL include VAT. Review the lines and total: EazyAL sends the amounts to TOConline exactly as you reviewed them. When everything is correct, confirm and select “Issue in TOConline” or “Emitir no TOConline.” TOConline creates and finalises the document straight away.
Before confirming, check the stay’s status in the picker. If EazyAL flags that the stay has already been invoiced in TOConline, do not create another document for it.
Tourist tax needs its own invoice
TOConline does not allow VAT-exempt and taxed lines on the same invoice. For that reason, EazyAL leaves tourist tax off the stay invoice and explains this on screen.
If you need to invoice tourist tax, create a separate document in TOConline using an exemption reason from your TOConline catalogue. Each invoice can use only one exemption reason. Check the details before issuing the separate document.
Step 5: Receipts, credit notes and PDFs
After issuing a document, use the available actions on its record:
Record payment issues a receipt (RC) for an FT invoice.
Credit this invoice in full issues a credit note (NC). The reason you enter appears on the credit note.
Download PDF saves a copy of the document.
Email PDF sends it to the guest.
Credit notes in EazyAL currently cover the full invoice. If a receipt has already been recorded for an invoice, make the correction in TOConline.
How these invoices reach Finanças
TOConline reports documents to the AT, either through its own communication or through the monthly SAF-T process. Use the reporting arrangement already set up for your TOConline company. EazyAL does not send invoices to the AT.
To check a document, go to e-Fatura › Faturação › Emitente › Consultar Documentos. The document is issued in TOConline, so you do not need to issue a second invoice for the same stay.
Common problems
“TOConline no longer accepts the saved credentials.”
Request new values through Empresa › Configurações › Dados API and replace the saved values in EazyAL. Your existing series and invoices stay in TOConline.
“There are no FT series in TOConline yet.”
Create an invoice series in TOConline and communicate it to the AT. Then return to EazyAL and check the available series again.
The document status says “Por confirmar” (“Not confirmed”).
TOConline did not return a clear answer. Select “Verificar de novo” (“Check again”). EazyAL looks for the document in TOConline and will not send it a second time.
“TOConline did not respond.”
Your connection is saved. Try again later.
“Something went wrong. Nothing was issued.”
This message means no document was issued, so it is safe to try again.
Frequently asked questions
Does EazyAL charge for connecting TOConline?
No. There is no additional EazyAL fee for this connection.
Will EazyAL create my TOConline company?
No. You need an existing TOConline company and access to its Empresário account to get the API values.
Can I keep using TOConline for everything else?
Yes. EazyAL issues stay documents in the connected company; you can continue using TOConline for your other work.
Can I switch from Vendus, InvoiceXpress or EazyAL?
Yes. Choose “Change invoicing provider” or “Mudar de fornecedor de faturação” in EazyAL.
Why isn’t tourist tax on the stay invoice?
TOConline does not allow VAT-exempt and taxed lines on the same invoice. EazyAL leaves tourist tax off that invoice; create a separate document in TOConline if you need to invoice it.
Connect your TOConline company
Open Compliance Hub › Invoices in EazyAL and connect the TOConline company you already use. Once connected, you can review a stay and issue its document in the right company without entering the stay details again.
