La gestión de documentos fiscales puede ser una tarea compleja y que consume mucho tiempo, especialmente cuando necesitas procesar grandes volúmenes de CFDIs. Fiscalapi revoluciona este proceso con su nueva funcionalidad de Descarga Masiva CFDI, diseñada para automatizar completamente la obtención de tus documentos fiscales.
¿Qué es la Descarga Masiva de XML?
La descarga masiva de XML es un servicio official que permite a los contribuyentes, empresas y contadores obtener grandes cantidades de archivos XML, que contienen la información de las facturas electrónicas (CFDI), emitidas o recibidas desde el portal del Servicio de Administración Tributaria (SAT) de manera manual.
La descarga masiva CFDI en Fiscalapi es un servicio inteligente que permite a los usuarios descargar CFDIs o metadatos de CFDIs sin esfuerzo y de manera completamente automática.
Fiscalapi se encarga de todo el proceso:
- 📅 Calendarización automática de solicitudes
- 📤 Solicitud al SAT
- 👀 Monitoreo del estado de las peticiones
- ⬇️ Descarga automática de documentos
- 🔄 Post-procesamiento de archivos
Los documentos quedan disponibles en múltiples formatos: archivos JSON, archivos .zip, archivos .xml, respuestas JSON y datos crudos en base64, todo accesible con una simple llamada HTTP, como ya es costumbre en Fiscalapi.
Conceptos de descarga masiva en Fiscalapi.
Fiscalapi gestiona todo el ciclo de descarga masiva a través de tres conceptos fundamentales:
1. Personas
Representa los diferentes tipos de entidades en el sistema:
- Empresas (Emisores de facturas CFDI)
- Clientes (Receptores de facturas CFDI)
- Organizaciones (Empresas que tienen sus propios clientes)
- Usuarios (Personas que consumen la API dentro de una organización)
- Holdings (Empresas con filiales o subsidiarias)
- Personas físicas (Individuos)
2. Reglas de Descarga
Son plantillas reutilizables para crear solicitudes de descarga. Una regla se crea una vez con los datos repetitivos y se reutiliza para lanzar solicitudes automáticamente.
Ejemplo de reglas:
- Una regla asocia una persona con su FIEL
- Una regla asocia el tipo de documentos a descargar (ej: ‘CFDI’, ‘Recibidos’, ‘Vigentes’)
3. Solicitudes de Descarga
Son registros concretos creados a partir de una regla de descarga, que incluyen:
- Todos los datos de la regla base
- Período específico (fecha inicial y fecha final)
- Gestión completa del estado y progreso
- Mecanismos de resiliencia y reintentos
- Garantía de completitud del proceso
Endpoints disponibles
Catálogos de Descarga Masiva
GET /api/v4/download-catalogs
GET /api/v4/download-catalogs/{catalogName}
Gestión de Reglas de Descarga
GET /api/v4/download-rules/all
GET /api/v4/download-rules
POST /api/v4/download-rules
GET /api/v4/download-rules/{id}
PUT /api/v4/download-rules/{id}
DELETE /api/v4/download-rules/{id}
POST /api/v4/download-rules/test
Gestión de Solicitudes de Descarga
GET /api/v4/download-requests
POST /api/v4/download-requests
GET /api/v4/download-requests/all
GET /api/v4/download-requests/{id}
DELETE /api/v4/download-requests/{id}
GET /api/v4/download-requests/{id}/xmls
GET /api/v4/download-requests/{id}/meta-items
GET /api/v4/download-requests/{id}/package
GET /api/v4/download-requests/{id}/raw-request
GET /api/v4/download-requests/{id}/raw-response
Ventajas de la Descarga Masiva en Fiscalapi
✅ Automatización completa – Sin intervención manual requerida
✅ Múltiples formatos – JSON, ZIP, XML, Base64
✅ API REST familiar – Integración sencilla con sistemas existentes
✅ Gestión de estados – Monitoreo en tiempo real del progreso
✅ Resiliencia incorporada – Reintentos automáticos ante fallos
✅ Escalabilidad – Maneja grandes volúmenes de documentos
✅ Flexibilidad – Configuración personalizada por reglas
Casos de Uso Ideales
- Contadores y despachos contables que manejan múltiples clientes
- Empresas con alto volumen de facturación
- Sistemas ERP que requieren sincronización automática
- Auditorías y compliance que necesitan reportes periódicos
- Análisis de datos fiscales y business intelligence
Comienza Hoy Mismo
¿Listo para simplificar tu gestión con fiscalapi? Explora la documentación completa y la colección de Postman incluida para comenzar a implementar esta poderosa funcionalidad en tu sistema.
Para más información técnica y ejemplos de implementación, consulta nuestra documentación de API o contacta a nuestro equipo de soporte.