Stock rules: buffer, locations and maximum

How stock is calculated#

For each linked listing, Toldo does this calculation:

Stock on Mercado Libre = (stock in the chosen locations − safety stock), capped at the maximum

The result is never less than zero.

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

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

Locations#

By default, Toldo adds up the available inventory of 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)#

It's the number of units you don't list on Mercado Libre, so your last pieces don't sell twice, for example if you sell on Shopify and Mercado Libre at the same time. It can be anywhere from 0 to 100,000 units. The default is 0.

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.

Products with several listings#

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

Mercado Libre Full#

Toldo never changes Full stock. That inventory is 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 of your own warehouse and leaves Full stock as it is. More details in Shipping.

When it updates#

When inventory changes in Shopify (because of a sale, an adjustment or a return), Toldo calculates the new number and sends it to Mercado Libre. It also compares the two again periodically to correct any differences.

Mercado Libre automatically pauses listings that run out of stock.

If an update doesn't go through#

Toldo records every stock update it sends in its activity log, with the reason in plain language when something fails. For example:

• Rate limit or Mercado Libre unavailable: Toldo retries on its own, later.
• 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.
• No warehouse chosen: if you have several warehouses of your own on Mercado Libre, choose in Toldo which one receives the stock.

Steps to set up your stock rules#

1. Open your connected account. In Toldo, go to Marketplaces and choose your Mercado Libre account.
2. Choose the locations. Leave All selected or check the Shopify locations that count for Mercado Libre.
3. Set your safety stock. Start with 1 or 2 units on your best-selling products.
4. Set a maximum, if you need one. Leave it empty to list all your available stock.
5. Save and check the preview. Toldo shows you how many units would be listed before it sends anything.

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. With stock updates off, Toldo doesn't change the quantities on your listings.

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, meaning it doesn't ship from Full. See Mercado Libre orders in Shopify.

What happens to Full stock?#

Toldo never changes it. Mercado Libre manages it.