- Home
- Documentation
- CFDI invoicing
- Self-invoicing portal
Self-invoicing portal
How customers request their invoice in Toldo's portal: where it appears, what they enter, which orders can be invoiced and what happens if there's an error.
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
Your customers request their invoice in Toldo's self-invoicing portal: they find their order with the link in their order email or with their order number, enter their tax details and get their CFDI as a PDF and XML. Sales without an invoice request go into their period's global invoice (factura global) as soon as the period closes; if your customer asks for their invoice later, Toldo takes their sale out of the global invoice.
Where the portal appears
- In your order emails, if you paste the snippet Toldo gives you in CFDI invoicing → Settings ("Add the request link to your order emails") into Shopify, under Settings → Notifications → Order confirmation (and other order emails). Once the invoice is stamped, the same snippet shows the link to download it.
- On a page in your store ("Portal for your store"), for customers who come on their own.
Each order's own link is saved as soon as Toldo learns the order was paid, which is almost always a few seconds after Shopify sent the order confirmation. So in that first email the snippet links your store's page with the order number already filled in, and your customer only adds the total they paid or their email. Emails sent later, such as the shipping confirmation, carry the order's own link.
The block for Shopify's order status page isn't available yet.
Your customer doesn't need an account: the email link already carries their order. If they come through your store's page, they enter their order number and the total they paid, or the email they used.
You can also create the invoice yourself, for a customer who asks you directly: in CFDI invoicing → Requests, under Create a factura for an order.
What details it asks for
| Detail | Notes |
|---|---|
| RFC | 13 characters for an individual (persona física), 12 for a legal entity (persona moral) |
| Name or business name (razón social) | Exactly as on their Constancia de Situación Fiscal, without "S.A. de C.V." |
| Postal code | The one of their tax address (domicilio fiscal) |
| Tax regime (régimen fiscal) | Only the ones that match their type of taxpayer are shown |
| CFDI use (uso del CFDI) | Only the ones allowed for their tax regime are shown |
| Optional: so the invoicing provider can email them their invoice |
- Card payments: the portal asks "How did you pay?" (credit or debit), because Shopify doesn't say. If your customer doesn't answer, 04 Tarjeta de crédito (credit card) is used. You can remove the question in Settings: "Ask card payers whether they paid by credit or debit".
- Their details: Toldo stores the details your customer enters, encrypted, to issue their invoice and so they can correct them if the SAT rejects them, and sends them to the invoicing provider when stamping. If your customer asks for them to be deleted, they're deleted; the stamped XML is kept.
Which orders can be invoiced
- Paid orders that aren't test orders and that aren't cancelled or fully refunded.
- Within the deadline to request an invoice: 30 days after payment, or the number you choose (up to 365) in "Days after purchase a customer can still ask". It never goes past the end of March of the following year.
Payment form
Toldo takes the payment form (forma de pago) from your payment gateway:
| Payment | Payment form on the CFDI |
|---|---|
| Card (Shopify Payments, Stripe, Conekta, Openpay and Clip) | 04 Tarjeta de crédito (credit card) or 28 Tarjeta de débito (debit card), depending on your customer's answer |
| Mercado Pago | The portal asks "How did you pay?"; with no answer, 31 Intermediario pagos (payment intermediary) |
| OXXO or cash | 01 Efectivo (cash) |
| SPEI or bank transfer | 03 Transferencia electrónica de fondos (electronic funds transfer) |
| PayPal | 06 Dinero electrónico (electronic money) |
| Buy now, pay later (Kueski, Aplazo) | 31 Intermediario pagos (payment intermediary) |
| Gift card | The one you choose in "For gift-card payments" (proposed: 05 Monedero electrónico) |
| Any other | The one you choose in "For payment gateways Toldo doesn't recognise". If you leave it on "Hold for review", the invoice waits for your review and the sale doesn't go into the global invoice |
Your own rules (for example, "bbva = 03") apply before this table.
If the details don't match the SAT
When the invoice is stamped, the name, RFC, tax regime and postal code are checked against the SAT's records. If something doesn't match, the portal says which detail to check, for example "The name doesn't match the one SAT has for this RFC." With Correct my data, your customer goes back to the filled-in form to correct it and try again.
If the sale is already in a global invoice
If your customer asks for their invoice after their sale went into a global invoice, Toldo does what the SAT requires: it issues the global invoice again without that sale, cancels the original with reason 04 and issues the invoice in your customer's name. If that global invoice already has credit notes, Toldo doesn't reissue it and the request doesn't go ahead: review it with your accountant. See Global invoice.
Customers abroad
A customer abroad without a Mexican RFC enters the generic RFC for foreign residents, XEXX010101000; the portal uses tax regime 616 and CFDI use S01. If the order ships abroad, the invoice waits for your review, because Toldo doesn't issue the foreign trade supplement (complemento de comercio exterior) yet. Meanwhile, your customer sees "The store is reviewing your request. You'll be able to download your factura here."
Steps your customer follows
- Open the portal. From the link in their order email or from your store's page.
- Enter their tax details. Exactly as they appear on their Constancia de Situación Fiscal.
- Send their request. With Request factura. Under "Your request" they see the status of their invoice; the page refreshes on its own.
- Download their invoice. Under "Your factura is ready", with the Download buttons. If they left their email, they also get it by email.
To see an invoice that was already issued
Asking for an invoice the first time only takes the order. To see or download it again from the portal, your customer first enters the RFC it was issued to:
- The order's page only says "This order already has a factura". The folio fiscal and the Download buttons appear once the right RFC is entered.
- The same goes for a request in progress: to see its status from the order's page, your customer enters the RFC it was requested with.
- If the invoice was issued to the generic RFC for foreign buyers (XEXX010101000), which every buyer abroad shares, the portal also asks for the name exactly as it appears on the invoice.
- If the details don't match, the portal gives the same answer in every case and limits the attempts.
An order number and a total aren't secrets, and the invoice carries your customer's RFC and name: that's why they aren't enough to show it again. The download link your customer gets by email keeps working without this step.
Frequently asked questions
Does my customer need to create an account?
No. The link in their order email is enough. If they come through your store's page, they use their order number and the total, or their email.
Do Mercado Libre sales use this portal?
No. The portal doesn't invoice the orders Toldo imports from a marketplace (Mercado Libre, Amazon Mexico or Coppel): it asks your customer to request their invoice on the marketplace. See Who invoices your Mercado Libre sales?.
What if the PDF doesn't show yet?
The stamped XML, which is the legal invoice, is stored as soon as it's stamped. If the invoicing provider doesn't hand over the PDF at that moment, Toldo asks for it again on its own, at growing intervals, for about ten hours; as soon as it arrives, it shows next to the XML, in the portal and on the invoice's page in Toldo.
What language is the portal in?
Spanish. There's an English version, but the portal has no language switcher: it only appears if the link ends in ?lang=en.