All guides

Mercado Libre

Stock rules: buffer, minimum, locations and maximum

How Toldo calculates the stock it lists on Mercado Libre from Shopify: locations, safety stock, minimum, maximum, units held for orders, warehouses and Full.

Rolling outUpdated

This feature is rolling out: we're turning it on in stages with our founding partners. What this guide describes may change before general availability.

In short

Toldo works out how many units to offer on Mercado Libre from your Shopify inventory: it adds up the locations you choose, subtracts your units held back (your safety stock, or buffer) and the units of orders that haven't lowered your Shopify stock yet, and, if you set them, applies a maximum and a minimum stock below which it sends 0. The rules belong to each connected account. It never changes the stock you have in Mercado Libre Full.

How stock is calculated

For each linked listing, Toldo does this calculation:

Stock on Mercado Libre = (stock at the chosen locations − safety stock − units held for orders), capped at the maximum

The result is never less than zero. If you set a minimum stock, it's zero while your locations hold fewer units than that minimum, not counting the units held for orders.

Example. You have 12 units in your warehouse and 5 in your physical store. You count both locations, your safety stock is 2, no units are held for orders and your maximum is 10:

  • Locations: 12 + 5 = 17
  • Minus the safety stock: 17 − 2 = 15
  • With the maximum: 10 units on Mercado Libre

Toldo doesn't send stock to a listing if the Shopify variant doesn't track inventory, nor to Mercado Libre kits, whose stock Mercado Libre works out from their components.

Units held for orders

Some sales on your marketplaces haven't lowered your Shopify stock yet, because their order isn't in Shopify yet. Toldo holds their units back and subtracts them from the stock it offers on every channel, not only the one that made the sale, so they don't sell twice. These are the units of orders:

  • waiting for your answer or already accepted, on marketplaces that ask you to accept each order, such as Coppel;
  • waiting because of your plan's limit;
  • that failed;
  • being created in Shopify;
  • waiting for their payment ("Waiting for payment"), such as a Mercado Libre purchase paid in cash at OXXO or a pending Amazon order. A Mercado Libre purchase's units are held only on your other channels: on Mercado Libre, Toldo doesn't subtract them, because Mercado Libre cancels a purchase whose payment is waiting for approval if the listing runs out of stock. Other marketplaces' orders are held on the order's own channel too: Amazon, for example, already sets those units aside from your listing, according to Seller Central's help.

Mercado Libre Full and Fulfillment by Amazon (FBA) orders hold nothing back: they ship from the marketplace's warehouse, not from your inventory. Test sales don't either.

Once the order is in Shopify, your Shopify stock goes down for the sale and Toldo stops holding those units. If the order is cancelled (for example, because the cash payment expired) or you refuse it, the units are offered again.

Holding the units of an unpaid order keeps the same item from selling twice: if it sold on another channel and the buyer then paid, you'd have to cancel one of the two sales, and marketplaces count that against you. The trade-off: until the payment arrives, your other channels don't offer those units.

Stock needs the orders in Shopify

While Toldo sends your stock to a marketplace, it also creates that marketplace's orders in Shopify: your Shopify stock only goes down for a sale once its order is in Shopify, so without the import the next update would offer the sold units again.

That's why Toldo won't save Send Shopify stock to Mercado Libre checked without Create Mercado Libre orders in Shopify. To stop importing orders, turn off stock updates first. If an account was saved that way before, its page warns you until you turn order import on or stock updates off.

Locations

By default, Toldo adds up the available inventory at all your Shopify locations. You can choose only some of them, for example the warehouse you ship your Mercado Libre sales from. A location with negative inventory counts as zero.

Safety stock (buffer)

These are the units you don't list on Mercado Libre so the last items don't sell twice, for example if you sell on Shopify and Mercado Libre at the same time. In Toldo it's called Units to hold back. It ranges from 0 to 100,000 units, and the default is 0. It's a single number per connected account: it's subtracted from the stock of each of its listings.

Maximum

This is the highest number of units Toldo lists, even if you have more. It keeps you from exposing all your inventory on a single channel. If you don't set one, there's no maximum.

Minimum stock to offer

If you set a minimum stock, Toldo sends 0 to Mercado Libre while your chosen locations hold fewer units than that number, not counting the units held for orders. It keeps the last pieces off the listing, for example if you keep a few for your physical store. In Toldo it's called Minimum stock to offer. It goes from 0 to 100,000 units; empty or 0 means no minimum.

Toldo compares your stock with the minimum before subtracting your safety stock. With a minimum of 3 and a safety stock of 1:

  • with 5 units, Toldo offers 4;
  • with 3 units, it offers 2;
  • with 2 units, it offers 0.

