All guides

Mercado Libre

Who invoices your Mercado Libre sales?

Choose whether Mercado Libre's Facturador or Toldo invoices your Mercado Libre sales, what Toldo does with each sale and why both should never invoice.

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

Each connected Mercado Libre account chooses who invoices its sales: the Facturador de Mercado Libre or Toldo. With Toldo, the buyer's tax details are read after each sale is imported: if they gave them, Toldo issues the CFDI in their name, stamps it and uploads it to the sale; if not, the sale goes into your global invoice. Choose only one: if both invoice, your sales would be invoiced twice.

The two options

On each connected account, under Sync rules, Who invoices your Mercado Libre sales? has two options.

Mercado Libre (its free Facturador)

It's the default. The Facturador de Mercado Libre, which you set up inside your Mercado Libre account, issues the CFDI for each sale, and Toldo issues none for these orders.

Toldo

Toldo's CFDI invoicing module invoices the sales of your Mercado Libre Mexico account: it issues a CFDI in the buyer's name when the buyer gave their tax details, and the other sales go into your global invoice (factura global). Toldo only invoices Mercado Libre Mexico accounts: on accounts from other countries this choice doesn't appear, and sales stay with Mercado Libre's own tools.

What Toldo does with each sale

After each sale is imported into Shopify:

  1. It reads the buyer's tax details. Toldo checks on Mercado Libre whether the buyer gave their details for an invoice: RFC, name or business name (razón social), tax regime (régimen fiscal), CFDI use (uso del CFDI) and postal code.
  2. If they gave them, it issues their CFDI. Toldo issues the CFDI in the buyer's name with those details, stamps it and uploads it to the sale on Mercado Libre, once. Mercado Libre delivers it to the buyer, so your buyer gets no email from the invoicing provider and doesn't use your portal.
  3. If they didn't, the sale goes into your global invoice. The same when the RFC is the generic XAXX010101000. Toldo issues the global invoice every day, for each period that closes at the frequency you chose.
  4. If Mercado Libre is still processing the details, Toldo reads them again for about two days. Meanwhile, the sale may go into a global invoice; if the details arrive later, Toldo reissues that global invoice without the sale (motive 04) and issues the buyer's CFDI. If that global invoice already has credit notes, Toldo doesn't reissue it: the sale stays in it, Toldo doesn't issue the buyer's CFDI, and the Activity asks you to issue it with your accountant.

If the buyer's details can't be used for a CFDI, or SAT doesn't recognise them (for example, the name doesn't match their RFC), the sale goes into the global invoice, and Toldo reads the details on Mercado Libre again in case the buyer corrects them: after 6 hours, then at 1, 2, 4 and 7 days, then every week, while the CFDI for that sale can still be requested ("Days after purchase a customer can still ask" in Settings, never past the end of March of the next year). If they come back corrected, Toldo issues the buyer's CFDI and takes the sale out of the global invoice, as in step 4. Each step, with its reason, shows in the account's Activity.

When the buyer's CFDI waits for your review

  • SAT product codes: the CFDI in the buyer's name needs each item's product code. If a product has no rule and there's no default code, the CFDI waits for your review. See SAT product codes.
  • IVA: the cases in the IVA section that wait for your review.
  • Plan limit: if you've already issued your plan's invoices this month, the CFDI waits, and Toldo stamps it on its own when the next month starts or as soon as you choose a bigger plan.

While the CFDI waits, the sale doesn't go into the global invoice.

Who invoices is fixed when the sale is imported

Each sale keeps the option its account had when the sale reached Shopify. If you change the option, the change applies to sales imported from then on: the ones already in Shopify are still invoiced by the tool they had. That way, no sale is invoiced twice because of the change. If you move from the Facturador to Toldo, Toldo doesn't invoice the earlier sales: check on Mercado Libre that they already have their invoice.

Payment method (FormaPago)

  • In the global invoice, each Mercado Libre sale counts with the code 31 Intermediario pagos (payment intermediary), because Mercado Pago collected the payment. The global invoice carries the payment method of its largest sale.
  • In the buyer's CFDI, Toldo uses how the buyer paid on Mercado Libre: 04 Tarjeta de crédito (credit card), 28 Tarjeta de débito (debit card), 06 Dinero electrónico (Mercado Pago balance), 01 Efectivo (cash) or 03 Transferencia electrónica de fondos (bank transfer). Any other way of paying, such as Mercado Crédito, takes 31.

If you added a line for "mercado libre" in CFDI invoicing → Settings → Payment method (FormaPago) → Your own rules, that code is used in both cases.

IVA

Mercado Libre's prices include IVA. In the order Toldo creates in Shopify, 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. Toldo takes each product's IVA from its rules in SAT product keys (the "IVA" column: the most specific rule for the product that sets one or, if none does, the default rule) and, for a product with no rule that sets a rate ("As charged" sets none), from Shopify: 16% if the product charges tax in Shopify, none if it doesn't. A 0% (tasa cero) product gets an IVA of 0. Shipping uses the "Shipping" rule's rate; without one, 16% if your store charges tax on shipping in Shopify.

