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

Referencia de la API CFDI Layer

Verifica y audita CFDI desde tu ERP, tu sistema contable o cualquier programa: las mismas respuestas que el sitio, por HTTP y en JSON.

Introducción

La API CFDI Layer expone por HTTP lo mismo que hacen las herramientas del sitio: la verificación rápida (¿el comprobante está vigente o cancelado ante el SAT? ¿su emisor está en la lista 69-B?) y la auditoría avanzada de un XML (esquema, sello digital, certificado, estatus y lista 69-B, con score y dictamen). Además da acceso al saldo y al historial de la cuenta.

Dirección basehttps://app.cfdilayer.com
FormatoJSON (UTF-8) en peticiones y respuestas
Versiónv1, en la ruta de cada operación
Fechas y horasISO 8601; las del servidor en UTC

Toda operación va sobre HTTPS. Las respuestas de éxito son 200 (o 201 al crear y 204 sin cuerpo al revocar o cerrar sesión); las de error siguen el formato estándar Problem Details con un código estable y un mensaje en español.

Inicio rápido

  1. Crea una llave.Con tu cuenta de cfdilayer.com, en Llaves API, pulsa Crear llave y cópiala: solo se muestra una vez.
  2. Envíala en cada petición en el encabezado X-Api-Key, siempre desde tu servidor (nunca desde una página web o una app instalada, donde cualquiera podría leerla).
  3. Haz tu primera verificación con POST /v1/verificaciones: solo necesitas el UUID, los RFC y el total.
  4. Revisa tu saldo en los encabezados RateLimit-* de cada respuesta o con GET /v1/cuenta/consumo.
