Shopify Integration

OrderDay integrates deeply with Shopify using OAuth authentication and webhooks for real-time synchronization.

Before You Connect

Ensure your Shopify products are configured correctly for best results. The vendor field is especially important for automatic distributor matching. See our Product Setup Guide.

How It Works

1. OAuth Connection

When you install OrderDay, you authorize the app to access your Shopify store data:

• One-click setup: No API keys to copy/paste
• Secure: Uses Shopify's official OAuth flow
• Scoped permissions: Only accesses necessary data (products, orders, inventory)

2. Initial Data Sync

After installation, OrderDay fetches:

• All products and variants
• Order history (last 90 days by default)
• Inventory levels across all locations
• Product vendors and categories

Sync time: Typically 1-2 minutes for stores with <1,000 products.

3. Real-Time Updates

OrderDay registers webhooks to stay in sync:

Event	What Happens
Product created	Added to OrderDay catalog
Product updated	Prices, inventory, and details refreshed
Product deleted	Marked as archived in OrderDay
Order created	Sales velocity recalculated
Inventory updated	Stock levels refreshed

Update latency: Changes appear in OrderDay within 5-10 seconds.

Embedded Admin Experience

OrderDay runs inside your Shopify admin using App Bridge:

• Native navigation: Feels like a built-in Shopify feature
• Polaris design system: Matches Shopify's UI/UX
• Single sign-on: No separate login required

Manual Sync

If you need to immediately refresh your product data from Shopify, use the Sync button in the Order Day header.

When to use manual sync:

• After making bulk product updates in Shopify
• When you want to see the latest inventory levels immediately
• If automatic sync appears delayed

The sync button clears all cached data and triggers a fresh fetch from Shopify. Changes will be visible after the page refreshes.

Data Synchronization

Product Data

OrderDay syncs the following product fields:

• Title, description, and vendor
• Variants (SKU, price, inventory)
• Images and product type
• Tags and collections

Note: OrderDay maintains its own supplier cost data (not stored in Shopify's cost field).

Order Data

For sales velocity calculations, OrderDay tracks:

• Order date and line items
• Quantity sold per variant
• Order status (fulfilled, cancelled, etc.)

Privacy: No customer personal information is stored.

Inventory Levels

Real-time inventory sync includes:

• Stock on hand per location
• Inventory policy (track/don't track)
• Low stock thresholds (configured in OrderDay)

Multi-Location Support

If your Shopify store has multiple locations:

• OrderDay aggregates inventory across all locations
• Purchase orders are location-aware
• Stock transfers are not currently supported (roadmap item)

Disconnecting Your Store

To disconnect OrderDay from your Shopify store:

1. Go to Settings → Apps and sales channels
2. Find OrderDay in the list
3. Click Uninstall

Warning: This will delete all OrderDay data including supplier costs, order history, and settings. This action cannot be undone.

Webhook Security

All webhooks are verified using HMAC signatures to ensure they originate from Shopify. OrderDay rejects any webhook with an invalid signature.

Rate Limits

OrderDay respects Shopify's API rate limits:

• GraphQL: 2,000 points per second (cost-based)
• REST: 2 requests per second (legacy endpoints)
• Webhooks: No rate limit (Shopify controls delivery)

For large operations (bulk updates, imports), OrderDay uses Shopify's bulk API to avoid throttling.

Troubleshooting

Products not syncing

1. Click the Sync button in the Order Day header to trigger an immediate refresh
2. Check webhook status in Settings → Integrations
3. If webhooks are missing, reconnect your Shopify store

Order data missing

OrderDay only syncs orders from the last 90 days during initial setup. To import older orders:

1. Go to Settings → Data Import
2. Click Import Historical Orders
3. Select date range (up to 2 years)

Permission errors

If you see "Missing access scope" errors:

1. Uninstall the OrderDay app
2. Reinstall from the Shopify App Store
3. Ensure all permissions are granted during installation

Next Steps

• Create your first order
• Set up supplier management
• Configure inventory alerts