Web service para descargar las facturas (XML) del SAT en PHP

Conoce como llevar a cabo la descarga de los archivos XML de las facturas que emites o recibes del SAT, haciendo uso del web service para PHP que Facturando pone a tu disposición.

A continuación, describiremos las características que el web service en Php, para la descarga de archivos XML, te ofrece:

Proceso de solicitud de descarga de comprobantes

1. Solicitud, la empresa o el usuario que requiera de descargar los archivos XML del servidor del SAT envía la petición al servicio web service, donde dicha petición contendrá un objeto JSON con todos los parámetros requeridos para llevar a cabo la ejecución del proceso.

2. Respuesta, el servicio recibe la petición y lleva a cabo las siguientes validaciones:

  • Que todos los parámetros de entrada, requeridos para el proceso de descarga, sean correctos.
  • Que el RFC no tenga registrada una petición de descarga activa, es decir, que no esté en proceso o pendiente, alguna solicitud de descarga.

Una vez realizadas las validaciones correspondientes, podrán generarse dos tipos de respuestas:

  • Cuando exista un error en el proceso de validación, se retornará un mensaje de error que contendrá número y descripción del mismo.
  • De ser todo correcto, se genera una respuesta de aceptación, donde se incluye un identificador de la petición.

3. Notificación, al finalizar el proceso de descarga, ya sea con o sin éxito, se notificará al solicitante, invocando la URL donde será enviado un objeto JSON con el resultado.

  • De existir un error, se enviará el número de error y descripción correspondientes.
  • En caso contrario, de finalizar el proceso de forma exitosa, se enviará el resumen del proceso (total de archivos descargados, no descargados, vigentes, cancelados, etc.,), así como la URL donde ese podrá descargar el archivo comprimido (zip) que contiene los archivos XML de los comprobantes.

Consulta del proceso de solicitud de descarga
La empresa o el usuario podrá realizar la consulta del estatus del proceso de descarga solicitado con anterioridad, mediante:

1. Solicitud, invocando el método de consulta del web service enviando como parámetro el objeto JSON con el identificador de la descarga asignado y el RFC de quien lo solicitó.

2. Respuesta, el servicio recibe la petición y lleva a cabo las siguientes validaciones:

  • Que todos los parámetros de entrada sean correctos.
  • Que la solicitud de descarga (identificador y RFC) se encuentren registrados en el sistema.

Realizadas las validaciones, se podrán generar dos tipos de respuestas:

  1. En caso de generarse un error en el proceso de validación, se retornará un mensaje de error que contendrá número y descripción del mismo.
  2. Cuando todo es correcto, se retorna el estado en que se encuentre el proceso de la descarga y para el caso de que esté totalmente finalizado, se incluirá el resumen del mismo y la URL de la descarga.

El proceso de implementación del web service en Php es muy práctico y sencillo, por lo que te invitamos a consultar toda la información relacionada con el mismo.

Ver más

Si tienes alguna duda con respecto a esta publicación, te invitamos a que nos contactes por medio del chat que aparece en nuestra página www.facturando.mx donde con gusto un asesor te atenderá.

Hasta la próxima.

Web service para descargar los XML del servidor del SAT

Nos es muy grato el poder compartir contigo la liberación de nuestra nueva solución para descargar los archivos XML de las facturas que emites o recibes, directamente del SAT; por lo que te invitamos a conocer a detalle esta nueva solución.

A quien va dirigido
Esta solución consta de un web service y está dirigida a aquellas empresas que tienen desarrollos para la web (PHP, Python, NodeJs, etc.) y que desean incluir dentro de su solución la capacidad de descargar los archivos XML, recibido o emitidos, directamente del servidor del SAT, evitando con esto que el usuario final del sistema tenga que llevar a cabo este proceso de forma manual.