curl -X POST https://app.cfdilayer.com/v1/verificaciones \
  -H "X-Api-Key: TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"uuid":"3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01","rfcEmisor":"DEM010101AB1","rfcReceptor":"EEJ010101AB1","total":18560.00}'
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$cuerpo = @{ uuid = "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01"; rfcEmisor = "DEM010101AB1"; rfcReceptor = "EEJ010101AB1"; total = 18560.00 } | ConvertTo-Json
$respuesta = Invoke-RestMethod -Method Post -Uri "https://app.cfdilayer.com/v1/verificaciones" -Headers $cabeceras -ContentType "application/json" -Body $cuerpo
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var respuesta = await http.PostAsJsonAsync("/v1/verificaciones", new
{
    uuid = "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01",
    rfcEmisor = "DEM010101AB1",
    rfcReceptor = "EEJ010101AB1",
    total = 18560.00
});
var json = await respuesta.Content.ReadAsStringAsync(); // respuesta.IsSuccessStatusCode indica si salió bien
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.post("https://app.cfdilayer.com/v1/verificaciones", headers=cabeceras, json={"uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "rfcEmisor": "DEM010101AB1", "rfcReceptor": "EEJ010101AB1", "total": 18560.00})
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/verificaciones", {
  method: "POST",
  headers: { "X-Api-Key": "TU_LLAVE", "Content-Type": "application/json" },
  body: JSON.stringify({ uuid: "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", rfcEmisor: "DEM010101AB1", rfcReceptor: "EEJ010101AB1", total: 18560.00 })
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/verificaciones");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE", "Content-Type: application/json"],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["uuid" => "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "rfcEmisor" => "DEM010101AB1", "rfcReceptor" => "EEJ010101AB1", "total" => 18560.00]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);

Autenticación

Hay dos formas de identificarse, según quién llama:

QuiénCredencialEncabezado
Un sistema (ERP, contabilidad, integración)Llave API de la cuenta. 64 caracteres, empieza con cl_. No caduca; se revoca desde Llaves API.X-Api-Key: TU_LLAVE
Una persona (la app de CFDI Layer)Token de acceso JWT obtenido con POST /v1/sesion/iniciar. Dura 15 minutos; se renueva con el token de renovación (30 días).Authorization: Bearer TU_TOKEN

Las operaciones de validación, cuenta e historial aceptan cualquiera de las dos. Las llaves (/v1/llaves) solo se administran con sesión: una llave no puede crear ni revocar llaves. Cada operación de esta referencia indica qué acepta.

Una cuenta puede tener hasta 3 llaves activas; conviene una por sistema, con un nombre que la identifique, para revocarla sin afectar a los demás.

Consultas y saldo

Cada verificación o auditoría hecha con llave descuenta una consulta de la bolsa mensual de la API de la cuenta (100 al mes en la cuenta gratuita; los planes amplían el volumen). Consultar el saldo, el historial o los planes no descuenta. Una consulta que falla por el SAT o por un error nuestro tampoco.

La bolsa se reinicia el día 1 de cada mes a las 00:00, hora del centro de México. Con sesión (la app) se usan las bolsas diarias de verificaciones y auditorías de la cuenta, las mismas del sitio.

Toda respuesta de una validación trae el saldo en encabezados:

EncabezadoSignificado
RateLimit-LimitConsultas incluidas en el periodo.
RateLimit-RemainingConsultas que quedan.
RateLimit-ResetSegundos que faltan para que se reinicie la bolsa.

Además hay un límite de velocidad de 120 peticiones por minuto por cuenta. Al rebasarlo la API responde 429 con el encabezado Retry-After.

Errores

Los errores llegan con Content-Type: application/problem+json y esta forma. codigo es estable (programa contra él); detail está pensado para mostrarse a la persona tal cual; traceId sirve para que te ayudemos si reportas un problema.

Ejemplo: datos inválidos (400)
{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Datos inválidos",
  "status": 400,
  "detail": "Revisa los campos indicados.",
  "codigo": "datos_invalidos",
  "errors": { "uuid": ["El UUID (folio fiscal) debe tener el formato XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX."] },
  "traceId": "00-d5c3dfe7ad60d38faefb78476e9bc2f9-e59a862fe0c55ecc-00"
}
EstadocodigoCuándo
400datos_invalidosFalta un dato o tiene mal formato; "errors" indica cada campo.
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
403correo_sin_confirmar / cuenta_bloqueada / cuenta_deshabilitadaLa cuenta no puede operar por ahora (al iniciar sesión).
404validacion_no_encontrada / llave_no_encontradaEl id no existe en la cuenta.
422xml_no_es_cfdi / llave_no_creadaLa petición es válida pero no se puede cumplir; "detail" explica por qué.
429cuota_agotadaSe terminaron las consultas del periodo; "detail" dice cuándo se reinician y "reiniciaEn" trae la fecha.
429demasiadas_peticionesMás de 120 peticiones por minuto; el encabezado Retry-After dice cuántos segundos esperar.
502servicio_no_disponibleEl SAT no respondió. No se descuenta la consulta; vuelve a intentar en unos minutos.

Validaciones

Verificación rápida

POST/v1/verificaciones
Llave API o sesión Descuenta 1 consulta

Consulta al SAT si un comprobante está vigente o cancelado y si su emisor aparece en la lista 69-B. Solo necesita los datos del comprobante; no hace falta el archivo XML.

Si el SAT no encuentra el comprobante, la respuesta es 200 con "encontrado": false y "estatus": "No encontrado" (código SAT N - 602). Un comprobante recién timbrado puede tardar hasta 72 horas en aparecer.

Cuerpo de la petición

CampoTipoDescripción
uuidobligatoriotextoFolio fiscal, con el formato XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.
rfcEmisorobligatoriotextoRFC de quien emitió la factura.
rfcReceptorobligatoriotextoRFC de a quien se le facturó.
totalobligatorionúmeroTotal del comprobante, con centavos.

Respuesta

CampoTipoDescripción
uuidtextoFolio fiscal consultado.
encontradobooleanotrue si el SAT tiene registrado el comprobante con esos datos.
estatustexto"Vigente", "Cancelado" o "No encontrado".
vigentebooleanotrue solo cuando el comprobante existe y está vigente.
esCancelabletexto o nullLo que informa el SAT: "Cancelable con aceptación", "Cancelable sin aceptación" o "No cancelable".
estatusCancelaciontexto o nullDetalle de la cancelación cuando el comprobante está cancelado (por ejemplo "Cancelado sin aceptación").
codigoSattextoCódigo y mensaje tal cual los devuelve el SAT ("S - Comprobante obtenido satisfactoriamente.", "N - 602: Comprobante no encontrado.").
rfcEmisortextoRFC del emisor.
rfcReceptortextoRFC del receptor.
totalnúmeroTotal del comprobante.
emisorSinRegistro69Bbooleano o nulltrue si el emisor no aparece en la lista 69-B (EFOS) del SAT; false si aparece; null si no se pudo consultar.
consultadoEnfecha y hora (UTC)Momento de la consulta al SAT.

Errores

EstadocodigoCuándo
400datos_invalidosFalta un dato o tiene mal formato; "errors" indica cada campo.
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
429cuota_agotadaSe terminaron las consultas del periodo; "detail" dice cuándo se reinician y "reiniciaEn" trae la fecha.
502servicio_no_disponibleEl SAT no respondió. No se descuenta la consulta; vuelve a intentar en unos minutos.
curl -X POST https://app.cfdilayer.com/v1/verificaciones \
  -H "X-Api-Key: TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"uuid":"3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01","rfcEmisor":"DEM010101AB1","rfcReceptor":"EEJ010101AB1","total":18560.00}'
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$cuerpo = @{ uuid = "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01"; rfcEmisor = "DEM010101AB1"; rfcReceptor = "EEJ010101AB1"; total = 18560.00 } | ConvertTo-Json
$respuesta = Invoke-RestMethod -Method Post -Uri "https://app.cfdilayer.com/v1/verificaciones" -Headers $cabeceras -ContentType "application/json" -Body $cuerpo
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var respuesta = await http.PostAsJsonAsync("/v1/verificaciones", new
{
    uuid = "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01",
    rfcEmisor = "DEM010101AB1",
    rfcReceptor = "EEJ010101AB1",
    total = 18560.00
});
var json = await respuesta.Content.ReadAsStringAsync(); // respuesta.IsSuccessStatusCode indica si salió bien
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.post("https://app.cfdilayer.com/v1/verificaciones", headers=cabeceras, json={"uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "rfcEmisor": "DEM010101AB1", "rfcReceptor": "EEJ010101AB1", "total": 18560.00})
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/verificaciones", {
  method: "POST",
  headers: { "X-Api-Key": "TU_LLAVE", "Content-Type": "application/json" },
  body: JSON.stringify({ uuid: "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", rfcEmisor: "DEM010101AB1", rfcReceptor: "EEJ010101AB1", total: 18560.00 })
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/verificaciones");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE", "Content-Type: application/json"],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["uuid" => "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "rfcEmisor" => "DEM010101AB1", "rfcReceptor" => "EEJ010101AB1", "total" => 18560.00]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01",
  "encontrado": true,
  "estatus": "Vigente",
  "vigente": true,
  "esCancelable": "No cancelable",
  "estatusCancelacion": "",
  "codigoSat": "S - Comprobante obtenido satisfactoriamente.",
  "rfcEmisor": "DEM010101AB1",
  "rfcReceptor": "EEJ010101AB1",
  "total": 18560.00,
  "emisorSinRegistro69B": true,
  "consultadoEn": "2026-10-02T21:57:21.4Z"
}

Auditoría avanzada

POST/v1/auditorias
Llave API o sesión Descuenta 1 consulta

Revisa el XML completo: que sea un CFDI legible, que cumpla el esquema del SAT, que el sello digital sea íntegro, que el certificado del emisor estuviera vigente, el estatus ante el SAT y la lista 69-B. Devuelve un score de 0 a 100 y un dictamen.

El certificado se evalúa a la fecha del timbrado: un certificado que ya venció sigue siendo válido para una factura timbrada cuando estaba vigente. Si selloDigital es false (documento alterado), revisa revision: datosAlterados dice exactamente qué cambió contra el original del SAT (por ejemplo, { "nodo": "Comprobante", "atributo": "Total", "valorOriginalSat": "18560.00", "valorEnArchivo": "9280.00" }) y descuadres explica qué cuenta no cuadra.

Cuerpo de la petición

CampoTipoDescripción
xmlBase64obligatoriotextoEl archivo XML timbrado, codificado en Base64. Hasta 2 MB.
nombreArchivotextoNombre del archivo, solo para identificarlo en el historial.

Respuesta

CampoTipoDescripción
uuidtexto o nullFolio fiscal del comprobante.
foliotexto o nullSerie y folio internos del emisor.
fechaEmisionfecha y horaFecha de emisión del comprobante.
fechaTimbradofecha y horaFecha en que el PAC lo timbró.
tipoDeComprobantetextoI ingreso, E egreso, T traslado, N nómina, P pago.
emisorobjetorfc y nombre del emisor.
receptorobjetorfc y nombre del receptor.
totalnúmero o nullTotal del comprobante.
monedatexto o nullClave de moneda (MXN, USD…).
scoreenteroConfianza de 0 a 100.
niveltexto"Confiable", "ConObservaciones" o "ConIrregularidades".
dictamentextoEl dictamen en palabras, listo para mostrar.
verificacionesobjetoSeis resultados: documentoValido, esquemaXsd, selloDigital, estatusVigenteSat, certificadoVigente y emisorSinRegistro69B. Cada uno es true (aprobada), false (falló) o null (no se pudo evaluar; no castiga el score).
estatusSatobjeto o nullEl mismo objeto que devuelve la verificación rápida.
certificadoobjeto o nullexpedido, vence y vigente del certificado con el que se selló.
esquemaobjeto o nullnodosAnalizados, nodosCorrectos y nodosFallidos de la validación contra el esquema del SAT.
revisionobjetoQué se alteró. comparadoConOriginalSat: true si la factura está en la bóveda de tu cuenta y se comparó contra el XML original del SAT. datosAlterados: cada dato distinto al original (nodo, atributo, valorOriginalSat, valorEnArchivo); vacío si todo coincide o si no se pudo comparar. descuadres: cuentas del propio XML que no cuadran (titulo, detalle), p. ej., el Total contra SubTotal + impuestos; se revisa siempre, aunque no tengamos el original.

Errores

EstadocodigoCuándo
400datos_invalidosFalta un dato o tiene mal formato; "errors" indica cada campo.
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
422xml_no_es_cfdiEl archivo no es un CFDI legible (no se descuenta la consulta).
429cuota_agotadaSe terminaron las consultas del periodo; "detail" dice cuándo se reinician y "reiniciaEn" trae la fecha.
502servicio_no_disponibleEl SAT no respondió. No se descuenta la consulta; vuelve a intentar en unos minutos.
curl -X POST https://app.cfdilayer.com/v1/auditorias \
  -H "X-Api-Key: TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d "{\"xmlBase64\":\"$(base64 -w0 factura.xml)\",\"nombreArchivo\":\"factura.xml\"}"
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$xml = [Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\facturas\factura.xml"))
$cuerpo = @{ xmlBase64 = $xml; nombreArchivo = "factura.xml" } | ConvertTo-Json
$respuesta = Invoke-RestMethod -Method Post -Uri "https://app.cfdilayer.com/v1/auditorias" -Headers $cabeceras -ContentType "application/json" -Body $cuerpo
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");
var xmlBase64 = Convert.ToBase64String(await File.ReadAllBytesAsync("factura.xml"));

var respuesta = await http.PostAsJsonAsync("/v1/auditorias", new
{
    xmlBase64 = xmlBase64,
    nombreArchivo = "factura.xml"
});
var json = await respuesta.Content.ReadAsStringAsync(); // respuesta.IsSuccessStatusCode indica si salió bien
Console.WriteLine(json);
import requests, base64

cabeceras = {"X-Api-Key": "TU_LLAVE"}
xml = base64.b64encode(open("factura.xml", "rb").read()).decode()
r = requests.post("https://app.cfdilayer.com/v1/auditorias", headers=cabeceras, json={"xmlBase64": xml, "nombreArchivo": "factura.xml"})
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
import { readFile } from "node:fs/promises";
const xml = (await readFile("factura.xml")).toString("base64");
const respuesta = await fetch("https://app.cfdilayer.com/v1/auditorias", {
  method: "POST",
  headers: { "X-Api-Key": "TU_LLAVE", "Content-Type": "application/json" },
  body: JSON.stringify({ xmlBase64: xml, nombreArchivo: "factura.xml" })
});
console.log(respuesta.status, await respuesta.json());
<?php
$xml = base64_encode(file_get_contents("factura.xml"));
$ch = curl_init("https://app.cfdilayer.com/v1/auditorias");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE", "Content-Type: application/json"],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["xmlBase64" => $xml, "nombreArchivo" => "factura.xml"]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01",
  "folio": "A1045",
  "fechaEmision": "2026-09-10T11:20:05-06:00",
  "fechaTimbrado": "2026-09-10T11:20:08-06:00",
  "tipoDeComprobante": "I",
  "emisor":   { "rfc": "DEM010101AB1", "nombre": "DEMOSTRACIONES EJEMPLO SA DE CV" },
  "receptor": { "rfc": "EEJ010101AB1", "nombre": "EMPRESA EJEMPLO SA DE CV" },
  "total": 18560.00,
  "moneda": "MXN",
  "score": 100,
  "nivel": "Confiable",
  "dictamen": "Comprobante confiable",
  "verificaciones": {
    "documentoValido": true,
    "esquemaXsd": true,
    "selloDigital": true,
    "estatusVigenteSat": true,
    "certificadoVigente": true,
    "emisorSinRegistro69B": true
  },
  "estatusSat": { "uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "encontrado": true, "estatus": "Vigente", "vigente": true, "esCancelable": "No cancelable", "codigoSat": "S - Comprobante obtenido satisfactoriamente.", "emisorSinRegistro69B": true },
  "certificado": { "expedido": "2024-03-15T10:00:00-06:00", "vence": "2028-03-15T10:00:00-06:00", "vigente": true },
  "esquema": { "nodosAnalizados": 52, "nodosCorrectos": 52, "nodosFallidos": 0 },
  "revision": { "comparadoConOriginalSat": true, "datosAlterados": [], "descuadres": [] }
}

Cuenta y saldo

Saldo de la cuenta

GET/v1/cuenta/consumo
Llave API o sesión No descuenta consultas

Cuántas consultas lleva la cuenta en cada bolsa y cuándo se reinicia cada una. No descuenta consultas.

Con llave API, la bolsa que te interesa es "api". Las bolsas "verificaciones" y "auditorias" son las del día en el sitio y la app.

Respuesta

CampoTipoDescripción
plantextoNombre del plan de la cuenta.
bolsas[]listaUna por bolsa de consumo: "verificaciones" y "auditorias" (por día, las del sitio y la app) y "api" (por mes, las consultas con llave).
bolsas[].nombretexto"verificaciones", "auditorias" o "api".
bolsas[].periodotexto"dia" o "mes".
bolsas[].limiteenteroConsultas incluidas en el periodo.
bolsas[].usadasenteroConsultas usadas en el periodo.
bolsas[].restantesenteroLas que quedan.
bolsas[].reiniciaEnfecha y hora (UTC)Cuándo vuelve a empezar el periodo (las 00:00 del centro de México).

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
curl "https://app.cfdilayer.com/v1/cuenta/consumo" \
  -H "X-Api-Key: TU_LLAVE"
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/cuenta/consumo" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var json = await http.GetStringAsync("/v1/cuenta/consumo");
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.get("https://app.cfdilayer.com/v1/cuenta/consumo", headers=cabeceras)
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/cuenta/consumo", {
  method: "GET",
  headers: { "X-Api-Key": "TU_LLAVE" }
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/cuenta/consumo");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE"],
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "plan": "Cuenta gratuita",
  "bolsas": [
    { "nombre": "verificaciones", "periodo": "dia", "limite": 10, "usadas": 0, "restantes": 10, "reiniciaEn": "2026-10-03T06:00:00Z" },
    { "nombre": "auditorias", "periodo": "dia", "limite": 10, "usadas": 0, "restantes": 10, "reiniciaEn": "2026-10-03T06:00:00Z" },
    { "nombre": "api", "periodo": "mes", "limite": 100, "usadas": 3, "restantes": 97, "reiniciaEn": "2026-11-01T06:00:00Z" }
  ]
}

Datos de la cuenta

GET/v1/cuenta
Llave API o sesión No descuenta consultas

Datos de la cuenta dueña de la llave o de la sesión.

Respuesta

CampoTipoDescripción
idtextoIdentificador de la cuenta.
correotextoCorreo con el que se inicia sesión.
nombretexto o nullNombre de la persona.
empresatexto o nullEmpresa, si la capturó.
rfctexto o nullRFC de la empresa, si lo capturó.
roltexto"Cliente" o "Superusuario".
fechaRegistrofecha y hora (UTC)Cuándo se creó la cuenta.
dosFactoresbooleanoSi la cuenta tiene verificación en dos pasos.

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
curl "https://app.cfdilayer.com/v1/cuenta" \
  -H "X-Api-Key: TU_LLAVE"
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/cuenta" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var json = await http.GetStringAsync("/v1/cuenta");
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.get("https://app.cfdilayer.com/v1/cuenta", headers=cabeceras)
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/cuenta", {
  method: "GET",
  headers: { "X-Api-Key": "TU_LLAVE" }
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/cuenta");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE"],
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "id": "4035f4fb-f8cd-4db6-aa48-2fc13f13028b",
  "correo": "contabilidad@empresa.mx",
  "nombre": "Ana Pérez",
  "empresa": "Empresa Ejemplo, S.A. de C.V.",
  "rfc": "EEJ010101AB1",
  "rol": "Cliente",
  "fechaRegistro": "2026-10-02T21:57:15Z",
  "dosFactores": false
}

Planes y precios

GET/v1/planes
Sin autenticación No descuenta consultas

Los planes vigentes, los mismos que muestra el sitio. No requiere llave.

Respuesta

CampoTipoDescripción
gratisobjetoverificacionesPorDia, auditoriasPorDia y consultasApiPorMes de la cuenta gratuita.
descuentoAnualPorcientoenteroDescuento por pago anual.
planes[]listaclave, nombre, precioMensual (MXN más IVA), consultasPorMes, excedentePorConsulta, recomendado y descripcion.
curl "https://app.cfdilayer.com/v1/planes"
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/planes"
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };

