With the Keskintech Marketplaces plugin, you can easily integrate your WordPress WooCommerce store with multiple marketplaces from a single dashboard. This documentation covers all integration processes step by step — including product export, category and brand matching, stock and price updates, and two-way synchronization.
Plugin Installation
To install the Keskintech Marketplaces plugin, log in to your WordPress admin panel and go to Plugins → Add New.
Search for “Keskintech Marketplaces” in the search field in the top right. When the plugin appears in the list, click “Install Now” and wait for the installation to complete.
Once the installation is finished, click “Activate” to enable the plugin. Keskintech Marketplaces is now ready to use.
Plugin Settings
After installation, the first step is to configure the settings. Go to Marketplaces → Settings in your WordPress admin panel.
Activation Code
You need a valid license to perform product operations via API. If you only plan to export data manually in CSV or XLSX format, you can skip this step.
For the activation code to be valid:
- You must have at least one license,
- You must have assigned a site to your license.
You can add your site from the My Sites menu in your Profile Panel (Control Panel). Then, from the My Licenses menu, assign the added site to your existing license.
Important: Assigning a site to a license cannot be undone.
To get your activation code, go to Profile → API Information tab. Copy your activation code and paste it into the relevant field.
Brand Settings
If you plan to send products from your WooCommerce store to marketplaces, you must enable brand settings.
You can define the brand source in two ways:
- Fixed Brand: If all products in your store share the same brand, choose this option and enter the brand name in the relevant field.
- Term (Taxonomy): If you manage your brands via WooCommerce or other plugins, use this option. In this case, the taxonomy information of your most recently published product is displayed below. Enter the taxonomy that represents the brand in the Brand Taxonomy field.
Default “In Stock” Value
This setting is used for products that do not have stock management enabled. Marketplaces require a stock quantity, not just a stock status.
If stock management is disabled for a product:
- Products marked as In Stock will be sent with the default stock quantity you set here.
- Products marked as Out of Stock will automatically be sent with a quantity of 0.
Default Desi Value
When sending products to marketplaces, volumetric weight (desi) information is required.
If your products have weight and dimension information defined, the system calculates and sends these values automatically. If this information is missing, the default desi value you set here will be used as the reference value during shipping.
Adding and Editing a Marketplace
Go to Marketplaces in your WordPress admin panel to list existing marketplaces. From this page, you can easily add, edit, or delete marketplaces.
To add a new marketplace, click the “Add New” button in the top left of the page.
General Fields
- Name: Enter a descriptive name to identify the marketplace you’re creating.
- Marketplace Type: Select which integration type this marketplace will use. Only marketplaces registered to your license are listed, and you can select based on your license.
API Information
You must enter the API credentials obtained from the relevant marketplace completely and accurately. Correct API information is critical for the integration to work properly.
Marketplace Settings
In this section, you can configure the basic settings for the marketplace:
- Currency
- Shipping company
- Default tax rate
Default Tax Rate:
For marketplaces that require a tax rate per product, you can set a default tax value to be applied to all products.
Order Fetching Settings
- Auto-fetch orders: Enable this option to automatically import orders from the marketplace into your site.
- Repeat Interval: Determines how frequently orders are checked and fetched.
- Deduct from Stock: Automatically decreases the stock of products in your store when orders arrive from the marketplace.
- Check Cancellations: Updates orders cancelled on the marketplace to “cancelled” status on your site as well.
- Check Returns: Orders that are returned and approved on the marketplace are updated to “refunded” on your site. Rejected or disputed returns are not included.
Pricing
The Pricing menu allows you to set marketplace-specific prices or create automatic pricing rules.
The system determines the product prices to send to marketplaces based on the following priority order:
- If a custom price is defined for the product, that price is used.
- If a valid pricing rule exists for the marketplace, the calculated price is used.
- If neither exists, the WooCommerce product price is used.
You can view which source determines a product’s price by hovering over the status indicator in the top left of the price field.
Go to Marketplaces → Pricing to access pricing settings. You can set prices using two methods:
Per-Product Pricing
With this method, you can manually enter marketplace-specific prices for each product. Bulk editing is supported so you can edit multiple products at once. Variable products can also have separate prices for each variation.
To set a price: select the products you want to edit and click “Edit Product Prices”. In the screen that opens, the Product Constant and marketplace price columns are listed.
If you selected multiple products, fields will auto-fill if those products share a common price for the marketplace; otherwise the fields appear empty.
Warning: Only the fields you modify will be updated. Prices you leave unchanged are preserved.
Product Constant
The product constant is a custom reference value you set for a product. You can use it like a cost price and then define operations based on this value in the pricing rules section to build your pricing strategy.
To remove a custom price for a product, select the products, clear the fields in the price editing screen, and save.
Pricing Rules
In this section, you can create separate pricing rules for each marketplace. The defined rules automatically calculate product prices. You can define addition, subtraction, multiplication, and division operations in any order to fully automate pricing.
Base Value
Determines the starting point for price calculation: Product site price or Product constant. The product constant value can be set from the Per-Product Pricing section.
Price Rules
In this area you can add new rules, edit existing rules, or delete unnecessary rules. The defined operations are applied in the order you specify, and the final price is the result of these operations.
Rounding
You can adjust the calculated price according to your chosen rounding type and value. For example: rounding type Decimal, value 90 — if the result is 324.452, the rounded price will be 324.90. This feature helps you keep marketplace prices strategic and consistent.
Tax Settings
If you want to send products from your WooCommerce store to marketplaces via API, some marketplaces require you to specify a tax rate for products. If you use a single tax rate for all products, it is faster and more practical to use the default tax rate option in the marketplace settings instead of configuring this section.
For detailed tax management, go to the Marketplaces → Settings → Tax tab. Here you can create, edit, or delete tax classes. Click “Add Tax Class” in the top left to create a new one.
Defining a Tax Class
- Name: Enter a descriptive name that identifies the tax class.
- In the section below, you can set separate tax rates for each of your defined marketplaces.
Setting Tax Rates for Products
To configure product-level tax settings:
- Go to the General tab on the product edit page and select the tax class for the product.
- For variable products, variations inherit the parent product’s tax class by default.
If you want to apply a different tax rate to a specific variation:
- Go to the Variations tab,
- Expand the relevant variation,
- Select the desired tax class from the Marketplace Tax field at the top.
This structure enables flexible tax management at the product and variation level.
Sending Products
You can quickly and easily send products from your WooCommerce store to marketplaces via API. Before sending, you need to complete several important steps to ensure the process runs smoothly.
Before Sending Products
Product Information
Product information must be complete before sending. Make sure the following fields are correctly filled in: product title, description, category, attributes, stock information, and product images.
Category: The most important point when selecting a product category is that it must be a leaf category (the lowest level, with no sub-categories beneath it). This is a standard requirement for marketplaces. Always assign your products to leaf categories.
Stock Code (SKU): All marketplace operations are based on the SKU. Simple products must have an SKU defined directly. Variable products must have an SKU for each variation. For variable products, the parent product’s SKU is treated as the model code.
Product Images:
Simple Products: The featured image is sent as the primary image; gallery images are sent as additional images.
Variable Products: The main image is the one in the top left of the variation row. Other images are taken from the marketplace images field at the bottom of the variation row.
Attributes: Adding detailed attributes to products improves visibility in search results and provides more information to customers. Some marketplaces require certain attributes for specific categories — submissions without required attributes will fail.
Matching
Before sending products, you must match your categories, brands, attributes, and attribute terms with the marketplace. This ensures that your data is correctly mapped to the corresponding fields in the marketplace. Go to Marketplaces → Matching.
Tip: Once you match a category and its related attributes/terms, you won’t need to match them again for other products in the same structure. Matching works at the category level, not the product level.
Category Matching: The Categories tab lists leaf categories from your site. Click “Match Category” next to the category you want to match, then click “Match” in the marketplace column. In the popup, select the marketplace equivalent and save.
Brand Matching: Brands detected based on your brand settings are listed. Click “Match Brand” and then “Match” in the marketplace column. For some marketplaces you can search by name; for others you enter the name as plain text.
Attribute and Term Matching: The Terms tab lists all attributes defined on your site. Matching is a two-step process: first match the attribute, then match the terms under it. You can define multiple rules per attribute for different categories. The first rule created is the default and applies to all categories.
Sending Products
Go to Marketplaces → Send Products. Select the marketplace you want to send to. If you have a valid license, the “Send Online” button appears.
Selection Type: Send all products in a specific category, or select individual products from the list. For variable products, you can choose all variations or only specific ones. Products that cannot be sent display a warning icon — hover over it to see the issue details.
Send Process: Make your product selections, proceed to the Confirm/Send step, and click “Start Process”. The system prepares the products and identifies any errors. If a product cannot be sent, error details are listed — click the product to see the reason. After fixing the issues, you can restart the process.
Updating Products
To update the price, stock, and other information of products you’ve already sent to marketplaces, go to Marketplaces → Update Products.
Select the marketplace you want to update. If you have a valid license, the “Send Online” button appears. On the page that opens, select which fields to update (e.g. price, stock) and choose products by category or individually. Variable products are also supported.
Note: Marketplace update rules vary. Some allow updating multiple fields in a single request; others only support specific fields per request. The system will alert you in such cases.
After completing your selections, click “Start Process”. When the process completes, an option to automate this update appears — give the task a name, set a repeat interval, and save.
Scheduled Tasks
Go to Marketplaces → Scheduled Tasks to manage your tasks. This page lists all scheduled tasks including product updates and order fetching.
Click “Edit” next to a task to modify it. Use the toggle at the top to pause or re-activate the task. The “Start” button runs the task immediately; the “Delete” button removes it entirely.
Logs
Go to Marketplaces → Logs → Operations to view all operations performed through the plugin — including all requests sent, operation statuses, and marketplace responses.
Requests generally complete within 1 to 5 minutes depending on server and marketplace load. If an operation shows “Awaiting response”, check again shortly — the status updates automatically when complete.
To review an operation’s details, click the record and go to the “Response” tab. Click on failed records to view error details and make the necessary corrections.