In this article, we will get an overview of the main Insert order errors you may encounter when using the Koongo Order Synchronisation service. You will learn how to easily identify and address these types of errors and warnings to get your orders transferred smoothly.

The order can not be inserted into the store because one of the items is either out of stock or without the minimum quantity required. The problem might occur when the product synchronization is not properly set up or the same product has been ordered on multiple places (channels, online store) at the same time.

If you want to transfer the order into your online store even if the products are out of stock, you will need to increase the stock of these products in your online store and ask Koongo support team to reinsert the order.

It is necessary to review the product syncing to ensure smooth product data updates.

The order can not be inserted into the store because the item included is not found in your store.
The problem might occur if the selling channel/marketplace account contains products that were added manually or from another data source (other than the current online store). The issue might happen also in case a product was deleted at an online store and not properly removed at the selling channel due to wrong product synchronization.

If you want to transfer the order with unknown items into your online store, you can use the Force Order Insert button (available for Shopify only). For some platforms (e.g. Magento, Prestashop, and others) it is impossible to insert orders with items/products, which are not defined in the store. The limitation is given by the architecture of particular platforms and Koongo can not get over it.

It is necessary to review the product syncing to ensure smooth product data updates.

The order can not be inserted into the store because it contains a shipping method that is not available in the related WooCommerce store.

It is necessary to select a valid shipping method in related store settings at your Koongo account.

If you have properly configured the shipping method for your store at the Koongo account (described in the section How you fix the issue? above), then the issue should not happen again.

The order can not be inserted into the store because the country is not allowed in your Prestashop backend.

Please, try to access your Prestashop backend and check International > Locations > Countries section to enable all needed countries.

Most of the selling channels will allow you to start with cross-border sales and you will get orders from many different countries. You just need to be sure that all countries opened in those selling channels are opened (allowed) as well in your Prestashop backend. Once the country is enabled, please get in touch with the Koongo support team to request the order re-insertion.

The order can not be inserted into the store because it's not possible to create the order address.

The issue is related to your 'tax identification number' settings in your Prestashop backend. Please check your 'tax identification number' settings and make sure it's turned off.

Once the Prestashop 'tax identification number' setting is turned off, please ask the Koongo support team to reinsert the order.

Once you turn off your 'tax identification number' settings in your Prestashop backend, all new orders will be processed correctly.

The order can not be inserted into the store because the item price and even the order total price amounts are missing.

Try to identify the specific item purchased and check if the price value is available within Koongo > Products > View Details. In case the items do have a valid price value imported into Koongo, do not hesitate to contact us, we will adjust the item price and update the totals forcing a new order re-sync.

Try to ensure all the items do have a valid price amount imported into Koongo. Furthermore, try to check the selling channel > Feed Preview to confirm a valid price value is exported. This error is usually caused by missing details in the order of data received via API.

The order can not be inserted into the store because the billing or the shipping address is missing.

Please, navigate to Koongo > Orders and check the specific order id with issues. Try to click the ℹ info icon next to every order and double-check the > Address tab to confirm either the Billing or Shipping addresses are missing. In that case, try to access your Seller Central and check the order with issues to get a valid Billing and Shipping address.

This type of error might need to be fixed by the Koongo support team. Please, do not hesitate to contact us if you need us to force the order re-insertion. We will need the order id with issues plus valid Billing and Shipping addresses to be used.

The order can not be inserted into the store because the customer's email address contains invalid values. e.g. email has suffix ".con" instead of ".com".

Please, navigate to Koongo > Orders and check up on the specific order with issues. Try to click the ℹ info icon next to every order and double-check the > Address tab to confirm the customer details and specifically the email inserted.

This type of error might need to be fixed by the Koongo support team. Please, do not hesitate to contact us if you need us to force the order re-insertion. We will need the order id with issues and a valid email address to be used.