Shopify Download Order Errors Troubleshooting Document

NoFulfillmentOrderInformation

Cause: This error occurs when a Shopify order is missing the necessary fulfillment order details. This can happen if the order is not yet ready for fulfillment in Shopify or if there's an issue with the order's data on the Shopify platform.
Troubleshooting:
1. Check Order Status in Shopify: Log in to your Shopify admin panel and navigate to the specific order. Ensure the order is in a paid and unfulfilled status.
2. Verify Location Assignment: Confirm that the products in the order are stockable at a location that is correctly linked to a Logiwa warehouse in your Shopify integration settings.
3. Retry the Download: After verifying the order in Shopify, manually trigger the Download Orders service again from the Logiwa IO integration screen.

Error Message: All products are Digital
Cause: The order contains only digital products. Logiwa IO's integration is designed to download and process orders with physical goods.
Troubleshooting:
1. Logiwa's Shopify integration recognizes when a product is not flagged with the "This is a physical product" checkbox in Shopify.
2. The system will not download orders that exclusively contain non-physical items.
3. For orders with a mix of physical and digital items, only the physical products will be downloaded into the Logiwa shipment order.
4. If these items are expected to be fulfilled automatically, you should create an automation rule in Shopify to flag digital products as fulfilled.

Error Message: The order includes custom products
Cause: The order contains a "Custom Item" that is not recognized as a standard product in Logiwa.
Troubleshooting:
1. Identify the Custom Product: The error message in the Integration History should specify which product is causing the issue.
2. Convert to a Standard Product: In Shopify, convert the custom item into a standard, trackable product with a unique SKU.

Error Message: The order includes products without an SKU
Cause: One or more products in the Shopify order are missing a SKU. While Logiwa can use a product's title as the SKU if the SKU field is empty, this error occurs if both are missing or if the configuration requires an SKU.
Troubleshooting:
1. Navigate to Products in Shopify: Log in to your Shopify admin panel and go to the "Products" section.
2. Edit the Product: Locate the product mentioned in the error log and open its details.
3. Assign a Unique SKU: Enter a unique SKU in the designated field for the product and each of its variants.,
4. Save and Retry: Save the changes in Shopify and re-run the Download Orders service in Logiwa.

Error Message: One or more SKUs in the order were not found in LogiwaIO
Cause: A product SKU from the Shopify order does not exist in your Logiwa product catalog, and the system is not configured to create it automatically.
Troubleshooting:
1. Check Integration Settings: Navigate to your Shopify store connection settings in Logiwa IO.
2. Enable Automatic Product Creation: Ensure that the "Download Products" setting is enabled. If it's disabled, you must enable the "Create Nonexistent Products When Orders Are Downloaded" option to allow Logiwa to create new product entries automatically.
3. Manual Product and Listing Creation: If you prefer not to enable automatic creation, you must manually create the missing product in Logiwa with the same SKU as in Shopify. Then, you need to manually add the Listing using Import Excel on the Product Listings Screen.
4. Retry Download: After adjusting the settings or creating the product, re-process the order.

Error Message: One or more products could not be created in LogiwaIO
Cause: The system attempted to create a product from a Shopify order but failed. This is typically due to missing essential product information in Shopify, such as the product's Title, which Logiwa uses as a fallback for the product name and description if the SKU is missing.
Troubleshooting:
1. Review Product in Shopify: Go to the product's page in your Shopify admin panel.
2. Ensure Essential Fields are Filled: Confirm that the product has a Title and a unique SKU.
3. Save and Sync: Save the product details in Shopify and trigger the order download again in Logiwa.

Error Message: Line details not found in the Order
Cause: The Shopify order was downloaded, but it contains no line items. This could be due to a data synchronization error or an issue with how the order was created in Shopify.
Troubleshooting:
1. Examine the Order in Shopify: Open the specific order in your Shopify admin panel.
2. Verify Line Items: Confirm that the order contains products with quantities in correct locations.
3. Re-save the Order: Make a minor, non-impactful change to the order (e.g., add and remove a tag) and save it. This can sometimes refresh the order data.
4. Retry Download: Manually run the Download Orders service in Logiwa again.

Error Message: No fulfillment order found with suitable status for fulfillment
Cause: The order exists and is unfulfilled, but Shopify has not marked it as ready for fulfillment at a location linked to your Logiwa warehouse. This can happen if inventory is not available at the assigned Shopify location or the order has a fulfillment status other than "Unfulfilled".
Troubleshooting:
1. Check Inventory in Shopify: In Shopify, verify that there is available stock for all order items at the location assigned to your Logiwa warehouse.
2. Check Fulfillment Status: On the order page in Shopify, check the fulfillment status. Ensure it is "Unfulfilled" and ready to be processed.
3. Verify Location Mapping: In your Logiwa Shopify integration settings, ensure that your Shopify locations are correctly mapped to your Logiwa warehouses.

Error Message: Unexpected Error
Cause: A generic, non-specific error occurred during the order download process. This can be caused by a temporary connection issue, an API timeout, or a rare edge case.
Troubleshooting:
1. Wait and Retry: Wait a few minutes and trigger the Download Orders service again. The issue may have been temporary.
2. Contact Support: If the error persists for the same order, contact the Logiwa IO Support Team. Please provide the Order Code, the time the error occurred, and the exact error message to facilitate a quicker resolution.