var json = await http.GetStringAsync("/v1/planes");
Console.WriteLine(json);
import requests

r = requests.get("https://app.cfdilayer.com/v1/planes")
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/planes", {
  method: "GET",
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/planes");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "gratis": { "verificacionesPorDia": 10, "auditoriasPorDia": 10, "consultasApiPorMes": 100 },
  "descuentoAnualPorciento": 15,
  "planes": [
    { "clave": "emprendedor", "nombre": "Emprendedor", "precioMensual": 349, "consultasPorMes": 500, "excedentePorConsulta": 0.90, "recomendado": false, "descripcion": "Soporte por correo" },
    { "clave": "profesional", "nombre": "Profesional", "precioMensual": 999, "consultasPorMes": 3000, "excedentePorConsulta": 0.50, "recomendado": true, "descripcion": "Soporte prioritario por correo" },
    { "clave": "empresarial", "nombre": "Empresarial", "precioMensual": 2999, "consultasPorMes": 15000, "excedentePorConsulta": 0.30, "recomendado": false, "descripcion": "Acuerdo de nivel de servicio (SLA), varias llaves API y acompañamiento en la integración" }
  ]
}

Complementos de pago

Pagos de una factura

GET/v1/facturas/{uuid}/pagos
Llave API o sesión Descuenta No descuenta consultas

