Back to Help

Todifit Retailer Documentation

Shopify integration guide

Shopify catalogue and inventory sync is coming soon. This page outlines how the planned Shopify connection will work and the data it will access.

Status: coming soon

The Shopify integration is in progress and is not available to retailers yet. The details below describe the planned connection so you know what to expect. Square is available today if you want to connect catalogue and inventory now.

Data the integration will access

  • Products, variants, titles, descriptions, images, colours, sizes, prices, and status needed to build Todifit catalog entries.
  • Inventory levels and locations needed to calculate available stock across the retailer store.
  • Webhook events for product changes, inventory changes, and app uninstall events.

Planned OAuth scopes

When available, Todifit will request Shopify offline access with these scopes: read_products, read_inventory, write_inventory, and read_locations.

  • read_products: import product and variant catalog data.
  • read_inventory: read available inventory by location.
  • write_inventory: push stock adjustments after Todifit sales or refund restocks.
  • read_locations: understand the retailer locations used for inventory calculations.

How retailers will connect and use it

  1. Open Stock & POS in the retailer dashboard.
  2. Choose Shopify and enter the shop domain when prompted.
  3. Approve the Todifit app in Shopify.
  4. Return to Todifit and run Sync now, or wait for the scheduled sync.
  5. Review imported products and keep stock accurate through Shopify or Todifit order flows.

Planned implementation overview

Todifit will store a retailer-specific offline token server-side. The integrations service will perform full catalog syncs, scheduled refreshes, and best-effort webhook updates. Provider stock will be treated as the sum of available inventory across the store locations. Sales will deduct stock and refunds will restock through provider-aware inventory updates.