Introducción

¿Que es?

Es una API para consulta y descarga de CFDIs desde el portal del SAT, ha sido desarrollada utilizando la arquitectura REST para exponer su funcionalidad a cualquier cliente que soporte el protocolo HTTP. Este webservice se encarga de recibir peticiones que potencialmente tardarán mucho en ser atendidas, por lo tanto, la API toma en cuenta estos escenarios y provee distintos métodos para consultar el estado o progreso de una consulta, para su posterior visualización y descarga.

¿Como funciona?

La fuente de las descargas es directamente en el portal CFDI del SAT, la autenticación se hace programaticamente con las credenciales proporcionadas y el captcha es resuelto sin la necesidad de la interacción del usuario. Con la autenticación exitosa se hace scrapping al portal examinando los formularios y resultados de los filtros de búsqueda. Las consultas producto de este proceso son concurrentes para agilizar los tiempos de finalización.

Requisitos

La descarga masiva desde el portal del SAT requiere de la ciec para la autenticación y que el contribuyente no tenga ningún tipo de bloqueo ante el portal y debe tener contratado un servicio de descarga masiva mediante ciec. Los aspectos para la conexión son básicos y solo se requiere de un cliente HTTP.

Consideraciones

Tenga en cuenta los siguientes puntos cuando consuma el servicio de descarga.

Limite de descargas

El limite diario oficial establecido por el SAT para la descarga de XML mediante el portal es de 2000 CFDI, sin embargo, debido al nivel de concurrencia de las solicitudes que se emplean, este limite puede variar y oscila entre 4000 y 7000 CFDI por día.

Rendimiento del SAT

Al ser el portal CFDI del SAT, la fuente de datos directa de este servicio, en caso de interrupciones en el portal, este servicio dejaría de operar con normalidad imposibilitando la descarga de XML o metadata.

500 Mismo Segundo

Otra limitante conocida del SAT es la imposibilidad de descargar más de 500 CFDI que fueron emitidos en el mismo segundo (misma fecha-hora). Para sobrepasar esto, el servicio intenta dividir el lapso de la consulta hasta el punto que no se rebase este limite.

Mantenimiento del servicio

Se realizan tareas de mantenimiento al servicio basadas en una condición de inodes; debido al alto volumen de archivos XML que el servicio puede descargar y con el objetivo de mejorar la eficiencia del mismo, todos los días se verifica que el nivel de inodes sea aceptable (debajo del 60%) en caso contrario el servicio entra en modo mantenimiento realizando las siguientes operaciones:

• A todas las solicitudes se les establece el estatus REPETIR.
• Se eliminan todos los archivos XML.
• El campo url de las entidades CFDI se establece en null (indicando que el XML ya no está disponible).
• El servicio entra en modo mantenimiento y no está disponible por al menos 30 min.

Esta verificación de inodes se realiza diariamente, sin embargo, la condición descrita no siempre se cumple. Se estima una superación de inodes de al menos 3 veces al mes.