FAQs

1. What does the 502 error code mean?

R: A 502 error code means that there is an error in Shopify’s server. Sometimes, this error is temporary and will be solved after the next synchronization. Thus, making changes in the products like switching the product’s visibility would solve the problem.

Additionally, a complete list of error codes that can be returned by Shopify and their descriptions are available at the following link: https://shopify.dev/api/usage/response-codes

So, if the 502 error code remains after sending the item to Shopify, the client can ask Shopify for more detailed information about the specific error. To do that, Sales Layer can provide the client with the “x-request-id” that identifies the request. 

2. Does Shopify Markets affect connector performance?

R: Related with 502 and 500 when working with third parties as Shopify Markets.

The fact of having markets activated may mean that the request could have a very large size in Sales Layer, even though 100 variants can be sent, it has this additional limitation. 

In the case of having Shopify Markets activated, the errors obtained by large requests are 500 and 502 errors that cannot be handled. In that case, the client has to contact Service Layer support for review.

3. How can I know if the synchronization of my items was done properly?

R: In the connector in Sales Layer, after the first synchronization, a section will appear with the synchronization record. There you can see all the information about the synchronization, errors, notices, and recommendations.

Warning: For security reasons, the synchronization will stop automatically if it generates more than 100 errors. If you need to change this setting, contact the Customer Success service.

4. Why are my images not syncing?

R: Images cannot exceed 20 megapixels on Shopify. In such a case, you can change the image output size on the connector and select a smaller one like the IMD.

5. What happens if I manually disable or refresh the connector while synchronization is in progress?

R: During a sync with Shopify, the system checks the status of the connector for every 50 items. In case the connector is disabled or a refresh has been launched, the current synchronization stops. When the connector is reactivated, another synchronization starts.

6. What does the “Update error with no response” message mean?

R: Sometimes, the Shopify API does not give any information about the sync result of the items. In such a case, Sales Layer will display the following error: “Update error with no response”.

In order to correct this error, you will need to re-send the item reported in the message. Just modify anything in that reference. This action will relist the item on the next sync.

7. What does the “Internal Server Error” mean?

R: This error refers to a Shopify API error when trying to sync. The Shopify API server returns a 500 error caused by a timeout while trying to receive a response from the database.

This is a typical Shopify error, as you can see also on their community site.

8. How can we send image/file type metafields to Shopify?

R: Currently it is not possible to send image or file type metafields to Shopify from Sales Layer. However, you can apply a workaround and send their URLs to be stored in your metafields.

To be able to send an image or a file to a metafield you will have to:

• Define a metafield in Shopify to receive a "single-line" text that can receive a single value or a list of values.

• Create a field in the Sales Layer connector following the nomenclature specified in the “Metafields” section of this manual. You will have to apply the following formula:  PRINT({our image field.org}) where “our image field” is the name of the image field that you want to export to Shopify.

9. What happens if we modify the handle of an item? Will it affect SEO?

R: When modifying the handle of an item, the data from Sales Layer will be modified, but no automatic redirection will be applied from the old URL to the new one. To do this, you can create the redirect manually as explained here.

You can also make a call to Shopify's GraphQl API (from the client side) as shown here.