Descarga Masiva de XML Web Service SAT versión 1.5 – Resúmen de los importantes cambios realizados por el SAT en su página.

Aquí tienes un resumen de los cambios y características clave de la Versión 1.5 de los Web Services de Descarga Masiva del SAT, recuerda que ya tenemos actualizado nuestro famoso programa de Descarga Masiva de XML desde la página del SAT.

Generalidades de la Actualización Web Service del SAT Versión 1.5:

• Fecha de entrada en producción: La Versión 1.5 de los Web Services de Descarga Masiva de CFDI y Retenciones (Descarga Masiva de Terceros) está documentada para entrar en producción a partir del 30 de mayo de 2025.
• Documentación: Se han actualizado los documentos técnicos para reflejar esta nueva versión.
• Antigüedad de Comprobantes: El servicio de solicitud permite pedir CFDI o Metadata con una antigüedad de hasta cinco ejercicios fiscales más el año en curso.
• Autenticación Consistente: El mecanismo de autenticación sigue utilizando la e.firma (Firma Electrónica) y cumple con las especificaciones de Web Services Security v1.0 (WS-Security 2004). Se obtiene un token que luego se usa en las llamadas a los servicios de solicitud, verificación y descarga. El token se envía en el header Authorization con el formato WRAP access_token="Token".

1. Servicio de Solicitud de Descarga Masiva (Versión 1.5) * Nueva Operación SolicitaDescargaFolio:

* Permite solicitar la descarga de un CFDI específico utilizando su Folio Fiscal (UUID).

* Requiere los parámetros: Folio (del CFDI) y RfcSolicitante. * La firma de la petición para esta operación debe incluir estos dos atributos ordenados alfabéticamente.

* Devuelve un IdSolicitud, CodEstatus y Mensaje.

* Nuevo código de error específico: «5012 – No se permite la descarga de xml que se encuentren cancelados» para esta operación.

* Parámetros Actualizados en SolicitaDescargaEmitidos y SolicitaDescargaRecibidos:

* RfcReceptor (en SolicitaDescargaEmitidos): Permite un máximo de 5 RFCs receptores.

* Complemento: Se actualizó la lista de complementos de CFDI que se pueden descargar, incluyendo los vigentes para la versión 4.0 del CFDI.

* EstadoComprobante (en SolicitaDescargaRecibidos):

* Para metadata, se incluirán comprobantes vigentes y cancelados.

* Para descarga de XML, solo se incluirán los vigentes; no se descargarán XML de comprobantes recibidos cancelados.

* Signature: Se reitera que la petición (los atributos del nodo solicitud) debe ordenarse alfabéticamente para la correcta validación de la firma. Se especifican los atributos a incluir en la cadena de firma para cada operación.

* Tipos de Comprobante (parámetro TipoComprobante): Se pueden especificar I (Ingreso), E (Egreso), T (Traslado), N (Nómina), P (Pago). Si es nulo, se obtendrán todos los tipos.

2. Servicio de Verificación de Descarga Masiva (Versión 1.5)

* Nuevos Códigos de Estatus/Mensajes de Error (para la petición de verificación):

* 5003 – Tope máximo de elementos de la consulta: Indica que la solicitud sobrepasa el máximo de resultados permitidos por tipo (Metadata o CFDI).

* 5011 – Límite de descargas por folio por día: Se ha alcanzado o sobrepasado el límite de descargas diarias por folio.

* Parámetros de Salida Detallados:

* EstadoSolicitud: Indica el estado de la solicitud de descarga (1: Aceptada, 2: En Proceso, 3: Terminada, 4: Error, 5: Rechazada, 6: Vencida – 72 horas después de generarse el paquete).

* CodigoEstadoSolicitud: Código de estado de la solicitud de descarga original (ej. «5000»).

* NumeroCFDIS: Número de CFDI que conforman la solicitud de descarga. * IdsPaquetes: Se devuelve una lista con los identificadores de los paquetes si la solicitud está «Terminada».

3. Servicio de Descarga de Solicitudes Exitosas (Descarga Masiva) (Versión 1.5)

* Códigos de Estatus/Mensajes de Error (para la petición de descarga del paquete):

* 5007 – No existe el paquete solicitado: Ocurre si no se encuentra el paquete o si ya expiró. Los paquetes tienen una vida de 72 horas.

* 5008 – Máximo de descargas permitidas: Un paquete solo puede descargarse un máximo de 2 veces.

* Salida: La operación Descargar devuelve el stream del paquete (Paquete) y también un CodEstatus y Mensaje en el Header de la respuesta SOAP.

4. URLs de los Servicios (Versión 1.5)

* El documento 0_UR_Ls_WS_Descarga_Masiva_V1_5_VF especifica las URLs productivas para esta versión. Se utilizan dominios bajo clouda.sat.gob.mx y hay rutas distintas para los servicios de CFDI y los de Retenciones, abarcando Autenticación, Solicitud, Verificación y Descarga.

    * **CFDI:**
        * Autenticación: `https://cfdidescargamasivasolicitud.clouda.sat.gob.mx/Autenticacion/Autenticacion.svc` [cite: 201]
        * Solicitud: `https://cfdidescargamasivasolicitud.clouda.sat.gob.mx/SolicitaDescargaService.svc` [cite: 201]
        * Verificación: `https://cfdidescargamasivasolicitud.clouda.sat.gob.mx/VerificaSolicitudDescargaService.svc` [cite: 201]
        * Descarga: `https://cfdidescargamasiva.clouda.sat.gob.mx/DescargaMasivaService.svc` [cite: 201]
    * **Retenciones:**
        * Autenticación: `https://retendescargamasivasolicitud.clouda.sat.gob.mx/Autenticacion/Autenticacion.svc` [cite: 201]
        * Solicitud: `https://retendescargamasivasolicitud.clouda.sat.gob.mx/SolicitaDescargaService.svc` [cite: 201]
        * Verificación: `https://retendescargamasivasolicitud.clouda.sat.gob.mx/VerificaSolicitudDescargaService.svc` [cite: 201]
        * Descarga: `https://retendescargamasiva.clouda.sat.gob.mx/DescargaMasivaService.svc` [cite: 201]

Estos son los cambios y puntos más destacados de la versión 1.5. Es una actualización importante, especialmente con la nueva operación de descarga por folio y las clarificaciones en los límites y manejo de errores.