Troubleshooting Invalid Item Mappings for Successful Transaction Posting in Webgility Desktop
This article helps users in Webgility Desktop identify and resolve errors related to invalid or missing item mappings when posting orders or transactions. It explains how to correctly link items to the corresponding products in accounting or inventory systems like QuickBooks and provides steps to remap items for successful transaction posting.
Overview
When posting an order or transaction in Webgility Desktop, you might receive an error related to invalid or missing item mapping. This usually means the item in your order isn’t correctly linked to the corresponding product in your accounting or inventory system (like QuickBooks).
This article walks you through how to identify, correct, and remap items so your transactions can post successfully.
🧭 Why Mapping Errors Happen
You’re likely seeing this error because:
-
The item was renamed, deleted, or updated in your store or accounting system.
-
The item was never mapped in Webgility Desktop.
-
Existing mappings are outdated or misconfigured.
🛠️ Step-by-Step: Fixing Mapping Errors
1. Review the Error Message
-
Webgility Desktop will display the specific error when a transaction fails.
-
Take note of the item name or SKU mentioned—this is the one causing the issue.
2. Check Current Mappings
-
In Webgility Desktop, go to Product Catalog
-
Search for the affected item by SKU or product name.
-
Confirm whether it’s already mapped or showing an invalid link.
3. Remove and Remap the Item
If the mapping is broken:
-
Select the item in the Product Mapping list.
-
Click Remove Mapping
-
Now click Remap.
-
Choose the correct item from your QuickBooks Desktop
-
Save your changes.
4. Retry the Transaction
-
Return to Orders > Recent Orders.
-
Select the failed order and click Post to QuickBooks Desktop
-
Verify that the transaction posts without errors.