Skip to main content

Shopify Connector

The Shopify connector links one Shopify shop to one eshopOS store and uses that link for preview and import jobs.

Current Integration Mode​

The current Shopify connector uses:

  • shop-domain entry
  • Shopify OAuth authorization
  • backend-only token storage
  • preview and import jobs scoped to the current store

What It Imports​

  • products
  • collections
  • variants
  • images and file-derived media
  • locations
  • inventory levels
  • customers

Merchant Setup Flow​

  1. Open Connectors.
  2. Open Shopify.
  3. Enter the shop domain, for example store-name.myshopify.com.
  4. Click Connect.
  5. Approve access in Shopify.
  6. Return to eshopOS.
  7. Run Preview before running import.

Core Mapping​

The Shopify connector normalizes Shopify data into eshopOS core records:

  • products become eshopOS products
  • collections become eshopOS categories
  • variants become eshopOS structured variants
  • locations become warehouses
  • inventory levels become warehouse stock

The storefront reads the normalized eshopOS catalog, not Shopify objects directly.

Notes​

  • reruns are expected to reconcile instead of duplicating records
  • disconnecting removes external access but does not delete imported catalog data
  • warnings during preview or import should be reviewed before rerunning