Useful Links

Troubleshooting

Introduction
When you're setting up SparkLayer, our team is on-hand to give you the support you need and you can contact us﻿ at any time. We've also detailed a number of common issues that are a useful starting point.
﻿
﻿
﻿
Pricing
See all our pricing FAQs
For further troubleshooting for pricing, please refer to Pricing FAQs﻿﻿
⚠️ Product prices aren't showing on the product pages or saying "Unavailable"
You've logged in as a B2B customer but prices aren't showing on your product pages or the product shows as 'Unavailable'
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Check that you've installed the Frontend Interfaces﻿﻿
Check that you've imported a price list﻿ that includes the product you are having issues with and you're signed in with a valid customer group. For example, if you have a price list "Base", make sure you have a customer group that is assigned this price list. You can also check your pricing in the Price Editor tool.
Check that you've assigned the correct customer tags to the customer record you are logging in with. The customer must have a tag of b2b by default and any additional tags that give them additional customer rules﻿
Check that you have SKUs for products. If you don't already have SKUs in Shopify, it's relatively quick to do. You can either edit individual products and add them manually, or you can use Shopify's 'Import' or 'Edit products' feature to do this in bulk.
Check that the product is set to "Active" within the Shopify admin (i.e. not "Draft" or "Pending"). SparkLayer will only import "Active" products.
SparkLayer will only import pricing for SKUs that are assigned to the B2B Ordering channel within Shopify. Make sure you have B2B ordering selected in Shopify.
If you're setting up tiered pricing, make sure that you've specified a price for a single unit for all products in your CSV. 
Not applicable
⚠️ I'm getting errors in the Price List import 
You've imported a CSV file but it's showing errors once you've uploaded it
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Check that all your products in Shopify have unique SKUs assigned. 
If your product has variants (e.g. small, medium, larger), make sure there are no duplicates in your SKUs 
Check that you've configured the price list CSV file as per the guides within Price Lists﻿ (e.g. ensuring no currency symbols in the price column)
Check that the product in Shopify has the B2B ordering channel ticked under 'Sales Channels'. SparkLayer will only import pricing for SKUs that are assigned to the B2B Ordering channel within Shopify.
Check that the product in Shopify has been set to Product Status "Active". Currently SparkLayer will only import prices for products that are active in Shopify (versus in "Draft" status)
Check the SKU exists within your Shopify catalogue
Not applicable
⚠️ Tiered pricing isn't showing when I upload a price list
You've logged in as a B2B customer and when you go to a product page, you can't see the tiered pricing you've uploaded.
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
When you upload your CSV for your price list, make sure the qty field is correctly populated. 
SparkLayer will only import pricing for SKUs that are assigned to the B2B Ordering channel within Shopify.
Make sure that you've specified a price for a single unit for all products in your CSV. 
Not applicable
﻿
﻿
﻿
Data Sync
⚠️ I'm getting errors in the Product Data Sync
﻿
If you're viewing the product data sync and you see a warning sign, there could be a number of reasons for this. 
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
First of all, we recommend clicking the warning box to see the issues flagged. The issues are typically data-related (e.g. missing a field) and the good news is they can be easily remedied. We've highlighted what the messages mean.
Error message
Diagnosis
Check SKUs are assigned to all variants in Shopify
For this specific product, within Shopify you are likely missing a SKU next to each variant or the main product itself. If you open the product in Shopify, you can add this under Inventory. Note: SparkLayer will only successfully import products that have SKUs assigned for all variants.
Not applicable
⚠️ The Product Data Sync says "This product cannot be found"
﻿
If you're searching for a product in the Product Data sync and it doesn't return any results, this could be due to a number of reasons.
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Check that you have valid SKUs for products. If you don't already have SKUs in Shopify, it's relatively quick to do. You can either edit individual products and add them manually, or you can use Shopify's 'Import' or 'Edit products' feature to do this in bulk.
Check that the product is set to "Active" within the Shopify admin (i.e. not "Draft" or "Pending"). SparkLayer will only import "Active" products.
SparkLayer will only import pricing for SKUs that are assigned to the B2B Ordering channel within Shopify. Make sure you have "B2B ordering" selected in Shopify for any products you want to show to B2B customers
If you're still having issues, please contact our support team and we'll be happy to help.
Not applicable
⚠️ I'm getting errors in the Customer Data Sync
﻿
If you're viewing the customer data sync and you see a warning sign, there could be a number of reasons for this. 
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
First of all, we recommend clicking the warning box to see the issues flagged. The issues are typically data-related (e.g. missing a field) and the good news is they can be easily remedied. We've highlighted what the messages mean.
Error message
Diagnosis
Address - The Country assigned is incomplete or invalid
Please make sure the customer record within Shopify has a Country assigned (e.g. United States of America). Please note: this must apply to all addresses within the customer's address book
Address - The City is missing and is a required field
Please make sure the customer record within Shopify has a City assigned. Please note: this must apply to all addresses within the customer's address book
Address - The address needs a first line added (Line 1)
Please make sure the customer record within Shopify has the first line of the address assigned. Please note: this must apply to all addresses within the customer's address book
Address - the Post/Zip code is invalid and is a required field
Please make sure the customer record within Shopify has the postal or zip code assigned. Please note: this must apply to all addresses within the customer's address book
{"code":"resource-id-not-found","message":"Invalid customer group "tier-1".","....":"group"}
Please check your customer tags in Shopify. It may be because the customer has a previously used tag which no longer corresponds to the tags in your Customer Groups. E.g. if they have a tag of b2b-tier-1 but the b2b-tier-1 customer group doesn't exist in the SparkLayer dashboard any more, it will show this error.﻿
In general, we always recommend the following:
Check the customer has a fully completed address, including Country, Line 1 address, City, and Zip/Post code
Check the customer doesn't have additional addresses that are incomplete in Shopify 
Check the customer hasn't had their email address recently changed. Whilst this shouldn't cause an issue, sometimes it can cause issues when syncing data
Not applicable
⚠️ The Customer Data Sync says "This Customer ID cannot be found"
﻿
If you're searching for a customer in the Customer Data sync and it doesn't return any results, this could be due to a number of reasons.
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Area
Diagnosis
Check the customer ID
You can also find this ID in the URL when navigating a customer within the Shopify Customers admin. For example, the URL in your browser may look something like this:

