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:

• ciec o e.firma para la autenticación.
• Que el contribuyente no tenga ningún tipo de bloqueo ante el portal.

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

Objetivo y Contexto Para garantizar la eficiencia y optimizar el rendimiento de la descarga de archivos XML de alto volumen, nuestro servicio de CFDI se someterá a un mantenimiento programado de forma mensual.

Fechas y Horario de Ejecución:

• Días de Ejecución: El 5 y 25 de cada mes.
• Hora de Inicio (CST): ($04:00 - 04:30$ CST) (Hora estándar del Centro).
• Duración Estimada: Mínimo 30 minutos de no disponibilidad.

Impacto Técnico y Operaciones Durante la ventana de mantenimiento, el servicio entra en modo restringido y ejecuta las siguientes operaciones:

• Disponibilidad: El servicio no estará disponible para procesamiento.
• Manejo de Solicitudes: Todas las solicitudes entrantes recibirán automáticamente el estatus de REPETIR.
• Gestión de Datos: Se ejecuta una limpieza de la capa de persistencia para liberar espacio y optimizar el almacenamiento:
• Eliminación de Archivos: Todos los archivos XML almacenados se eliminan del sistema.
• Actualización de Entidades: El campo url de todas las entidades CFDI se establecerá en null, lo que indica que el recurso XML asociado ya no es accesible.

Recomendación: Se sugiere a los desarrolladores evitar la programación de tareas críticas que dependan de este servicio durante el periodo de mantenimiento ($04:00 - 04:30$ CST) en los días indicados.