How to Resolve Duplicate Item Mappings in Webgility Desktop
This article helps Webgility Desktop users identify and resolve duplicate item mappings in Webgility Desktop that can lead to failed order postings, inventory discrepancies, and incorrect product synchronization with QuickBooks Desktop. It provides step-by-step instructions to detect, remove, and correct duplicate mappings, ensuring smooth and accurate syncing between sales channel and QuickBooks Desktop.
Step 1: Identify Duplicate Mappings
To check for duplicate item mappings:
-
Open Webgility Desktop
-
Go to Products
-
Look for:
-
Store items mapped to more than one QuickBooks product
-
Repeated SKUs or product names with different QuickBooks links
-
⚠️ Signs of duplicate mappings:
Posting errors when syncing orders
Mismatched inventory counts in QuickBooks
Multiple entries for the same product
💾 Step 2: Backup Your Configuration
Before making any changes:
-
Go to System > Database > Backup
🗑️ Step 3: Remove Duplicate Mappings
Clean up the incorrect links:
-
In Product Mapping, locate items mapped to multiple QuickBooks products
-
Select the duplicate mappings
-
Click Remove Mapping
-
Confirm the deletion when prompted
Repeat this for all affected items.
🔄 Step 4: Refresh Items from QuickBooks and Store
This will:
-
-
Import current QuickBooks product data
-
Clear out any outdated or obsolete items
-
🔗 Step 5: Remap Items Correctly
After cleanup:
-
Return to Products > Product Mapping
-
Find unmapped items from your store
-
Click Map to QuickBooks for each
-
Select the correct QuickBooks item from the list
-
Save the new mapping
💡 Tip: Ensure that SKUs or item names match across both systems to avoid future conflicts.
✅ Step 6: Test by Posting an Order
Verify that the mapping changes have resolved the issue:
-
Select an order that previously failed due to a mapping error
-
Click Post to QuickBooks
-
Confirm that the order processes successfully, with no item-related errors