OAuth Connection Flow

To connect your Shopify store:

1. Navigate to /integrations and open the Shopify tab
2. Click Connect Shopify to begin the OAuth flow
3. You will be redirected to Shopify to authorize SortSwift
4. Select your store and approve the requested permissions
5. Shopify redirects back to SortSwift with the connection established
6. Select your Currency and Location settings as needed

The Four Shopify Apps

SortSwift uses up to four Shopify apps, each with a specific role. This separates inventory updates, pricing updates, POS sync, and rate-limit handling for reliability.

1. Main Integration App (Required)

The primary app for inventory sync and store operations:

• Inventory push: Batch, single, all, or remaining items
• Validate items before or after sync
• Auto-push toggle for continuous updates
• Metafields sync for custom product data
• Location selection for multi-location stores
• Block sealed/singles to control what syncs
• Webhook handling for product updates and orders
• Order forwarding from Shopify to SortSwift

2. Pricing App (Required)

Dedicated app for price updates to avoid rate-limit conflicts:

• Handles all price pushes separately from inventory
• Uses your autopricing rules and marketplace sources
• Reduces risk of hitting Shopify API limits during large syncs

3. POS Connector App (Optional)

For stores using SortSwift POS with Shopify:

• Syncs orders and inventory between SortSwift POS and Shopify
• Enables in-store sales to reflect on your Shopify store

4. Speed Booster Apps (Optional)

Additional apps to increase effective API rate limits:

• Create apps like "SortSwift Booster 1", "SortSwift Booster 2", etc.
• Grant only: read_products, write_products, read_inventory, write_inventory
• Enter tokens in SortSwift Speed Booster configuration
• Faster bulk syncs for large catalogs

Permission Checking

Each app has its own permission set. SortSwift checks permissions before sync operations:

• Main app: Full access to products, inventory, locations, webhooks
• Pricing app: Read/write products and variants for price updates
• POS Connector: Order and inventory sync scopes
• Speed Booster: Products and inventory only

Webhook Handling

When connected, SortSwift registers webhooks for:

• Product updates: Keep SortSwift in sync when products change in Shopify
• Orders: New Shopify orders can be forwarded to SortSwift for fulfillment

Connection Verification

• Status will update to "Connected" with your store name
• Sync options and settings become available
• Advanced location mode for multi-location inventory
• You can start pushing inventory to Shopify

Troubleshooting

• OAuth denied: Ensure you approve all requested permissions
• Permission errors: Reconnect to refresh scopes if you changed app permissions
• Already connected: Disconnect first if switching to a different store
• Connection timeout: Check internet and Shopify API status