What it does

Mercado Libre is the largest online marketplace in Latin America. If you run a CS-Cart or Multi-Vendor store and want Mercado Libre as an additional sales channel, this add-on connects your own seller account and your own Mercado Libre application to your shop. It works with the sites of Mexico, Brazil, Argentina, Chile, Colombia, Uruguay and Peru, with the currency and category language of the site you choose.

How it works

Create your own application in the Mercado Libre developer center, enter its App ID and secret and authorize it with one login; use a Mercado Libre test user in Test mode, as there is no sandbox. Map categories and attributes, set markup and stock buffer. The sync creates items and updates stock and price. Orders arrive by notification and by polling. Failed jobs retry automatically.

Features

Your own Mercado Libre application: browser sign-in, tokens refreshed automatically and stored encrypted
Test mode for Mercado Libre test users, one-click connection test that also checks the site
Category predictor and category and attribute mapping, with a markup and a brand per category
Items with pictures by URL, SELLER_SKU, GTIN or the empty-GTIN reason, plain text description and a readable reason per refused item
Stock and price updates, stock 0 pauses the item, a price that Mercado Libre ignores is reported
Order import by notification and polling without duplicates, with shipment status follow
Mercado Envios 2 labels in PDF or ZPL, own-carrier tracking number
Seven sites with the matching currency, Spanish or Portuguese category names from Mercado Libre
Job queue with automatic retries and a log with filters and CSV export
Multi-Vendor: one marketplace account or one account per vendor

What you get

Package	kv_mercadolibre-1.0.0.zip, installed through Add-ons → Manage add-ons
Updates & support	12 months included. Download new versions from your account and install them in Add-ons → Manage add-ons or the Upgrade Center.
License	1 production installation. Staging, dev and localhost are free and unlimited. The add-on keeps working after the update period ends. How licensing works

Compatibility

We list only the builds we install and test on. “Tested” means the full test plan was run on that build; “Supported” means the build is inside the supported range and uses the same hooks.

CS-Cart version and edition compatibility
CS-Cart version	CS-Cart	CS-Cart Ultimate	Multi-Vendor	Multi-Vendor Ultimate
4.22 and later	Testing next	Testing next	Testing next	Testing next
4.21.2	Supported	Supported	Supported	Supported
4.20.x	Supported	Supported	Supported	Supported
4.19.x	Supported	Supported	Supported	Supported
4.18.x	Supported	Supported	Supported	Supported
4.17.2	Supported	Supported	Tested	Supported
Before 4.17.2	Not supported	Not supported	Not supported	Not supported

Last tested build: Multi-Vendor 4.17.2, Nov 6, 2026Tested on: Multi-Vendor 4.17.2

Requirements

Platform	CS-Cart and Multi-Vendor 4.17.2 or later (4.21.x supported)
Requirement	Administrator access to the store's admin panel
Requirement	A Mercado Libre seller account of one of the seven sites (Mexico MLM, Brazil MLB, Argentina MLA, Chile MLC, Colombia MCO, Uruguay MLU, Peru MPE) and your own application (App ID and Secret Key) created in the Mercado Libre developer center (developers.mercadolibre.com, "My applications"). In Argentina, Mexico, Brazil and Chile Mercado Libre allows creating an application only after the account holder's data is validated
Requirement	Products with a barcode (it becomes the SELLER_SKU of the item; a valid GTIN/EAN is also sent as GTIN) and images reachable from the internet (Mercado Libre downloads them)
Requirement	A public https address for your store: the redirect address of the application and the notification address must be https
Requirement	A cron job on your server (see Configuration)
Core changes	None. Hooks and template overrides only

1.0.0

Nov 6, 2026

Latest

Added 9

Initial release on the Marketplace Hub, for Mercado Libre Mexico, Brazil, Argentina, Chile, Colombia, Uruguay and Peru.
Your own Mercado Libre application: App ID and Secret Key stored encrypted, authorization code flow against the site's host with a single-use state, access token refreshed automatically with the single-use refresh token (a parallel refresh is detected), test users for Test mode (Mercado Libre has no sandbox), connection test that also checks the seller's site.
Category tree crawl, category predictor, category and attribute mapping (closed lists by value id), price rules, stock buffer.
Items created from mapped products: pictures by URL, SELLER_SKU, GTIN when the barcode is a valid one and the empty-GTIN reason when the category accepts it, plain text description as a second call, listing type, shipping mode, seller warranty, readable reason per refused item.
Stock and price updates with one call per item; stock 0 pauses the item; a price Mercado Libre ignores (automation or campaign) is reported on the product.
Order import by polling and by notification (topics orders_v2, items, shipments; key-protected address, answered at once and processed from the queue); shipment status follow, cancelled orders.
Mercado Envios 2 labels (PDF and ZPL) from the Orders page; own carrier tracking number and status shipped for custom shipping.
Job queue with retries and back-off, cron (command line and secret address), log viewer with CSV export.
Multi-Vendor: marketplace owner mode or one Mercado Libre account per vendor.

Tested on Multi-Vendor 4.17.2. First release.

Do I need my own Mercado Libre application?

Yes. You create an application in the Mercado Libre developer center and enter its App ID and Secret Key on the Connection page. The add-on never uses a shared key, and Mercado Libre shows your application's name when the seller grants access.

Is there a sandbox?

No. Mercado Libre offers test users on the production API instead. Create a test seller and a test buyer for your site (see Installation), authorize the add-on in Test mode with the test seller and trade between the two.

Which sites are supported?

Mexico (MLM), Brazil (MLB), Argentina (MLA), Chile (MLC), Colombia (MCO), Uruguay (MLU) and Peru (MPE). One site per account; the currency and category language follow it. Category names come from Mercado Libre in Spanish or Portuguese.

Why does a product need a barcode?

The barcode is sent as the item's SELLER_SKU, which is how stock, price and orders are matched back to your products. When it is a valid GTIN (EAN, UPC, ISBN) it is also sent as GTIN. Categories that require a GTIN refuse products without one; categories that only prefer one get the reason "No registrado" instead.

What does the category predictor do?

It asks Mercado Libre which category fits a text (for example a product title) and shows the answer first in the category search. Mercado Libre may moderate items that are listed in a category other than the predicted one.

Does it send invoices or fiscal documents?

No. Brazilian fiscal notes (NF-e) and other invoices are not sent in this version.

Does it cancel orders or handle returns at Mercado Libre?

No. Seller cancellations, claims and returns are handled in Mercado Libre. A cancelled order still becomes a cancelled CS-Cart order.

Does it need the notification address?

It is recommended: orders then arrive within the next queue run instead of the next sync. Without it the add-on polls the order list, so nothing is lost.

Can I list variations (size, colour)?

Not in this version. Every CS-Cart product becomes one simple item.

Is it endorsed by Mercado Libre?

No. It uses the public Mercado Libre API under your own account and application.