Mercado Libre Connector for OpenCart 2.3, 3.x and 4.x — listings, prices, stock, orders

Mercado Libre Connector connects an OpenCart shop to Mercado Libre: Mercado Livre in Brazil and Mercado Libre in Mexico, Argentina and Colombia. The module links your existing listings to products and keeps their price and stock in step. Pro brings paid orders into OpenCart, gives Mercado Envíos labels, reports own-carrier shipments and creates new listings from products.

What the buyer sees

A buyer on Mercado Libre sees your shop price in the local currency: at the shop rate or your own, with tax and markup, rounded for the currency (Colombian pesos without cents). When a product runs out or is switched off, its listing is paused and goes back on sale once the product is available again.

What the admin gets

Extensions → Modules → Mercado Libre Connector: country, redirect URI and notifications URL for the application, App ID, secret key and the “Connect to Mercado Libre” button. The import reads the listings of the account and links them to products by listing id, SELLER_SKU or GTIN; whatever is not linked shows in a list with the reason. Then exchange rate, tax, markup in percent and a fixed amount, safety stock.

The product form gets a Mercado Libre tab: sell or not, listing id or link, SKU, GTIN, the price and stock that go to Mercado Libre, the state and the “Send now” and “Read the listing” buttons.

In Pro, paid orders arrive in OpenCart from Mercado Libre notifications and a check every 5 minutes: name, delivery address, phone and the buyer’s shipping in the total. A cancellation on Mercado Libre sets the order to “Canceled” and returns the stock. The order page gets a panel: read the order again, Mercado Envíos label as PDF, “shipped” and “delivered” with tracking for own carriers. New listings are created from a product: category, attributes, up to 10 pictures, description.

How it works, step by step

1. In the Mercado Libre developer centre of your country you create an application with the addresses from the module and paste its App ID and secret key.
2. “Connect to Mercado Libre” opens the Mercado Libre consent page; after you allow access the tokens are stored encrypted and renew by themselves.
3. The import links existing listings to products by listing id, SELLER_SKU or GTIN.
4. Price and stock changes join a queue, cron sends only what changed every minute, and once an hour the module checks everything.
5. In Pro, orders arrive in OpenCart, and “shipped” and “delivered” for own carriers go back to Mercado Libre.

Under the hood

• Keys and tokens are stored encrypted (AES-256 with HMAC); after a 401 the token is renewed and the request repeated.
• Only changes are sent; a disabled or deleted product pauses its listing.
• Listings with variations are shown with an explanation but not changed: they are edited on Mercado Libre.
• Orders are never doubled; Mercado Envíos Full orders are not created by default, because their stock sits in the Mercado Libre warehouse.
• A cart of several orders (pack): shipping is counted once.
• API log: 100 entries over 30 days.

How to install

1. Extensions → Installer: upload the archive for your version without renaming the file.
2. OpenCart 3.x and 2.3: Extensions → Modifications → Refresh.
3. Extensions → Modules → Mercado Libre Connector → install → edit.
4. Choose the country, create the application with the addresses from the module, paste the App ID and secret key, press “Connect to Mercado Libre”.
5. On the Products tab run “Import and link” and check the linked products.
6. For Pro: paste the key or start the 7-day trial on the Licence tab.