All guides

Mercado Libre

Link listings by SKU or barcode

How Toldo links your Mercado Libre listings to your Shopify variants by SKU or barcode, and how to resolve conflicts.

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 links each Mercado Libre listing to a Shopify variant by looking first for the same SKU and then for the same barcode (GTIN). If it finds more than one possible variant, it doesn't guess: it marks the listing “Several matches” for you to choose. You can also link a listing by hand, or several at once. Several listings can point to the same variant.

How Toldo looks for matches

For each listing (or each variation of a listing), Toldo looks for a Shopify variant in this order:

  1. By SKU. It compares the listing's SKU with your variants' SKUs. On Mercado Libre, Toldo takes the SKU attribute and, if there isn't one, the SKU field that older listings use. It's not case-sensitive and ignores extra spaces.
  2. By barcode. If there's no SKU match, it compares the listing's barcode (GTIN, EAN or UPC) with your variants' barcodes. Toldo removes spaces and hyphens and compares without leading zeros, so a 12-digit UPC matches the same code written with 13 or 14 digits. Only codes with 8, 12, 13 or 14 digits count; one with letters or other characters doesn't.

The three results

ResultWhat it meansWhat to do
LinkedThere's exactly one variant with that SKU or codeNothing: the listing is already syncing
Several matchesThere's more than one variant with that SKU or codeChoose the variant with Use …, under Variants with this code:, or fix the duplicate SKUs
Not linkedNo variant matchesAdd or fix the SKU or the barcode, or link it by hand with Link to a variant

Toldo never guesses when there are several matches: a wrong link would send one product's stock to another.

A link you make by hand stays as long as the variant exists. Automatic links are recalculated at every sync: if you change a SKU, the link moves or is lost. If you don't want to sync a listing, use Ignore: it stays Ignored until you click Stop ignoring.

Several listings at once

In your account's list of listings, you can tick several and act on them together:

  • Ignore selected and Stop ignoring selected do what Ignore and Stop ignoring do, for every listing you ticked.
  • Link selected to a variant opens Shopify's picker: you choose one variant and every ticked listing is linked to it by hand, for example the Classic and the Premium listing of one product. Toldo sends them their stock right away and, if you turned on price updates, their price too.

Select this page ticks every listing on the page, and Clear selection unticks them.

If the list you're looking at (a tab or a search) has more listings than fit on the page, the box Apply to all … listings in this list, not just this page appears. With it ticked, Ignore and Stop ignoring apply to the whole list once you confirm. For example, open the Not linked tab, tick the box and ignore all at once the listings you don't sell in Shopify. Each run covers up to 10,000 listings; if more remain, Toldo tells you and you run it again for the rest. Linking only works on the listings you tick.

The account's Activity records how many listings changed.

Several listings, one variant

It's normal to sell the same product in more than one listing, for example a Clásica listing and a Premium one. Toldo links them all to the same variant, and that's not a conflict: they all get the same stock.

On accounts with User Products, up to 30 listings can share the same user product. They share stock. On Mercado Libre each one can have its own price, but if you turn on sending prices, Toldo sends them all the same one.

Listings with variations

In a listing with variations (for example, sizes or colors), Toldo links each variation separately. That's why each variation needs its own SKU: Toldo doesn't copy the listing's SKU to its variations (unless it has only one), because that would link them all to the same variant.

Steps to prepare your SKUs

  1. Give each variant in Shopify a unique SKU. Two variants with the same SKU create a conflict. Toldo shows you the list of repeated SKUs.
  2. Use the same SKU on Mercado Libre. Enter it in the SKU field of each listing or each variation.
  3. Check your barcodes. If you use them, make sure they're GTINs with 8, 12, 13 or 14 digits.
  4. Sync your listings. On your account's page, click Sync listings now (Toldo also does it on its own every 6 hours). Review the Several matches and Not linked tabs and fix whatever is missing.

Create your listings as products in Shopify