En caso de que seas un desarrollador de aplicación de escritorio (C#, Visual Basic.Net, FoxPro, Delphi, Java, Visual Basic, etc.) tenemos para ti una librería con la que puedes llevar a cabo el mismo proceso sin necesidad de usar este web service: Electronic Document Download.

Características:
A continuación, describiremos las características más importantes que posee nuestra solución:

  • Podrás automatizar el proceso de descarga de los XML del servidor del SAT.
  • No existe límite en la cantidad de comprobantes fiscales digitales (XML) a descargar, podrás descargar 1,000,000 comprobantes si así lo deseas.
  • Puedes descargar todos los archivos XML de todos tus RFC, ya que no tenemos ninguna restricción al respecto.
  • Podrás descargar todo tipo de comprobantes, ya sean emitidos, recibidos, activos o cancelados.
  • Podrás hacer uso de una serie de filtros (día, mes, año, status, etc.) con los cuales podrás descargar exactamente los archivos que necesites.

Tiempo de ejecución
Esta es la mejor parte de nuestra solución, ya que el tiempo de promedio de descarga de un archivo XML es de 300 milésimas de segundo, esto significa que se pueden descargar 3 comprobantes por segundo; todo eso es gracias a los diferentes procesos de optimización realizado por nuestra área de desarrollo.

Especificación técnica
Hemos creado una serie de recursos para que puedas conocer a detalle el funcionamiento de nuestra solución, los cuales te invitamos a leer:

Infraestructura
Consientes de la fuerte demanda que puede tener este servicio, nuestra área de TI ha desarrollado toda una red de servidores, que nos permitan dar respuesta, ágil e inmediata, a todos aquellos usuarios que deseen llevar a cabo el proceso de descarga; adicionalmente, tenemos la capacidad de crecer la solución tanto como se requiera.

Costo
Por ser nuestra primera versión BETA pública, hemos decidido ponerla a disposición de todas las empresas sin ningún tipo de costo, una vez que sea supera esta etapa, se estarán publicando las condiciones comerciales y los costos correspondientes.

Esta fase BETA se tiene planeada hasta el día 15/Junio/2016, por lo tanto, podrás continuar usando el servicio hasta dicha fecha, antes de dicha fecha estaremos dando a conocer la parte comercial.

Te invitamos a que conozcas a detalle el servicio web descargando la documentación y ejemplos correspondiente.

DESCARGAR

Si tienes alguna duda con respecto a esta liberación, te invitamos a que nos contactes por medio del chat que aparece en nuestra página www.facturando.mx donde con gusto un asesor te atenderá.

Hasta la próxima.

¿Cómo usar el web service para descargar los XML del SAT?

Si deseas conocer más acerca de esta solución te invitamos a leer este artículo o visitar nuestro site oficial.

A continuación, mostramos los pasos que se deberán de seguirse para consumir el web service de descarga de XML del SAT, siendo los siguientes:

  1. Solicitud de descarga – envío de la petición de descarga mediante un objeto JSON con todos los parámetros requeridos para ejecutar el proceso.
  2. Respuesta – el servicio recibe la petición y lleva a cabo la validación de la misma; de haber algún error, se retorna un mensaje con número y descripción del error obtenido, en caso contrario, de no haber error, el servicio encolará la petición para su procesamiento.
  3. Notificación – Una vez que el proceso de petición de descarga haya finalizado, será notificado al solicitante, invocando la URL o la cuenta de correo indicada, donde será enviado un objeto JSON con el resultado, el cual contiene un resumen del proceso y la URL del archivo ZIP con los XML descargados.

Para mayor información, te recomendamos ver esta presentacion que preparamos para tí.

Descarga de archivos
En cuanto a la descarga de archivos, podrás descargar todos los archivos XML de tus facturas, emitidas o recibidas, sin importar la cantidad de que se trate, ya que el servicio web se encargará de esto, dejando atrás la limitante que se tenía en el SAT (500 comprobantes por consulta).

Además, podrás definir el nombre de la carpeta como serán agrupados los comprobantes dentro del archivo ZIP que los contendrá, así como, el nombre que éstos llevarán, haciendo uso y combinando los parámetros como más te convenga:

  • Tipo de consulta (emitidos / recibidos)
  • Datos del emisor (RFC / razón social)
  • Datos del receptor (RFC / razón social)
  • Fecha de emisión (año / mes / día)
  • Fecha de certificación (año / mes / día)
  • PAC que certifico
  • Folio fiscal (UUID)
  • Efecto del comprobante (Ingreso, etc.)
  • Estado del comprobante (vigente / cancelado)

Filtrado de la descarga
Podrás descargar exactamente los comprobantes que desees, esto mediante el uso de una serie de parámetros, como son:

  • Tipo de consulta (emitidos o recibidos)
  • Un rango de fechas (inicial – final)
  • Estado del comprobante (todos, vigentes o cancelados)
  • Por folio fiscal (UUID)
  • Con o sin complementos fiscal
  • Por un RFC en específico

Reporte de datos de comprobantes descargados
Al finalizar el proceso de la descarga de comprobantes, y si lo solicitaste, se generará un reporte detallado con datos de los archivos descargados:

  • Emisor
  • Receptor
  • Totales: Total, SubTotal, descuento.
  • Impuestos: IVA, ISR, IEPS, TUA
  • Etc.

Este reporte podrá ser generado en diferentes formatos, de acuerdo a tus requerimientos:

  • JSON
  • XML
  • CSV
  • Excel
  • TXT

Restricciones en el uso del web service de descarga
Al hacer uso del web service de descarga deberás de tener en cuenta las siguientes consideraciones o restricciones:

  • Solo se permite una petición para un mismo RFC en proceso, de existir la solicitud de una segunda petición, ésta será rechazada, mientras la primera no haya terminado en su totalidad.
  • El rango de fechas para el filtrado de la descarga no podrá exceder de 1 mes por petición.
  • La descarga por UUID (folio fiscal) podrá hacerse con un máximo de 100 UUIDs por petición.

Te invitamos a que conozcas a detalle el servicio web descargando la documentación y ejemplos correspondiente.

DESCARGAR

Si tienes alguna duda con respecto a esta liberación, te invitamos a que nos contactes por medio del chat que aparece en nuestra página www.facturando.mx donde con gusto un asesor te atenderá.

Hasta la próxima.