Menu
Close
Verso can automatically import orders from your Shopify store as draft Package Slips, making it easy to fulfill orders directly from your inventory management system.
When you connect your Shopify store to Verso:
1. Verso periodically checks your Shopify store for new orders
2. Each order is automatically converted to a draft Package Slip
3. Line items are matched to your products by SKU
4. You review and finalize the Package Slip in Verso
5. Inventory is deducted only when you mark the slip as shipped
This integration is one-way, Verso only reads orders from Shopify and doesn't send information back. Your Shopify store remains the source of truth for order management.
1. Log in to your Shopify admin dashboard
2. Click Settings in the bottom left corner
3. Select Apps and sales channels
4. Click Develop apps (you may need to click "Allow custom app development" first) [Legacy app only]
5. Click Create an app
6. Give your app a name like "Verso Inventory Sync" and click Create app
1. Click on Configure Admin API scopes
2. Scroll down to find the Orders section
3. Check the box for read_orders permission
4. Click Save at the bottom of the page
1. Click on the API credentials tab
2. Under Admin API access token, click Install app
3. Click Install to confirm
4. Your Admin API access token will now be displayed , click Reveal token once to see it
5. Important: Copy this token immediately and store it securely. You won't be able to see it again!
1. Open Verso and navigate to your workspace
2. Go to Workspace Settings (richt click the workspace name in the sidebar)
3. Scroll to the Advanced section
4. Find Shopify Integration
5. Enter your store URL (just the store name, like `mystore.myshopify.com`)
6. Paste your Admin API access token
7. Choose how often you want Verso to check for new orders (we recommend 5 minutes)
8. Click Test Connection to verify everything is working
9. Toggle Enable Automatic Sync to start importing orders
For the integration to work properly, Shopify must use the same SKU's as used in Verso. As Verso has controlled SKU's to ensure they are unique.
Automatic Syncing
Once enabled, Verso will:
- Check for new Shopify orders at your chosen interval (1-30 minutes)
- Sync more frequently when the app is active, less when it's in the background
- Import only new orders that haven't been processed yet
- Avoid duplicates automatically
Manual Syncing
You can also trigger a sync manually:
- Click the Sync Now button in Shopify settings
- New orders will be imported immediately
Managing Imported Orders
Imported orders appear as draft Package Slips in your Package Slips list:
- The slip notes will show "Imported from Shopify order #1234"
- Customer shipping information is automatically filled in
- Line items are matched to your inventory by SKU
- Review each slip to ensure accuracy
- Finalize and print when ready to ship
Handling Unmatched SKUs
If a Shopify order contains a SKU that doesn't exist in your Verso workspace:
- The order will still be imported if at least one item matches
- A warning will appear in the Package Slip notes
- You can manually add missing items or adjust the slip as needed
Connection Test Fails
"Unauthorized - check your access token"
- Your access token may be incorrect or expired
- Create a new custom app and generate a new token
"Access forbidden - check your API permissions"
- Make sure you've enabled the `read_orders` permission
- Save the scopes and reinstall the app
Orders Not Syncing
Check the sync status in Shopify settings:
- Look for error messages under the status indicator
- Ensure "Enable Automatic Sync" is toggled on
- Try clicking "Sync Now" to test manually
Orders appear in Shopify but not in Verso:
- Verso only imports orders with status "open"
- Make sure the order hasn't been archived or closed
- Check that line items have valid SKUs
SKUs Not Matching
Ensure SKU consistency:
- SKUs are matched case-insensitively (ABC123 matches abc123)
- Leading/trailing spaces are automatically trimmed
- Make sure your Shopify product SKUs exactly match your Verso inventory
- Your Shopify access token is stored securely in your Mac's Keychain
- Verso only requests read-only access to orders
- No customer data is shared with third parties
- The integration works entirely on your Mac — no external servers involved
- Use consistent SKUs across Shopify and Verso for automatic matching (required)
- Test with a few orders wit manual import before enabling automatic sync
- Review draft slips before finalising to catch any issues
- Keep sync intervals reasonable (5-15 minutes is usually perfect)
- Check the sync status regularly during initial setup