Los complementos de pago, las notas de crédito y el saldo de una factura de tu bóveda (facturas emitidas o recibidas por las empresas que tu cuenta descarga del SAT). Sirve para cargar automáticamente los complementos que tus proveedores no te mandan. No consulta al SAT ni descuenta consultas.

Solo hay complementos para facturas PPD (a crédito); las PUE se pagan de contado. El SAT da al emisor hasta el día 5 del mes siguiente al pago para timbrar el complemento.

Parámetros

CampoTipoDescripción
uuidobligatoriotexto (ruta)Folio fiscal de la factura.
incluirXmlbooleano (query)true para recibir el XML de cada complemento en xmlBase64. Por defecto false.

Respuesta

CampoTipoDescripción
facturaobjetouuid, serie, folio, fechaEmision, emisor, receptor, total, moneda, metodoPago y estatus de la factura.
resumenobjetoestado (SinPago, Parcial, Pagada o NoAplica si no es PPD o está cancelada), total, pagado, notasCredito, saldoPendiente y moneda. Es el mismo cálculo que ves en el portal.
complementos[]listaCada complemento: uuid, serie, folio, fechaEmision, emisor, receptor, estatus, fechaCancelacion, enBovedaDesde, canceladoDetectadoEn, cambioEn, documentosPagados[] (uuidFactura, fechaPago, numParcialidad, impSaldoAnterior, impPagado, impSaldoInsoluto, moneda) y xmlBase64.
notasCredito[]listauuid, fechaEmision, total, moneda y estatus de las notas de crédito que afectan a la factura.
descargaSatobjetorfc, automatica, completaHasta (fecha hasta la que la bóveda está completa) y ultimaDescarga (UTC). Un complemento timbrado después de completaHasta aparecerá en una descarga siguiente.

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
404no_esta_en_bovedaLa factura no está en tu bóveda (no es de una empresa que tu cuenta descarga del SAT, o aún no se descarga).
curl "https://app.cfdilayer.com/v1/facturas/{uuid}/pagos" \
  -H "X-Api-Key: TU_LLAVE"
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/facturas/{uuid}/pagos" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var json = await http.GetStringAsync("/v1/facturas/{uuid}/pagos");
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.get("https://app.cfdilayer.com/v1/facturas/{uuid}/pagos", headers=cabeceras)
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/facturas/{uuid}/pagos", {
  method: "GET",
  headers: { "X-Api-Key": "TU_LLAVE" }
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/facturas/{uuid}/pagos");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE"],
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "factura": { "uuid": "3F2A9C10-7B4E-4D21-9A6F-5C1E8B7D2A01", "serie": "A", "folio": "1045", "fechaEmision": "2026-09-10T11:20:05", "emisor": { "rfc": "DEM010101AB1", "nombre": "DEMOSTRACIONES EJEMPLO" }, "receptor": { "rfc": "EEJ010101AB1", "nombre": "EMPRESA EJEMPLO" }, "total": 18560.00, "moneda": "MXN", "metodoPago": "PPD", "estatus": "Vigente" },
  "resumen": { "estado": "Parcial", "total": 18560.00, "pagado": 9280.00, "notasCredito": 0, "saldoPendiente": 9280.00, "moneda": "MXN" },
  "complementos": [
    { "uuid": "8C1D4E22-0A6B-4F3C-9E77-2B5D1A9C3F10", "serie": "P", "folio": "220", "fechaEmision": "2026-10-03T09:12:40", "emisor": { "rfc": "DEM010101AB1", "nombre": "DEMOSTRACIONES EJEMPLO" }, "receptor": { "rfc": "EEJ010101AB1", "nombre": "EMPRESA EJEMPLO" },
      "estatus": "Vigente", "fechaCancelacion": null, "enBovedaDesde": "2026-10-04T06:31:12Z", "canceladoDetectadoEn": null, "cambioEn": "2026-10-04T06:31:12Z",
      "documentosPagados": [ { "uuidFactura": "3F2A9C10-7B4E-4D21-9A6F-5C1E8B7D2A01", "fechaPago": "2026-10-01T12:00:00", "numParcialidad": 1, "impSaldoAnterior": 18560.00, "impPagado": 9280.00, "impSaldoInsoluto": 9280.00, "moneda": "MXN" } ],
      "xmlBase64": null }
  ],
  "notasCredito": [],
  "descargaSat": { "rfc": "EEJ010101AB1", "automatica": true, "completaHasta": "2026-11-11", "ultimaDescarga": "2026-11-12T06:51:06Z" }
}