If you sell products on Mercado Libre that you don't have in Shopify yet, Toldo can create them for you. Tick Not linked listings and choose Create in Shopify: Toldo creates one product per listing, with all its variations, and links it.

  • As a draft. It doesn't show on your online store until you publish it in Shopify, and it syncs all the same while it's a draft.
  • With the listing's data: title, description, brand, pictures, SKU, barcode and price. Variations (color, size) become variants, with up to 3 attributes and 100 variations.
  • With its stock at the Shopify location you choose, which must be one your stock rules count. From then on, Toldo sends Shopify's stock as for any linked listing: with a safety stock of 2, the listing shows 2 fewer.
  • With a price that leaves the listing's alone. The listing's regular price, not a promotion's. If you sync prices with a markup, the product gets the price that your rule turns back into the listing's, or the next one up if your rounding can't land exactly on it.

Full listings start at 0 in Shopify: their stock is in Mercado Libre's warehouse. Not created: Full listings with Flex (they mix Mercado Libre's stock with yours), listings of accounts with several warehouses, listings in another currency than your store, and listings with a variation already linked. The account's Activity says which were left out and why. A Clásica and a Premium listing of the same product become one product: the second links to the first's by its SKU or barcode, or by being the same product on Mercado Libre. With price sync on, both get that product's price. Shopify's stock also includes the units of your orders on that account that Mercado Libre already took and that haven't reached Shopify yet (for example, those waiting on your plan's limit).

Steps to create your listings in Shopify

  1. Open the account. In Toldo, go to your Mercado Libre account and scroll to the listings.
  2. Tick the missing ones. Choose the Not linked tab and tick the listings you want in Shopify.
  3. Choose Create in Shopify. Pick the location that gets the stock and confirm with Create products.
  4. Accept the permission. The first time, Shopify asks you to let Toldo create products.
  5. Review the drafts. In a few minutes they appear in Shopify's Products. Review them and publish them on your online store whenever you like.

In Toldo's dashboard, Create in my store does the same with one account's listings, once you've granted the permission in Shopify.

Export your listings

On the account's page, Export listings (CSV) downloads all its listings with what they're linked to: SKU, Shopify product and variant, how they were linked, stock and price on Mercado Libre, status and last error. In the dashboard, Export CSV in Listings does the same for all your accounts, or the one you filtered. Use it to check the links in a spreadsheet or keep a copy. It uses commas and decimal points, as Excel does in Mexico; if your spreadsheet uses semicolons, open it with its text or CSV import.

When Mercado Libre changes your listings

Mercado Libre is moving listings with variations to User Products: a listing with variations becomes one listing per variation, with new IDs.

When that happens, Toldo marks the old listing as Closed and, at the next sync, links the new ones like any other listing: by SKU and then by barcode.

Your decisions move to the new listings:

  • Links made by hand. If you linked a variation by hand, that variation's new listing is linked to the same Shopify variant.
  • Ignored listings. If you ignored a variation, its new listing is Ignored.

To tell which new listing belongs to each variation, Toldo uses the relation Mercado Libre gives, the same user product, the same SKU or the same barcode. If the match isn't unique, Toldo doesn't guess: link the new listing yourself. If you already decided something about the new listing, Toldo keeps it. It looks for the new listings at every sync for the next 7 days, and the account's Activity records it: "Mercado Libre replaced … listings with new ones: your links and choices moved to the new listings."

While the migration is in progress, Toldo waits and retries. Earlier orders keep their original link.

Frequently asked questions

Can I ignore many listings at once?

Yes. Open the tab or search that gathers them, tick Apply to all … listings in this list and click Ignore selected. Toldo asks you to confirm before it applies to the whole list.

Is the SKU case-sensitive?

No. "ABC-01", "abc-01" and "ABC-01 " count as the same SKU.

What happens to a listing with no SKU or barcode?

It stays Not linked and doesn't sync. Add a SKU that matches a Shopify variant or link it by hand with Link to a variant.

Can Toldo create my Mercado Libre products in Shopify?

Yes. Tick the unlinked listings and choose Create in Shopify: Toldo creates each one as a draft product, with its pictures, variations, price and stock, and links it.

Can I have the same product in a Clásica and a Premium listing?

Yes. Both are linked to the same Shopify variant and get the same stock.