At 0 units, Mercado Libre pauses the listing for lack of stock. Once you have the minimum again, Toldo sends your stock and Mercado Libre reactivates the listing, unless you paused it yourself.

Products with several listings

If a product has several listings (for example, a Clásica and a Premium listing for the same user product), Toldo writes the stock only once and Mercado Libre copies it to all of them. That's why one product can't have different quantities: Toldo rejects that case and shows it to you.

Accounts with several warehouses

If your Mercado Libre account uses several warehouses of your own, you choose in the account's rules which one receives your Shopify stock, under Warehouse that receives your Shopify stock. The other warehouses keep the stock you set on Mercado Libre: Toldo doesn't touch them.

Until you choose one, Toldo doesn't change those listings' stock and shows "Your account has several Mercado Libre warehouses: choose the one that receives your Shopify stock in this account's rules."

When you switch warehouses, the previous one goes to 0 as Toldo updates each listing, so those units aren't offered twice.

When Toldo stops syncing a listing (you ignore it, or it's left not linked or with several matches), the stock it left in a warehouse becomes yours, like any other warehouse's: a later warehouse switch no longer empties it.

Mercado Libre Full

Toldo never changes Full stock. That inventory sits in Mercado Libre's warehouses and only changes when you send merchandise or make a sale. Toldo reads it to show it to you, without touching it.

If a listing combines Full with Flex, Toldo only updates the stock in your own warehouse and leaves the Full stock as it is. This works in Argentina and Chile, and on accounts with several warehouses. In Mexico, Mercado Libre only lets Flex stock be set apart from Full on accounts with several warehouses. On an account without several warehouses in Mexico, Brazil or Colombia, and on listings in the older model (with variations), Toldo can't separate that stock and doesn't change it: you'll see "Full + Flex stock can't be set for this listing." More details in Shipping.

When it updates

When your inventory changes in Shopify (because of a sale, an adjustment or a return), Toldo works out the new number and sends it to Mercado Libre a few seconds later. It also sends it when another of your marketplaces holds back or releases units of that product. On top of that, every 6 hours it recalculates the stock of all your linked listings and sends it if it changed or if Mercado Libre shows more units than Toldo sent.

Mercado Libre automatically pauses listings that run out of stock. Toldo keeps sending stock to paused listings; to closed ones, it doesn't.

If an update doesn't go through

Toldo records every stock update it sends in the account's Activity, with the reason in plain language when something fails. For example:

  • Rate limit reached or Mercado Libre unavailable: Toldo retries on its own every few minutes; if it keeps failing, it tries again at the 6-hour check.
  • Listing being migrated: Toldo waits for the migration to finish and retries.
  • Mercado Libre responded but kept the previous quantity: this happens on some accounts with several warehouses; Toldo tries updating by warehouse and, if it can't, shows it to you.
  • Several warehouses, none chosen: choose the one that receives your Shopify stock in the account's rules (see Accounts with several warehouses).

Steps to set up your stock rules

  1. Open your connected account. In Toldo, go to Marketplaces, choose your Mercado Libre account and scroll down to Sync rules.
  2. Choose the locations. In Locations that count, leave All locations or choose Only these locations and check the ones that count for Mercado Libre.
  3. Choose the warehouse, if your account has several. In Warehouse that receives your Shopify stock, choose the Mercado Libre warehouse that receives your stock. If your account has a single warehouse, this field doesn't appear.
  4. Set your units to hold back. Enter a number in Units to hold back. It's subtracted from the stock of each of the account's listings; 1 or 2 units are usually enough to start.
  5. Set a maximum, if you need one. Enter it in Most units to offer; leave it empty for no limit.
  6. Set a minimum stock, if you need one. Enter it in Minimum stock to offer; leave it empty to always send your stock.
  7. Save. Click Save rules: if you changed your stock rules, Toldo sends the new stock to your linked listings right away. Under Listings, each one shows the stock sent ("Sent") and the stock on Mercado Libre ("On Mercado Libre").

Frequently asked questions

Can I turn off stock updates?

Yes. They're on by default, but you can turn them off for each connected account: uncheck Send Shopify stock to Mercado Libre in the account's rules. With stock updates off, Toldo doesn't change the quantities on your listings, and you can then stop importing that account's orders too.

Does Toldo change my Shopify inventory?

The stock rules don't: they only read your Shopify inventory. Your Shopify inventory goes down when Toldo imports an order that ships from your own inventory, that is, not from Full. See Mercado Libre orders in Shopify.

What happens to Full stock?

Toldo never changes it. Mercado Libre manages it.

What happens when my stock drops below the minimum?

Toldo sends 0 and Mercado Libre pauses the listing for lack of stock. As soon as your locations hold the minimum again, Toldo sends your stock and the listing is reactivated, unless you paused it yourself.