Managing Integrations
The My Integrations page in the Customer Portal lists every connection you have set up, whichever platform it uses, and lets you change its settings, reconnect it, or remove it.
It covers all cloud integrations: Xero, MYOB, Zoho Books, QuickBooks, Odoo Accounting, Cloudbeds and Custom Integration. ERP Connector is installed on your own network and is managed there instead. See On-premise integration.
Have a reseller key instead? If a FiscoBridge partner gave you a prepaid
INT-XXXX-XXXX-XXXXkey, redeem it from the Upgrade Plan button on this page. See Activating an Integration Key.
Need a certificate? Every integration requires a digital fiscal certificate (
.pfx). If you don't have one yet, see Requesting a Digital Certificate.
Connection Usage
At the top of the page, a bar shows your current usage:
- Connection usage: how many active integrations you have against the number your plan allows
- Subscription expires: when your integration plan ends. If you hold more than one subscription, the bar shows the next date on which seats expire, and the info icon lists each subscription
- Free testing: shown when you have no paid plan yet. You can connect one integration and fiscalize a limited number of invoices to try it out, with no payment details needed. Going live requires a paid plan
Use Upgrade Plan to buy more connections or redeem a key.
Viewing Your Integrations
- Go to Integrations → My Integrations in the sidebar
- You'll see a table of all your connections, active ones first

Each row shows:
| Column | Description |
|---|---|
| Connection | The company or organisation name from the connected platform, the platform it is connected through (for example via Xero), and the UID of the fiscal certificate it uses |
| Plan | The integration plan the connection is on (for example Business or Professional), or Trial while you are testing without a paid plan |
| Created | When the integration was set up |
| Invoices (monthly) | Invoices fiscalized this month against your plan limit. A Trial connection shows its total against the testing allowance instead |
| Status | Active or Inactive, with a warning icon beside it if the connection or its tax labels need attention |
| Actions | The main action for that platform, plus a ⋮ menu with the rest |
Click a row to expand it. The detail panel shows which company in your accounting system is fiscalized under which fiscal certificate and location, and whether its tax labels are in order.
Pending Integrations
If you started setting up an integration but didn't complete it (for example, you uploaded a certificate but didn't finish authorizing the platform), it appears in a separate table above the main one with status Pending. Click Resume to pick up where you left off, or the delete icon to discard the unfinished setup.
Available Actions by Platform
| Platform | Main button | In the ⋮ menu |
|---|---|---|
| Xero | Reconnect | Settings, Remove |
| MYOB | Reconnect | Settings, Configure tax labels, Remove |
| Zoho Books | Reconnect | Settings, Webhook, Remove |
| QuickBooks | Reconnect | Settings, Remove |
| Cloudbeds | Reconnect | Settings, Remove |
| Odoo Accounting | Configure | Settings, Remove |
| Custom Integration | API Keys | Settings, Remove |
Changing Settings
Open the ⋮ menu on an integration and choose Settings. What you can change depends on the platform:
| Setting | Available for | What it does |
|---|---|---|
| Fiscalize invoice | Xero, MYOB, Zoho Books, QuickBooks | The point at which an invoice is fiscalized, for example when it is approved or when it is paid |
| Fiscalize sales receipts | Zoho Books | Also fiscalizes sales receipts, in addition to invoices |
| Receipt format | Xero, Zoho Books, QuickBooks | Receipt slip or A4 invoice (see below) |
| Training mode (test invoices) | All platforms | Fiscalizes invoices as Training instead of Normal, so you can test safely |
Click Save changes to apply. New settings apply to invoices fiscalized after you save. Invoices that are already fiscalized are never fiscalized again.
Important: Training invoices are not real fiscal invoices. Remember to switch Training mode off before you start issuing real invoices.
Receipt Format
Every fiscalized invoice gets a fiscal receipt attached to the document in your accounting system and offered on the receipt link. You can choose between two formats:
- Receipt slip (journal): the till-style receipt exactly as printed by the SDC. This is the default.
- A4 invoice: a full-page fiscal invoice with the same fiscal elements (SDC invoice number, counter, QR code, items, tax by label, totals and payment types) laid out as a standard invoice.
For Xero, Zoho Books and QuickBooks you choose the format in the connect dialog, or later from Settings on the integration. The choice applies to invoices fiscalized after you save it; receipts already attached are not regenerated. Cloudbeds always uses the A4 invoice, because it is the document your guests receive. Whichever format you choose, the receipt link lets the recipient download the other one as well.
Reconnecting
Xero, MYOB, Zoho Books, QuickBooks and Cloudbeds connect through an authorization that can expire or be withdrawn on the platform's side. When that happens the integration stops fiscalizing, and for most platforms a warning appears above the table saying FiscoBridge couldn't reach it.
- Click Reconnect on the integration (or in the warning)
- Sign in to the platform and approve access again
- The integration returns to Active status
Reconnecting does not create a new integration: it keeps the same certificate, settings and invoice history.
Odoo Accounting connects with an API key rather than an authorization. If the key is replaced or the Odoo address changes, click Configure and enter the new details. See Connecting Odoo.
Tax Label Warnings
FiscoBridge compares the tax rates in your accounting system with the fiscal tax labels on your certificate, and shows a notice above the table when they differ:
- A tax rate doesn't match its fiscal label rate. Tax would be reported differently from what your accounting system charged. Correct the rate in your accounting system.
- A fiscal label has no matching tax rate. This is informational. Invoices using your existing rates fiscalize normally; add the missing rate only if you need it.
Click How to fix for the platform-specific steps, then Re-check once you have made the change. This check runs for Xero, Zoho Books, QuickBooks, Odoo Accounting and Cloudbeds.
MYOB works differently: you map each MYOB tax code to a fiscal label yourself. If any codes are unmapped, a warning shows how many, and invoices using them are not fiscalized until you click Configure tax labels and map them. See Connecting MYOB.
Zoho Books Webhook Setup
Each Zoho Books integration has a Webhook option in its ⋮ menu. It opens a dialog with that integration's own webhook URL, its secret token, and step-by-step instructions for setting up near real-time invoice notifications in Zoho Books. See Connecting Zoho Books for full details.

