Skip to main content

Integrations - Import Errors

Tom Higgs avatar
Written by Tom Higgs
Updated this week

Overview

The Import Errors page tracks and displays synchronisation failures between Mintsoft and your connected e-commerce platforms, helping you identify and resolve data transfer issues that could affect order processing and inventory accuracy. This page monitors all integration points across your account. Common causes and fixes can be found in our troubleshooting guide.

Accessing the Import Errors Page

To access the Import Errors page, please follow these steps:

  1. Click Connect then Import Errors.

  2. All orders with import errors will be displayed.


What Import Errors tracks

The Import Errors page monitors synchronisation across your connected systems:

  • Order import failures from e-commerce integrations (Shopify, Amazon, eBay, Magento, BigCommerce, and others).

  • Product synchronisation issues between your Mintsoft account and connected systems.

  • Stock level sync failures when inventory updates don't transfer correctly.

  • Despatch and fulfilment update errors when shipping confirmations fail to send to external systems.


Understanding error types

The Import Errors page displays several common error types:

UnableToFindProduct

The system cannot locate a product SKU referenced in the import. This typically occurs when an order contains a product code that doesn't exist in your Mintsoft product catalogue.

UnableToExportOrder

The order failed to send to an external system (like your accounting software or ERP). This can happen due to connectivity issues, missing required fields, or system configuration problems.

UnableToDespatch

Despatch confirmation updates failed to send back to the source channel. This prevents your sales channel from receiving tracking information and shipment status updates.

UnableToSyncStock

Stock level synchronisation failed between Mintsoft and connected channels. This can result in overselling or incorrect inventory displays on your sales channels.

AddressIncomplete

The shipping address is missing required fields such as street address, city, postal code, or country. Orders with incomplete addresses cannot be processed until the information is completed.


Information displayed for each error

Each error entry on the Import Errors page shows:

  • Clear error message explaining what went wrong.

  • The affected order number or product SKU.

  • Source system identifier (e.g., Shopify, Amazon, AccessDimensions).

  • Timestamp showing when the error occurred.

  • Additional context about the specific data that caused the issue.


Error notifications

The system generates feed notifications to alert you about new import errors:

  • You'll receive notifications for errors that occurred within the last hour.

  • Errors remain flagged as incomplete until they are resolved.


How import errors are resolved

Automatic retry for deleted orders

For orders imported through e-commerce integrations that were deleted before despatch, Mintsoft will automatically attempt to re-import them during the next scheduled synchronisation. This prevents data loss from accidental deletions.

Manual orders

Important: Mintsoft does not retain records of manually added orders that have been deleted. Recovery of manually deleted orders is not possible, so exercise caution when deleting orders that were not imported from a connected channel.

Resolving import errors

Follow these steps to resolve import errors:

1. Identify the root cause

Review the error message to understand what prevented the import. Common causes include:

  • Missing or incorrect product SKUs.

  • Incomplete customer information.

  • Address validation failures.

  • Connectivity issues with external systems.

  • Data format mismatches.

2. Correct the underlying issue

Act based on the error type:

For missing products:

  • Add the product to your catalogue or update SKU mappings.

For address errors:

  • Contact the customer to obtain complete shipping information.

For sync failures:

  • Check your integration settings and credentials.

For export errors:

  • Verify external system availability and configuration.

3. Allow re-synchronisation

Once you've resolved the issue, the system will attempt to process the item again during the next sync cycle.


Troubleshooting specific scenarios

Dispatched orders without tracking

If you encounter errors related to dispatched orders that lack tracking information, verify:

  • Whether the order status was set to backorder before cancellation (this can cause processing confusion).

  • If the shipment was properly generated within Mintsoft.

  • Cross-reference with your courier portal to confirm whether tracking information exists but wasn't captured.

Product synchronisation errors

When products fail to synchronise, ensure:

  • Product information is complete in both systems.

  • SKU mappings are correctly configured.

  • Required custom fields are populated.

  • Product categories and attributes meet channel requirements.

Monitoring and maintenance

The Import Errors page is your diagnostic tool for maintaining smooth data flow between Mintsoft and your connected business systems. Regular monitoring helps prevent order delays and inventory discrepancies.

Did this answer your question?