Start your free 30-day trial now. Connect your Magento store to Koongo in a few steps. In case a firewall protection is used, please check Koongo IP addresses to be whitelisted
Note: The HTTP basic authentication has to be turned off for Koongo API integration.
The REST API cannot connect a webshop with active HTTP basic authentication.
About Koongo
Koongo provides smooth integration to various online marketplaces and price comparison websites worldwide. Koongo solution enables you to import your Shopify products to Koongo.
You can optimize your data. And create automatic connections to marketplaces and price comparison websites of your choice.
Koongo offers order management functionality for selected online marketplaces. Koongo transfers marketplace orders back to your Shopify store. Marketplace orders can be fulfilled directly in Shopify just like ordinary orders.
1. Download Koongo Install Packages
Download both Koongo module and Order extension
2. Install Koongo Extensions
To install both Koongo extensions, you can use either Magento Connect Manager or upload over FTP
2.1. Magento Connect Manager Installation
You can use Magento Connect Manager to install both Koongo extensions
Log into your Magento Connect Manager
Upload both installation packages, as shown on the image below:
2.2. FTP/SSH Installation
You can install Koongo API extensions over FTP or SSH/SCP client.
Unpack the downloaded install packages.
Upload API Extension content to your Magento installation folder. Please ignore the file package.xml in the installation package.
Upload Order Extension content to your Magento installation folder.
3. Clear Magento Cache
Log into your Magento backend and clear your Magento cache
4. Connect Koongo
Start Koongo wizard and connect your Magento store to Koongo
Start Koongo wizard by selecting System -> Webservices -> Kaas access authorization
Insert user password you used for log in to your Magento backend
Authorize Koongo connection
5. Sign Up for Koongo Account
The Koongo wizard will re-direct you to the Koongo registration website
Sign up or log into your Koongo account
Authorize Koongo access
In case the Koongo Authorize form is not available, please check if Mage_Oauth is Enabled. Simply go to System -> Configuration -> Advanced -> Advanced and enable Mage_Oauth.
In case the store was not added properly, please check if your /api/rest returns error 404 - https://yourstore/api/rest
If your Magento store runs on an apache server, you can fix that in .htaccess by uncommenting this part of the code or adding this code if it missing there:
############################################ ## rewrite API2 calls to api.php (by now it is REST only) RewriteRule ^api/rest api.php?type=rest [QSA,L]
!!! IMPORTANT !!! this RewriteRule MUST be before the ending rule, which everything else redirects to your homepage!
RewriteRule .* index.php [L]
Also is important to turn on HTTP authorization in your .htaccess file. You must uncomment this part of the code:
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
If you have an NGINX server, .htaccess is not used. In that case, you must solve all redirections and settings in the Nginx configuration.
6. Add Store
Add a store to your Koongo account by clicking the "Add New" button.
7. Create a Product Feed
Follow Quick Start Guide, Add new feed part. Feel free to contact Koongo support at support@koongo.com.
8. Order API - General Settings
For Order API, it is possible to set various Order API parameters.
To set them up please go to System → Configuration → Koongo → Order API
8.1. General
GTIN Attribute - Select GTIN attribute for order item identification during import. You can use EAN, UPC, GTIN, etc
Default Shipping Method - default shipping method for imported orders
Secondary Shipping Method - backup shipping method for imported orders
Import Backorders - allows you to import orders if the ordered item is not available for sale - e.g. product is out of stock
Display Channel Columns In Order Grid - allows you to display channel and marketplace in order grid
Order Increment Id Format - Format of order increment id. Default Magento format or Koongo format ##{{channel_code}}-##{{marketplace_code}}-##{{channel_order_id}} are available.
Debug mode - Debug mode allows advanced logging.
8.2. Customer Account Management
Assign Order To Customer Account - If set to Yes, then imported orders are assigned to customer accounts. A new customer account is created, if the account does not exist for the given email address
Customer Group - default customer group for new customers