https://your-shopify-store-url.com/admin/customers/5917633347819 

In this example, the external customer ID would be 5917633347819
Check the customer tag
SparkLayer relies on the customer tag feature within Shopify. For a customer to sync with SparkLayer, they must have a tag of b2b set within their customer record in Shopify. Without this, their record will not sync to SparkLayer.
In general, we always recommend the following:
Check the customer has a tag of b2b assigned
If you're still having issues, please contact our support team and we'll be happy to help.
Not applicable
﻿
﻿
﻿
Website
⚠️ Nothing happens when I log in as a B2B customer on my store
You've logged into your Shopify store with a customer account but nothing happens and you don't see the SparkLayer Frontend widgets load
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Check that you've assigned the correct customer tags to the customer record you are logging in with. The customer must have a tag of b2b by default and any additional tags that give them additional customer rules
Check that your B2B customers have a valid address assigned to them. From the Customer Import, you can see if any customers don't
Check that there are no syncing issues for the customer in the Data Sync tool
Check that you've installed the Frontend Interfaces﻿﻿
Check that you are testing on the correct Shopify storefront theme (e.g. you may have installed SparkLayer on a backup theme)
Not applicable
⚠️ The SparkLayer frontend widgets aren't loading on my product pages
You've logged in as a B2B customer and the SparkLayer My Account shows but no B2B prices show on product pages
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Check that you've installed the Frontend Interfaces﻿﻿
Check that you have SKUs for products. If you don't already have SKUs in Shopify, it's relatively quick to do. You can either edit individual products and add them manually, or you can use Shopify's 'Import' or 'Edit products' feature to do this in bulk.
Check that the product is set to "Active" within the Shopify admin (i.e. not "Draft" or "Pending"). SparkLayer will only import "Active" products.
SparkLayer will only import pricing for SKUs that are assigned to the B2B Ordering channel within Shopify. Make sure you have "B2B ordering" selected in Shopify for any products you want to show to B2B customers
Not applicable
⚠️ A message saying 'An unknown error occurred' shows
You've logged in as a B2B customer and when you go through the checkout, you see an error message showing on the top right of your browser
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Check that the products in your order don't have prices of 0.00 set in Shopify. In general, SparkLayer relies on the Shopify price being higher than the B2B price in order to place an order with the correct calculations. Prices of 0.00 will throw an error and prevent checking out
If you're using multiple-currencies, make sure you've configured Shopify Markets as per our guide here﻿. You'll need to ensure each market has currencies and shipping methods correctly set
If you're placing an order as a sales agent﻿, make sure the email address of the customer you're placing an order for is valid. Any invalid emails (e.g. an incorrect domain name) may prevent an order being placed due to Shopify rejecting the details.
Within your core script﻿, make sure the siteId variable matches that shown in the SparkLayer Dashboard.
Not applicable
﻿
﻿
﻿
﻿
Orders
⚠️ Orders aren't showing in the Orders admin
You've placed an order via the SparkLayer Quick Order cart but it's not showing up in your Shopify admin
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Check that the order has been placed as a B2B customer. You can check this from the "Notes" field within the order in Shopify
Unless the order is placed via 'Upfront Payment' (i.e. by card payment), the order will appear as a Draft order within Shopify by default. You can access this by clicking Orders and then Draft Orders within the Shopify admin. If you'd prefer for all orders to arrive in Shopify as completed orders (i.e. not draft orders), you can enable this here.
Not applicable
﻿
﻿
﻿
Checkout
⚠️ Customers can't place orders because of incomplete addresses
A signed in B2B customer is trying to complete their order but it says their addresses are incomplete
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
Make sure that all address fields for the customer are completed within their customer record in Shopify
Make sure they have no incomplete addresses saved against their account
Not applicable
⚠️ Shipping methods aren't showing for customers
﻿
You've logged in as a B2B customer and when you get to the Shipping Method, you can't see a shipping method to select
✅ View possible resolutions
🛍️ Using Shopify
🌐 Other platforms
Possible resolutions:
If you're using SparkLayer's built-in shipping, make sure that you've set up your shipping rules correctly, e.g. by country or by customer group. If the customer doesn't match any of the rules you've set, no shipping method will be shown.
If you're using Shopify to set your shipping methods, make sure you have a shipping country specified for your shipping methods, e.g. if the customer is from United Kingdom, ensure that your shipping methods have United Kingdom as an option
If you're using Shopify Markets, make sure that you have shipping profiles set up for your destination countries.
Not applicable
﻿

