Disconnect Xero

Disconnecting Xero removes the accounting integration from Qoblex: it revokes Qoblex’s connection to your Xero organization and deletes the saved Xero settings and credentials in Qoblex. After disconnecting, Qoblex stops sending sales, purchases, payments, refunds, inventory, and manufacturing accounting activity to Xero until the integration is connected and configured again.

This article explains what disconnecting does, how to do it from the Xero Settings tab, what to check before you disconnect, and how to recover if the disconnect does not complete. Disconnecting does not undo or remove anything Qoblex has already sent to Xero; it only stops future syncing.

What disconnecting does

When you disconnect Xero, Qoblex:

• revokes the connection to the linked Xero organization (Qoblex no longer has access to that organization);
• deletes the stored Xero credentials and the Xero integration record in Qoblex, including all account, tax, tracking category, document-status, and sync-rule settings;
• returns to the Integrations area, where Xero no longer appears as the installed accounting integration.

Documents and journals that Qoblex already synced remain in Xero. Disconnecting does not delete or reverse them.

Disconnecting Xero is an accounting-impacting action. It revokes the connection and deletes your Xero settings in Qoblex. Confirm with the accounting owner before you proceed.

Before you disconnect

Disconnecting interrupts accounting sync and discards your Xero mappings in Qoblex, so review the current state first.

Open the Sync Status tab on the Xero page and check:

• whether invoices, payments, refunds, bills, goods receipts, supplier returns, inventory journals, or manufacturing entries are still pending or failed to sync;
• whether records that already synced to Xero are correct (these stay in Xero after you disconnect);
• whether the accounting team still expects Qoblex to send new transactions;
• whether a different fix would solve the issue without disconnecting (see below).

If failed records are visible in Sync Status, decide whether to resolve them before disconnecting or to intentionally leave them unsynced, and record that decision for accounting review.

When not to disconnect

Disconnecting is rarely the right first step. Do not disconnect Xero if the problem can be resolved by:

• reconnecting or refreshing authorization with Xero;
• correcting ledger account mappings;
• correcting tax mappings;
• correcting tracking categories;
• adjusting override rules for future syncs;
• resolving failed records in Sync Status and re-syncing them.

If your only goal is to re-authorize, you usually do not need to uninstall. When the integration shows as disconnected, the Xero settings page displays “Oops! It looks like your Xero integration is disconnected. Click here to reconnect Stock&Buy to Xero,” which lets you reconnect without losing your settings.

Disconnect the integration

1. Go to Integrations and open Xero.
2. On the Settings tab, scroll to the bottom of the page.
3. Choose Uninstall Xero Add-on.
4. When Qoblex asks Are you sure you want to uninstall this Addon?, confirm to proceed.

While the removal request runs, Qoblex blocks the page so you cannot make other changes. Do not close the browser until the page finishes.

When the disconnect succeeds, Qoblex clears the Xero connection, returns to Integrations, and reloads the page so Xero no longer shows as installed.

If you have unsaved Xero settings changes and try to leave the page first, Qoblex warns “You have pending changes, if you leave this page you will lose those changes. Do you want to continue?” Cancelling the uninstall confirmation leaves Xero connected and keeps you on the Settings tab.

After disconnecting

1. Confirm in Integrations that Xero no longer appears as the installed accounting integration.
2. Tell finance users that new invoices, payments, bills, refunds, inventory movements, and manufacturing costs will not sync to Xero until an accounting integration is connected and configured again.
3. If you reconnect later, review every mapping (accounts, taxes, tracking categories, document statuses, sync rules) before syncing new transactions — your previous Xero settings were deleted when you disconnected and are not restored automatically.

Qoblex supports only one accounting integration at a time. If you try to add Xero or QuickBooks while one is already installed, Qoblex shows “Only one accounting integration is supported at a time. Uninstall the existing accounting integration first.” Disconnect the current integration before connecting a different one.

Information to record

Before disconnecting, note these details so the accounting team has a clear record if Xero is reconnected later:

• the connected Xero organization;
• the reason for disconnecting;
• whether Sync Status had failed or pending records;
• the last successful sync date, if known;
• who approved the disconnect.

Troubleshooting