SAT11 min de lectura
Descarga masiva de XML del SAT: guía práctica 2026
Descarga masiva de XML del SAT: cómo funciona el servicio web con e.firma, sus límites vigentes, el portal, el estatus de cancelación y cómo automatizarla.
Equipo Tecsolt

Para hacer la descarga masiva de XML del SAT tienes dos vías oficiales: el portal Consulta y recuperación de comprobantes, útil para pocos archivos, y el servicio web de descarga masiva, que con tu e.firma permite pedir por periodo los XML completos o la metadata de tus CFDI emitidos o recibidos, de los últimos cinco ejercicios más el año en curso. Automatizar la descarga consiste en que un programa haga esas solicitudes por ti, de forma programada, y guarde y valide los XML sin que entres al portal.
Esta guía explica cómo funciona el servicio web en su versión 1.5 (vigente desde el 30 de mayo de 2025), qué límites y reglas aplica el SAT, qué pasa con los CFDI cancelados, cómo organizar los XML para que sirvan de algo y qué conviene automatizar. Las reglas técnicas vienen de la documentación oficial del SAT, que enlazamos para que verifiques cualquier cambio. Si llevas la contabilidad de varios clientes, al final enlazamos la guía de automatización fiscal para despachos contables, que retoma estos XML para la conciliación y la DIOT.
Definición rápida: la descarga masiva de CFDI es la recuperación, desde los servidores del SAT, de todos los comprobantes que emitiste o recibiste en un periodo, en paquetes ZIP con los XML completos o con la metadata (un listado con UUID, RFC, montos, fechas y estatus de cada comprobante). Solo puede pedirla el emisor o el receptor de los CFDI.
¿Qué opciones da el SAT para descargar XML de forma masiva?
| Vía | Autenticación | Capacidad | Para quién |
|---|---|---|---|
| Portal Consulta y recuperación de comprobantes | Contraseña o e.firma | Descarga manual, por páginas y con límites de descarga | Negocios con pocas facturas al mes o consultas puntuales |
| Servicio web de descarga masiva (versión 1.5) | Solo e.firma | Solicitudes por periodo con un tope de resultados por solicitud (código 5003 si se excede) | Empresas con volumen, despachos con varios RFC, sistemas que necesitan los XML al día |
| Software comercial o desarrollo propio | Tu e.firma, a través del servicio web | La del servicio web, más la organización y validación que agregue el programa | Quien no quiere programar contra el SAT |
El portal funciona bien si emites y recibes unas decenas de facturas al mes. En cuanto hay varios RFC, cientos de proveedores o necesitas la información cada semana, los límites del portal y el trabajo manual (filtros, captcha, descargar por páginas) lo vuelven impráctico, y ahí entra el servicio web.
¿Cómo funciona el servicio web de descarga masiva?
El servicio web no es una página: es una API SOAP que un programa consume en cuatro pasos. La documentación técnica de la versión 1.5 está publicada por el SAT en tres documentos: solicitud, verificación y descarga de solicitudes exitosas.
- Autenticación. El programa firma una petición con la e.firma (certificado y llave privada) del contribuyente y recibe un token de corta duración. Sin token no hay acceso a los demás servicios.
- Solicitud. Se presenta la petición con tres operaciones posibles:
SolicitaDescargaEmitidos,SolicitaDescargaRecibidosoSolicitaDescargaFolio(un solo CFDI por su UUID, nueva en la versión 1.5). Se indica el rango de fechas, si quieres XML o metadata y filtros opcionales como estado del comprobante o RFC de la contraparte. El SAT responde con un identificador de solicitud. - Verificación. El programa consulta periódicamente el estado de la solicitud: aceptada, en proceso, terminada, error, rechazada o vencida. Cuando termina, el SAT devuelve los identificadores de los paquetes generados. El tiempo de respuesta no está garantizado: puede ir de minutos a horas según el volumen y la carga del SAT.
- Descarga. Cada paquete se descarga como un ZIP codificado en Base64, que contiene los XML o el archivo de metadata.
Lo importante para un negocio es que el proceso es asíncrono: pides hoy y recibes después. Por eso la automatización tiene sentido: un programa puede presentar las solicitudes de madrugada, verificar cada cierto tiempo y descargar en cuanto el SAT termina, sin que nadie esté pendiente.
¿Qué límites y reglas tiene la descarga masiva en 2026?
Estas son las reglas que vienen en la documentación vigente del SAT. Las tienes que conocer tanto si programas tu propia integración como si evalúas un software.
| Regla | Qué dice el SAT | Qué implica |
|---|---|---|
| Antigüedad | Comprobantes de hasta cinco ejercicios más el año en curso | Lo más antiguo debe estar en tus respaldos |
| Volumen por solicitud | Hay un tope máximo de resultados por solicitud, para CFDI y para metadata; si se excede, código 5003 | Divide periodos grandes (por mes, semana o día) |
| Solicitudes repetidas | Código 5002: “se han agotado las solicitudes de por vida” con el mismo criterio | No pidas el mismo periodo una y otra vez; guarda lo que descargas |
| Solicitud duplicada activa | Código 5005: ya existe una solicitud activa con los mismos criterios | Espera a que termine la anterior |
| Vida de los paquetes | Los paquetes duran 72 horas; después la solicitud aparece como vencida (código 5007 al descargar) | Descarga en cuanto la solicitud termine |
| Descargas por paquete | Cada paquete se puede descargar un máximo de dos veces (código 5008) | Verifica la integridad del ZIP antes de darlo por bueno |
| Descarga por folio | Límite diario de descargas por folio (código 5011) | No uses la descarga por UUID como sustituto de la descarga por periodo |
| Autenticación | Solo e.firma; un certificado revocado o caduco devuelve el código 304 | Vigila la vigencia de la e.firma de cada RFC |
Dos cambios de la versión 1.5 que rompieron integraciones antiguas, según reportó la comunidad que mantiene librerías abiertas como sat-ws-descarga-masiva de PhpCfdi: la fecha inicial debe ser estrictamente menor a la final (ya no se puede consultar un solo instante) y el límite inferior del periodo se calcula como la fecha actual menos seis años.
Con la regla de 5002, el diseño importa: un programa mal hecho que pide el mismo mes cada hora agota sus intentos y se queda sin poder repetir esa consulta. Un buen diseño pide periodos que no se traslapan, registra qué se pidió y qué se recibió, y solo vuelve a pedir lo que falta.
¿Qué pasa con los CFDI cancelados?
Este es el punto que más confunde, y el que más impacto tiene en la contabilidad.
- CFDI emitidos: la operación
SolicitaDescargaEmitidospermite descargar comprobantes vigentes y cancelados. - CFDI recibidos:
SolicitaDescargaRecibidosentrega metadata de vigentes y cancelados, pero XML solo de vigentes. Si pides XML de recibidos sin filtrar por estado, el valor por defecto es “vigente”. La descarga por folio de un XML cancelado devuelve el código 5012.
En la práctica significa dos cosas. Primero, si un proveedor cancela una factura antes de que la descargues, ya no vas a obtener su XML por el servicio web; solo verás en la metadata que existió y cuándo se canceló. Segundo, un XML que descargaste vigente puede cancelarse después, y tu copia local seguirá diciendo lo mismo, porque el XML no cambia: el estatus vive en el SAT.
Por eso la descarga no basta. Hay que revisar el estatus periódicamente, y hay dos formas oficiales:
- Metadata: cada registro trae el estatus del comprobante y, si aplica, la fecha de cancelación. Descargar la metadata del periodo y cruzarla contra tus XML es la forma más eficiente de detectar cancelaciones en bloque.
- Servicio de verificación de CFDI: el SAT ofrece una consulta pública de verificación por UUID, RFC emisor, RFC receptor y total, con su versión de servicio web, que devuelve si el comprobante está vigente o cancelado y su estatus de cancelación. Sirve para validar comprobantes uno por uno, por ejemplo antes de pagar a un proveedor.
Las reglas de quién puede cancelar, en qué plazo y cuándo se necesita aceptación del receptor las explicamos en cancelación de CFDI 4.0. Desde el lado del receptor, lo relevante es enterarte a tiempo: deducir o acreditar IVA con una factura cancelada es una diferencia que el SAT detecta sola.
¿Qué necesitas antes de automatizar?
- e.firma vigente de cada RFC. El servicio web no acepta contraseña ni Certificado de Sello Digital (CSD); usa el certificado
.cer, la llave.keyy su contraseña. El certificado de e.firma tiene vigencia de cuatro años: lleva un calendario de vencimientos, porque cuando caduca la descarga se detiene sin más aviso que un error 304. - Autorización por escrito si descargas para terceros. Si eres despacho, la e.firma es del cliente y equivale a su firma autógrafa. Pacta por escrito para qué la usas y cómo la resguardas.
- Un lugar seguro para la e.firma. Cifrada, con acceso restringido y bitácora. La documentación del SAT advierte que la e.firma no debe guardarse en el repositorio de llaves de un equipo que no sea propio.
- Un criterio de periodos. Por ejemplo: cada noche, emitidos y recibidos del día anterior; cada semana, metadata del mes en curso para revisar cancelaciones; al cierre, una verificación completa del mes.
- Un repositorio para los XML. Ver la siguiente sección.
¿Cómo organizar los XML descargados?
Mil XML en una carpeta de descargas no son información, son un problema. Una organización que funciona:
- Estructura por RFC, año, mes y tipo:
RFC/2026/10/emitidos/yRFC/2026/10/recibidos/, con cada archivo nombrado por su UUID. El UUID es único, así que evita duplicados de forma natural. - Índice en base de datos. Al guardar cada XML, extrae los datos clave (UUID, tipo de comprobante, emisor, receptor, fecha, subtotal, impuestos, total, método y forma de pago, uso de CFDI) a una tabla. Buscar “todas las facturas PPD de este cliente sin complemento de pago” debe ser una consulta, no abrir archivos.
- Estatus separado del XML. Guarda el estatus (vigente o cancelado) y la fecha de la última verificación en el índice, y actualízalo con la metadata.
- Relaciones. Liga los complementos de pago con las facturas PPD que liquidan, y las notas de crédito con las facturas que afectan. Es la base de la cartera y de la conciliación; el detalle del REP está en nuestra guía del complemento de pago.
- Respaldos fuera del equipo. Los XML son parte de tu contabilidad, que el Código Fiscal de la Federación (artículo 30) obliga a conservar por lo general cinco años. Aplica la regla de respaldos 3-2-1 y guárdalos en almacenamiento en la nube con versiones, no solo en una laptop.
Con los XML ordenados e indexados, todo lo demás se vuelve posible: preparar la DIOT a partir de los recibidos, revisar si algún proveedor aparece en la lista 69-B del SAT cruzando RFC, conciliar contra bancos o alimentar el sistema contable.
¿Qué conviene automatizar y qué no?
| Tarea | ¿Automatizar? | Por qué |
|---|---|---|
| Solicitudes periódicas por RFC | Sí | Es repetitiva y sigue reglas fijas |
| Verificación y descarga de paquetes | Sí | El SAT responde a destiempo y los paquetes vencen en 72 horas |
| Validación de estructura y deduplicación por UUID | Sí | Es determinística |
| Revisión de cancelaciones con metadata | Sí | Detecta en bloque lo que cambió después de descargar |
| Alertas de e.firma por vencer | Sí | Evita que la descarga se detenga en silencio |
| Clasificación contable de gastos | Parcial | Reglas para proveedores conocidos; lo nuevo requiere criterio o apoyo de IA con revisión |
| Decidir qué es deducible | No | Es criterio fiscal del contador |
La descarga, la validación y el control de estatus no necesitan inteligencia artificial: necesitan reglas exactas y repetibles. Donde la IA sí aporta (clasificar gastos, explicar diferencias) lo tratamos en IA para despachos contables.
¿Software comercial o integración propia?
Usa un software especializado si lo que necesitas es tener los XML de uno o varios RFC al día, buscarlos, ver su estatus y sacar reportes. Es la opción más rápida y barata, y te libera de seguir los cambios del SAT, que como mostró la versión 1.5, pueden romper integraciones de un día para otro. Al evaluar uno, pregunta cómo resguarda la e.firma, si descarga de forma programada, cómo maneja los cancelados y si puedes exportar tus XML en cualquier momento.
Desarrolla una integración propia cuando los XML deben entrar directamente a tu ERP o sistema contable, cuando hay reglas de negocio específicas (por ejemplo, ligar cada factura recibida con su orden de compra) o cuando manejas un volumen o un número de RFC que justifica tener el proceso en casa. En ese caso, la integración habla con el servicio web del SAT y con tus sistemas mediante APIs, y conviene apoyarse en librerías probadas en lugar de escribir el cliente SOAP desde cero.
Ambas opciones conviven bien: un servicio de descarga que expone los XML por API y un sistema propio que los consume.
Errores comunes al descargar XML del SAT
- Descargar solo al cierre de mes. Para entonces, algunas facturas recibidas ya se cancelaron y no podrás obtener su XML.
- Repetir solicitudes idénticas hasta toparse con el 5002.
- Pedir periodos enormes que exceden el tope por solicitud y regresan con 5003.
- No verificar el estatus después de descargar. El XML no te dice que fue cancelado.
- Dejar vencer la e.firma de un cliente y descubrirlo semanas después.
- Guardar la e.firma en una carpeta compartida sin cifrado ni control de acceso.
- No tener respaldo de los XML de ejercicios que ya salieron del rango de seis años del servicio web.
Cómo te ayuda Tecsolt
En Tecsolt desarrollamos Masiva CFDIs, nuestra plataforma de descarga masiva: registras cada RFC con su e.firma, programas descargas de emitidos y recibidos (hasta 200,000 CFDI por solicitud), y los XML quedan organizados con visor, PDF y búsqueda por UUID, RFC, monto o fecha. Además te avisa de cancelaciones, de proveedores en la lista 69-B y de la vigencia de tu e.firma, y en su plan Premium genera la DIOT a partir de tus XML. Tiene plan gratuito para una empresa; puedes probar Masiva CFDIs sin costo.
Si lo que necesitas es que los CFDI lleguen directo a tu ERP o a tu sistema contable, hacemos la integración a la medida dentro de nuestro servicio de facturación electrónica. Desarrollamos software desde junio de 2017, con más de 100 proyectos entregados, y el código y los accesos quedan a nombre de tu empresa. Agenda una reunión y revisamos tu flujo de CFDI.
Preguntas frecuentes
¿Cómo descargar de forma masiva los XML del SAT?
Hay dos caminos oficiales. En el portal de consulta y recuperación de comprobantes descargas a mano, con límites de descarga. Con el servicio web de descarga masiva, que exige e.firma, un programa presenta una solicitud por periodo, la verifica hasta que el SAT la termina y descarga los paquetes ZIP con los XML o la metadata.
¿Cuántos XML puedo descargar del SAT en una sola solicitud?
El servicio web tiene un tope de resultados por solicitud, distinto para XML y para metadata. Si el periodo lo excede, la verificación responde con el código 5003 (tope máximo de elementos de la consulta) y hay que dividirlo en periodos más cortos. El portal también limita la descarga, así que no sirve para volúmenes grandes.
¿Puedo descargar los XML de facturas canceladas?
De CFDI emitidos sí: el servicio web permite descargar vigentes y cancelados. De CFDI recibidos, la versión 1.5 solo entrega el XML de los vigentes; de los cancelados obtienes la metadata, que incluye el estatus y la fecha de cancelación. Por eso conviene descargar los XML de recibidos en cuanto se emiten.
¿Qué tan atrás puedo descargar mis CFDI?
La documentación del servicio web indica comprobantes con antigüedad de hasta cinco ejercicios más el año en curso. En la práctica, el SAT rechaza solicitudes cuya fecha inicial sea anterior a seis años contados desde la fecha actual. Si necesitas información más antigua, debe estar en tus propios respaldos.
¿Qué significa el error 5002 de la descarga masiva?
Significa que se agotaron las solicitudes de por vida para esos mismos criterios: el SAT limita cuántas veces puedes pedir exactamente el mismo periodo con los mismos filtros. La salida práctica es planear las solicitudes para no repetirlas y guardar bien lo descargado. Cambiar el rango de fechas genera una solicitud distinta.
¿Es legal usar un software para descargar mis XML del SAT?
Sí. El servicio web de descarga masiva es un mecanismo público del SAT y solo entrega comprobantes en los que el solicitante es emisor o receptor. El software que uses debe autenticarse con tu e.firma, así que revisa cómo la resguarda y quién tiene acceso a ella antes de contratarlo.
- #descarga masiva
- #xml sat
- #cfdi
- #e.firma
- #web service sat


