API del SAT: qué se consulta en línea, qué se descarga y qué se hace a mano

Qué es

Cuando alguien dice "la API del SAT" suele imaginar un servicio único y moderno que contesta al instante cualquier cosa. No es lo que hay: son varios mecanismos disparejos, de épocas distintas y con formas de consulta propias.

Conviene pensarlo en tres categorías. Hay datos que sí se preguntan en línea a un servicio de la autoridad; otros no se preguntan: se descargan publicados y se consultan del lado de uno; y otros hay que resolverlos por el portal o a mano. Los dos primeros no envejecen igual: uno contesta con el estado de hoy y el otro con el de su última descarga. Saber en cuál cae lo que necesitas te dice qué puede prometerte una herramienta.

En palabras de contador

Piensa en el cliente que llega con la contabilidad repartida: parte en un sistema, parte en hojas de cálculo y parte en papel, cada cosa de una época distinta. No hay un solo lugar donde pedirlo todo: trabajas con lo que hay y te aprendes por dónde se saca cada cosa.

Ese es el terreno de quien busca "la API del SAT": nadie va a ordenarlo antes de tu cierre. Lo que rinde es saber qué se resuelve por cada vía y qué tramo sigue siendo tuyo.

Ejemplo aplicado

El estatus de un comprobante sí se consulta en línea. Preguntar si un CFDI sigue vigente o fue cancelado se hace contra un servicio web SOAP de la autoridad. No es una API moderna, pero es la vía formal: la solicitud va en XML y la respuesta también.

Las listas publicadas se descargan, no se preguntan una por una. Para contrastar proveedores contra las listas 69, 69-B y 69-B bis, la herramienta baja lo publicado y lo consulta localmente: doscientos proveedores toman segundos, con la fecha de la descarga como referencia.

Lo que no se resuelve por esas dos vías alguien lo hace a mano. Una constancia que el cliente necesita para su expediente se descarga del portal con su contraseña. Ahí no hay nada que automatizar: conviene presupuestar esa hora.

Para qué sirve en un despacho

• Distinguir un dato preguntado al momento de uno leído de una copia descargada.
• Preguntarle a un proveedor de dónde saca cada dato y con qué fecha.
• Saber qué parte del proceso se automatiza y cuál seguirá siendo manual.
• Dejar asentada la fuente y la hora de cada consulta en el papel de trabajo.

Riesgos o limitaciones

Ambos dependen de disponibilidad: el servicio en línea puede tardar o no contestar, y una revisión masiva que no lo contemple se detiene a la mitad sin avisar. La copia descargada sabe lo que sabía el día que se bajó: si fue hace tres meses, eso es lo que sabe.

Tampoco esperes que cubran cualquier consulta. Y ninguna consulta automática sustituye tu criterio: que un comprobante aparezca vigente no lo vuelve deducible.

Buena práctica

Exige que cada resultado venga con dos datos: de dónde salió y cuándo. Un dictamen que dice "vigente" sin aclarar si se preguntó hoy o se leyó de una copia de abril te sirve la mitad; esa evidencia va junto al papel de trabajo.

Preguntas frecuentes

¿Puedo conectarme yo directamente a esos servicios? Técnicamente sí, con apoyo de quien construya la conexión, pero casi todos la reciben ya integrada.

¿Cada cuánto conviene actualizar las listas descargadas? Tan seguido como tu riesgo lo pida; con deducciones fuertes, antes de cada cierre. Lo mínimo es conocer la fecha de la última actualización.

¿Por qué me piden el XML si la autoridad ya recibió el comprobante? Porque el servicio que confirma el estatus responde eso —si sigue vigente o fue cancelado— y no el detalle. Los conceptos, impuestos y complementos los lees del archivo que resguardas.

Escrito y revisado por Ernesto Sobrino, contador.
Última revisión: 24 de agosto de 2026.