Descarga masiva de XML

La descarga masiva obtiene del SAT, de forma automática, tres tipos de documentos: CFDI (las facturas completas en XML), metadatos (un resumen de cada comprobante) y retenciones (comprobantes de retenciones e información de pagos). Con ellos puedes generar tu contabilidad electrónica y tus pólizas contables, conciliar cuentas por pagar, cuentas por cobrar y movimientos bancarios, preparar auditorías, automatizar la cadena de suministro y el pago a proveedores, y verificar los comprobantes que recibes.

Marco legal

La descarga masiva se basa en los artículos 29 y 29-A del Código Fiscal de la Federación (CFF), que establecen la obligación de expedir comprobantes fiscales digitales y sus requisitos, y en la regla 2.7.6.4 de la Resolución Miscelánea Fiscal (RMF), que regula el servicio de descarga masiva de CFDI y retenciones.

Requisitos

La descarga masiva requiere la e.firma (FIEL) vigente del contribuyente. La e.firma y el certificado de sello digital (CSD) constan cada uno de un archivo .cer, un archivo .key y una contraseña, pero tienen propósitos distintos: el CSD solo sirve para sellar facturas, y la e.firma es una firma electrónica de propósito general que sirve para todo lo demás, incluida la descarga masiva.

Tipos de descarga

Fiscalapi descarga tres tipos de documentos del SAT. Eliges el tipo con el campo satQueryTypeId al crear una regla de descarga.

Conceptos

Estos son los conceptos de la descarga masiva, del más general al más específico:

Jerarquía de entidades

Las respuestas de la API siguen esta estructura jerárquica:

Regla de descarga
  └── Solicitud de descarga
        └── Paquete de descarga
              ├── Xml[]          (cuando satQueryTypeId = "CFDI")
              └── MetadataItem[] (cuando satQueryTypeId = "Metadata")

Una regla genera solicitudes a lo largo del tiempo: Fiscalapi crea al menos una solicitud automática por día, y tú puedes crear con la API tantas solicitudes manuales como necesites. Cada solicitud produce uno o más paquetes, y cada paquete contiene los XML o los metadatos extraídos.

Ambiente de pruebas

El SAT no ofrece un ambiente de pruebas para la descarga masiva. Por eso Fiscalapi incluye en su ambiente de pruebas un simulador propio que reproduce el flujo completo. Para usarlo, sigue estos tres pasos.

Paso 1: Configurar la cuenta para emisión de CFDI

Sigue el inicio rápido para configurar tu cuenta: crea una persona emisor, sube sus certificados de prueba y verifica que puedes emitir facturas.

Paso 2: Emitir facturas de prueba

Emite algunas facturas de prueba por referencias, con la API o desde el dashboard. La simulación toma tus facturas más recientes cuyo emisor es una persona registrada en tu cuenta, así que las facturas por valores no sirven para este paso. Puedes usar cualquier cliente HTTP o la colección de Postman, y el tutorial de emisión de facturas explica el proceso en detalle.

Paso 3: Simular la descarga masiva desde el dashboard

El simulador necesita facturas emitidas en tu cuenta. Con ellas, ve a Descarga CFDI > Reglas de descarga en el menú lateral del dashboard y presiona Agregar, en la parte superior derecha.

Crear una regla de descarga de prueba desde el dashboard

Resultado del flujo de prueba

Al completar el flujo, Fiscalapi crea una regla de descarga de prueba en estado Aprobada y una solicitud de descarga en estado Completada, con los CFDI descargados (XML) y sus metadatos. También puedes iniciar la simulación con la API:

POST /api/v4/download-rules/test

Cómo funciona en producción

Para usar la descarga masiva en producción, sigue estos pasos en el dashboard:

1. Activa el módulo de descarga masiva en Compras en línea > Módulos adicionales.
2. Crea una persona con el RFC del que descargarás documentos y sube su e.firma.
3. En Descarga CFDI > Reglas de descarga, crea una regla de descarga y asígnala a esa persona.
4. En Descarga CFDI > Solicitudes de descarga, crea una solicitud de descarga y asígnala a la regla.

Tabla de solicitudes de descarga de CFDI, metadatos o retenciones

Tipos de solicitud

Ciclo de vida

Las reglas y las solicitudes de descarga pasan por varios estados durante su procesamiento. Consúltalos para seguir el avance de tus descargas.

Estados de la regla de descarga

Pendiente (1) --> Aprobada (2) --> Abandonada (-1)
                             └--> Rechazada (3)

Estados de la solicitud (Fiscalapi)

EsperandoSat (1) --> EsperandoApi (2) --> Completada (3)
                                      └--> Abandonada (-1)

Estados de la solicitud en el SAT

Desconocido (0) --> Aceptada (1) --> EnProceso (2) --> Terminada (3)
                                                   └--> Error (4) --> Abandonada (-1)
                                                   └--> Rechazada (5) --> Abandonada (-1)
                                                   └--> Vencida (6) --> Abandonada (-1)

Procesamiento automático

Desde la fecha de aprobación de una regla, y mientras siga en estado Aprobada, Fiscalapi ejecuta la descarga sin intervención manual:

Reglas de validación

Validaciones para reglas de descarga

Combinaciones prohibidas

Límites de período

Regla de unicidad

No puede haber dos reglas activas, es decir, en cualquier estado salvo Abandonada, con el mismo RFC, tipo de consulta (satQueryTypeId), emitidos o recibidos (downloadTypeId) y estatus de factura (satInvoiceStatusId). La unicidad se revisa por RFC, así que aplica aunque el RFC esté registrado en dos personas.

Códigos de estado del SAT

El SAT responde a cada operación de descarga masiva con uno de estos códigos:

Recursos relacionados