contacto@cfdilayer.com Escríbenos, te respondemos pronto

Tu primera consulta a la API de CFDI Layer

Verifica una factura por API, sin programar: con una herramienta para probar APIs o desde Excel con Power Query.

8 min de lectura Revisado en noviembre de 2026 Equipo CFDI Layer
Lo que vas a aprender
  • 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.

  1. Crea una petición nueva de tipo POST a https://app.cfdilayer.com/v1/verificaciones.
  2. En los encabezados (headers) agrega X-Api-Key con tu llave y Content-Type con application/json.
  3. En el cuerpo (body), elige JSON y pega el ejemplo de abajo con los datos de tu factura.
  4. Envía. En la respuesta busca estatus, vigente y emisorSinRegistro69B.
Cuerpo de la petición

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

CampoQué significa
encontradoSi 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».
esCancelableSi se puede cancelar y de qué forma.
emisorSinRegistro69Btrue cuando el emisor no aparece en la lista 69-B.
codigoSatEl 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.

Consulta de Power Query

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
Cuidado con
  • 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.
¿Quieres validar el XML completo? La auditoría por API revisa además el esquema, el sello digital y el certificado, y devuelve un score de 0 a 100. Ver la documentación

Explicamos herramientas, no damos asesoría fiscal. Revisado en noviembre de 2026.

Siguiente tutorial¿Qué es un modelo de lenguaje (y qué no es)?
Ocurrió un error inesperado. Recargar ×
CFDI Layer

Cargando información…

Cargando información… volvemos a intentar en s

No se pudo restablecer la conexión.

La sesión está en pausa.

No se pudo reanudar la sesión.

Esto puede tardar unos segundos. Tu trabajo en pantalla se conserva.

Revisa tu conexión a internet y vuelve a intentarlo, o recarga la página.