Shopify
Connect Shopify to Moselle to sync sales, inventory, and product data for demand forecasting and inventory planning.
Overview
The Shopify integration imports your sales history, current inventory levels, and product catalog into Moselle. Once connected, data syncs automatically on a daily basis.
Connect Shopify
Log in to Moselle and click your avatar in the top right corner
Select Settings from the dropdown menu
Click the Integrations tab
Select Shopify and click Connect
You will be redirected to Shopify to install the Moselle app
Click Install on the Moselle app page
Enter your Shopify login credentials
Once connected, your sales and inventory begin importing and appear on the Catalog page.
Multiple Stores
You can connect multiple Shopify stores to a single Moselle account. Repeat the connection process for each store.
Data Sync Details
Sync Frequency — Shopify data syncs daily overnight (EST).
Sales Attribution — By default, Moselle uses gross sales. Your administrator can switch to net sales if needed. See Revenue Calculation Methods below for details.
SKU Matching — Shopify listings automatically link to Moselle items when SKUs match exactly. Non-matching SKUs require manual linking.
App Permissions & Legacy Installs
If you installed the Moselle app on Shopify before mid-2025, your integration might lack the specific permissions required for newer inventory features. This can cause inventory syncs to fail even if sales data is updating correctly.
The Fix: To resolve this, you must approve the updated permissions:
Go to Settings > Integrations in Moselle.
Locate the Shopify integration and click Connect again.
Shopify will show a screen with the updated permissions. Click Install App or Update App to grant the new inventory scopes required.
Troubleshooting
Sales numbers don't match Shopify exactly
Timezone differences and gross vs. net sales definitions
Expected behavior — see Revenue Calculation Methods above to align your settings.
Listings not linking automatically
SKUs don't match between Shopify and Moselle
Manually link listings or update SKUs to match
Inventory not syncing
Missing permissions (Legacy Install)
Click Connect again in Settings to approve updated permissions (see above).
Missing historical sales data
Shopify listing was deleted
Contact Moselle support — deleted listings lose variant IDs and require manual repair
Revenue Calculation Methods
Quick Answer: Moselle supports two Shopify revenue methods — gross (default, before discounts) and net (after discounts). Your administrator can switch between them at any time.
Gross Revenue (Default)
Gross revenue is the total sales amount before any discounts are applied. This is the default setting for all Shopify stores connected to Moselle.
Example: A customer buys 2 items at $50 each with a 20% discount code. Gross revenue is $100 (the full price before the discount).
This method is ideal if you want to track total potential revenue before promotional activity.
Net Revenue
Net revenue is the sales amount after all discounts are subtracted, including:
Line-level discounts (automatic discounts, product-specific promotions)
Order-level discounts (checkout promo codes)
Example: Using the same scenario above, net revenue is $80 (after the $20 discount).
Why It Matters
The revenue method you choose affects:
Historical sales data displayed across Moselle
Forecast revenue projections used for planning
Comparison with Shopify reports — match Moselle to Shopify's "Gross Sales" or "Net Sales" metrics
How to Change the Revenue Method
Contact your Moselle administrator or support team
Specify which Shopify store(s) need the change
After configuration, a backfill recalculates your historical sales data automatically
Note: After changing the revenue method, historical sales numbers are recalculated to ensure consistency across all your data.
Matching Shopify Reports
Gross revenue (default)
Gross Sales metric
Net revenue
Net Sales or Product Sales metric
Minor variances may occur due to timezone differences between Moselle and Shopify.
Important
Do not delete Shopify listings. Deleted listings lose their variant IDs, which breaks historical sales and inventory data. If listings are deleted, contact Moselle support to repair the affected data.
Last updated