Fiscalapi XML Downloader (sat-ws-descarga-masiva)

Descripción

Librería .NET para consultar y descargar facturas (CFDI) emitidas y recibidas a través del servicio web del SAT, incluyendo la obtención de metadata. Este servicio es parte del sistema "Consulta y recuperación de comprobantes" del SAT (documentación oficial).

Casos de Uso

• Automatización de cadena de suministros
• Automatización de cuentas por pagar
• Automatización de cuentas por cobrar
• Contabilidad electrónica
• Contabilidad general
• Generación de pólizas contables

Instalación

Install-Package Fiscalapi.XmlDownloader -Version 4.0.120

⚠️ Esta librería depende de Fiscalapi.Credentials. Se recomienda leer su documentación antes de continuar.

Arquitectura del Proyecto

Estructura de Código

src/
├── XmlService/           # Clase principal que consume los servicios
├── Services/             # Implementación de servicios
│   ├── Authenticate/    
│   ├── Query/           
│   ├── Verify/          
│   └── Download/        
├── Common/              # Objetos compartidos
├── Models/              # Objetos DTO
├── Packaging/           # Manejo de paquetes del SAT
├── Builder/             # Generación de mensajes SOAP
└── SoapClient/          # Cliente HTTP para el Webservice

Servicios Principales

Cada servicio (Authenticate, Query, Verify, Download) contiene:

• Result: Resultado de la operación
• Parameters: Parámetros de operación

Funcionamiento del Servicio Web

Flujo de Operación

1. Autenticación: Utilizando FIEL (manejo automático del token)
2. Solicitud: Especificación de parámetros (fechas, tipo de solicitud)
3. Verificación: Consulta de disponibilidad
4. Descarga: Obtención de paquetes

Límites y Consideraciones

• Hasta 200,000 registros por petición (1,000,000 en metadata)
• Sin límite en número de solicitudes
• Tiempo de respuesta variable (minutos a horas)

Documentación Oficial

• Portal SAT - Consulta y Recuperación
• Solicitud de Descargas
• Verificación de Solicitudes
• Descarga de Solicitudes

Ejemplos de Uso

Consulte la rama master para ejemplos detallados de uso.

Compatibilidad

• Compatible con .NET 8
• Soporta aplicaciones Windows Forms, Console y Web
• Seguimos Versionado Semántico 2.0.0

🤝 Contribuir

1. Haz un fork del repositorio.
2. Crea una rama para tu feature: git checkout -b feature/AmazingFeature.
3. Realiza commits de tus cambios: git commit -m 'Add some AmazingFeature'.
4. Sube tu rama: git push origin feature/AmazingFeature.
5. Abre un Pull Request en GitHub.

🐛 Reportar Problemas

1. Asegúrate de usar la última versión del SDK.
2. Verifica si el problema ya fue reportado.
3. Proporciona un ejemplo mínimo reproducible.
4. Incluye los mensajes de error completos.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MPL. Consulta el archivo LICENSE para más detalles.

Roadmap

• Descarga de CFDI emitidos y recibidos
• Descarga de metadata de CFDI
• Documentación exhaustiva

Licencia

Copyright © FISCAL API S DE R.L DE C.V. Este proyecto está licenciado bajo la Licencia MIT.