uuid.mx

Timbrado CFDI
desde tu sistema.

Crea tu cuenta, activa el sandbox y timbra en minutos.

CFDI 4.0 · multi-RFC · sin anualidades · sin caducidad.

Sandbox activo · Producción activa

// Quickstart

Comienza en 30 segundos

Genera tu API key en el portal y mándala como Bearer en cada request. Sin SDKs, sin abstracciones raras.

POST /timbrar Emite un CFDI 4.0 en JSON 
# 1. Timbrar — manda tu CFDI como JSON
curl -X POST https://api.uuid.mx/v1/timbrar \
  -H 'Authorization: Bearer uuid_sandbox_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "Version": "4.0",
    "Serie": "F",
    "Folio": "001",
    "Emisor": { "Rfc": "EKU9003173C9", ... },
    "Receptor": { "Rfc": "URE180429TM6", ... },
    "Conceptos": [ ... ]
  }'

# Respuesta — uuid, sello SAT, XML completo y QR
{ "data": { "uuid": "283278da-b743-...", ... } }
POST /cancelar Cancela un CFDI vigente 
# 2. Cancelar — por UUID y motivo (catálogo SAT)
curl -X POST https://api.uuid.mx/v1/cancelar \
  -H 'Authorization: Bearer uuid_sandbox_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "rfc": "EKU9003173C9",
    "uuid": "283278da-b743-48bc-8001-62ce33471607",
    "motivo": "02",
    "folioSustitucion": ""
  }'
POST /prefacturar NUEVO Prefactura self-service 
# 3. Prefacturar — genera una prefactura SIN el RFC del cliente.
#    Mandas el mismo CFDI de siempre pero SIN Receptor, mas tu propia
#    referencia (ticket, orden, folio). Recibes un link con QR: el cliente
#    lo escanea, captura la referencia y sus datos fiscales, y uuid.mx
#    timbra. Ideal para gasolineras, restaurantes y farmacias.
curl -X POST https://api.uuid.mx/v1/prefacturar \
  -H 'Authorization: Bearer uuid_sandbox_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "referencia": "A-1042",
    "vigenciaSegundos": 86400,
    "cfdi": {
      "Emisor": { "Rfc": "TU_RFC", "RegimenFiscal": "601" },
      "Conceptos": [ ... ],
      "Total": "1250.00"
    }
  }'

# Respuesta — imprime url (o el QR) y la referencia en el ticket
{
  "data": {
    "prefacturaId": "pf_K7M2QX9B4T",
    "referencia": "A-1042",
    "url": "https://facturar.uuid.mx/K7M2QX9B4T",
    "qrUrl": "https://facturar.uuid.mx/qr/K7M2QX9B4T.png",
    "estado": "pendiente",
    "expiraEn": "2026-09-26T18:00:00Z",
    "creadoEn": "2026-09-25T18:00:00Z"
  }
}

# El CFDI te llega al webhook que configuras UNA vez en el portal
# (evento prefactura.timbrada), no por request.
Documentación completa →

// Para agentes

Tu agente integra y depura solo

Conecta Claude Code, Cursor o cualquier agente compatible con MCP a uuid.mx. Tu agente timbra en sandbox, lee lo que se envió y lo que respondió el SAT en cada petición, corrige y reintenta, sin que tengas que abrir el portal.

MCP https://api.uuid.mx/mcp NUEVO Con tu misma API key 
# Claude Code — la key se guarda en tu usuario, no en el repo
claude mcp add --transport http uuidmx https://api.uuid.mx/mcp \
  --header 'Authorization: Bearer uuid_sandbox_...'

# Cursor (.cursor/mcp.json) — la key sale de tu entorno: export UUID_API_KEY=uuid_sandbox_...
{ "mcpServers": { "uuidmx": {
    "url": "https://api.uuid.mx/mcp",
    "headers": { "Authorization": "Bearer ${env:UUID_API_KEY}" }
} } }

No pegues tu key directo en un mcp.json del proyecto: se va al repo con el siguiente commit. Usa la variable de entorno, como arriba. Revisa la configuración para otros agentes →

// Integrar

Integra el timbrado CFDI 4.0 de uuid.mx en este proyecto. Parte de la plantilla de factura global, timbra una de prueba en sandbox y, si falla, revisa el evento de esa petición hasta que salga.

obtener_plantilla · timbrar · ver_evento
// Depurar

Revisa el request 65983fe2-0585-4af4-a6dd-980e2ba82f92 de uuid.mx. Dime por qué falló y qué campo del CFDI tengo que corregir.

buscar_eventos · ver_evento
// Seguir una factura

¿Qué pasó con la factura eb726f5f-6ab7-4da0-8168-ee5816b98e74? Dame su historia en uuid.mx y confirma si sigue vigente en el SAT.

buscar_eventos · consultar_estatus_sat
Con key de sandbox Timbra, cancela y prefactura sin costo, y revisa cada petición para depurar.
Con key de producción Solo consulta: revisa qué pasó con un request o una factura, pero no puede emitir ni cancelar.
Guía completa del MCP →

// Autofacturación

Dale a tus clientes autofacturación en una línea de código

Genera una prefactura sin pedirle el RFC al cliente. Comparte el link o QR, él captura sus datos y uuid.mx timbra en automático. Tú recibes el CFDI por webhook.

// 01

Gasolineras

Nadie se baja de la bomba a dictar su RFC. Imprime el QR en el ticket y el conductor factura desde su celular.

// 02

Restaurantes

Ponlo en el ticket o en la cuenta digital. El comensal factura cuando se acuerda, ya sin estar ahí.

// 03

Farmacias

Gastos médicos deducibles sin detener la fila para capturar datos fiscales.

También en hoteles, estacionamientos, talleres, tiendas de conveniencia y retail: donde pedir el RFC en el mostrador detiene la línea.

// Lo que incluye

Sin sorpresas

✓Timbres multi-RFC — un solo paquete sirve para todos tus emisores
✓Sin vigencia — los timbres no caducan
✓Cancelaciones no se descuentan del volumen
✓Cualquier CFDI: nómina, facturas, complementos de pago, carta porte
✓Ambiente de pruebas sin costo
✓Soporte técnico incluido
✓PDF personalizado con tu logotipo y colores
✓1 año de almacenamiento incluido
✓El registro de cada petición: lo que enviaste y lo que respondió el SAT
✓Servidor MCP para que tu agente de IA integre y depure

// Precios

Pagas lo que timbras

Sin anualidades. Sin Caducidad. Sin contrato forzoso.

* Los precios ya incluyen IVA.

250 timbres
$1,000
$4.00 / timbre
Empezar
1,000 timbres
$3,000
$3.00 / timbre
Empezar
2,000 timbres
$5,500
$2.75 / timbre
Empezar

¿Haces timbrado masivo?

Tenemos precios especiales por volumen — escríbenos a ventas@uuid.mx y te armamos un plan a la medida.

Empieza a timbrar hoy.

Crea una cuenta gratis y prueba el sandbox sin costo.

Crear cuenta →