Si tu empresa procesa cientos o miles de comprobantes fiscales al mes, el portal web del SAT resulta insuficiente por el límite práctico de consultas y archivos. Por ello, contralores, TI y despachos usan el WebService oficial de Descarga Masiva de CFDI y Metadata.
La comunicación directa con los servidores del SAT suele presentar fallas, códigos ambiguos y peticiones rechazadas. Aquí resumimos el ciclo y los códigos más frecuentes.
Cómo funciona el ciclo de descarga masiva
- Autenticación: token firmado con e.firma (FIEL).
- Solicitud: filtros (fechas, RFC, tipo). El SAT responde con un
IdSolicitud. - Verificación: consulta periódica hasta que los paquetes estén listos.
- Descarga: obtención de ZIP con XML o Metadata.
Principales códigos y qué hacer
1. Código 5000 — Solicitud recibida con éxito
No es un error. La solicitud entró a la cola asíncrona. Espera minutos antes de verificar el estado.
2. Código 5002 — Límite de solicitudes alcanzado
Hay demasiadas peticiones abiertas con parámetros similares. Evita duplicados y espacia las consultas.
3. Código 5004 — No se encontró información
No hay comprobantes en el rango o hay desfase de zona horaria (UTC vs. Centro de México). Revisa fechas y tipo emitido/recibido.
4. Código 5005 — Ya existe una solicitud idéntica en proceso
Se lanzó la misma consulta mientras otra sigue pendiente. Reutiliza el IdSolicitud previo.
5. Error 300 / 301 — Token o firma inválida
FIEL vencida, uso de CSD en lugar de FIEL, o firma XML mal formada. Renueva certificados y valida el digest.
6. Paquete en estado «Rechazada»
Suele ocurrir al superar topes de volumen (metadata/CFDI). Fragmenta el rango por semanas o días.
Automatiza con ArkaFiscal
ArkaFiscal resuelve la complejidad del WebService: descarga desatendida, reintentos, sincronización de metadata, cancelaciones y confronta contra ERP sin scripts manuales.