Complementos nuevos o cancelados

GET/v1/pagos
Llave API o sesión Descuenta No descuenta consultas

Para sincronizar: los complementos de pago que entraron a tu bóveda, o que vimos cancelarse, entre «desde» y «corte». Se filtra por cuándo llegaron a la bóveda, no por la fecha de pago, para no perder los que se timbran tarde; un complemento que se cancela después vuelve a aparecer con su nuevo estatus. No consulta al SAT ni descuenta consultas.

Corrida típica: GET /v1/pagos?desde=(corte anterior)&rfc=(tu RFC)&incluirXml=true; mientras hayMas sea true, pide pagina=2, 3… con el mismo corte; al terminar, guarda el corte. Revisa descargaSat.completaHasta: lo timbrado después todavía puede llegar.

Parámetros

CampoTipoDescripción
desdeobligatoriofecha y hora UTC (query)Desde cuándo (sin incluirlo). En la primera corrida, la fecha desde la que quieres traer; después, el «corte» de la corrida anterior.
cortefecha y hora UTC (query)Hasta cuándo (incluido). Omítelo en la primera página: la respuesta trae el corte; manda ese mismo corte en las páginas siguientes.
rfctexto (query)RFC de una de tus empresas (emisora o receptora del complemento). Sin RFC devuelve todas tus empresas.
paginaentero (query)Número de página, desde 1. Por defecto 1.
tamanoentero (query)Complementos por página: hasta 500, o hasta 100 con incluirXml. Por defecto 100.
incluirXmlbooleano (query)true para recibir el XML de cada complemento en xmlBase64.

Respuesta

CampoTipoDescripción
desdefecha UTCEl desde aplicado.
cortefecha UTCEl corte aplicado. Guárdalo: es el «desde» de tu siguiente corrida.
pagina, tamano, total, hayMasentero / booleanoPaginación: hayMas = true si falta pedir más páginas con el mismo corte.
descargaSatobjeto o nullEstado de la descarga del SAT de ese RFC (solo si mandas rfc): rfc, automatica, completaHasta y ultimaDescarga.
complementos[]listaOrdenados por cambioEn; cada uno con los mismos campos que en «Pagos de una factura».

Errores

EstadocodigoCuándo
400datos_invalidosFalta un dato o tiene mal formato; "errors" indica cada campo.
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
curl "https://app.cfdilayer.com/v1/pagos" \
  -H "X-Api-Key: TU_LLAVE"
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/pagos" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var json = await http.GetStringAsync("/v1/pagos");
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.get("https://app.cfdilayer.com/v1/pagos", headers=cabeceras)
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/pagos", {
  method: "GET",
  headers: { "X-Api-Key": "TU_LLAVE" }
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/pagos");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE"],
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "desde": "2026-11-11T06:00:00Z", "corte": "2026-11-12T06:00:00Z", "pagina": 1, "tamano": 100, "total": 1, "hayMas": false,
  "descargaSat": { "rfc": "EEJ010101AB1", "automatica": true, "completaHasta": "2026-11-11", "ultimaDescarga": "2026-11-12T05:51:06Z" },
  "complementos": [
    { "uuid": "8C1D4E22-0A6B-4F3C-9E77-2B5D1A9C3F10", "serie": "P", "folio": "220", "fechaEmision": "2026-10-03T09:12:40", "emisor": { "rfc": "DEM010101AB1", "nombre": "DEMOSTRACIONES EJEMPLO" }, "receptor": { "rfc": "EEJ010101AB1", "nombre": "EMPRESA EJEMPLO" },
      "estatus": "Cancelado", "fechaCancelacion": "2026-11-11T13:02:10", "enBovedaDesde": "2026-10-04T06:31:12Z", "canceladoDetectadoEn": "2026-11-12T05:40:22Z", "cambioEn": "2026-11-12T05:40:22Z",
      "documentosPagados": [ { "uuidFactura": "3F2A9C10-7B4E-4D21-9A6F-5C1E8B7D2A01", "fechaPago": "2026-10-01T12:00:00", "numParcialidad": 1, "impSaldoAnterior": 18560.00, "impPagado": 9280.00, "impSaldoInsoluto": 9280.00, "moneda": "MXN" } ],
      "xmlBase64": null }
  ]
}

Historial

Listar validaciones

GET/v1/historial
Llave API o sesión No descuenta consultas

Las validaciones de la cuenta (hechas desde el sitio, la app o la API), de la más reciente a la más antigua, por páginas.

Ejemplo de dirección con filtros: /v1/historial?pagina=1&tamano=20&tipo=Auditoria

Parámetros

CampoTipoDescripción
paginaentero (query)Número de página, desde 1. Por defecto 1.
tamanoentero (query)Elementos por página, de 1 a 100. Por defecto 20.
tipotexto (query)Filtra por "Verificacion" o "Auditoria". Sin filtro devuelve ambas.

Respuesta