Updated 20 Sep 2023

Did this page help you?

TABLE OF CONTENTS

Error message	Diagnosis
Check SKUs are assigned to all variants in Shopify	For this specific product, within Shopify you are likely missing a SKU next to each variant or the main product itself. If you open the product in Shopify, you can add this under Inventory. Note: SparkLayer will only successfully import products that have SKUs assigned for all variants.

Error message	Diagnosis
Address - The Country assigned is incomplete or invalid	Please make sure the customer record within Shopify has a Country assigned (e.g. United States of America). Please note: this must apply to all addresses within the customer's address book
Address - The City is missing and is a required field	Please make sure the customer record within Shopify has a City assigned. Please note: this must apply to all addresses within the customer's address book
Address - The address needs a first line added (Line 1)	Please make sure the customer record within Shopify has the first line of the address assigned. Please note: this must apply to all addresses within the customer's address book
Address - the Post/Zip code is invalid and is a required field	Please make sure the customer record within Shopify has the postal or zip code assigned. Please note: this must apply to all addresses within the customer's address book
{"code":"resource-id-not-found","message":"Invalid customer group "tier-1".","....":"group"}	Please check your customer tags in Shopify. It may be because the customer has a previously used tag which no longer corresponds to the tags in your Customer Groups. E.g. if they have a tag of b2b-tier-1 but the b2b-tier-1 customer group doesn't exist in the SparkLayer dashboard any more, it will show this error.

Area	Diagnosis
Check the customer ID	You can also find this ID in the URL when navigating a customer within the Shopify Customers admin. For example, the URL in your browser may look something like this: https://your-shopify-store-url.com/admin/customers/5917633347819 In this example, the external customer ID would be 5917633347819
Check the customer tag	SparkLayer relies on the customer tag feature within Shopify. For a customer to sync with SparkLayer, they must have a tag of b2b set within their customer record in Shopify. Without this, their record will not sync to SparkLayer.