Connecting Shopify with MercadoLibre: requirements and common errors

To connect Shopify with MercadoLibre you need three things in place before you touch a single button: a MercadoLibre account with administrator permissions (not a limited secondary user), a Shopify catalog with clean SKUs and EAN/GTIN codes on your products, and a clear decision about which channel is the source of truth for price and for stock. Without those three pillars, the technical link will work on day one and break on day two, when a sale on one channel fails to deduct inventory on the other and you end up selling something you no longer have.

The connection itself is a bridge that syncs three flows: the catalog (a Shopify product publishing as a listing on MercadoLibre), the inventory (a unit sold anywhere subtracting on both sides), and the orders (a MercadoLibre purchase showing up in your operation like any other). What most sellers underestimate is that connecting isn’t “hit sync”; it’s agreeing on the rules of the game up front so both catalogs speak the same language.

This article covers what you actually need ready, the permissions people forget, and the errors that repeat every time someone starts linking both platforms without a plan. It’s the groundwork that comes before choosing how you connect —there are several ways: native app, middleware or API—; here we’re talking about the foundations that make any of those ways work.

the real requirements before you link

Start with the account. On the MercadoLibre side you need to own the account or have a role with full permissions: publish, edit listings, manage stock, and view orders. Many attempts fail because whoever runs the connection logged in as a collaborator who can see sales but can’t modify listings, and the authorization is granted only halfway. On the Shopify side you need access to your store’s app store (or private/custom app permissions) to install the connector and grant it scope to products, inventory, and orders.

Then comes the catalog, which is where almost everything is decided. Every product you want to sync needs a unique, stable SKU: no two variants sharing a SKU, no SKUs that change every time you re-edit the product. The SKU is the key the bridge uses to match “this in Shopify” with “this on MercadoLibre.” If the key is ambiguous, the sync matches wrong or doesn’t match at all.

Glossary: what an EAN/GTIN is and why MercadoLibre asks for it →

And here’s the requirement most people ignore: the EAN/GTIN barcodes. MercadoLibre uses catalog-by-code to attach your products to existing listings and gain exposure. If your Shopify products don’t carry the GTIN in the right field, the MercadoLibre publication comes out incomplete, without catalog, or rejected. Loading them before you connect saves you dozens of manual corrections later.

the permissions almost everyone forgets

The word “connect” sounds like a single click, but technically you’re authorizing an application to act on your behalf across two platforms. That permission —the scope— defines what the connector can read and what it can write. If you authorize read-only on products but not write on inventory, you’ll see your catalog synced but the stock will never deduct: the perfect picture of a broken bridge.

The permissions you need to grant, one by one: on MercadoLibre, listing management (create and edit), read and write on stock, and read on orders/sales. On Shopify, read and write on products, inventory, and orders. When a MercadoLibre sale doesn’t show up in Shopify, nine times out of ten it’s because the orders scope wasn’t granted, not because “the system is failing.”

A detail that bites late: MercadoLibre authorizations expire. The token that works today can expire in weeks if the connector doesn’t renew it on its own. When everything “stops syncing” from one day to the next without you changing anything, the first suspect is an expired token that needs re-authorizing. A good connector refreshes the permission silently; an improvised one leaves you finding out after you’ve already oversold.

common errors when starting out

The first, and most expensive: duplicate listings. You connect, sync, and suddenly the same product appears twice on MercadoLibre because a manual listing already existed and the connector created another without recognizing it. The golden rule is to decide up front who the source of truth is and to run a matching pass of what already exists against the new items, instead of letting the bridge create everything from scratch.

The second: syncing the same price on both channels. MercadoLibre’s commissions, its shipping costs, and Full aren’t your Shopify store’s. A price that leaves you margin on Shopify can leave you at zero —or negative— on MercadoLibre. Price is thought through per channel from the real net, not copied flat. Here a per-channel price calendar keeps a well-meaning promo from eating your profit on the more expensive platform.

Glossary: what a unified catalog is and the problem it solves →

The third: confusing physical stock with available stock. You publish 40 units on both channels without subtracting what’s committed —what’s sold but not yet shipped, what’s held, what’s reserved at the 3PL— and you end up overselling at the worst moment. Connecting two catalogs multiplies this risk, because now two platforms draw from the same inventory pool.

Glossary: real available, the number you can actually sell →

why real time changes everything

The multichannel seller’s deeper pain isn’t technical, it’s about time. Without a connection that syncs in the moment, the operation becomes a dance of tabs: one for Shopify, another for MercadoLibre, a spreadsheet where you reconcile inventory by hand every night, and the permanent feeling of not knowing how much you really have available. Every minute between a sale and its update on the other channel is a window for overselling.

When inventory deducts across both catalogs the instant a unit sells, that spreadsheet disappears. Not because you automated it, but because the question it answered stopped existing. The unified catalog stops being two lists you try to keep identical and becomes a single truth reflected in two storefronts. The uncertainty —“do I have it or not?”— resolves itself.

That’s the point the word “connect” can’t quite express. You don’t connect two platforms to see them together; you connect them to stop reconciling them. The difference between an hourly sync and a real-time one is the difference between checking and trusting.

how to start without tripping

The order that avoids 80% of the problems is this: first clean the catalog in Shopify (unique SKUs, GTINs loaded, titles and variants tidy). Second, verify full permissions on both accounts before authorizing. Third, run matching against what already exists on MercadoLibre so you don’t duplicate. Fourth, test with a handful of products —five or ten— before syncing the whole catalog. Fifth, validate that a test sale deducts stock on both sides and that the order arrives complete.

That small pilot shows you where your setup is loose without risking the entire catalog. If you want the detailed flow for selling on both without doubling your effort, it’s laid out in how to connect Shopify and MercadoLibre to sell on both without double work.

Connecting well isn’t a one-day event; it’s having tidied the house before opening the door between two rooms. Requirements and permissions are boring, and that’s exactly why they get skipped —and exactly why they’re almost always the root cause when something “stops working” weeks later.