This document provides steps to diagnose and resolve issues when orders fail to transfer from Shopify to HotWax Commerce (OMS).
When an order fails to import from Shopify to HotWax, it typically does not appear in the OMS, and an error is logged in the EXIM Import record for Shopify orders in HotWax Commerce. Several factors can contribute to these errors, such as incompatibility of exported data, API endpoint issues, or the absence of required meta fields during order processing. A report titled The Shopify Order Import Error Report details these failures, outlining specific errors generated by the system. These errors can usually be resolved by the following steps:
Navigate to OMS: Log in to OMS.
Check Order: Search the order on the OMS find order page to verify if the order is already available in OMS.
Log in to OMS: Use your username and password to log in to Hotwax Commerce OMS
.
Navigate to the Import Section:
Go to MDM > EXIM
in from the hamburger menu.
Navigate to Shopify Jobs
and select Import Shopify Order
under the Order Management tab.
Re-import the Order:
Select the Shopify config and enter the Shopify Order ID
.
Run the job by clicking the Run
button.
Verify Successful Import:
To verify the order's successful import, go to MDM > EXIM
.
Navigate to Shopify Jobs and click on Shopify Order MDM
under the MDM tab.
If the order still fails to import, troubleshoot the import failure by checking the error logs in the EXIM Import record for detailed errors. Some possible failure reasons are:
Connection timeout.
Transaction is empty.
Valid fields are missing in order JSON.
Identify the issue's source, determining if it originates from Shopify, the integration process, or HotWax Commerce.
If the cause remains unclear, reach out to HotWax Commerce support, providing them with the error logs for efficient troubleshooting.