El 30 de mayo de 2025, el SAT puso en marcha la versión 1.5 de su Web Service para la descarga masiva de CFDI. Esta nueva versión incorpora funciones adicionales, mejora la velocidad de los procesos y soluciona errores de versiones anteriores.

El objetivo principal de esta actualización es facilitar la recuperación masiva de archivos XML para los contribuyentes.

En este artículo, te explicamos los cambios más importantes y cómo prepararte para implementarlos correctamente.

¿Qué es la Descarga Masiva de XML del SAT?

La descarga masiva de XML es una funcionalidad que permite a los contribuyentes obtener múltiples CFDI desde los servidores del SAT mediante servicios web automatizados.

Esta herramienta es especialmente útil para empresas, contadores y desarrolladores que necesitan acceder a grandes volúmenes de facturas emitidas o recibidas, ya sea para fines contables, fiscales o de auditoría.

Generalidades de la Versión 1.5 del Web Service SAT

La nueva versión del Web Service fue documentada para entrar en producción el 30 de mayo de 2025. Las especificaciones técnicas han sido actualizadas para reflejar los siguientes cambios clave:

• Antigüedad de comprobantes permitida: Ahora se pueden solicitar CFDI o metadata con una antigüedad de hasta cinco ejercicios fiscales más el año en curso.
• Autenticación segura: Se mantiene el uso de la e.firma para autenticar al solicitante. El sistema utiliza un token bajo el estándar WS-Security 1.0, que debe enviarse en el encabezado HTTP con el formato Authorization: WRAP access_token=”Token”.
• Soporte ampliado de complementos y tipos de comprobante: La versión 1.5 es compatible con la estructura y complementos de CFDI 4.0, permitiendo filtrar por tipo de comprobante—I (Ingreso), E (Egreso), T (Traslado), N (Nómina), P(Pago)—o solicitar todos si se deja nulo el campo correspondiente.

Cambios en el Servicio de Solicitud de Descarga Masiva

Uno de los aspectos más importantes en esta versión es la introducción de una nueva operación denominada SolicitudDescargaFolio().

Esta operación permite solicitar la descarga específica de un CFDI mediante su folio fiscal (UUID), brindando mayor precisión en los procesos de recuperación individual.

Detalles de esta Nueva Operación:

• Parámetros requeridos: Folio y RfcSolicitante, que deben firmarse ordenados alfabéticamente.
• Respuesta: El servicio devuelve un IdSolicitud, un CodEstatus y un Mensaje.
• Nuevo código de error:
• 5012 – No se permite la descarga de XML cancelados bajo esta operación.

Actualizaciones en Parámetros Existentes:

• SolicitaDescargaEmitidos(): Ahora permite incluir hasta cinco RFC receptores por solicitud.
• SolicitaDescargaRecibidos(): Para solicitudes de metadata, se incluyen comprobantes vigentes y cancelados. En cambio, para la descarga de XML, solo se incluyen los vigentes. El sistema da la opción de enviar el estado Todos, Vigentes o Cancelados. Sin embargo, si elegimos las opciones Todos o Cancelados, el sistema marca el error 301 – XML Mal Formado. Solo podemos realizar la descarga al seleccionar la opción Vigentes.
• Se reitera la importancia de ordenar alfabéticamente los atributos dentro de la cadena de firma para asegurar la validación correcta.

Verificación de Solicitudes de Descarga

La operación de verificación también se ha robustecido. Ahora incluye mensajes de error más precisos que permiten identificar problemas específicos durante el seguimiento de una solicitud:

• 5003 – Tope máximo de elementos de consulta: Se excede el número máximo de resultados permitidos.
• 5011 – Límite de descargas por folio por día: Indica que ya se alcanzó el número máximo de descargas diarias permitido para un folio. De momento, la documentación liberada por parte del SAT no ha especificado cuál es el límite de descargas por folio por día. Esperamos que esta situación se aclare a la brevedad, pero nosotros asumimos que, si no se ha aclarado el límite, es porque no se ha cambiado de la versión anterior a esta.

Descarga de Paquetes

Una vez que la solicitud se ha procesado exitosamente, los paquetes resultantes se pueden descargar. No obstante, también aquí se han implementado reglas estrictas de control para evitar el uso indebido o sobrecarga del servicio.

Códigos de Error Destacados:

• 5007 – No existe el paquete solicitado: El paquete ha expirado (tienen una vigencia de 72 horas) o no fue generado.
• 5008 – Máximo de descargas permitidas: Cada paquete solo puede descargarse dos veces.

La operación devuelve el flujo de datos comprimido en un Paquete, así como un CodeEstatus y Mensaje en el encabezado de respuesta SOAP.

Recomendaciones para Contribuyentes y Desarrolladores

Ante estos cambios, es importante que las empresas, contadores y proveedores de software contable tomen las siguientes medidas:

• Actualizar sus sistemas de integración para alinearse con la versión 1.5.
• Revisar cuidadosamente la documentación técnica proporcionada por el SAT.
• Automatizar procesos de autenticación y solicitud para evitar errores humanos.
• Controlar los límites de descarga para no rebasar los topes diarios o por paquete.
• Mantener la seguridad de certificados y credenciales utilizados en las peticiones.

Conclusión

La versión 1.5 del Web Service SAT para la descarga masiva de XML representa un avance importante en términos de funcionalidad, control y seguridad.

Aunque implica ajustes técnicos para su adopción, también abre la puerta a una gestión más eficiente de los CFDI.

Es importante comprender sus parámetros y operar dentro de sus límites para sacar el máximo provecho de esta herramienta oficial.

Acciones Implementadas a eComprobante

En respuesta a estos recientes cambios, en dSoft procedimos de inmediato a actualizar nuestras soluciones eComprobante COM Ver. 1.0.0.19 y eComprobante EXE Ver. 1.0.1.113. El objetivo fue asegurar la continuidad del servicio y reducir al mínimo cualquier posible afectación para ustedes.

Esta actualización contempla la integración de los nuevos métodos de solicitud de CFDI vía Web Service, conforme a las disposiciones actuales del SAT.

Adicional a ello, debido a que nuestro equipo de expertos también identificó modificaciones de diseño en el portal de descarga del SAT, actualizamos el proceso “Descarga CFDI 500+” para alinearse con los cambios en el diseño y estructura del portal.

Reiterando nuestro compromiso con ustedes, les informamos que estas mejoras están incluidas sin costo extra para todos los clientes con póliza vigente. Nuestro propósito es asegurar un servicio que se adapte a las actualizaciones de las plataformas oficiales, manteniendo su operación continua y actualizada.

Si tienen dudas o requieren asistencia, pueden contactar a nuestro equipo de soporte para brindarles ayuda.