El servicio de descarga masiva del SAT responde con códigos numéricos: 5000 es «solicitud aceptada», 5004 «no se encontró información», 5005 «solicitud duplicada», 5002 «se agotaron las solicitudes» y 301 «XML mal formado», que casi siempre es una fecha inválida. Ninguno es un error de tu e.firma; son respuestas del SAT a lo que pediste.
Cómo funciona el servicio, en dos líneas
La descarga masiva es un servicio web del SAT en cuatro pasos: te autenticas con tu e.firma, solicitas un rango de fechas (emitidos o recibidos), verificas hasta que el SAT termina de armar los paquetes y los descargas en ZIP. Cada paso tiene sus propios códigos de respuesta. Los de abajo son los que más confunden.
Los códigos de la solicitud
5000: solicitud aceptada
Todo bien. El SAT recibió tu solicitud y te dio un identificador. Ahora toca verificar hasta que esté lista; puede tardar de minutos a horas, y en temporadas de saturación, días.
5004: no se encontró la información
El rango que pediste no tiene comprobantes en el SAT. Dos causas: de verdad no hubo facturas en ese periodo, o las pediste demasiado pronto y el SAT todavía no las integra. El SAT puede tardar horas en reflejar una factura timbrada, así que para rangos recientes conviene volver a pedir más tarde.
5005: solicitud duplicada
Ya existe una solicitud idéntica (mismo RFC, mismas fechas, mismo tipo) en proceso o terminada. El SAT no la repite. La solución es recuperar el identificador de la solicitud original y seguir verificándola, o cambiar el rango de fechas.
5002: se han agotado las solicitudes de por vida
Es el límite de solicitudes para una misma combinación de parámetros. Aparece cuando un sistema pide una y otra vez exactamente el mismo rango. Cambia las fechas aunque sea por un minuto, y revisa por qué tu sistema repite solicitudes.
301: XML mal formado
El mensaje completo suele ser «la solicitud de descarga no es válida, fecha final inválida». Casi siempre es una fecha en el futuro: el SAT trabaja en hora del centro de México y si tu sistema manda la hora en UTC, por la tarde-noche la fecha final ya cae en «mañana». También aparece si la fecha final es menor que la inicial o si pides más de cinco años atrás.
Los códigos de la verificación y la descarga
- Estado 1 (aceptada), 2 (en proceso), 3 (terminada). Sigue verificando mientras esté en 1 o 2. Cuando llega a 3, la respuesta trae los nombres de los paquetes para descargar.
- Estado 4 (error) o 5 (rechazada). La solicitud no se pudo procesar. Vuelve a solicitar con un rango más corto.
- Estado 6 (vencida). Los paquetes estuvieron disponibles 72 horas y nadie los descargó. Hay que solicitar de nuevo.
- 404 o 500 al descargar. Es intermitente y suele ser saturación del SAT. Reintenta más tarde; el paquete sigue ahí hasta que venza.
Límites que conviene conocer
- Hasta 200,000 comprobantes por solicitud; si el rango trae más, el SAT la rechaza y hay que dividirla.
- Hasta cinco años hacia atrás más el ejercicio en curso.
- El SAT tiene hasta 48 horas para procesar y los paquetes duran 72 horas disponibles.
- Las cancelaciones de facturas recibidas no se pueden descargar como XML; se consultan por metadatos.
Preguntas frecuentes
¿El error 5004 significa que mi e.firma está mal?
No. Si llegaste a recibir un 5004 es porque la autenticación con tu e.firma funcionó. El código solo dice que no hay comprobantes para el rango que pediste.
¿Cada cuánto debo solicitar la descarga masiva?
Para mantenerte al día basta con unas pocas solicitudes al día con ventanas de dos o tres días que se traslapen. Pedir cada pocos minutos no trae facturas más rápido y provoca errores 5005 y 5002.
¿Por qué me rechaza con «fecha final inválida» solo por las noches?
Porque tu sistema manda la hora en UTC. A partir de las 18:00 hora de México, la hora UTC ya corresponde al día siguiente y el SAT la considera una fecha futura. Convierte las fechas a hora del centro de México antes de enviarlas.
Cómo lo resuelve Contapolis
Contapolis maneja estos códigos por ti: reintenta los errores intermitentes, evita las solicitudes duplicadas, manda las fechas en hora local y vuelve a cubrir las últimas 72 horas en cada corrida para no dejar huecos. Tú solo ves tus facturas en tu contabilidad.
Conecta tu e.firma y olvídate de los códigos.