Get Started
How to set up a Merkandi product feed - AdTribes
  1. Home
  2. Knowledge Base
  3. Filters & Rules
  4. How to set up a Merkandi product feed

How to set up a Merkandi product feed

Merkandi is a B2B wholesale and surplus goods marketplace where trade buyers search for overstock, clearance, and bulk lots. If you’re selling wholesale quantities through WooCommerce, connecting your store to Merkandi puts your products in front of buyers actively looking for that kind of stock.

Product Feed Pro includes a dedicated Merkandi XML template. It handles the required XML structure automatically, wrapping product names and descriptions in CDATA and grouping all your product images into the correct nested format.

This guide walks you through creating the feed, mapping your product data to Merkandi’s fields, and submitting the feed URL to your Merkandi seller account.

Prerequisites

Before you set up your Merkandi feed, make sure you have:

RequirementDetails
Plugin versionProduct Feed Pro 13.5.5 or later (or Product Feed Elite, which bundles Product Feed Pro)
Merkandi seller accountAn active seller account at merkandi.com to submit and manage your feed
Merkandi reference IDsInteger IDs for your product category, country, and grade. Download the CSV reference lists from merkandi.com under the “Files with IDs lists” section.

How to create a Merkandi product feed

Step 1: Open the Add New Feed form

In your WordPress admin sidebar, go to Product Feed → Add New Feed.

Step 2: Name your feed and select the Merkandi channel

On the General tab:

  1. Enter a name for your feed in the Project name field, for example Merkandi Feed.
  2. Open the Channel dropdown and select Merkandi.
  3. The feed format is set automatically to XML, the only format Merkandi accepts.
  4. Click Save & Continue to move to the Field Mapping tab.
General tab with Merkandi selected in the channel dropdown and XML shown as the feed format

Step 3: Map required Merkandi attributes

On the Field Mapping tab, the left column lists Merkandi’s feed attributes, and the right Value column is where you connect each attribute to a WooCommerce source or a static value.

Merkandi rejects feeds with any missing required field: every required attribute must return a value for every product.

Required fields

Merkandi attributeWhat to map
SKUSelect SKU from the Value dropdown.
NameSelect Product name. Merkandi’s seller specification states a 70-character maximum; the plugin does not truncate this automatically.
DescriptionSelect Product description. Merkandi’s seller specification states a minimum of 100 characters and a maximum of 4,000; the plugin does not enforce these limits.
PhotosSelect All images (comma separated). The plugin includes up to seven images per product automatically.
Category IDEnter a static integer from Merkandi’s category reference list (for example, 42).
Country IDEnter a static integer from Merkandi’s country reference list (for example, 45 for Germany).
Grade (ware ID)Enter a static integer from Merkandi’s product grade reference list (for example, 1 for new goods).
LocaleEnter the ISO 639-1 language code for your product data (for example, en, de, or pl).
Minimum order typeEnter qty if the minimum order is expressed as a quantity, or price if it is expressed as a monetary value.
Minimum orderEnter the minimum quantity (or value) a buyer must order (for example, 10).

Category ID, Country ID, and Grade (ware ID) are Merkandi-specific reference IDs with no WooCommerce equivalent. Enter them as static integers. Download the reference CSV files from your Merkandi seller account to find the correct integer for each. For detailed instructions on entering static values, see How To Add Fixed Value To Your Product Feed?

Field Mapping tab showing required Merkandi attributes mapped to WooCommerce fields

Step 4: Map optional attributes

These fields aren’t required, but including them gives buyers more detail and can improve your listing performance.

Merkandi attributeWhat to map
CurrencyEnter a static currency code in ISO 4217 format (for example, EUR, GBP, or USD). If omitted, Merkandi uses your account’s default currency.
PriceSelect Price from the Value dropdown. If omitted, Merkandi marks the listing as “price on request”.
Retail priceEnter your recommended retail price as a static value, or map to a custom attribute.
EANMap to your product’s EAN or barcode attribute.
QuantityMap to your stock quantity attribute, or enter a static value.
Shipping daysEnter the number of days for delivery (for example, 5).
Promotional priceMap to your sale price attribute if you run promotions.
Minimum priceEnter the lowest price you’ll accept, used alongside the negotiation feature.
Maximum discountEnter the maximum percentage discount you’re willing to offer (for example, 15).
For negotiationEnter 1 to mark the listing as open for price negotiation, or 0 to keep the price fixed.
TARIC codeEnter the customs tariff code for your product category if required for your market.
Video URLMap to a custom attribute that stores your product video URL.
Measure unitEnter a static integer from Merkandi’s measure unit reference list.
Price measure unitEnter a static integer from Merkandi’s price unit reference list.
Auto refreshEnter 1 to enable automatic offer refresh (requires the Auto refresh service on your Merkandi account), or 0 to disable it.
Special products zoneEnter 1 to restrict your listing to Merkandi’s exclusive zone (hidden from public search), or 0 to keep it public.
Merkandi IDLeave blank unless Merkandi has already assigned your offer an internal ID.