Managing API Keys (Custom Integration)
For custom API integrations:
- Click API Keys on the integration
- You'll be taken to the API Keys management page
- From there you can create new keys or revoke existing ones
See Custom Integration for details.
Removing an Integration
- Open the ⋮ menu on the integration and choose Remove
- Confirm the action in the dialog
Note: Removing an integration stops all syncing, revokes its API keys and deletes its invoice history from the portal. Fiscal receipts that were already issued stay valid and remain attached to the documents in your accounting system.
Empty State
If you haven't set up any integrations yet, you'll see a prompt to create your first one. Click Create Integration to get started.
How Quickly Invoices Are Fiscalized
Timing depends on the platform, not on your plan:
| Platform | Typical timing |
|---|---|
| Xero | Real-time, as soon as the invoice reaches your chosen trigger |
| QuickBooks | Usually within a minute or two, with a check every 5 minutes as a backup |
| Zoho Books | Within about 5 minutes for invoices and 15 minutes for credit notes. Near real-time if you set up the webhook |
| MYOB | Up to 5 minutes |
| Odoo Accounting | About a minute |
| Cloudbeds | Near real-time, with a check every 15 minutes as a backup |
| Custom Integration | Immediately, when your system calls the API |
Troubleshooting
Integration shows as Inactive, or a warning says FiscoBridge couldn't reach the platform?
- Click Reconnect and approve access again (for Odoo Accounting, click Configure and check the API key)
- Check that your integration plan is still active in the connection usage bar
Not seeing expected invoices?
- Verify the integration status is Active
- Allow for the platform's normal timing, shown in the table above
- Check the Fiscalize invoice setting. An invoice is only fiscalized once it reaches the chosen trigger
- Look for a tax label warning above the table. Invoices with unmapped MYOB tax codes are not fiscalized
- Make sure you haven't reached your monthly invoice limit. Once the limit is reached, fiscalization stops until you upgrade. See Invoice Limits and Usage
Invoices are fiscalized as Training?
- Open Settings on the integration and switch Training mode off
Connection limit reached?
- When you click Create Integration and you've hit your limit, a dialog offers to buy an integration plan with more connections. If you got your plan from a FiscoBridge partner, contact them to add connections
Next Steps
- Requesting a Digital Certificate — Get the
.pfxcertificate every integration needs - Integrations Overview — Review all supported platforms
- Connect Xero — Set up a new Xero connection
- Connect MYOB — Sync from MYOB AccountRight or MYOB Business
- Connect Zoho Books — Set up a Zoho Books connection
- Connect QuickBooks — Set up a QuickBooks connection
- Connect Odoo — Connect Odoo Accounting with an API key
- Connect Cloudbeds — Fiscalize guest folios from Cloudbeds
- Custom Integration — Get API credentials