lunes, 29 de marzo de 2021

AddOnSAT-WebService

 Manual AddOnSAT WebService



El pasado 25 de Marzo, se subió la actualización al aplicativo AddOnSAT complemento de Excel, para poder realizar descargas por paquetes de miles de xml, cuando se te acabe las descarga de los 2000 por web, recordemos que en principio el AddOnSAT tenia y tiene la posibilidad de realizar descarga vía web, pero a solicitud de varios usuarios hemos agregado la descarga WebService para solicitar paquetes de Miles de XML.

Ya antes para el uso de la descarga web, se había elaborado un video tutorial para el manejo de la descarga via web, en este caso vamos a describir los pasos para utilizar la descarga vía WebService.

Descarga el DEMO para su evaluación, si lo decides una vez terminado el periodo de prueba adquiere la licencia anual por tan solo $499.00 y recibe actualizaciones gratis por un año, y renueva tu licencia anual pagando únicamente el 35% sobre el precio de la aplicación.

DESCARGA EL DEMO


Realiza tu pago con Mercado pago, y utiliza tu tarjeta de crédito y otros medios de pago disponible.


Bien, para empezar se agrego un nuevo menú para el uso de la descarga vía WebService:



Para eso se tubo que agregar también un menú  nuevo para poder dar de alta el catalogo de RFC, donde se guardara los datos de la firma electrónica y contraseña, de la firma electrónica solo se guarda la ruta local donde se encuentra los archivos, esos datos se guarda de forma Local en una base de datos que se encuentra en la carpeta C:\BaseAddOnSAT en un archivo "bdWsSAT.sqlite",  AppsJasr declara que no guarda ningún dato relativo a contraseña, ni datos relacionado con el acceso a las paginas del SAT, ni archivos relacionados con la firma electrónica, todos los datos se almacenan de forma local para que el sistema tome los datos y se automatice la obtención de los datos y si errores de escritura.

Este es el boton donde se muestra el catalogo de empresas:


Al dar clic sobre el botón en forma de casita, nos desplega el siguiente formulario, en el que trae las opciones de agregar, modificar y eliminar estos últimos en el menú contextual, (botón derecho), un botón de refrescar el catalogo, aceptar y salir.


Para iniciar el catalogo damos clic en el botón Agregar, y se nos abrirá el siguiente formulario:


Donde el campos ID EMPRESA se llena de forma automática por lo que no hay que capturar nada, el campo de la FIEL y el de la LLAVE FIEL, damos doble clic sobre el área de captura para seleccionar ambos archivos donde se encuentren alojados, lo seleccionamos y se rellena en automáticos el directorio donde se guardan, los campos RFC y NOMBRE se llenan en automático al leer los datos del archivo .cer de la fiel, el campo ARCHIVO PFX, cuando se realiza el alta por primera vez, este campo queda vacío (Este archivo se genera una única vez, pero primero debemos dar de alta la empresa con los datos de la fiel.), los campos PASSWORD FIEL Y CONTRASEÑA se captura de forma manual.

Una vez se termina de capturar la información mínima solicitada en el manual, procedemos a dar clic en el botón Actualizar del formulario para guardar los datos en la base de datos C:\BaseAddOnSAT\bdWsSAT.sqlite y continuamos agregando todos nuestros RFC's, una vez terminemos las capturas damos clic en el botón Salir.

y regresamos al formulario Listado de empresas, y damos clic en el botón de refrescar del formulario:


Enseguida se nos actualiza con los RFC que hayamos capturado, seleccionamos con el Mouse cualquiera de nuestras empresas dadas de alta,  damos clic en el botón aceptar, esto hará que la aplicación trabaje y tome los datos con la empresa seleccionada, una vez seleccionada la empresa nos vamos al menú del WebService para generar el archivo PFX de la empresa seleccionada, este paso solo se realiza una vez cuando se da de alta la empresa, posteriormente ya no se realiza al menos que hayas perdido el archivo PFX y en todo caso podrás venir a generarlo nuevamente desde aquí.



Este proceso se realiza por cada empresa dada de alta, una vez generado el archivo si no existió ningún error relativos a los archivos de la fiel se nos muestra el siguiente mensaje:


