Web service del SAT para la descarga masiva de XML

El objetivo de este artículo es dar a conocer el web service que el Servicio de Administración Tributaria (SAT) pone a disposición de los contribuyentes para la descarga de CFDI y metadatos de forma masiva.

Este servicio web puede ser usado por cualquier contribuyente, no importa si es una persona física o moral, esto debido a que solamente se requiere la e.firma para su uso.

Aunque lo anterior es verdad, la realidad es que las personas que más se ven beneficiados con el mismo, son aquellas que manejan grandes volúmenes de información, porque a través de este, es posible:

• Descargar hasta 200,000 XML en una sola petición.
• Consultar hasta 1,000,000 de UUIDs (Metadata).

Y ese es precisamente el principal beneficio que ofrece este servicio, el poder descargar grandes volúmenes de información, ya que supera por mucho los 33,000 XML que se pueden descargar a través del método tradicional; más adelante profundizaremos sobre este tema.

A continuación, describiremos la funcionalidad que el web service del SAT ofrece:

Pasos
Para el uso de este servicio, deberás seguir una serie de pasos para poder obtener finalmente la información que requieres:

• Realizar una solicitud de la información (metadata o XML) que requieres.
• Verificar, periódicamente, si la solicitud enviada ya está atendida por el SAT.
• Descargar el resultado de la solicitud realizada.

Características
En seguida, mencionaremos las características del Web Service del SAT, siendo estas las siguientes:

• Autenticación – para poder hacer uso de cualquier funcionalidad del web service es necesario autentificarse por medio de la eFirma.
• Tipo de proceso – existen dos tipos de procesos:
• Metadata: que consiste en obtener un listado de los datos básicos de los comprobantes que ha emitido o recibido un contribuyente.
• CFDI: el objetivo de este proceso es obtener los archivos XML (CFDI) de los comprobantes que ha emitido o recibido un contribuyente.
• Descarga – dependiendo del tipo de proceso, se tiene un límite en la cantidad de comprobantes:
• Metadata: para este tipo de proceso el límite de descarga es de hasta 1 millón de registros por consulta.
• CFDI: para este tipo de proceso el límite de descarga es de hasta 200 mil XML por solicitud.
• Solicitudes – no existe límite en el número de solicitudes.

Parámetros
El web service de descarga masiva ofrece la posibilidad de hacer solicitudes de consulta (metadata) y descarga de XML (CFDI) de acuerdo con los siguientes parámetros:

• Fecha inicial y final del periodo a solicitar.
• RFC del receptor, hasta 5 contribuyentes.
• RFC del emisor.
• RFC del solicitante.
• Tipo de solicitud (Metadata o CFDI).
• Tipo de comprobante (Emitidos o Recibidos).
• Tipo de efecto del comprobante a solicitar (Ingreso, Egreso, Nómina, Pago, Traslado o Todos).
• Estado de los comprobantes a obtener (Vigentes, Cancelados o Todos).
• RFC a cuenta de terceros.
• Complemento del CFDI (Carta porte, IEDU, Nómina, Pagos, Vales de despensa, etc.).
• Folio fiscal (UUID) solo 1.

Beneficios y Desventajas
Como comentamos líneas arriba, desde nuestro punto de vista, la única ventaja de este servicio con respecto a la descarga tradicional es la posibilidad de descargar un alto volumen de información, recuerda:

Puedes descargar una gran cantidad de comprobantes: hasta 1 millón de registros de metadata y hasta 200 mil XML por solicitud.

Desventajas:
Aunque la idea del SAT es buena, la realidad es que en la práctica se queda corta y presenta varias desventajas.

A continuación, describiremos las más importantes:

• El tiempo de respuesta no es inmediato, puede tardar de 24 a 72 horas o nunca responder.
• Su inestabilidad, ya que constantemente presenta intermitencias o de plano deja de funcionar.
• Se tiene que usar la e.firma, no existe forma de hacer uso de la CIEC.
• Los filtros o parámetros permitidos son muy pocos, por lo que no es posible definir exactamente la información que se requiere.
• La falta de documentación y claridad en el uso de este hace que el proceso de implementación sea difícil y muchas veces no se logra comprender a cabalidad cada una de las partes del mismo.
• Con respecto a este tema, hemos creado un artículo en donde hablamos a fondo acerca de este tema y comparamos la descarga tradicional y este servicio ofrecido por el SAT:

Comparativo WS y página del SAT

¿Cómo usar el web service?
En Facturando contamos con una solución (librería, DLL) con la cual podrás usar, fácilmente, cualquiera de las dos opciones de descarga:

Desde el portal del SAT mediante la clave CIEC o la e.firma.
Usando el web service del SAT.

Si deseas conocer todo al respecto de esta, te invitamos a dar clic aquí

DLL para la descarga masiva de XML

Palabras finales
Para finalizar, nos gustaría comentar:

• Por el momento, la descarga tradicional, esto es, a través del portal SAT usando la CIEC o e.firma es la mejor opción para descargar tus XML.
• El uso del web service del SAT, solamente se recomienda cuando quieras descargar grandes volúmenes de XML.

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.