Troubleshooting: Orders not importing


  • This guide aims to help you find out why your orders are not displaying in Starshipit. We will cover the following areas:
  • The most common reasons for not being able to find your order(s) are:
    • The order was already processed/Archieved - use search all, to find missing orders
    • The order was not imported - mainly because the status didnt match, or because a rule prevented it from being imported.

All orders not importing

If all orders from your platform have stopped importing, the connection between Starshipit and your platform has likely been broken. This means we are not able to connect to the platform to retrieve orders. Follow the below to troubleshoot:-

  1. To auto-import your orders, go to Settings > Integrations > Automatically Import orders.
  2. Go to Settings > Integrations > [Integration Name] > Test. If you get an error here, we recommend starting over with the integration guide and re-integrate the platform. It may be that the user created to integrate the account has been removed or had its password changed. 
  3. If applicable: Ensure you have whitelisted Starshipit's IPs from your servers.
    This is not required for Shopify.
  4. If the test succeeded, try to run a manual import for 30 days.

Some orders are not importing 

If specific orders are not imported, it is likely related to the order, or the configuration of your account. 

  1. By default, Starshipit's auto import task (which runs every 20 minutes) will look at the last 2 days' worth of orders. If your order is older than that, navigate to Logs > Verbose Logs and activate logging for 15 minutes or 1 hour. Then run a manual import to bring the orders in. This is common for back-ordered/pre-ordered shipments where it takes some time before you are ready to process the order. Make sure to check the Verbose Logs and filter by order number to verify the issue. For Shopify, it will import any order updated since the last auto import started.
  2. If you're having trouble with Shopify orders, navigate to Settings > Integrations > Shopify Settings > Troubleshooting import tab and follow the steps in the page.
  3. Check your account to ensure nothing could be preventing them from coming in:
    • Go to Settings > Rules and ensure you do not have any rules where the action is Import Orders or Do Not Ship and the condition meets the order you are trying to import. A good way to see if this is causing the issue is to remove the rule and try import and see if that helps. 
    • With Shopify and TradeGecko, you can configure the integration to block orders with specific tags. If the order you are trying to import has a tag, go to Settings > [Integration Name] > and check to see if the tag is in the list of exclusions
    • With each platform, in Settings > [Integration Name] > Status to Import, you can specify what status orders should be in to be allowed to import into Starshipit. Make sure that the status you have configured here matches the status of the order in your platform.  
    • Ensure that the order number you have doesn't already exist in Starshipit
  4. Check the order in your eCommerce platform for the following things:
    • Does the order have a shipping address?
    • Do the items in the order require shipping (Shopify)?
    • Is the order unfulfilled/open? 
  5. Advanced: With an order number that isn't importing, you can go to Settings > Integrations > [Integration Name] > Tools/Advanced and find a tool for Check Order Details. If you enter the order number here, you can pull up the API information for that order and see if the status matches what you have set in Starshipit for import.

Imported orders are missing data

If you notice that some of the orders you imported are missing items or tags, you can resolve this issue by removing and then re-importing them. This process will help to ensure that all the necessary information and tags are properly included with each order. By removing and re-importing the orders, you have the opportunity to check the data and resolve any missing item or tag issues that may have occurred during the initial import.

If none of these suggestions solves your problem, please contact our support team here.

Want to deliver great shipping experiences?

Start a 30-day free trial or book a demo with one of our shipping experts

Was this article helpful?
1 out of 4 found this helpful



Please sign in to leave a comment.