CampoTipoDescripción
totalenteroCuántas validaciones hay en total (con el filtro aplicado).
paginaenteroPágina devuelta.
tamanoenteroTamaño de página aplicado.
elementos[]listaLas validaciones de la página; cada una con los campos de abajo.
elementos[].identeroIdentificador de la validación; sirve para pedir su detalle.
elementos[].fechafecha y hora (UTC)Cuándo se hizo.
elementos[].tipotexto"Verificacion" o "Auditoria".
elementos[].origentextoDesde dónde se hizo: "Web", "App" o "Api".
elementos[].nombreArchivotexto o nullNombre del XML, solo en auditorías.
elementos[].uuidtexto o nullFolio fiscal.
elementos[].rfcEmisortexto o nullRFC del emisor.
elementos[].rfcReceptortexto o nullRFC del receptor.
elementos[].totalnúmero o nullTotal del comprobante.
elementos[].scoreentero o nullScore de la auditoría (0 a 100); null en verificaciones.
elementos[].estatustexto o nullEstatus ante el SAT en ese momento.
elementos[].selloValidobooleano o nullResultado del sello digital, solo en auditorías.
elementos[].emisorSinRegistro69Bbooleano o nullSi el emisor estaba fuera de la lista 69-B.

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
curl "https://app.cfdilayer.com/v1/historial" \
  -H "X-Api-Key: TU_LLAVE"
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/historial" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var json = await http.GetStringAsync("/v1/historial");
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.get("https://app.cfdilayer.com/v1/historial", headers=cabeceras)
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/historial", {
  method: "GET",
  headers: { "X-Api-Key": "TU_LLAVE" }
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/historial");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE"],
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "total": 42,
  "pagina": 1,
  "tamano": 2,
  "elementos": [
    { "id": 10083, "fecha": "2026-10-02T21:57:22Z", "tipo": "Auditoria", "origen": "Api", "nombreArchivo": "factura.xml", "uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "rfcEmisor": "DEM010101AB1", "rfcReceptor": "EEJ010101AB1", "total": 18560.00, "score": 100, "estatus": "Vigente", "selloValido": true, "emisorSinRegistro69B": true },
    { "id": 10082, "fecha": "2026-10-02T21:57:21Z", "tipo": "Verificacion", "origen": "Api", "nombreArchivo": null, "uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "rfcEmisor": "DEM010101AB1", "rfcReceptor": "EEJ010101AB1", "total": 18560.00, "score": null, "estatus": "Vigente", "selloValido": null, "emisorSinRegistro69B": true }
  ]
}

Detalle de una validación

GET/v1/historial/{id}
Llave API o sesión No descuenta consultas

Una validación del historial con la respuesta completa que se guardó cuando se hizo (la misma que devolvió la verificación o la auditoría).

Parámetros

CampoTipoDescripción
idobligatorioentero (ruta)El id que aparece en la lista.

Respuesta

CampoTipoDescripción
validacionobjetoLa validación, con los campos de la lista.
detalleobjeto o nullLa respuesta guardada: para una auditoría, los resultados de cada revisión; para una verificación, el estatus ante el SAT.

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
404validacion_no_encontradaNo hay una validación con ese id en la cuenta.
curl "https://app.cfdilayer.com/v1/historial/10083" \
  -H "X-Api-Key: TU_LLAVE"
$cabeceras = @{ "X-Api-Key" = "TU_LLAVE" }
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/historial/10083" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", "TU_LLAVE");

var json = await http.GetStringAsync("/v1/historial/10083");
Console.WriteLine(json);
import requests

cabeceras = {"X-Api-Key": "TU_LLAVE"}
r = requests.get("https://app.cfdilayer.com/v1/historial/10083", headers=cabeceras)
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/historial/10083", {
  method: "GET",
  headers: { "X-Api-Key": "TU_LLAVE" }
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/historial/10083");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: TU_LLAVE"],
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "validacion": { "id": 10083, "fecha": "2026-10-02T21:57:22Z", "tipo": "Auditoria", "origen": "Api", "nombreArchivo": "factura.xml", "uuid": "3f2a9c10-7b4e-4d21-9a6f-5c1e8b7d2a01", "rfcEmisor": "DEM010101AB1", "rfcReceptor": "EEJ010101AB1", "total": 18560.00, "score": 100, "estatus": "Vigente", "selloValido": true, "emisorSinRegistro69B": true },
  "detalle": { "esquemaXsd": { "listValidacionesNodos": [ "…" ] }, "selloDigital": { "esValido": true }, "estatusSat": { "estado": "Vigente" }, "…": "…" }
}

Llaves API

Listar llaves

GET/v1/llaves
Solo con sesión No descuenta consultas

Las llaves de la cuenta, activas y revocadas. Nunca devuelve la llave completa, solo su prefijo.

Respuesta

CampoTipoDescripción
identeroIdentificador de la llave (para revocarla).
nombretextoNombre que le dio el usuario.
prefijotextoLos primeros caracteres de la llave ("cl_" y 12 más): sirven para reconocerla sin mostrarla completa.
creadafecha y hora (UTC)Cuándo se creó.
ultimoUsofecha y hora (UTC) o nullÚltima petición hecha con ella.
activabooleanofalse cuando fue revocada.

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
curl "https://app.cfdilayer.com/v1/llaves" \
  -H "Authorization: Bearer TU_TOKEN_DE_ACCESO"
$cabeceras = @{ "Authorization" = "Bearer TU_TOKEN_DE_ACCESO" }
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/v1/llaves" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Authorization = new("Bearer", "TU_TOKEN_DE_ACCESO");

var json = await http.GetStringAsync("/v1/llaves");
Console.WriteLine(json);
import requests

cabeceras = {"Authorization": "Bearer TU_TOKEN_DE_ACCESO"}
r = requests.get("https://app.cfdilayer.com/v1/llaves", headers=cabeceras)
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/llaves", {
  method: "GET",
  headers: { "Authorization": "Bearer TU_TOKEN_DE_ACCESO" }
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/llaves");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer TU_TOKEN_DE_ACCESO"],
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
[
  { "id": 11, "nombre": "ERP de producción", "prefijo": "cl_eefa871eaf8f", "creada": "2026-10-02T21:57:19Z", "ultimoUso": "2026-10-02T21:58:03Z", "activa": true }
]

Crear una llave

POST/v1/llaves
Solo con sesión No descuenta consultas

Crea una llave para la cuenta. La llave completa viene solo en esta respuesta: guárdala en ese momento. Una cuenta puede tener hasta 3 llaves activas.

Cuerpo de la petición

CampoTipoDescripción
nombreobligatoriotextoNombre para reconocerla (hasta 100 caracteres).

Respuesta

CampoTipoDescripción
identeroIdentificador de la llave (para revocarla).
nombretextoNombre que le dio el usuario.
prefijotextoLos primeros caracteres de la llave ("cl_" y 12 más): sirven para reconocerla sin mostrarla completa.
creadafecha y hora (UTC)Cuándo se creó.
llavetextoLa llave completa (64 caracteres, empieza con "cl_"). No se puede volver a consultar.

Errores

EstadocodigoCuándo
400datos_invalidosFalta un dato o tiene mal formato; "errors" indica cada campo.
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
422llave_no_creadaYa hay 3 llaves activas; revoca una para crear otra.
curl -X POST https://app.cfdilayer.com/v1/llaves \
  -H "Authorization: Bearer TU_TOKEN_DE_ACCESO" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"ERP de producción"}'
