QuickBooks Online Error Code Resolutions

• Check for deleted or inactive object
  • Adjust filter in QBO show 'Inactive' objects, locate the inactive object, and restore it
• Recreate the object
  • If the object has been deleted and you're unable to recover, you may need to go ahead and recreate it.
  • If the object is an invoice or payment record, you will find a 'Clear ID' button available for use within the Quickbooks Online Unsynced Entities report in SingleOps 

• Data included when creating the Client cannot be pulled over due to too many characters. For example, a phone number related to the Client has over 21 characters included.
• The CustomerMemo field refers to the total length of the characters on a job within a note field. The total number of characters in the Notes section on the job cannot exceed the 1,000 character limit. 

• Adjust the number of characters in the specified field to be within the allowed amounts.
• Update your Notes section on the job to ensure that the length of each section is short enough that the total equals less than 1,000 characters in each section

This error occurs when the email address specified in the request doesn't conform to RFC 822.

Review the email address of the client and change the email to use an email address based on syntax rules of RFC 822

This error occurs when a referenced item (like a customer, product, or account) has been deleted or made inactive in QuickBooks, but the system is still trying to use it. This can happen if you've deleted something in QBO or if SingleOps is referencing a deleted item

Check for deleted or inactive items. Verify that all customers, products, accounts, and other relevant items are active and haven't been accidentally deleted in QBO

This happens due to a timeout on the QuickBooks end

Your QuickBooks Online subscription does not support features being used by SingleOps.

Upgrade your QuickBooks Online account to include additional features required.

A business validation error has occurred while processing your request: Business Validation Error: The payments you entered add up to more than the amount received

The sync is trying to apply a payment that doesn't align with the outstanding balance of the selected invoice

• Review the invoice and payments for mismatches
• Ensure the payment amounts entered match the actual amounts received
• Check for sync errors related to the invoice
• Contact Support if unable to determine resolution support@singleops.com

Business Validation Error: Make sure all your transactions have a GST/HST rate before you save

Item in QBO account is missing a tax code on the item under Products and Services

A business validation error has occurred while processing your request: Business Validation Error: You cannot enter more than 100 characters in the email field. You tried entering...which is x characters

The email field exceeds the supported limit

Update the email of the client to be within the limit allowed. This is usually specificed within the error itself.

Duplicate Document Number Error: Duplicate Document Number Error: You must specify a different number. This number has already been used.

This will occur if you are using SingleOps Deposit or Prepay Feature. When the credit memo generates, it matches the transaction number of the sales receipt so that the payments are linked and deductions are made. Because of this, an error in the sync will occur when the credit memo attempts to sync without a setting change in QBO account settings

There is a setting in QBO to correct this:

Custom Transaction Number Setting in QuickBooks to use Deposits/Prepay

Invalid Company Status Erro

This indicates that SingleOps is attempting to sync with a QuickBooks Online account that is no longer active

• Sync SingleOps with an active QuickBooks Online account
• Reactivate the previous QuickBooks Online account

The account period has closed

This indicates the transaction date (TxnDate field) is earlier than the company's closed book date

Account Period Closed, Cannot Update Through Services API: The account period has closed and the account books cannot be updated through through the QBO Services API. Please use the QBO website to make these changes

An update or a payment record has attempted a sync on an invoice. The QBO account for the invoice month have been closed so future syncing on the invoice is blocked

• Open the QuickBooks file through the Account Settings in your QBO account and then resync the payments that are needing to be synced from SingleOps
• If unable to open books, the records that will not sync will have to be entered into QuickBooks manually.
  • To avoid future sync errors on these invoices, you will need to mark the invoice to 'Never Sync' and then Clear the errors from your Quickbooks Online Unsynced Entities report

The name supplied already exists. Another customer,
supplier, or employee is already using this name. Please use a different name.

This indicates that another Client already exists in QBO with an identical Display Name. You will need to merge these Client within SingleOps.

• Change the name of the Client in QuickBooks Online. Example: Jane Doe to Jane Doe*
• Visit the QuickBooks Online error code and click the Re-Sync  to try to sync over Jane Doe again
• Within SingleOps navigate to Jane Doe* after it syncs over from QB
• Select Merge
• Merge  Jane Doe*  into Jane Doe
• Select to save the Client
• Select Yes within the prompt that asks if you would like to merge Client

The customer you have specified has been deleted

A Client in QuickBooks Online with an identical Display Name has been Archived.

Un-archive the Client in QuickBooks Online, to do that follow these steps:

• Select Sales or Invoicing from the left menu.
• Select Customers at the top.
• At the top of the customer list click the small gear and select Include Inactive.
• Click the customer you wish to restore; inactive customer will be noted as (deleted).
• Click the Make active button next to the customer name.

Transaction date is prior to start date for inventory item: Transactions with inventory (QOH) products cant be dated earlier than the Inventory Start Date for the product

An item on the SingleOps invoice is setup as an inventory type in the account's QuickBooks Online configurations and has an "As of Date" on the item that is after the invoice date containing the inventory item

The invoice will not sync unless ONE of the TWO are adjusted (see below):

• In SingleOps - The invoice dateto be past the starting date of the inventory item in your QB 

• In QuickBooks - Adjust the inventory date to be of an earlier time, years in the past for example, and this should prevent the problem for resurfacing and allow these to sync

Invalid account type used

An item involved is not configured correctly.

Items have to have an income account and the selection made is not of type 'Income'