Troubleshooting Missing State Codes in Shopify B2B Orders in Webgility Desktop
This article helps Webgility Desktop users troubleshoot and resolve issues with missing state codes in orders downloaded from a Shopify B2B store. Missing state or province codes can disrupt order posting in Webgility Desktop or downstream systems. The guide walks users through configuration checks, resolution steps, testing procedures, and effective communication with customers. It is intended for use when customers report incomplete address details, particularly missing state or province codes, in their downloaded Shopify orders.
Issue Context
You’re supporting a customer who reported that orders downloaded from Shopify B2B are missing the state code in the shipping or billing address. This leads to failures or incomplete records during order posting or fulfillment integration.
Resolution Steps
1. Confirm the Reported Issue
Begin by reviewing the customer’s ticket:
- Confirm that the issue specifically involves missing state/province codes in downloaded B2B orders
- Ask for an example order ID or export sample, if needed
- Audit the Shopify Platform Configuration
Next, log in to the customer’s Shopify B2B admin account (ensure you have the proper access).
Then:
- Navigate to Settings > Checkout or relevant Order Export settings
- Locate the section that defines which fields are included when exporting or downloading orders
- Look specifically for an option labeled something like “Include State/Province Code.”
- Enable the State Code Option
Once you find the correct setting:
- Check or toggle ON the field to include State/Province Code
- Save the changes in the Shopify admin
- Test the Configuration Change
After updating the setting:
- Download or sync a test order
- Check the order in Webgility Desktop or in the downloaded CSV/Excel/API output
- Verify that the state code is now included in the address fields
Note: Use both B2B and B2C test orders if needed to confirm the setting applies universally.
- Ensure Order Posting Completes Successfully
If the state code is now present:
- Retry the order sync or posting process in Webgility Desktop
- Confirm that it completes without address-related errors