- Home
- Documentation
- Mercado Libre
- Mercado Libre orders in Shopify
Mercado Libre orders in Shopify
How Toldo imports your Mercado Libre sales into Shopify: when an order comes in, how packs (carts) arrive and what happens with cancellations and refunds.
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
When a Mercado Libre sale is paid, Toldo creates an order in Shopify with its products, the shipping cost and the "Mercado Libre" tag, without creating a customer. A cart with several products (a pack) arrives as a single order. If Mercado Libre cancels the sale, Toldo cancels the order in Shopify or, if it's already fulfilled, tags it so you can handle the return.
When an order comes into Shopify
Toldo imports a sale when Mercado Libre marks it as paid. While the payment is pending or in process (with a cash payment at OXXO, until the buyer pays at the store), the sale waits under Recent orders as "Waiting for payment", and its units are held back from the stock of your other channels. Only sales placed after you connect your account are imported.
| Status on Mercado Libre | What Toldo does |
|---|---|
| Paid | Creates the order in Shopify |
| Confirmed, payment pending, in process or partially paid | Waits for the payment, holding its units on your other channels |
| Cancelled or invalid | Marks it as cancelled and offers its units again |
Toldo receives Mercado Libre's notifications as they happen and, on top of that, checks recent sales every hour in case a notification was missed. Each sale is imported only once.
Packs: one cart, one order
When a buyer buys several products in the same cart, Mercado Libre creates a pack: several orders with a single shipment. Toldo imports it as a single Shopify order, with all its products.
The pack comes in when all its orders are paid and Toldo can read all of them: that way you don't end up with an incomplete order that products couldn't be added to later.
What the order includes
- Products: each product with its quantity and unit price.
- Shipping: what the buyer paid for shipping, once per pack.
- IVA: in a store in Mexico, each product and the shipping carry their IVA as a tax line inside the price, so Shopify's reports show it and the order's total stays Mercado Libre's. See IVA.
- Buyer: the order comes in without a customer: it doesn't carry the buyer's name, nickname or email. Only when you ship it yourself (your own shipping) does it carry the shipping address, with the recipient's name and phone; with Mercado Envíos, Mercado Libre generates the label.
- Tags:
Mercado Libreandtoldo-import, so you can filter these orders in Shopify.
Toldo never subscribes your Mercado Libre buyers to marketing emails in Shopify: Mercado Libre's rules don't allow their data to be used for that.
Inventory
When the order ships from your own inventory, your Shopify stock goes down like with any sale. When it ships from Full, it doesn't: that inventory belongs to Mercado Libre. See Shipping.
If a listing isn't linked, its product goes into the order as a line without a product (with its title, SKU and price) and your Shopify stock doesn't change for it; the account's Activity lets you know.
If Shopify rejects an order, it shows as "Failed" under Recent orders: use Retry or, if you sorted it out yourself, I handled it. Temporary errors are retried on their own.
Cancellations and refunds
Toldo treats the sale as cancelled when:
- Mercado Libre cancels it or marks it as invalid;
- in Mexico, Mercado Libre refunds the buyer to their Mercado Pago account (the sale stays "paid" on Mercado Libre, but it shouldn't be shipped anymore);
- Mercado Libre detects a fraud risk. Don't ship that sale.
If the sale was already in Shopify and the order hasn't been fulfilled, Toldo cancels it, records the refund and puts the stock back into your inventory (except for Full), without notifying the buyer. If it's already fulfilled, Shopify doesn't allow cancelling it: Toldo adds the "Cancelled on Mercado Libre" tag and lets you know in Activity so you can handle the return by hand. If Shopify rejects the cancellation, Toldo tags it too, so you can cancel it by hand.
If only part of a pack is cancelled before it's imported, the order arrives without those products. If it's cancelled afterwards, Toldo doesn't change the order: it adds the "Partly cancelled on Mercado Libre" tag and lets you know in Activity so you can refund those products by hand.
Test sales
Mercado Libre test sales are imported as Shopify test orders: they carry the "Test" badge under Recent orders and don't count toward your plan's limit.
If you pause syncing
While the account is paused (with Pause syncing, on the account's page), Toldo doesn't import orders or move stock or prices. When you click Resume syncing, it imports the orders from the last 30 days; older ones aren't imported.
Steps to start importing orders
- Connect your account. See Connect your Mercado Libre account.
- Link your listings. That way each product in the order points to its Shopify variant. See Link listings.
- Leave order import turned on. Create Mercado Libre orders in Shopify is checked on every connected account.
- In Mexico, decide who invoices. Before your first sale, choose who invoices your Mercado Libre sales.
Invoicing these sales
This applies to Mercado Libre Mexico accounts, whose sales are invoiced with CFDI. Mercado Libre sales are never invoiced from the Self-invoicing portal: the order's toldo-import tag prevents it. They're invoiced by Mercado Libre's Facturador or by Toldo, depending on what you choose in Who invoices your Mercado Libre sales?.
Plan limits
Each imported order counts toward your plan's monthly limit. A pack counts as one order, and an order that's cancelled later still counts. Test sales don't count. If you reach the limit, new orders aren't lost: they stay "Waiting (plan limit)" and Toldo imports them in its hourly check as soon as you have room, next month or on a bigger plan. While they wait, their units are subtracted from the stock Toldo sends to all your channels. See Plans and limits.
Export your orders
On the account's page, Export orders (CSV) downloads the orders Toldo knows for that account: the Mercado Libre number, the state, the Shopify order, the total, the shipping and the dates. In the dashboard, Export CSV in Orders does the same for all your accounts, or the one you filtered. The file holds no data about your buyers. It uses commas and decimal points, as Excel does in Mexico: if your spreadsheet uses semicolons or rounds long order numbers, open it with its text or CSV import and mark that column as text.
Frequently asked questions
Why doesn't an order have a shipping address?
Because Mercado Libre handles the shipping (Mercado Envíos, Flex or Full) or because delivery is arranged with the buyer. Toldo only copies the address and phone when you ship it yourself; if Shopify doesn't accept the address, the order is created without it and Activity asks you to copy it from Mercado Libre.
Can an order be duplicated?
No. Toldo uses the pack (or order) number to import each sale only once, even if it receives several notifications.
Can I turn off order import?
Only if you also turn off that account's stock updates: your Shopify stock only goes down for a Mercado Libre sale once its order is in Shopify, so without the import Toldo would offer what you sold again. Under Sync rules, uncheck Send Shopify stock to Mercado Libre and Create Mercado Libre orders in Shopify, then click Save rules. See Stock needs the orders in Shopify.