Below are the common errors and warnings you might encounter while working with Qoblex and Xero
Warnings
Payment for SALE_ORDER not synced to Xero. The corresponding invoice XERO_INVOICE is not Approved (current state is Draft)
Meaning: A Xero invoice must be approved so Qoblex can attach a payment to it.
How to fix: Approve the invoice in Xero. If you want to have Qoblex automatically do this for you then please change the invoice sync status to Approved under Integrations -> Xero integration settings -> Advanced settings
The corresponding invoice XERO_INVOICE is not Approved (current state is Draft)
Meaning: A Xero invoice must be approved so Qoblex can attach a payment to it.
How to fix: Approve the invoice in Xero. If you want to have Qoblex automatically do this for you then please change the invoice sync status to Approved under Integrations -> Xero integration settings -> Advanced settings
Payment for SALE_ORDER not synced to Xero.
The corresponding invoice XERO_INVOICE is not Approved (current state is Submitted)
Meaning: A Xero invoice must be approved so Qoblex can attach a payment to it.
How to fix: Approve the invoice in Xero. If you want to have Qoblex automatically do this for you then please change the invoice sync status to Approved under Integrations -> Xero integration settings -> Advanced settings
Payment for ORDER_NUMBER not synced to Xero.
The corresponding invoice LINK_TO_XERO_INVOICE is already Paid in Xero
Meaning: Qoblex tried to attach a payment to an invoice in Xero but the invoice is already marked as Paid in Xero.
How to fix: This warning is safe most of the time and is only meant to let you know that a payment has not been synced because the invoice is already Paid. You might want to double check the payment in Xero to make sure it is correct.
Could not change ORDER in Xero (INVOICE LINK) as it is locked.
Current bill status is Authorised
Meaning: Qoblex tried to update an order in Xero but it failed as the invoice/bill is locked. Invoices and Bills which are approved in Xero cannot be changed.
How to fix: As the invoice / bill is locked in Xero, any updates should be performed directly in Xero.
Errors
Could not sync closed orders to Xero: Account code ‘CODE’ is not a valid code for this document.
Meaning: Qoblex failed to push a journal entry (either a COGS or SOH) to your Xero file.
How to fix: Make sure the COGS and SOH accounts under Integrations -> Xero integration settings are assigned to existing Xero ledger accounts and are correct.
Could not push ORDER_ID to Xero.
oauth_problem=token_rejected&oauth_problem_advice=The%20access%20token%20has%20not%20been%20authorized%2C%20or%20has%20been%20revoked%20by%20the%20user
Meaning: Qoblex failed to sync data to Xero as the authentication failed.
How to fix: Qoblex keeps a list of orders which failed to sync and retries the sync operation every hour.
All you need to do is uninstall then reinstall the Xero integration for the missed orders to sync.
(Your might need to take a screenshot of the installation settings before uninstalling just in case you need to remember what ledger accounts where used)
Could not push payment for SALE_ORDER_ID to Xero.
You must specify and Account code or Account ID for the payment, Account could not be found
Meaning: Qoblex failed to sync a payment to Xero as the linked ledger account does not have a code defined.
How to fix: Log into your Xero account and set the payment account code. Once done, go to Qoblex and make sure the payment ledger account has a valid account code assigned to it.
Could not sync inventory adjustments to Xero: You cannot save this transaction using an inventory account type
OR
Could not sync closed orders to Xero: You cannot save this transaction using an inventory account type
Meaning: Qoblex failed to sync either adjustments or closed orders to Xero journals as the linked ledger account is reserved and cannot be used for such transactions (this usually happens with the Inventory ledger account in Xero which is reserved)
How to fix: Ensure the Stock On Hand, Cost Of Goods Sold and Adjustments are linked to accounts which are not of type Inventory.
Could not push PURCHASE_ORDER_ID.
An unexpected HTTP response was returned while performing OAuth operations
Meaning: Qoblex failed to sync a purchse order to Xero. This error is caused by a Xero outage.
How to fix: This error is caused by a Xero outage, Qoblex will keep trying to sync data every hour until Xero is back and the error will automatically get resolved.
Could not push payment for SALE_ORDER to Xero.
Account type is invalid for making a payment to/from
Meaning: Qoblex failed to sync a payment to Xero.
How to fix: The xero payment account used must be a either a bank account or a ledger account for which the “Enable payments to this account” option is ticked on. Please check out the Xero Integration Setup guide for more information.
Could not push SALE_ORDER to Xero.
The document date cannot be before the period lock date, currently set at XERO_ACCOUNT_LOCK_DATE, Invoice not of valid status for modification, This document cannot be edited as it has a payment or credit note allocated to it.
Meaning: Qoblex failed to send an update of a sale order to Xero.
How to fix: Please review your organization settings with your accountant. You can also take a look at this Xero help article 1 on working with lock dates.
Could not push TRANSACTION to Xero.
Tax rate must be Active.
Meaning: Qoblex failed to send a transaction (can be an adjustment, purchase order, sale order or a credit note) to Xero. This error occurs when a previously synced tax rate has been deleted in Xero.
How to fix: Please create a new tax rate within Qoblex and use that instead of the one being used in the transaction which failed to sync through. If the transaction cannot be edited then please contact us.
The TaxType code ‘INPUT2’ cannot be used with account code ‘<code>’
Meaning: Qoblex failed to send a transaction (can be a purchase order, sale order, or a credit note) to Xero. This error occurs when a tax rate type does not match the account type the transaction is being synced to. Example: using a REVENUE tax type against an EXPENSE account code.
How to fix: Please edit your tax rate mappings within Qoblex, under the Xero integration.