En el que nos dice que si queremos trabajar con el contribuyente al que se le genero el archivo PFX, volvamos a listar el catalogo de empresas y tomar los datos actualizados los cuales ya incluirán la ruta donde se encuentra el archivo PFX. El archivo PFX nos servirá para poder identificar a la empresa en el WebService del SAT, el archivo PFX incluye la llave y el certificado de la fiel, y se genera para simplificar el proceso de autenticación, si recuerdan bien notaran que el archivo tiene la misma extensión que utiliza el IMSS en la generación de sus certificados, y si se fijan cuando se firman en el IDSE solo colocamos un archivo y nunca ponernos la llave del certificado, bueno el proceso es parecido.

Una vez dado de alta y generado el archivo PFX para todas las empresas, solo es necesario seleccionar una empresa para trabajar con ella, y al seleccionarla les mostrara el datos del RFC seleccionado aquí:


Por lo que de esta forma sabrán siempre con empresa esta trabajando.


Para comenzar a realizar solicitudes de descarga damos clic en el menú del WebService:


Se nos desplegara el siguiente formulario con los datos prellenados de la ruta del archivo PFX el RFC y el Password de la Fiel, y damos clic en el botón iniciar sesión:

    

Si las credenciales y los datos capturados fueron correctos se mostrara el siguiente mensaje:
De lo contrario mandaría un mensaje de error.



En ese momento se nos habilitara dentro del mismo formulario anterior los campos para poder capturar los parámetros de los XML a solicitar:

Se podrá parametrizar la consulta para buscar por XML recibidos o Emitidos, que se selecciona dentro del combo "Búsqueda por:", así mismo se podrá capturar dentro del campo búsqueda por RFC, un RFC para buscar solo XML de ese RFC capturado, si se deja en blanco traerá todos los RFC de la consulta, podrán agregar adicionalmente un filtro en el tipo de descarga, para que nos traiga los archivos XML de la consulta o el METADA de la consulta(Archivo de texto que contiene la información de la consulta), una vez parametrizado lo filtros de la búsqueda, daremos clic en botón de "Solicitar descarga".



Si la búsqueda se genero correctamente se nos muestra el siguiente mensaje:


Cabe aclarar que dependiendo el filtro de búsqueda es decir del numero de XML que contenga la consulta es el tiempo en que nuestra solicitud se encuentre disponible para su descarga, por lo que por sugerencia para que los paquetes no tarden tanto, realicen sus consultas dependiente de los XML que la empresa emite, y se realizan consulta que no contengan muchos miles de XML, hay consultas que arrojan mas de 200,000 xml que si podrán estar disponible pero el tiempo de espera podar ser de hasta un día o mas, dependiendo del servicio del SAT. Toda atraso o falla en el servicio de descarga no es responsabilidad del aplicativo AddOnSAT, el aplicativo responde a las peticiones mientras el WebService del SAT este disponible, de lo contrario no funcionaria.

Bien si nuestra consulta fue exitosa y después de un tiempo de espera que puede ser de 1 minuto o mas de un minuto, 1 hora o mas de una hora, un día o mas de un día, etc., podremos consular nuestra solicitud desde aquí:


Se nos desplega el siguiente formulario:



En este formulario se desplegara todas las solicitudes que hayamos realizado, de entrada el formulario se desplega con las consultas pendientes de descarga es decir con el filtro de Estatus = 0, solo seleccionamos la solitud que deseemos para consultar si ya se encuentra disponible, si ya se encuentra disponible se realizara la descarga, de lo contrario enviara un mensaje indicando lo contrario.

Antes de presionar el botón Descargar del formulario debemos de seleccionar la carpeta donde queremos guardar los paquetes descargados, los cuales viene en un archivo comprimido con la conocida extinción *.zip, la cual tendremos que descomprimir para obtener los XML o el archivo METADA en su caso.



Una vez seleccionada la carpeta donde se guardaran nuestras solicitudes damos clic en el botón Descargar del formulario y si la solicitud ya esta disponible se nos mostrara el siguiente mensaje:




Y con esto se terminaría el proceso del uso del servicio del WebService del SAT., espero que esta guía les sea útil para el buen manejo del aplicativo. cualquier duda o comentario comente.



Saludos cordiales:

JASR