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. A cart with several products (a pack) arrives as a single order. If Mercado Libre cancels or refunds the sale, Toldo marks it as canceled.
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, the sale waits.
| Status on Mercado Libre | What Toldo does |
|---|---|
| Paid | Creates the order in Shopify |
| Confirmed, payment pending, in process or partially paid | Waits |
| Canceled or invalid | Marks it as canceled |
Toldo receives Mercado Libre's notifications right away and also checks recent sales every hour in case a notification got lost. Each sale is imported only once.
Packs: one cart, one order
When a buyer purchases 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 once 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.
- Buyer: their name and their Mercado Libre nickname. The address and phone number only come through when you handle the shipping yourself (self-shipping); with Mercado Envíos, Mercado Libre generates the shipping 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 using their data for that.
Inventory
When the order ships from your own inventory, your Shopify stock goes down as with any sale. When it ships from Full, it doesn't: that's Mercado Libre's inventory. See Shipping.
Cancellations and refunds
Toldo treats the sale as canceled when:
- Mercado Libre cancels it or marks it as invalid;
- in Mexico, Mercado Libre refunds the buyer's money to their Mercado Pago account (the sale stays "paid" on Mercado Libre, but it should no longer be shipped);
- Mercado Libre detects a fraud risk. Don't ship that sale.
If the sale was already in Shopify, Toldo cancels or refunds the order and returns the stock to your inventory, except Full stock. If only part of a pack is canceled, the order keeps the products that are still valid: the canceled ones are left out if the cancellation arrives before the import, or refunded if it arrives after.
Test sales
Sales that Mercado Libre marks as test sales 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. It's on by default for each connected account.
- Decide who invoices. Before your first sale, choose who invoices your Mercado Libre sales.
Invoicing these sales
Mercado Libre sales are never invoiced from the Shopify self-invoicing portal: the order's tags prevent it. They're invoiced by the Facturador de Mercado Libre (Mercado Libre's invoicing tool) 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. See Plans and limits.
Frequently asked questions
Why doesn't an order have a shipping address?
Because it ships with Mercado Envíos: Mercado Libre generates the label, with the buyer's address. Toldo only copies the address and phone number to the order when you handle the shipping yourself.
Can an order be duplicated?
No. Toldo uses the pack number (or the order number) to import each sale only once, even if it receives several notifications.
Can I turn off order import?
Yes, for each connected account. Stock and prices keep syncing.
Was this guide helpful?
Your email app will open with a message ready to send us.