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.
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 flags a conflict for you to resolve. 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:
- 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.
- By barcode. If there's no SKU match, it compares the listing's barcode (GTIN, EAN or UPC) with your variants' barcodes. Toldo compares only the digits, 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.
The three results
| Result | What it means | What to do |
|---|---|---|
| Linked | There's exactly one variant with that SKU or code | Nothing: the listing is already syncing |
| Conflict | There's more than one variant with that SKU or code | Choose the right variant or fix the duplicate SKUs |
| Unlinked | No variant matches | Add or fix the SKU or the barcode |
Toldo never guesses in a conflict: a wrong link would send one product's stock to another.
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, but each one can have its own price.
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, because that would link them all to the same variant.
Steps to prepare your SKUs
- 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.
- Use the same SKU on Mercado Libre. Enter it in the SKU field of each listing or each variation.
- Check your barcodes. If you use them, make sure they're GTINs with 8, 12, 13 or 14 digits.
- Look for matches in Toldo. Review the conflicts and the unlinked listings, and fix whatever is missing.
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 looks for the new listings by user product, SKU and barcode, and moves the link. If the match isn't clear, it doesn't guess: it shows it to you so you can review it. While the migration is in progress, Toldo waits and retries. Earlier orders keep their original link.
Frequently asked questions
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 unlinked and doesn't sync. Add a SKU that matches a Shopify variant.
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.
Was this guide helpful?
Your email app will open with a message ready to send us.