Troubleshooting Delayed Shopify Fee Data Causing Sync Errors in Webgility Desktop
This article helps Webgility Desktop users in troubleshooting issues where fees and order data from Shopify channel do not sync correctly with QuickBooks Desktop, often due to delays in fee data provided by Shopify channel. It guides users through steps to address missing fee details and orders stuck with errors, including implementing a custom node solution to manage these delays ensuring accurate and timely syncing of orders and fees.
Overview
When fees and order data from Shopify do not sync correctly with QuickBooks, particularly when fee details are missing or an order remains in error, the cause is often a delay in fee data provided by Shopify. This guide outlines troubleshooting actions and solutions, including the implementation of a custom node to handle these delays.
Symptoms
- Fees not appearing in QuickBooks for synced Shopify orders.
- Orders stuck in QuickBooks with errors related to missing fee details.
- Delays in order posting or failed sync operations.
Root Cause
Shopify sometimes delays providing fee data for new orders. If a sync to QuickBooks occurs before fees are available, the following issues can result:
- Missing fee details in QuickBooks.
- Orders being posted incompletely or with errors.
Troubleshooting Steps
1. Verifying the Custom Node is Active
- Confirm with the engineering or integration team that the custom node has been implemented and is enabled in the Shopify-QuickBooks workflow.
2. Handling Stuck Orders
If orders remain in error:
- Check Integration Logs:
- Search for sync attempts where fee data was missing.
- Look for log entries indicating delays or errors tied to Shopify’s fee data endpoints.
- Update or Retry Order Posting:
- Once fees are available, update affected order items as needed.
- Re-initiate the posting to QuickBooks. Monitor for successful export.
3. Confirming Resolution
- After the sync completes and fee details appear in QuickBooks, confirm the order is no longer in an error state.