FiscoBridge Help Main Site

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-XXXX key, 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

  1. Go to Integrations → My Integrations in the sidebar
  2. You'll see a table of all your connections, active ones first

Integrations list page showing connected platforms with creation date, monthly invoices, status and actions

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.

  1. Click Reconnect on the integration (or in the warning)
  2. Sign in to the platform and approve access again
  3. 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.

Actions menu on a Zoho Books integration showing Settings, Webhook and Remove

Managing API Keys (Custom Integration)

For custom API integrations:

  1. Click API Keys on the integration
  2. You'll be taken to the API Keys management page
  3. From there you can create new keys or revoke existing ones

See Custom Integration for details.

Removing an Integration

  1. Open the ⋮ menu on the integration and choose Remove
  2. 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