Hoy hemos liberado una nueva versión de nuestra librería (DLL) para la descarga masiva y automática de archivos XML del servidor del SAT; en esta ocasión hemos agregado nuevas características, además hemos mejorado algunas de las ya existentes.
A continuación, describiremos los cambios más importantes:
Web service del SAT
Lo primero que hemos realizado es agregar soporte al servicio web ofrecido por el SAT, para descarga de los archivos XML; para esto hemos implementado nuevas clases y métodos que permiten invocar fácilmente al mismo.
Este web service tiene como principal y única ventaja la posibilidad de descargar grandes cantidades de archivos (200,000 por petición); aunque a primera vista parece una excelente opción para abandonar la descarga tradicional, la realidad es que en la práctica son muchas las desventajas que presenta, por eso, a pesar de todo seguimos recomendando la descarga como se viene haciendo.
Hemos preparado dos artículos donde:
- Explicamos a detalle, ¿qué es y cómo se usa?
- Hacemos un comparativo con la descarga que ya se viene manejando.
Uso de la e.firma para la descarga de los XML
Actualmente, para la consulta y descarga de los XML se usa la clave CIEC como método de autenticación al servidor del SAT; a partir de esta versión también podrás hacer uso de la firma electrónica (e.firma).
Si deseas conocer todos los detalles al respecto, te invitamos a leer este artículo.
Otros cambios
En este punto queremos mencionar dos cambios que consideramos relevantes para esta liberación.
El primero es que hemos actualizado todos los ejemplos para mostrar el uso de la firma electrónica, además hemos creado un nuevo ejemplo donde se muestra cómo hacer uso del web service del SAT.
El segundo cambio tiene que ver con las DLLs que usa la librería, se han agregado 3 referencias que deberás incorporar a tu proyecto para que funcione esta nueva versión:
- HyperSoft.ElectronicDocumentLibrary.dll
- HyperSoft.Resource.dll
- HyperSoft.Base.dll
Incompatibilidad
Esta es la primera vez, desde que desarrollamos la librería, que realizamos cambios que hacen que la nueva versión sea incompatible con el código que ya tienes desarrollado y que implica que tendrás que realizar cambios a tu código.
No fue sencillo tomar la decisión sobre estos cambios porque sabíamos que iban a afectar a todos los usuarios y los iba a obligar a rehacer parte de su desarrollo, pero era necesario hacerlos para poder implementar estas nuevas características y otras que estamos planeando implementar.
A continuación, describiremos brevemente estos cambios:
- Se agregaron nuevos códigos de error.
- Algunos códigos de error fueron reemplazados por otros.
- Se eliminó la exportación a Excel, para esto recomendamos usar la exportación a CSV.
- Se agregó la clase SslValidador, la cual deberás instanciar y usar antes de invocar cualquier método de la librería.
Para conocer el detalle de estos cambios, te recomendamos leer el archivo “Historial de cambios.txt” que acompaña al instalador de esta nueva versión.
Esperamos que este artículo te haya sido de utilidad y te invitamos a estar atento a este blog y a seguirnos en nuestras redes sociales (Twitter, Facebook, YouTube) donde estaremos publicando más contenido de este estilo.
Hasta la próxima.