Product and customer sync
How sync works
Once your platform is connected (see Managing integrations), SparkLayer keeps two feeds from your store:
- Product sync tells SparkLayer which products and variants exist, so it knows which B2B prices to show when a signed-in B2B customer views a product.
- Customer sync tells SparkLayer who your B2B customers are, so it recognises them when they sign in and shows them the right B2B pricing and rules.
Your store
Sync
Price lists and customer groups
Storefront
Each feed has a full sync, which copies everything, and partial syncs, which copy what's changed since. SparkLayer syncs every product in your store by default. A product can't be bought by B2B customers until it has a price: see Pricing.
Check your products are syncing
Go to Pricing,Products (opens in your SparkLayer Dashboard in a new tab). When everything is working, the banner at the top reads Products sync completed. It says your products synced with no errors, and shows the times of the last full and partial sync.
SparkLayer picks up product changes automatically, usually within about 10 minutes of you saving them, so you don't need to start a product sync yourself. If a change still hasn't shown after that, contact support.
When to ask us for a full product sync
Partial syncs pick up recent changes. A few problems need a full product sync, which our team runs for you. Contact support if:
- You deleted a product and added it again, and it shows "Please ensure the variant SKU is unique", but the SKU isn't used anywhere else
- "SKU not unique" errors stay after you've made every SKU unique, for example after merging products into variants
- Products or variants you deleted on your platform still show to B2B customers, in the Products search or in the Price editor, where View product in Shopify opens a product that no longer exists
- You added a stock location, or imported a large batch of products, and products show as out of stock although they have stock
- Searching by SKU or barcode in the cart finds nothing, for products that show in the Products search
- You changed prices on a lot of products at once, and Product data still shows the old retail price
- You replaced test products with your live catalogue, or imported it again, and no products sync, although every variant has a SKU
- Products shows "500 Server Error" for many products, and it's still there a few minutes later
- New products show sync errors, or SparkLayer doesn't load on their pages, although each has a unique SKU, is Active and is in the SparkLayer sales channel
A full sync usually takes 20 to 30 minutes.
Look up a product's data
The search on Pricing,Products (opens in your SparkLayer Dashboard in a new tab) shows what SparkLayer has for a product, to diagnose a price or stock question.
- Go to Pricing,Products (opens in your SparkLayer Dashboard in a new tab).
- Search by name, SKU, barcode or ID.
- Check the results. Each shows the Product and its ID or SKU.
- Click a variant to open its Product data page, with its pricing and stock.
| Search by | Example or where to find it |
|---|---|
| SKU | The stock keeping unit of a variant. A product with three variants might have the SKUs ABC-1, ABC-2 and ABC-3. |
| ID | The product's ID on your platform. On Shopify, open the product in the admin: the ID is the number at the end of the URL. In https://your-shopify-store-url.com/admin/products/7356521840875 the ID is 7356521840875. |
| Name | All or part of the product name. |
| Barcode | The barcode, if the product has one. |
If nothing comes back, try the SKU, or a different name. If a product still isn't there, see Troubleshooting.
Stock states
SparkLayer also holds each variant's stock, in the Stock data card on its Product data page.
| What the card shows | What it means |
|---|---|
| A table of stock levels | Stock information exists for this variant, for each location. |
| No stock data found for this variant. | SparkLayer has no stock data for this variant. Variants without stock data can't be bought. |
| Stock is not being tracked for this variant. | Inventory tracking is turned off for this variant on your platform, so there's no stock information. The variant can still be bought. |
Check your customers are syncing
SparkLayer imports only customers tagged b2b, or customers your developer has sent with metafields in the sparklayer namespace. That way, you control which customers are imported. On Shopify, see Assign customers to a customer group and Shopify metafields.
To check a customer has synced, find them in Customers (opens in your SparkLayer Dashboard in a new tab) and open them. Their page shows what SparkLayer holds: their details, customer group, company and addresses. See Find and manage customers.
Fix customer sync errors
When some customers didn't sync, Customers (opens in your SparkLayer Dashboard in a new tab) shows a banner such as Customers sync completed with 3 errors, with the times of the last full and partial sync.
- Click Show errors. The table lists each customer's Name and a Description of the problem, such as "The customer must have a first name".
- Fix each customer in Shopify.
- Wait for the next partial sync. Fixed customers sync then.
From your first week, Home's briefing also tells you when customers didn't sync, with Show errors. Common errors and fixes are in Troubleshooting.
If a customer or their address won't sync, these are the 2 most common causes:
| Cause | Fix |
|---|---|
| An incomplete address, often a secondary (second) address in the customer's address book | Complete the address in Shopify, with a country, first line, city and postcode or ZIP code, or delete it. Every address must be complete, not only the default one. |
| The sales rep groups metafield isn't limited to preset choices (Shopify) | Turn on Limit to preset choices on the metafield's definition, with each sales rep group as a choice. See Set up the sales rep groups metafield. |
Re-running the customer sync
You don't need to start a customer sync yourself: customer changes usually sync within about 10 minutes. If you think it's stuck, contact support.
Troubleshooting
For product sync, check the products have a SKU on every variant and are Active. For customer sync, click Show errors on Customers (opens in your SparkLayer Dashboard in a new tab). For common causes and fixes, see Troubleshooting. If you can't resolve it, contact support.
Look the product up at Pricing,Products (opens in your SparkLayer Dashboard in a new tab). Also check the product has a price in one of the customer's price lists.
Find them in Customers (opens in your SparkLayer Dashboard in a new tab). If they aren't there, check they're tagged b2b on your platform (or, if your developer set them up that way, have sparklayer metafields), then check Show errors for a sync problem.
SparkLayer picks up product changes automatically, usually within about 10 minutes of you saving them. If they still haven't updated after that, contact support and we'll run a product sync for you.
Last updated