The buyer's CFDI and the global invoice take the IVA from those tax lines, as for your store's own orders: a product without IVA follows "When Shopify charged no IVA on a product without a rule" in Settings. These wait for your review:

  • products with the 8% border-region IVA, which Toldo doesn't issue yet;
  • a product without IVA when that setting says "Hold for review";
  • an item from a listing that isn't linked to a product in your store, when that setting says untaxed products are 0% (tasa cero) or exempt: Toldo gives it 16%, the general rate, but can't know whether it applies.

If Shopify doesn't let Toldo read what decides an order's IVA, Toldo creates the order without a tax breakdown, and the CFDI takes IVA as included in each price, at its rules' rate or 16%; a product without a rule waits for your review when that setting says 0% or exempt.

Cancellations and returns

  • Mercado Libre cancels the sale before you fulfill the order: the sale didn't happen. If it wasn't in a global invoice yet, it doesn't go into any; if it already was, the refund Shopify records becomes a credit note related to that global invoice. If the buyer's CFDI was already stamped, Toldo asks SAT to cancel it with motive 03 (No se llevó a cabo la operación: the operation didn't happen), and the refund waits for that cancellation instead of becoming a credit note; if SAT doesn't accept the cancellation, the refund does become a credit note.
  • A return after the order was fulfilled: when you record the refund in Shopify, Toldo issues a credit note (CFDI de egreso) related to the buyer's CFDI or, if the sale was in your global invoice, to that global invoice. See Credit notes.

If Mercado Libre doesn't accept the CFDI

Mercado Libre takes one invoice per sale. If it doesn't accept the one Toldo uploads (for example, because the sale already has one from the Facturador or uploaded by hand), Toldo records it in the Activity and in the CFDI's history and doesn't try again: check it and, if needed, upload it by hand. You download the PDF and XML from the CFDI in CFDI invoicing → Documents.

If the Mercado Libre account needs to be reconnected, the upload waits up to 14 days for you to reconnect it. If Mercado Libre keeps failing after several tries, the Activity asks you to upload it by hand.

If you correct the buyer's details

When you correct the buyer's details on a stamped CFDI (on the CFDI, Correct the customer's data), Toldo stamps the corrected CFDI and uploads it to the sale in place of the earlier one: it first removes from the sale the files of the earlier CFDI that Toldo uploaded, then uploads the new one's, which Mercado Libre delivers to the buyer. If the sale has another invoice, from the Facturador or uploaded by hand, Toldo doesn't remove it: the Activity tells you so you can sort it out by hand.

Why only one option

No API tells Toldo whether you have the Facturador de Mercado Libre turned on. If both invoice, each sale would end up with two CFDIs. That's why, after you connect your account, Toldo asks you to choose an option; until you do, the default (the Facturador de Mercado Libre) applies.

Steps to have Toldo invoice your Mercado Libre sales

  1. Set up invoicing. Enter your issuer details, upload your CSD (Certificado de Sello Digital) and switch to production. See Set up your issuer and CSD.
  2. Check your SAT product codes. Choose a default code or rules for your products, with their IVA. See SAT product codes.
  3. Turn off the Facturador de Mercado Libre. Do it from your Mercado Libre account, so it doesn't invoice the same sales.
  4. Choose Toldo on your connected account. In Toldo, go to Marketplaces, open your Mercado Libre account and, under Sync rules, in Who invoices your Mercado Libre sales?, choose Toldo and click Save rules.
  5. Check the Activity. It shows, sale by sale, whether the buyer's CFDI was issued or the sale went into the global invoice.

Mercado Libre sales and the self-invoicing portal

The Mercado Libre sales Toldo imports into Shopify carry the toldo-import tag, which keeps them out of the Self-invoicing portal: if a buyer goes there, the portal asks them to request their invoice on Mercado Libre. That way they're never invoiced two ways.

Frequently asked questions

Can I change the option later?

Yes, it's a setting on each connected account. Before you change it, make sure the other tool stops invoicing new sales. The change applies to sales imported from then on; earlier ones are still invoiced by the tool they had.

What tax details does Toldo use?

The ones the buyer registered on Mercado Libre: RFC, name or business name (razón social), tax regime (régimen fiscal), CFDI use (uso del CFDI) and postal code.

Can my buyer ask for their invoice later?

Toldo reads their tax details when it imports the sale and, if Mercado Libre is still processing them, reads them again for about two days. If their details couldn't be used or SAT didn't recognise them, Toldo reads them again while the CFDI can still be requested, in case they correct them on Mercado Libre. If the buyer hadn't given their details when the sale was imported, Toldo doesn't look again: the sale goes into your global invoice and Toldo doesn't issue their CFDI. If they ask you later, check with your accountant how to handle it.

Do Mercado Libre's withholdings change anything?

The IVA and ISR withholdings (retenciones) that Mercado Libre applies as a platform are a separate matter from the invoice to your buyer. Review your withholding certificates (constancias de retención) with your accountant.