Integra el SAT a tu software en días, no en meses.
Descarga masiva de CFDI, sincronización automática, catálogos SAT, webhooks y API REST empresarial. Una sola integración para todos los RFC que administra tu producto.
- API REST
- Alta disponibilidad
- Webhooks
- Multiempresa
- OAuth 2.0
- Escalable
Grupo Constructor Norte
AAA010101AAA
Logística Peninsular
BBB020202BB1
Distribuidora Bajío
CCC030303CC2
Servicios Industriales MTY
DDD040404DD3
El problema
Integrar el SAT no debería ser parte de tu negocio.
Todo equipo que conecta con el SAT termina construyendo la misma infraestructura: autenticación con e.firma, descargas asíncronas, desempaquetado de ZIP, parseo de XML y catálogos que cambian sin aviso. Es trabajo que no diferencia tu producto y que nunca termina.
Autenticación y e.firma
Firmar la petición SOAP con el certificado del contribuyente, manejar la vigencia y renovar el token antes de que expire a mitad de un proceso.
Descargas asíncronas
El SAT acepta la solicitud y responde después: a veces en minutos, a veces en horas. Tu sistema necesita esperar sin bloquearse y sin perder el hilo.
Polling y límites
Consultar el estado con la cadencia correcta, respetar los topes de solicitudes por día y degradar con elegancia cuando el servicio del SAT no responde.
ZIP y XML
Desempaquetar, detectar codificación, tolerar BOM, resolver namespaces y sobrevivir a comprobantes que no cumplen del todo con el esquema.
CFDI 3.3, 4.0 y complementos
Dos versiones vigentes en la práctica, más complementos de pagos, nómina y comercio exterior, cada uno con su propia estructura.
Catálogos que cambian
Claves de producto y servicio, regímenes y formas de pago se actualizan sin previo aviso. Un catálogo viejo produce validaciones que fallan en silencio.
Cambios del SAT
Ajustes de esquema, de endpoint o de reglas de validación llegan con poco margen. Alguien de tu equipo tiene que estar pendiente.
Mantenimiento permanente
Nada de lo anterior se construye una vez. Es una superficie viva que compite por el tiempo del equipo con el producto que sí vendes.
Cluum absorbe esas ocho capas y expone una sola: una API REST estable, versionada y documentada.
Cuando el SAT cambia un esquema, publica un catálogo nuevo o su servicio se degrada, el ajuste ocurre de nuestro lado del contrato. Tu integración no se entera y tu equipo no vuelve a abrir ese código.
Plataforma
Todo lo que necesitas del SAT, detrás de un solo contrato.
Ocho capacidades que resuelven el ciclo completo: obtener los comprobantes, entenderlos, mantenerlos al día y poder demostrar de dónde salieron.
Descarga masiva de CFDI
Emitidos y recibidos, por rango de fechas o por UUID. Cluum administra el ciclo completo de la descarga masiva del SAT —solicitud, verificación, reintentos— y te entrega el resultado ya listo.
CFDI normalizado
El XML llega parseado a un esquema estable: comprobante, emisor, receptor, conceptos línea por línea, impuestos y complementos. Sin desempaquetar ZIP ni pelear con namespaces.
Catálogos SAT sincronizados
Claves de producto y servicio, unidades, formas y métodos de pago, regímenes fiscales y códigos postales. Los mantenemos al día contra las publicaciones del SAT; tú sólo consultas.
API REST predecible
Recursos coherentes, paginación por cursor, errores tipados y códigos HTTP correctos. Diseñada para que un backend la consuma sin envolverla en capas de defensa.
Webhooks firmados
La descarga del SAT es asíncrona; tu integración no debería hacer polling. Te avisamos cuando hay resultado, con firma HMAC, reintentos con backoff y entrega idempotente.
Multiempresa por diseño
Un solo contrato con Cluum para todos los RFC que administra tu software. Aislamiento por tenant, credenciales por empresa y alcance explícito en cada llave de API.
Versionado con contrato
La versión va en la ruta y los cambios que rompen compatibilidad estrenan versión nueva. Las versiones anteriores conservan soporte y ventana de migración anunciada.
Trazabilidad completa
Cada solicitud, descarga y entrega de webhook queda registrada con marca de tiempo y actor. Cuando el área fiscal pregunte de dónde salió un comprobante, hay respuesta.
Cómo funciona
Cuatro pasos. Uno solo es tuyo.
Tu equipo escribe la primera llamada y el manejador del webhook. Lo que ocurre en medio —la parte que cambia, falla y se degrada— corre por nuestra cuenta.
01
Tu ERP
Tu sistema solicita la sincronización de un RFC y un periodo con una llamada HTTP.
02
Cluum Fiscal API
Firmamos con la e.firma, encolamos, reintentamos y vigilamos el ciclo asíncrono completo.
03
SAT
El servicio de descarga masiva procesa la solicitud y libera los paquetes cuando están listos.
04
Tu base de datos
Recibes un webhook firmado con los CFDI ya normalizados, listos para escribir.
Desarrolladores
Dos funciones y estás sincronizando.
Una llamada para pedir el periodo y un manejador para recibir el resultado. No hay SOAP, ni certificados en tu servidor, ni una máquina de estados que mantener.
Creas la solicitud de descarga. Responde 202 de inmediato: el SAT tarda lo que tarda.
Recibes el webhook descarga.completada, firmado con HMAC y con entrega idempotente.
import { Cluum } from '@cluum/fiscal'
const cluum = new Cluum(process.env.CLUUM_API_KEY)
// El SAT resuelve en asíncrono: esto encola la solicitud y regresa de inmediato.
const descarga = await cluum.descargas.crear({
rfc: 'AAA010101AAA',
tipo: 'recibidos',
periodo: { desde: '2026-01-01', hasta: '2026-01-31' },
})
console.log(descarga.id) // "dsc_8f2c1a4e9b"
console.log(descarga.estado) // "en_proceso"→Minutos después, en tu endpoint de webhooks:
{
"id": "evt_3d9a71c5f0",
"tipo": "descarga.completada",
"creado_en": "2026-02-03T09:31:07Z",
"datos": {
"descarga_id": "dsc_8f2c1a4e9b",
"rfc": "AAA010101AAA",
"estado": "completada",
"comprobantes": 1284,
"paquetes": [
{ "id": "pkg_a71f", "comprobantes": 1000 },
{ "id": "pkg_b32e", "comprobantes": 284 }
]
}
}Casos de uso
Quién construye sobre Cluum.
El mismo contrato de API sostiene productos muy distintos. Lo que cambia es qué haces con los comprobantes una vez que llegan limpios a tu base de datos.
Conciliación de compras sin captura
Los CFDI recibidos entran directo al módulo de cuentas por pagar y se cruzan contra órdenes de compra. Se acaba la captura manual de facturas de proveedor.
Historial de facturación en la ficha del cliente
Cada cuenta muestra lo realmente facturado y cobrado, tomado de la fuente fiscal y no de lo que alguien anotó en una nota.
Evaluación de crédito con datos verificables
Ingresos y flujo comprobados contra CFDI timbrados, con consentimiento del contribuyente. Suscripción con evidencia en lugar de estimación.
Cierre mensual sin descargas manuales
La contabilidad del periodo se arma con los comprobantes ya sincronizados. El despacho deja de vivir en el portal del SAT.
Cientos de RFC bajo un mismo tablero
Alta de clientes por API y sincronización desatendida por cada RFC administrado, sin abrir una sesión por contribuyente.
Gasto e ingreso reales como fuente de datos
Conceptos línea por línea alimentan tableros de compras, proveedores y categorías de gasto con granularidad de partida.
Evidencia con trazabilidad
Comprobantes con su cadena de origen y bitácora de acceso, listos para sustentar una revisión interna o una auditoría externa.
Validación contra la realidad del SAT
Contrasta lo que tu sistema emitió contra lo que efectivamente quedó timbrado y detecta faltantes o cancelaciones no reflejadas.
Beneficios
El costo real no es construirlo. Es mantenerlo.
Una integración con el SAT hecha en casa se entrega una vez y se paga todos los trimestres: cambios de esquema, catálogos nuevos, incidentes del servicio. Cluum convierte ese gasto recurrente en una dependencia estable.
Días
en lugar de meses
Una integración funcional en una tarde y en producción en días. Lo que normalmente toma un trimestre de trabajo dedicado.
0
mantenimiento del lado del SAT
Los cambios de esquema, catálogos y reglas los absorbemos nosotros detrás de un contrato de API que no se mueve.
1
integración para todos tus clientes
Conectas una vez y das de alta RFC por API. Cada cliente nuevo de tu software es un registro, no un proyecto.
SLA
con respaldo contractual
Disponibilidad comprometida por escrito, estado del servicio público y soporte con escalamiento para clientes de plataforma.
Documentación con ejemplos ejecutables, no sólo referencia generada.
Ambiente de pruebas con datos sintéticos desde el primer día.
Registro de cambios público y política de versionado por escrito.
Soporte técnico con escalamiento para clientes de plataforma.
Arquitectura
Qué corre de nuestro lado del contrato.
Las capas marcadas son responsabilidad de Cluum: las operamos, las monitoreamos y las actualizamos cuando el SAT cambia. Tu sistema sólo toca los extremos.
Cliente
Tu ERP, CRM, software contable o fintech.
- SDK oficial
- HTTP directo
API Gateway
Operado por Cluum
Frontera pública: autentica, limita y protege.
- TLS 1.3
- Llaves por alcance
- Límite de tasa
- Idempotencia
Cluum Fiscal API
Operado por Cluum
Contrato REST estable y versionado que aísla a tu código del SAT.
- REST v1
- Multi-tenant
- Paginación por cursor
- Errores tipados
Servicios internos
Operado por Cluum
Donde vive la complejidad que tu equipo ya no escribe.
- Cola de descargas
- Firmado con e.firma
- Parser CFDI
- Sync de catálogos
SAT
Servicio de descarga masiva. Asíncrono y fuera de nuestro control.
- SOAP
- Reintentos con backoff
- Tolerancia a caídas
Webhooks
Operado por Cluum
Cerramos el ciclo notificando a tu sistema, no al revés.
- Firma HMAC
- Reintentos
- Entrega idempotente
Tu base de datos
CFDI normalizados escritos donde tu producto los necesita.
- JSON normalizado
- XML original
Preguntas
Lo que preguntan los equipos técnicos.
Si falta algo, escríbenos a hola@cluum.mx. Responde alguien que conoce la integración, no un formulario.
¿Listo para dejar de mantener integraciones con el SAT?
Agenda una llamada técnica de 30 minutos. Revisamos tu arquitectura, te damos acceso al ambiente de pruebas y sales con una estimación real de integración.
Ambiente de pruebas sin costo · Sin cargo por integración inicial