- Qué datos necesitas y cómo crear tu llave
- Cómo enviar la verificación y leer la respuesta
- Cómo hacerlo desde Excel
La idea en una frase
Vas a hacer tu primera verificación de una factura por API: le mandas a CFDI Layer el UUID, los RFC y el total, y te responde si está vigente o cancelada ante el SAT y si el emisor aparece en la lista 69-B. Sin programar: con una herramienta para probar APIs, o con Excel.
Lo que necesitas
- Una cuenta de CFDI Layer (la gratuita incluye 100 consultas de API al mes).
- Una llave API: en tu cuenta, sección Llaves API, botón Crear llave. Cópiala; solo se muestra una vez.
- Los datos de una factura: UUID, RFC del emisor, RFC del receptor y total. Si no sabes dónde están, revisa Cómo leer el XML de una factura.
Opción A: con una herramienta para probar APIs
Herramientas como Postman, Insomnia o Bruno sirven para hacer peticiones a una API sin programar.
- Crea una petición nueva de tipo POST a
https://app.cfdilayer.com/v1/verificaciones. - En los encabezados (headers) agrega
X-Api-Keycon tu llave yContent-Typeconapplication/json. - En el cuerpo (body), elige JSON y pega el ejemplo de abajo con los datos de tu factura.
- Envía. En la respuesta busca
estatus,vigenteyemisorSinRegistro69B.
Cambia los datos por los de tu factura (el total con centavos):
{
"uuid": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"rfcEmisor": "RFC_DEL_EMISOR",
"rfcReceptor": "RFC_DEL_RECEPTOR",
"total": 1160.00
}Cómo leer la respuesta
| Campo | Qué significa |
|---|---|
encontrado | Si el SAT tiene registrada la factura con esos datos. Una recién timbrada puede tardar hasta 72 horas en aparecer. |
estatus y vigente | «Vigente» o «Cancelado». |
esCancelable | Si se puede cancelar y de qué forma. |
emisorSinRegistro69B | true cuando el emisor no aparece en la lista 69-B. |
codigoSat | El mensaje original del SAT. |
Si algo sale mal, la API responde con un código y un mensaje claro: 401 si la llave no es válida, 400 si falta un dato o tiene un formato incorrecto, y 429 si se acabaron tus consultas o hiciste demasiadas en un minuto. Todos están en la documentación.
Opción B: desde Excel
En el tutorial Consultar una API desde Excel conectaste Excel a una consulta sencilla. Una verificación es igual, pero enviando datos: en el Editor avanzado de Power Query se usa Web.Contents con la opción Content, que convierte la petición en un POST.
Pégala en Inicio → Editor avanzado y cambia la llave y los datos:
let
Datos = [uuid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
rfcEmisor = "RFC_DEL_EMISOR", rfcReceptor = "RFC_DEL_RECEPTOR", total = 1160.00],
Respuesta = Json.Document(
Web.Contents("https://app.cfdilayer.com/v1/verificaciones",
[Headers = [#"X-Api-Key" = "TU_LLAVE", #"Content-Type" = "application/json"],
Content = Json.FromValue(Datos)])),
Tabla = Record.ToTable(Respuesta)
in
Tabla- Cada verificación gasta una consulta de tu bolsa. Al actualizar el Excel se vuelve a consultar.
- Tu llave: no la pegues en archivos que compartes ni en un chat de IA. Si se expone, revócala y crea otra.
- El total: debe coincidir con el del XML, con centavos; si no, el SAT no encontrará la factura.
Explicamos herramientas, no damos asesoría fiscal. Revisado en noviembre de 2026.
Siguiente tutorial¿Qué es un modelo de lenguaje (y qué no es)?