Error Code: 9999 Due to Invalid Matching in Webgility Online
This article helps Webgility Online users resolve order posting error "Errorcode:9999" between Webgility Online and QuickBooks Online that occur due to unmapped or incomplete product data. It explains how missing or unrecognized items in QuickBooks Online can disrupt the posting process and provides step-by-step instructions to identify, map, or correct item records to ensure successful synchronization.
Step-by-Step Resolution
Step 1: Confirm the Error
-
Attempt to sync the affected order in Webgility.
-
Check the Order History for error code 9999.
-
Confirm that the issue points to missing or unmatched item(s).
Step 2: Verify Product Mapping
-
In Webgility, go to Products.
-
Locate the products included in the failed order.
-
Review the QuickBooks Item Name field for each.
-
Confirm that every product is mapped to an existing item in QuickBooks.
If a product isn't mapped or the mapping is incorrect, it will prevent the order from posting.
Step 3: Correct or Create Product Mappings
-
Select the unmapped product in Webgility.
-
Click Map to QuickBooks Item (or similar).
-
Choose the appropriate item from the QuickBooks list.
-
If the item doesn’t exist in QuickBooks, select Create to generate the item and automatically map it.
-
-
Save the changes.
Step 4: Re-Sync the Product List (Recommended)
-
Navigate to Sync Settings > Products.
-
In the top-right, click the dropdown and select Download from Scratch.
-
Click the circular refresh icon and confirm with Yes when prompted.
-
Wait for the sync to complete and show “Done!”
-
Click Save to apply the changes.
Step 5: Retry Syncing the Order
-
Go to the Orders tab in Webgility.
-
Select the order that previously failed.
-
Click Post to QuickBooks (or Sync).
-
Verify that the order now posts successfully without error code 9999.