Connecting Shopify

You need Owner or Admin access to the Shopify store you want to connect. Ventorie requests the following Shopify scopes: read_products, write_products, read_inventory, write_inventory, read_orders, read_locations.

Go to Integrations → Add integration → Shopify. Enter your store's subdomain (just the part before .myshopify.com). Click Connect — you'll be redirected to Shopify's authorization screen. Approve the permissions, and you'll land back in Ventorie with the connection active.

On every sync Ventorie pulls: • Products — All active products and variants, including SKUs, prices, and images. Bundle/kit products are detected and modeled as Bills of Materials. • Orders — All orders from your connected store, including line items, quantities, and fulfillment status. Incremental syncs use a time-window cursor to avoid duplicates and gaps. • Locations — Shopify location names and IDs. You map these to your internal warehouses so inventory can be attributed correctly.

Shopify locations need to be mapped to Ventorie locations before inventory can be tracked per-warehouse. Click 'Manage' on the Shopify connector card → Locations. For each Shopify location, toggle it on and select the internal warehouse it corresponds to. Unmapped locations are ignored during sync.

Inventory in Ventorie comes from your 3PL (ShipBob) by default. If you want to seed Ventorie with Shopify's current inventory levels as a one-time starting point, click 'Import now' in the Inventory section of the Shopify connector card. This pulls the current Shopify inventory snapshot into Ventorie once — it won't repeat on future syncs.

Toggle 'Sync inventory to Shopify' on the connector card to push Ventorie's inventory levels back to Shopify after each sync. This requires write_inventory scope — reconnect the store if you see a permission error. This is useful when Ventorie is your inventory source of truth and you want Shopify's storefront to stay accurate.

The default sync schedule is manual. Use the 'Auto-sync schedule' dropdown on the connector card to set hourly, every 6 hours, every 12 hours, or daily automatic syncs. Scheduled syncs require the background worker to be running — contact support if you're on a plan that includes scheduled syncs.