InvoiceXpress¶
InvoiceXpress is a popular certified billing platform in Portugal. FaturaSync connects to it via API to create draft invoices automatically.
Setup¶
You need two things from your InvoiceXpress account:
1. Find your API Key¶
- Log in at invoicexpress.com
- Click your account name in the top-right corner
- Go to Definições (Settings) → Integrações (Integrations) → API
- Your API Key is displayed on this page — copy it
2. Find your Account Subdomain¶
Your subdomain is the part before .invoicexpress.com in your account URL. For example:
- URL:
https://mycompany.invoicexpress.com→ subdomain:mycompany - You can see it in your browser's address bar when logged in
Connect to FaturaSync¶
- Go to Settings in FaturaSync
- Select InvoiceXpress as your invoicing provider
- Paste your API Key
- Enter your Subdomain (just the name, not the full URL)
- Click Save
How drafts are created¶
When you click Create Draft in FaturaSync:
- FaturaSync sends the booking data to InvoiceXpress via their API
- A draft invoice (rascunho) is created in your InvoiceXpress account
- The draft includes: client name, service description, amount, and IVA
Finding your drafts in InvoiceXpress¶
- Log in to InvoiceXpress
- Go to Documents > Invoices (or Documentos > Faturas)
- Filter by Draft status
- Your FaturaSync-generated invoices will be there, ready for review
What's included in the draft¶
| Field | Value |
|---|---|
| Client name | Guest name from the booking |
| Description | Accommodation service with check-in/check-out dates |
| Amount | Net amount (after commission deduction) |
| IVA rate | Based on your property's location setting |
| Document type | Invoice (Fatura) |
Finalizing invoices¶
After reviewing the draft in InvoiceXpress:
- Open the draft document
- Verify all details are correct
- Click Finalize (Finalizar) to convert it to a final invoice
- Optionally send it to the guest by email
Review before finalizing
Once an invoice is finalized in InvoiceXpress, it receives a sequential number and cannot be deleted — only credited. Always review drafts before finalizing.
Troubleshooting¶
- "Invalid API key" — Re-copy the key from InvoiceXpress settings, making sure there are no extra spaces
- "Account not found" — Check your subdomain is correct (just the name, not the full URL)
- Draft not appearing — Allow a few seconds, then refresh your InvoiceXpress dashboard