Shopify Sync Errors – Troubleshooting Guide

Shopify Sync Errors – Troubleshooting Guide

Overview

When syncing data between Hike POS and Shopify, you may occasionally encounter errors that prevent products, sales, or customers from syncing successfully.

This guide explains common Shopify sync errors, their possible causes, and the steps you can follow to resolve them.

Before you begin: Identify the exact error message displayed in Hike POS and locate the corresponding error below. Follow the recommended troubleshooting steps and try syncing the affected record again.

If the error persists after following the suggested steps, please contact Hike POS Live Chat Support for further assistance.


1. Product Sync Errors

Error 1: Duplication of product in HikePOS! Already HikePOS product is mapped with Shopify product Id

Entity: Product

Possible cause: Multiple products in Hike POS have the same name, causing a conflict when mapping them to Shopify products.

How to resolve:

  1. Identify the products in Hike POS that have the same name.

  2. Open your Shopify store and locate the corresponding products.

  3. Find the Shopify product handle for each product.

  4. Add the corresponding Shopify product handle to the relevant product in Hike POS to ensure the products are mapped correctly.

  5. Try syncing the affected products again.

Error 2: Error: [API] API Access has been disabled

Entity: Product

Possible cause: Your Shopify store may still be using the old Hike POS app, which Shopify has discontinued.

How to resolve:

  1. Log in to your Shopify account.

  2. Open the installed apps section and locate the old Hike POS app.

  3. Uninstall the discontinued app.

  4. Install the Hike custom app in your Shopify account.

  5. Check the integration and try syncing the affected products again.

If you need assistance installing the correct app or reconnecting the integration, contact Hike POS Live Chat Support.

Error 3: SKU already exists

Entity: Product

Possible cause: A simple product may have been converted into a variable product in Shopify, resulting in a duplicate SKU between the parent product and one of its variants.

How to resolve:

  1. Open Shopify and locate the affected product.

  2. Review the SKU assigned to the parent product and its variants.

  3. Identify any duplicate SKUs.

  4. Either update the SKU of the affected variant in Shopify or update the parent product's SKU in Hike POS to ensure the SKUs do not conflict.

  5. Try syncing the product again.

Error 4: Product attribute is not deleted

Entity: Product

Possible cause: The variant attributes associated with the product may have been deleted from Hike POS, causing an issue with product synchronisation.

How to resolve:

  1. Open the affected product in Hike POS.

  2. Review its variant attributes and check whether any attributes have been deleted or modified.

  3. If the product's variant configuration has changed, contact Hike POS Live Chat Support for assistance with correcting the product configuration and synchronisation.

Error 5: Throttled

Entity: Product

Possible cause: Shopify has API rate limits that restrict the number of requests that can be processed within a given period. This error may occur when the integration exceeds the permitted request limit.

How to resolve:

  1. Wait for Shopify's API rate limit to reset.

  2. Once the limit resets, check the product sync status in Hike POS.

  3. If the product has not synced successfully, try syncing it again.

  4. If the error continues, contact Hike POS Live Chat Support.

For more information, refer to Shopify's official documentation on API usage limits.

Error 6: Variable $productId of type ID! was provided invalid value

Entity: Product

Possible cause: The same SKU may have been assigned to multiple variants in Shopify, causing a conflict when syncing products to Hike POS.

How to resolve:

  1. Open Shopify and locate the affected product.

  2. Review the SKUs assigned to its variants.

  3. Check whether the same SKU has been assigned to multiple variants.

  4. Update the duplicate SKUs so that each variant has the correct, unique SKU.

  5. Save the changes and try syncing the product to Hike POS again.


2. Sales Sync Errors

Error 7: Something went wrong (internal error). Please try again!

Entity: Sales

Possible cause: The group tax name may exceed the supported length, causing an error during sales synchronisation.

How to resolve:

  1. Check whether the error occurs when syncing a sale that includes group tax.

  2. If the error persists, contact Hike POS Live Chat Support and share the affected sale details and the exact error message.

Note: The technical team is working on extending the supported group tax name length. If the issue is related to this limitation, a customer-side change may not resolve it immediately.

Error 8: phone: Phone has already been taken

Entity: Sales

Possible cause: The phone number associated with the customer is already assigned to another customer in Shopify. Shopify therefore rejects the operation.

How to resolve:

  1. Open Shopify and locate the customer associated with the affected sale.

  2. Review the customer's phone number.

  3. Check whether the same phone number is already associated with another Shopify customer.

  4. If the phone number is incorrectly assigned or duplicated, correct the customer records where appropriate.

  5. Try syncing the affected sale again.

If the error persists, contact Hike POS Live Chat Support for assistance.


3. Customer Sync Errors

Error 9: Required Name or Company Name or Email!

Entity: Customer

Possible cause: Shopify has restricted access to customer personal data through the integration for stores on its Basic plan. As a result, Hike POS may not receive the customer name, company name, or email address required to map the customer correctly.

How to resolve:

  1. Identify the customer associated with the affected Shopify sale.

  2. Open Hike POS and create a customer record using the same name and email address as the customer associated with the Shopify sale.

  3. Ensure the customer details match the available information in Shopify.

  4. Save the customer record and check whether the customer is mapped correctly.

  5. Try syncing the affected sale again.

Note: The Hike POS team is working with Shopify to resolve this limitation or identify a suitable workaround. If the issue continues after creating the matching customer record, contact Hike POS Live Chat Support.

Error 10: Country is required!

Entity: Customer

Possible cause: The customer's country is missing from the customer record in Hike POS. Shopify requires a country when the customer is synced.

How to resolve:

  1. Open the affected customer record in Hike POS.

  2. Locate the address details.

  3. Enter the customer's country in the country field.

  4. Save the changes.

  5. Try syncing the customer to Shopify again.

Error 11: At least one attribute to change must be present

Entity: Customer

Possible cause: The customer has multiple addresses in Shopify, which caused an issue when Hike POS attempted to update the customer record.

How to resolve:

  1. Check whether the error is still occurring when syncing or updating the customer.

  2. If the error persists, contact Hike POS Live Chat Support and provide the affected customer details and exact error message.

Note: This issue has previously been resolved by the technical team and should not occur again. If you encounter it, our support team can investigate further.


4. Still Unable to Sync?

If you have followed the troubleshooting steps above and the error still occurs, please contact the Hike POS Live Chat Support team.

To help us investigate the issue efficiently, please provide:

  • The exact error message displayed in Hike POS.

  • The affected entity, such as Product, Sales, or Customer.

  • The relevant product name, SKU, sale details, or customer details, as applicable.

  • A screenshot of the error message, if available.

  • The troubleshooting steps you have already completed.

Our support team will review the details and assist you with the next steps.

Important: Some Shopify sync errors are caused by API restrictions, integration limitations, or technical issues that cannot be resolved through customer-side changes alone. In such cases, our team will investigate and provide further guidance.