Mercado Libre Connector for WooCommerce — listings, prices, stock and Mercado Libre orders

Mercado Libre Connector for WooCommerce lists the products of your shop on Mercado Libre and keeps their prices and stock up to date. It works with Mercado Livre in Brazil and Mercado Libre in Mexico, Argentina and Colombia through your own application in the Mercado Libre developer centre. Pro brings paid Mercado Libre orders into WooCommerce with the delivery address, tracking number and shipment status.

What the buyer sees

A buyer on Mercado Libre sees your product with the name, pictures, description and attributes from the shop and a price in the local currency with your markup. A variable product becomes a family of listings (User Products model) or one listing with variations (previous model), depending on the model of your account. When a product runs out, its listing is paused and goes back on sale once stock returns.

What the admin gets

WooCommerce → Mercado Libre: country, redirect URI for the application, APP ID, secret key and the “Connect to Mercado Libre” button. The access token renews by itself; if the access is revoked, the plugin says so on every admin screen. Then a markup in percent and a fixed amount, an exchange rate when the shop currency differs, a safety stock and the buttons “Check the catalogue”, “Link items already on Mercado Libre”, “Send changes now” and “Send all again”.

Products get a “Mercado Libre” tab: sell or not, category with a suggestion from the name and a check of the required attributes, listing type, condition, brand, model, GTIN, own price. The result for every listing is shown there too, with a link to it.

In Pro, paid orders arrive in WooCommerce every 5 minutes, or within seconds with the notifications on. Products are matched by listing, SELLER_SKU or SKU, and the stock is taken at once. Address, logistics, tracking number and shipment status come from the Mercado Libre shipment. A sale cancelled on Mercado Libre cancels the order and returns the stock, and a purchase flagged as fraud risk goes on hold with a “do not ship” note.

How it works, step by step

1. In the Mercado Libre developer centre of your country you create an application with the redirect URI the plugin shows, and paste its APP ID and secret key.
2. “Connect to Mercado Libre” opens the Mercado Libre consent page, where you allow access with the main seller account.
3. If you already sell on Mercado Libre, “Link items already on Mercado Libre” links listings to products by SELLER_SKU or GTIN, so nothing is listed twice.
4. In your products you tick “Sell on Mercado Libre”, choose a category and fill in the required attributes.
5. Price and stock changes join a queue that goes out every 5 minutes, only what changed. In Pro, orders arrive in WooCommerce.

Under the hood

• OAuth 2.0 with your application; the secret key and tokens are stored encrypted.
• The plugin detects the listing model of the account (User Products or previous) by itself.
• Price: with tax, the sale price while a sale runs, with markup and exchange rate. Without a rate no price is sent rather than a wrong one.
• Only changes are sent; a queue every 5 minutes and buttons to send at once.
• API log of 300 requests without tokens or buyer data.
• Pro: orders_v2, shipments and items notifications at a separate address with a secret token, repeats are not processed twice; WooCommerce e-mails to Mercado Libre buyers stay off unless you switch them on.
• HPOS compatible. Pro includes Spanish and Brazilian Portuguese translations.

How to install

1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
2. WooCommerce → Mercado Libre: choose your country and copy the redirect URI.
3. In the Mercado Libre developer centre create an application with that address and the scopes read, write and offline_access, then paste its APP ID and secret key into the plugin.
4. Press “Connect to Mercado Libre” and allow access with the main seller account.
5. Link existing listings, switch selling on in your products, press “Check the catalogue”, then “Send changes now”.
6. For Pro: paste the key or start the 7-day trial at the bottom of the settings page.

The “Download free” button gives the free version; the same one goes to wordpress.org. Pro is the full archive, it appears in your account after a purchase or a trial.