$cabeceras = @{ "Authorization" = "Bearer TU_TOKEN_DE_ACCESO" }
$cuerpo = @{ nombre = "ERP de producción" } | ConvertTo-Json
$respuesta = Invoke-RestMethod -Method Post -Uri "https://app.cfdilayer.com/v1/llaves" -Headers $cabeceras -ContentType "application/json" -Body $cuerpo
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Authorization = new("Bearer", "TU_TOKEN_DE_ACCESO");

var respuesta = await http.PostAsJsonAsync("/v1/llaves", new
{
    nombre = "ERP de producción"
});
var json = await respuesta.Content.ReadAsStringAsync(); // respuesta.IsSuccessStatusCode indica si salió bien
Console.WriteLine(json);
import requests

cabeceras = {"Authorization": "Bearer TU_TOKEN_DE_ACCESO"}
r = requests.post("https://app.cfdilayer.com/v1/llaves", headers=cabeceras, json={"nombre": "ERP de producción"})
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/llaves", {
  method: "POST",
  headers: { "Authorization": "Bearer TU_TOKEN_DE_ACCESO", "Content-Type": "application/json" },
  body: JSON.stringify({ nombre: "ERP de producción" })
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/llaves");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer TU_TOKEN_DE_ACCESO", "Content-Type: application/json"],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["nombre" => "ERP de producción"]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "id": 11,
  "nombre": "ERP de producción",
  "prefijo": "cl_eefa871eaf8f",
  "creada": "2026-10-02T21:57:19Z",
  "llave": "cl_eefa871eaf8f_…48 caracteres más…"
}

Revocar una llave

DELETE/v1/llaves/{id}
Solo con sesión No descuenta consultas

La llave deja de funcionar de inmediato y no se puede reactivar. Responde 204 sin cuerpo.

Parámetros

CampoTipoDescripción
idobligatorioentero (ruta)El id de la llave.

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
404llave_no_encontradaNo hay una llave con ese id en la cuenta.
curl -X DELETE https://app.cfdilayer.com/v1/llaves/11 \
  -H "Authorization: Bearer TU_TOKEN_DE_ACCESO"
$cabeceras = @{ "Authorization" = "Bearer TU_TOKEN_DE_ACCESO" }
$respuesta = Invoke-RestMethod -Method Delete -Uri "https://app.cfdilayer.com/v1/llaves/11" -Headers $cabeceras
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Authorization = new("Bearer", "TU_TOKEN_DE_ACCESO");

var respuesta = await http.DeleteAsync("/v1/llaves/11"); // 204 si se revocó
import requests

cabeceras = {"Authorization": "Bearer TU_TOKEN_DE_ACCESO"}
r = requests.delete("https://app.cfdilayer.com/v1/llaves/11", headers=cabeceras)
print(r.status_code)  # 204 si se revocó
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/llaves/11", {
  method: "DELETE",
  headers: { "Authorization": "Bearer TU_TOKEN_DE_ACCESO" }
});
console.log(respuesta.status); // 204 si se revocó
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/llaves/11");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer TU_TOKEN_DE_ACCESO"],
    CURLOPT_CUSTOMREQUEST => "DELETE",
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);

Sesión (para apps)

Iniciar sesión

POST/v1/sesion/iniciar
Sin autenticación No descuenta consultas

Entra con el correo y la contraseña de la cuenta de cfdilayer.com. Devuelve un token de acceso (15 minutos) y uno de renovación (30 días). Es lo que usa la app de CFDI Layer; un sistema integrado no la necesita: usa su llave.

Límite: 10 intentos de inicio de sesión por minuto por dirección IP.

Cuerpo de la petición

CampoTipoDescripción
correoobligatoriotextoCorreo de la cuenta.
contrasenaobligatoriotextoContraseña.
codigo2fatextoCódigo de la app de autenticación, solo si la cuenta tiene verificación en dos pasos.
dispositivotextoNombre del dispositivo, para reconocer la sesión (por ejemplo "Pixel 9 · Android 15").

Respuesta

CampoTipoDescripción
tokenAccesotextoToken JWT para el encabezado Authorization: Bearer. Dura 15 minutos.
tokenAccesoExpirafecha y hora (UTC)Cuándo vence el token de acceso.
tokenRenovaciontextoToken para obtener tokens nuevos sin volver a pedir la contraseña. Dura 30 días y es de un solo uso.
tokenRenovacionExpirafecha y hora (UTC)Cuándo vence el token de renovación.
usuarioobjetoLos datos de la cuenta (ver GET /v1/cuenta).

Errores

EstadocodigoCuándo
400datos_invalidosFalta un dato o tiene mal formato; "errors" indica cada campo.
401credenciales_invalidasEl correo o la contraseña no son correctos.
401requiere_2faLa cuenta tiene dos pasos: repite la petición con codigo2fa.
401codigo_2fa_incorrectoEl código de dos pasos no es válido.
403correo_sin_confirmarLa cuenta aún no confirmó su correo.
403cuenta_bloqueadaDemasiados intentos; espera unos minutos.
403cuenta_deshabilitadaLa cuenta fue deshabilitada.
curl -X POST https://app.cfdilayer.com/v1/sesion/iniciar \
  -H "Content-Type: application/json" \
  -d '{"correo":"contabilidad@empresa.mx","contrasena":"TU_CONTRASEÑA","dispositivo":"Pixel 9 · Android 15"}'
$cuerpo = @{ correo = "contabilidad@empresa.mx"; contrasena = "TU_CONTRASEÑA"; dispositivo = "Pixel 9 · Android 15" } | ConvertTo-Json
$respuesta = Invoke-RestMethod -Method Post -Uri "https://app.cfdilayer.com/v1/sesion/iniciar" -ContentType "application/json" -Body $cuerpo
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };

var respuesta = await http.PostAsJsonAsync("/v1/sesion/iniciar", new
{
    correo = "contabilidad@empresa.mx",
    contrasena = "TU_CONTRASEÑA",
    dispositivo = "Pixel 9 · Android 15"
});
var json = await respuesta.Content.ReadAsStringAsync(); // respuesta.IsSuccessStatusCode indica si salió bien
Console.WriteLine(json);
import requests