Step 5: Apply filters and rules (optional)

Use the Filters tab to exclude products you don’t want in the Merkandi feed, such as products that are out of stock or below a minimum price. Use the Rules tab to transform values before they appear in the feed, such as truncating long product names to meet Merkandi’s 70-character limit.

For detailed instructions, see How To Create Filters For Your Product Feed? and How to Create Product Feed Rules.

Step 6: Generate the feed

Click Save & Continue to progress through any remaining tabs. On the Conversion & Google Analytics tab, click Generate Product Feed to start feed generation. Product Feed Pro processes your WooCommerce catalog and produces an XML file.

Once the feed finishes processing, go to Product Feed in your WordPress admin. Copy the Feed URL shown next to your new feed. You’ll need this URL to submit to Merkandi.

Submit your feed to Merkandi

The Merkandi seller portal interface can change over time. The steps below reflect the standard XML import flow; check Merkandi’s own seller help documentation if the import screen looks different.

  1. Log in to your Merkandi seller account at merkandi.com.
  2. Go to the XML import section of your seller portal (User Control Panel).
  3. Paste your feed URL into the import URL field.
  4. Choose whether to import once or repeatedly (daily, weekly, or monthly).
  5. Save the import configuration.

Merkandi fetches your feed on its own schedule and updates your listings automatically. When the cyclic import option is selected, the feed URL must remain permanently accessible.

Troubleshooting

My feed was rejected by Merkandi
Check that all required fields are mapped and return a value for every product. Merkandi rejects feeds with any empty required field. Also, confirm that your Category ID, Country ID, and Grade (ware ID) are valid integers from Merkandi’s reference lists. An incorrect ID causes a validation error even when the field isn’t blank.
My products aren’t showing in the feed
If you’ve added filters on the Filters tab, check that your conditions aren’t excluding products unintentionally. Also, confirm that your products have an SKU set in WooCommerce. The SKU field is required, and products without one won’t have a valid feed entry.
Some images aren’t appearing in the feed
The plugin includes up to seven product images per listing. If a product has more than seven images, only the first seven appear in the feed. Also, confirm that your image files have publicly accessible URLs. Merkandi can’t fetch images from password-protected or private URLs.
The Category ID, Country ID, or Grade field is empty
These fields don’t have a WooCommerce equivalent, so the plugin can’t suggest a default value. You need to enter each one manually as a static integer. Download the reference CSV files from your Merkandi seller account and enter the matching number in the Value column.

FAQ

Do I need Product Feed Elite to use the Merkandi channel?
No. The Merkandi template is included in Product Feed Pro at no cost. You don’t need Product Feed Elite to create a Merkandi feed.
Does the feed include variable products?
Yes. Each product variation appears as a separate <product> entry in the XML. For detailed instructions, see How To Add Variable Products To Your Product Feeds?
Can I use tiered pricing in my Merkandi feed?
Yes, if you have a wholesale pricing plugin that supports the adt_merkandi_pricing_tiers filter. When tiered pricing is active, the feed outputs a <pricing> block with quantity-from, quantity-to, and a price for each tier; the flat Price field is omitted automatically. Contact your pricing plugin’s support team for details on enabling this integration.
Can I filter which products appear in the Merkandi feed?
Yes. Use the Filters tab to control which products are included, for example, by category, stock status, or any product attribute. Use the Rules tab to transform field values before they appear in the feed, such as truncating long product names. For detailed instructions, see How To Create Filters For Your Product Feed? and How to Create Product Feed Rules.
How often does Merkandi fetch my feed?
The fetch schedule is controlled by Merkandi, not the plugin. When you set up the XML import in your Merkandi seller account, you choose the frequency: once, daily, weekly, or monthly.

Need more help?

If you’re on Product Feed Elite, you can open a support ticket, and the team will help you get your Merkandi feed working.

If you’re on Product Feed Pro, post your question in the WordPress.org support forum.

Was this article helpful?

Related Articles

Complete Your Purchase
AdTribes WooCommerce Product Feed

The best WooCommerce product feed plugin

  • AdTribes Pty Ltd
    ABN: 40 675 636 816
Product
Resources & Info
Partner Sites
Rymera