Issue Facturama CFDI invoices from a list of jobs

1. You sign in to Facturama in the browser (Iniciar sesión) with the account that holds your invoicing folios.
2. You find the client in your client catalog, which Facturama keeps so you can invoice quickly, or add the client first.
3. You add the product or service lines, check the amounts and issue the CFDI 4.0 invoice, which Facturama stamps for the SAT.
4. You send the invoice to the client by email from Facturama and download the PDF and XML if you want your own copy.
5. You repeat this for every client, and a skipped row is a late invoice.

Here are this week's finished jobs. For each client, find them in Facturama (create the client if missing, and tell me), issue one CFDI invoice with 16% IVA, and email it to the client.

1. 01

   Match each client first

   The agent looks every client name up with list_clients. A name with no match or with two close matches goes on your list, and a client is created only when the RFC, name and tax details are in your prompt or files.

2. 02

   Check the receiver data

   Before stamping, the agent confirms that each client has an RFC, a CFDI use, a tax zip code and a fiscal regime, the fields Facturama's own invoice example sends for the receiver. A client missing one is reported instead of guessed.

3. 03

   Group rows into one invoice per client

   Rows for the same client share one invoice, each with its quantity and unit price. The agent adds the 16% IVA line you asked for and shows subtotal, tax and total for your OK before create_invoice runs.

4. 04

   Stamp, then read back the folio

   create_invoice stamps the invoice with the SAT, so there is no draft stage. The agent reports the series, folio and UUID Facturama returns for every invoice.

5. 05

   Email only after the stamp

   email_invoice runs for the invoices that were stamped, to the address you gave. A stamp that failed is reported once and never retried on its own.

Rows in the list: 3 across 2 clients
Stamped: 2
- Estudio Norte SA de CV: FAC-101, 2 x 500.00 + IVA 160.00 = 1,160.00 MXN
- Clinica Alba SC: FAC-102, 1 x 800.00 + IVA 128.00 = 928.00 MXN
Emailed: 2
Needs you: 0 clients with missing RFC or fiscal regime

curl -X POST https://cotlet.dev/api/v1/facturama/clients/cl_4821/invoices \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"description":"Design review hour","quantity":2,"unit_price":500,"tax_rate":0.16}],"payment_form":"transfer","payment_method":"single payment"}'

{
  "invoice_id": "Y61TLX-Ls_ZJFqzjanPN1w2",
  "series": "FAC",
  "folio": "101",
  "uuid": "6f1c2a90-3b7e-4d55-9a1e-0c52b8e4d7a1",
  "cfdi_type": "ingreso",
  "status": "issued",
  "issued_at": "2026-10-14T10:32:00-06:00",
  "client": {
    "client_id": "cl_4821",
    "rfc": "XAXX010101000",
    "name": "Estudio Norte SA de CV"
  },
  "items": [
    {
      "description": "Design review hour",
      "quantity": 2,
      "unit_price": 500,
      "subtotal": 1000,
      "tax_rate": 0.16,
      "tax": 160,
      "total": 1160
    }
  ],
  "subtotal": 1000,
  "tax_total": 160,
  "total": 1160,
  "currency": "MXN"
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is facturama_write → create_invoice. Example data.

• Issue Facturama credit notes for returns and discounts
• Collect your monthly Facturama CFDI XML and PDF files
• Facturama API and MCP server: every tool
• All use cases