How to sync inventory between Shopify and Mercado Libre
How inventory sync between Shopify and Mercado Libre works: what stock to send, locations, warehouses, Full, unpaid orders and what to check when it's off.
In short
To sync inventory between Shopify and Mercado Libre, let Shopify lead and give each listing a calculated number: the stock at the locations that ship your sales, minus a safety stock and the units of sales that aren't Shopify orders yet, capped at a maximum. That number should update with every change notification and with a periodic full check. Full stock is controlled by Mercado Libre, and listings of the same product share their stock.
Syncing inventory between Shopify and Mercado Libre means each listing offers the units you can actually sell, and that number changes when your inventory changes. It doesn't depend on a particular tool: every tool has to answer the same questions.
This guide explains how it works: what number each listing should get, what happens with several locations and warehouses, with Full and with sales that aren't paid yet, when to update and what to check when a number doesn't match. If you're looking for why you sell items you no longer have, start with how to avoid overselling.
One source of truth
Your inventory has to live in one place. Usually that's Shopify: it's where you record purchases, adjustments, returns and the sales from all your channels, and Mercado Libre gets a number calculated from there.
That has a practical consequence: if you change the stock by hand on Mercado Libre, the next update overwrites it. Adjustments are made in Shopify.
The exception is Full, Mercado Libre's fulfillment service. That stock sits in Mercado Libre's warehouses and Mercado Libre controls it, not your store. We cover it below.
What number each listing should get
The number you list isn't your total inventory. It's this calculation:
Listed stock = stock at the locations that count − safety stock − units of sales that aren't Shopify orders yet, capped at a maximum and never below zero.
- Locations that count. Only the ones that ship your Mercado Libre sales.
- Safety stock. A few units you don't list, to absorb two purchases at almost the same time on two channels.
- Units of sales that haven't reached Shopify yet. Until a sale is an order in Shopify, your Shopify inventory doesn't subtract it. If you don't subtract those units, you offer items you already sold.
- Maximum. An optional cap, so you don't expose all your inventory on a single channel.
Example. You have 10 units in your warehouse and 4 in your physical store, which sells over the counter. You only count the warehouse (10), keep 2 as safety stock (8) and there's a sale on another channel that hasn't reached Shopify yet (7). If your maximum is 6, you list 6.
Several locations in Shopify
Shopify tracks inventory by location: each variant's inventory card shows how many units are at each active warehouse or store.
Count only the locations you ship your Mercado Libre sales from. A physical store that sells over the counter can run out before your listing finds out.
If a location goes negative, count it as zero. It can happen with counter sales: according to Shopify's help, in Shopify POS (Shopify's point of sale) staff can keep selling when available inventory reaches zero or below.
Accounts with several Mercado Libre warehouses
Mercado Libre lets some accounts spread the stock of one product across several warehouses of their own; it calls this multi-origin stock. According to its developer documentation, not every account has it: Mercado Libre turns it on based on criteria such as the logistics you use or the addresses you ship from. Warehouses can only be created from your Mercado Libre account.
On an account like that, stock is managed per warehouse. Your sync needs to know which warehouse should receive your Shopify stock: usually the one that ships those sales. The others keep whatever you set on Mercado Libre.
One detail from that same documentation: on an account with several warehouses, a stock change sent the usual way can come back as successful without changing anything. If your number doesn't move, check this case first.
Full and Full + Flex
With Full, your merchandise sits in Mercado Libre's warehouses and Mercado Libre ships each sale. According to its developer documentation, you send the merchandise to the warehouse from your account, and through the API that stock can only be read.
That's why a sync should never write Full stock or add it to the stock you list from Shopify.
A listing can have Full and Flex (Mercado Libre's same-day delivery, which you handle yourself) at the same time. How its stock is split depends on your country and your account: according to Mercado Libre's documentation, in Argentina and Chile Flex stock can be managed separately; in Mexico, through warehouse management; and in Brazil, that option is generally blocked. We explain it in Mercado Libre Full and your Shopify stock.
One product behind several listings
Under Mercado Libre's User Products model, one product (really, one variant) can sit behind several listings, for example a Clásica and a Premium listing (two of Mercado Libre's listing types). According to its documentation, a product can have up to 30 listings, and when you change the stock of one, Mercado Libre copies the change to all the others.
For your sync, that means two things:
- Stock is written once per product. There's no point in sending 5 to the Clásica listing and 3 to the Premium one: both end up with the same number.
- They all point to the same Shopify variant. It's not a conflict: it's the same product with different sales conditions.
Before User Products, each listing had its own stock. If you still have listings like that, your tool has to update each one. And for each listing to find its variant you need clean SKUs; we explain how in SKUs and variants.
Unpaid sales: cash at OXXO
On Mercado Libre Mexico, a buyer can pay in cash with an OXXO ticket (OXXO is a convenience store chain in Mexico). Until they pay, the purchase exists but isn't paid.
According to Mercado Libre's developer documentation, a purchase like that can be cancelled for two reasons: the payment doesn't arrive within a certain period, or the payment had to be approved before the stock was subtracted and, in the meantime, the listing was paused or closed because it ran out of stock. In that case, Mercado Libre returns the money to the buyer.
For your inventory, that leaves two rules:
- On Mercado Libre, you don't need to hold those units. If they run out before the payment is approved, Mercado Libre cancels the purchase.
- On your other channels, you do. That sale isn't an order in Shopify yet, so your store would keep offering the item. If it sells there and the buyer then pays at OXXO, you have two sales for one item and you'll have to cancel one.
Holding those units has a cost: until the payment arrives, your other channels don't offer them. If the purchase is cancelled, they're offered again.
Why orders have to reach Shopify
Shopify subtracts inventory once the order exists. According to its help, the units of an order that's been placed but not yet fulfilled move to the Committed state and stop being available.
If a Mercado Libre sale never reaches Shopify as an order, your Shopify inventory doesn't go down. The next time your tool sends the stock, it will offer the item you already sold again.
That's why syncing stock and importing orders go together. And while an order hasn't been created in Shopify (because it failed, because it's waiting or because it's being created), its units are subtracted from the stock you list.
Full orders are different: they should reach Shopify for your records, but without lowering your locations, because they ship from Mercado Libre's warehouse.
When stock should update
The ideal combines two things:
- An update for each change. Shopify notifies apps about changes in your store (webhooks), and Mercado Libre sends notifications when a listing, a sale or a product's stock changes. That way the number moves when your inventory moves, not at set intervals.
- A periodic full check. Both admit a notification can be lost. Shopify warns that delivery of its notifications isn't always assured and recommends fetching its data again periodically. Mercado Libre considers a notification lost when your app hasn't acknowledged it after eight retries, within an hour.
Also recalculate when you change your rules (locations, safety stock or maximum) and when another channel holds or releases units.
What to check when a number doesn't match
Before you fix it by hand, find the cause. These are the most common ones:
- The listing points to another variant. A duplicate or mistyped SKU links it to the wrong product.
- The difference is on purpose. Safety stock, the maximum and held units lower the number you list.
- A location doesn't count, or it's negative. Check which locations add up.
- Some sales didn't reach Shopify. An order that failed or is waiting doesn't lower your Shopify inventory.
- It's Full stock. On a listing with Full, the number you see may be the one in Mercado Libre's warehouse, not yours.
- Your account has several warehouses. Check which one receives your Shopify stock and whether the change really went through.
- The product has several listings. With User Products they share stock; before, each had its own.
- You paused the listing, or it's closed. According to Mercado Libre, a listing you paused yourself doesn't reactivate on its own even if you send it stock, and a closed one can't be reactivated, only relisted. If Mercado Libre migrated it to User Products, the old one is closed and there's a new one.
- The variant doesn't track inventory in Shopify. If Track quantity is off, there's no number to copy.
- The last update failed. Mercado Libre limits how many calls it accepts per minute. Check your tool's log.
To compare, export your Shopify inventory by location (under Products > Inventory, with Export) and put it next to your listings' stock.
Steps to sync your inventory
- Choose the source of truth. Usually Shopify. From then on, nobody adjusts stock by hand on Mercado Libre.
- Clean up your SKUs. One unique SKU per variant, the same on both channels.
- Choose the locations that count. Only the ones that ship your Mercado Libre sales.
- Set your safety stock and, if you need one, a maximum. To start, 1 or 2 units of safety stock are usually enough.
- Keep Full separate. Your sync shouldn't write it or add it.
- Choose the warehouse that receives your stock, if your Mercado Libre account has several.
- Import your orders into Shopify. Without orders, your Shopify inventory doesn't go down.
- Hold unpaid sales on your other channels. And release them if the purchase is cancelled.
- Test with a few products. Change the stock of 3 to 5 products in Shopify and check each of their listings.
- Compare once a day during the first week. Export your Shopify inventory by location and check that each listing has the expected number.
Frequently asked questions
Shopify or Mercado Libre: which one should lead on stock?
Only one, and usually Shopify, because that's where you record the purchases, adjustments and sales of all your channels. The exception is Full: Mercado Libre controls that stock.
Why does my listing show fewer units than Shopify?
Almost always on purpose: safety stock, the maximum, locations that don't count and units held for sales that haven't reached Shopify yet all lower the number you list.
What happens with a purchase paid in cash at OXXO?
It waits for its payment. Meanwhile, it's a good idea to hold its units on your other channels. On Mercado Libre you don't need to: according to its documentation, if the listing runs out of stock before the payment is approved, Mercado Libre cancels the purchase.
Is it enough for my tool to react to notifications?
Not quite. Shopify and Mercado Libre notify each change, but both admit a notification can be lost. A full check every so often catches what slipped through.
Can I adjust stock directly on Mercado Libre?
If Shopify leads, no: the next update overwrites your change. Make the adjustment in Shopify. Full stock is separate: you increase it by sending merchandise to Mercado Libre's warehouse.
About Toldo
Toldo is a Shopify app we build; it's rolling out in stages with a small group of founding partners. It calculates each listing's stock with this guide's formula: the stock at the Shopify locations you choose, minus your Units to hold back (a single number per connected account) and the units held for orders that aren't in Shopify yet, capped at the maximum you set and never below zero. It recalculates as soon as Shopify reports the change and when another channel holds or releases units, checks all your linked listings every 6 hours and records each update in the account's Activity, with the reason in plain language if something fails. It lets you choose the warehouse that receives your stock if you have several, never changes Full stock and doesn't send stock without also creating your Mercado Libre orders in Shopify (stock rules). It charges a flat monthly price, with no per-sale commission. During the rollout, we turn on each feature in stages. If you sell on Mercado Libre and Shopify, you can apply as a founding partner.
Mercado Libre, Shopify and OXXO are trademarks of their respective owners. Toldo is an independent app; it isn't affiliated with or endorsed by them.
Sources
Accessed on November 16, 2026, unless another date is given.
- Mercado Libre Developers, publishing and syncing (updated October 21, 2026): https://developers.mercadolibre.com.ar/en_us/products-sync-listings
- Mercado Libre Developers, User Products (updated December 19, 2025): https://developers.mercadolibre.com.ar/en_us/user-products
- Mercado Libre Developers, price per variation (updated August 13, 2026): https://developers.mercadolibre.com.ar/en_us/price-per-variation
- Mercado Libre Developers, multi-origin stock (updated April 20, 2026): https://developers.mercadolibre.com.ar/en_us/multi-origin-stock
- Mercado Libre Developers, multi-origin stock FAQ (updated May 5, 2026): https://developers.mercadolibre.com.ar/en_us/multi-origin-stock-management-user-products
- Mercado Libre Developers, distributed stock (updated April 22, 2026): https://developers.mercadolibre.com.ar/en_us/distributed-stock
- Mercado Libre Developers, Full (updated February 19, 2026): https://developers.mercadolibre.com.ar/en_us/fulfillment
- Mercado Libre Developers, sales and order statuses (updated June 24, 2026): https://developers.mercadolibre.com.ar/en_us/manage-sales
- Mercado Libre Developers, notifications (updated June 23, 2026): https://developers.mercadolibre.com.ar/en_us/products-receive-notifications
- Mercado Libre Mexico, how to pay for your purchase (cash with an OXXO ticket): https://www.mercadolibre.com.mx/ayuda/Como-pagar-tu-compra_923
- Shopify Help Center, inventory states: https://help.shopify.com/en/manual/products/inventory/managing-inventory-quantities/inventory-states
- Shopify Help Center, setting up inventory for the first time (Shopify POS sales at zero stock): https://help.shopify.com/en/manual/products/inventory/getting-started-with-inventory/set-up-inventory-tracking
- Shopify Help Center, exporting and importing inventory with a CSV file: https://help.shopify.com/en/manual/products/inventory/setup/inventory-csv
- Shopify Developers, about webhooks: https://shopify.dev/docs/apps/build/webhooks