r = requests.post("https://app.cfdilayer.com/v1/sesion/iniciar", json={"correo": "contabilidad@empresa.mx", "contrasena": "TU_CONTRASEÑA", "dispositivo": "Pixel 9 · Android 15"})
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/sesion/iniciar", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ correo: "contabilidad@empresa.mx", contrasena: "TU_CONTRASEÑA", dispositivo: "Pixel 9 · Android 15" })
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/sesion/iniciar");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["correo" => "contabilidad@empresa.mx", "contrasena" => "TU_CONTRASEÑA", "dispositivo" => "Pixel 9 · Android 15"]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{
  "tokenAcceso": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…",
  "tokenAccesoExpira": "2026-10-02T22:12:18Z",
  "tokenRenovacion": "q3Vb…",
  "tokenRenovacionExpira": "2026-11-01T21:57:18Z",
  "usuario": { "id": "4035f4fb-…", "correo": "contabilidad@empresa.mx", "nombre": "Ana Pérez", "rol": "Cliente", "dosFactores": false }
}

Renovar la sesión

POST/v1/sesion/renovar
Sin autenticación No descuenta consultas

Cambia el token de renovación por un par de tokens nuevos. El token de renovación usado deja de servir; si se vuelve a usar, la sesión completa se cierra por seguridad.

Cuerpo de la petición

CampoTipoDescripción
tokenRenovacionobligatoriotextoEl token de renovación vigente.

Respuesta

CampoTipoDescripción
…La misma respuesta que al iniciar sesión, con tokens nuevos.

Errores

EstadocodigoCuándo
400datos_invalidosFalta un dato o tiene mal formato; "errors" indica cada campo.
401sesion_vencidaEl token de renovación venció, ya se usó o la sesión se cerró: hay que iniciar sesión de nuevo.
curl -X POST https://app.cfdilayer.com/v1/sesion/renovar \
  -H "Content-Type: application/json" \
  -d '{"tokenRenovacion":"TU_TOKEN_DE_RENOVACION"}'
$cuerpo = @{ tokenRenovacion = "TU_TOKEN_DE_RENOVACION" } | ConvertTo-Json
$respuesta = Invoke-RestMethod -Method Post -Uri "https://app.cfdilayer.com/v1/sesion/renovar" -ContentType "application/json" -Body $cuerpo
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };

var respuesta = await http.PostAsJsonAsync("/v1/sesion/renovar", new
{
    tokenRenovacion = "TU_TOKEN_DE_RENOVACION"
});
var json = await respuesta.Content.ReadAsStringAsync(); // respuesta.IsSuccessStatusCode indica si salió bien
Console.WriteLine(json);
import requests

r = requests.post("https://app.cfdilayer.com/v1/sesion/renovar", json={"tokenRenovacion": "TU_TOKEN_DE_RENOVACION"})
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/sesion/renovar", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ tokenRenovacion: "TU_TOKEN_DE_RENOVACION" })
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/sesion/renovar");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["tokenRenovacion" => "TU_TOKEN_DE_RENOVACION"]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{ "tokenAcceso": "eyJ…", "tokenAccesoExpira": "2026-10-02T22:27:18Z", "tokenRenovacion": "k8Pz…", "tokenRenovacionExpira": "2026-11-01T22:12:18Z", "usuario": { "…": "…" } }

Cerrar la sesión

POST/v1/sesion/cerrar
Solo con sesión No descuenta consultas

El token de renovación deja de servir. Responde 204 sin cuerpo.

Cuerpo de la petición

CampoTipoDescripción
tokenRenovacionobligatoriotextoEl token de renovación de la sesión que se cierra.

Errores

EstadocodigoCuándo
401no_autenticadoFalta la llave, está mal escrita o fue revocada (o el token de sesión venció).
curl -X POST https://app.cfdilayer.com/v1/sesion/cerrar \
  -H "Authorization: Bearer TU_TOKEN_DE_ACCESO" \
  -H "Content-Type: application/json" \
  -d '{"tokenRenovacion":"TU_TOKEN_DE_RENOVACION"}'
$cabeceras = @{ "Authorization" = "Bearer TU_TOKEN_DE_ACCESO" }
$cuerpo = @{ tokenRenovacion = "TU_TOKEN_DE_RENOVACION" } | ConvertTo-Json
$respuesta = Invoke-RestMethod -Method Post -Uri "https://app.cfdilayer.com/v1/sesion/cerrar" -Headers $cabeceras -ContentType "application/json" -Body $cuerpo
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };
http.DefaultRequestHeaders.Authorization = new("Bearer", "TU_TOKEN_DE_ACCESO");

var respuesta = await http.PostAsJsonAsync("/v1/sesion/cerrar", new
{
    tokenRenovacion = "TU_TOKEN_DE_RENOVACION"
});
var json = await respuesta.Content.ReadAsStringAsync(); // respuesta.IsSuccessStatusCode indica si salió bien
Console.WriteLine(json);
import requests

cabeceras = {"Authorization": "Bearer TU_TOKEN_DE_ACCESO"}
r = requests.post("https://app.cfdilayer.com/v1/sesion/cerrar", headers=cabeceras, json={"tokenRenovacion": "TU_TOKEN_DE_RENOVACION"})
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/v1/sesion/cerrar", {
  method: "POST",
  headers: { "Authorization": "Bearer TU_TOKEN_DE_ACCESO", "Content-Type": "application/json" },
  body: JSON.stringify({ tokenRenovacion: "TU_TOKEN_DE_RENOVACION" })
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/v1/sesion/cerrar");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer TU_TOKEN_DE_ACCESO", "Content-Type: application/json"],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["tokenRenovacion" => "TU_TOKEN_DE_RENOVACION"]),
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);

Estado del servicio

Estado del servicio

GET/salud
Sin autenticación No descuenta consultas

Responde 200 cuando la API y su base de datos están disponibles; 503 si la base de datos no responde. No requiere llave y no cuenta como consulta.

Respuesta

CampoTipoDescripción
estadotexto"ok" o "sin_base_de_datos".
fechafecha y hora (UTC)Hora del servidor.
curl "https://app.cfdilayer.com/salud"
$respuesta = Invoke-RestMethod -Method Get -Uri "https://app.cfdilayer.com/salud"
$respuesta | ConvertTo-Json -Depth 6
using System.Net.Http.Json;

using var http = new HttpClient { BaseAddress = new Uri("https://app.cfdilayer.com") };

var json = await http.GetStringAsync("/salud");
Console.WriteLine(json);
import requests

r = requests.get("https://app.cfdilayer.com/salud")
print(r.status_code, r.json())
// Node 18 o superior (fetch incluido)
const respuesta = await fetch("https://app.cfdilayer.com/salud", {
  method: "GET",
});
console.log(respuesta.status, await respuesta.json());
<?php
$ch = curl_init("https://app.cfdilayer.com/salud");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
]);
$respuesta = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
print_r($respuesta);
Respuesta
{ "estado": "ok", "fecha": "2026-10-02T21:57:17Z" }

¿Integraste la versión anterior de la API (api.cfdilayer.com)? Sigue en servicio y su referencia está en Swagger; sus llaves son distintas de las de esta API.

¿Dudas de integración o necesitas una llave de prueba? Escríbenos.

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.