Valida los datos fiscales de tus clientes contra el SAT, en una sola llamada API.

Deja de pedirle a alguien de tu equipo que revise Constancias de Situación Fiscal a mano. Tu sistema sube el PDF, nosotros lo validamos contra el SAT en segundos y te regresamos el RFC, régimen y domicilio fiscal listos para timbrar.

# una llamada, con la CSF de tu cliente
curl -X POST https://api.validacionfiscal.mx/v1/mx/validaciones-fiscales \
  -H "Authorization: Bearer vf_live_..." \
  -F "archivo=@constancia.pdf"

Qué puedes hacer con la API

Cuatro capacidades sobre la misma cuenta y el mismo saldo de créditos — intégralas todas o solo la que necesites.

QR

Validación de CSF vía QR

Tu cliente sube la Constancia de Situación Fiscal en PDF. Extraemos el código QR y consultamos directo al SAT — el resultado refleja los datos vigentes hoy, sin importar qué tan vieja sea la CSF.

Revalidación instantánea

Con el folio de una validación anterior, vuelve a consultar al SAT sin pedir el PDF otra vez. Útil para confirmar que un proveedor sigue vigente antes de cada pago.

69B

Listado 69-B (EFOS)

Revisa si un RFC aparece en la lista de contribuyentes que el SAT presume facturan operaciones simuladas, antes de darlo de alta como proveedor.

Autofacturación para tus clientes

Registra una venta y dale a tu cliente final una liga pública para que capture sus propios datos fiscales — sin que tenga que crear una cuenta ni compartir ninguna credencial tuya.

Pruébala aquí mismo

Sin crear cuenta, sin pegar ninguna key tuya -- estos dos botones ya traen una API key de modo prueba (sandbox) integrada. Nunca tocan el SAT en vivo ni cuestan un crédito real, así que la respuesta es simulada -- pero es exactamente el mismo JSON, con la misma forma, que verías con una cuenta real.

Validar una CSF (PDF)

Sube cualquier PDF -- en modo prueba no se lee de verdad, regresa un resultado simulado de ejemplo.


      

Consultar lista 69-B

Escribe cualquier RFC -- en modo prueba, un RFC específico de ejemplo sale como "en la lista" y cualquier otro sale limpio.


      

¿Ya tienes cuenta? Genera tu propia API key (de prueba o real) desde tu panel, o revisa la documentación completa con todos los endpoints.

Cómo funciona

De cero a tu primera validación en minutos, sin hablar con nadie de nuestro equipo.

Crea tu cuenta

Te registras solo, sin aprobación manual, y confirmas tu correo.

Genera tu API key

Desde el panel, en modo prueba (sandbox) o en modo real (live) cuando estés listo.

Haz tu primera llamada

Mándanos el PDF de la CSF por API, con la key en el header Authorization.

Recibe el resultado

JSON con RFC, régimen fiscal, domicilio y un código de estatus claro — listo para tu sistema.

Pensada para integrarse, no para adivinar

Autenticación con API key, respuestas JSON consistentes, y códigos de error estables para que tu código reaccione sin tener que parsear texto en español.

Petición
POST /v1/mx/validaciones-fiscales
Authorization: Bearer vf_live_...
Content-Type: multipart/form-data

archivo=constancia.pdf
Respuesta 200
{
  "identificacion_fiscal": "AAA010101AAA",
  "razon_social": "MI EMPRESA SA DE CV",
  "regimen_fiscal_codigo": "601",
  "regimen_fiscal_descripcion": "General de Ley...",
  "codigo_postal": "06000",
  "token_validacion": "https://...",
  "creditos_consumidos": ["VALIDACION_CSF_MX"]
}

Seguridad y aislamiento por diseño

No es solo una capa de código: la separación entre clientes vive en la base de datos misma.

Aislamiento real entre cuentas

Cada cliente solo puede leer y escribir sus propios datos, reforzado a nivel de base de datos (row-level security), no solo por lógica de la aplicación.

Límite de peticiones

Cada API key y cada IP tienen un límite de peticiones por minuto, para frenar abuso antes de que afecte tu saldo o el servicio.

Modo sandbox real

Prueba tu integración completa con keys vf_test_... que nunca gastan crédito ni llaman al SAT — resultados simulados pero consistentes.

Sin cobros duplicados

Las llamadas que cobran crédito soportan una clave de idempotencia, para que un reintento por timeout de tu lado nunca te cobre dos veces.

Precios

Un solo saldo de créditos para todo — validaciones, revalidaciones, lista 69-B y autofacturación descuentan del mismo lugar. No todas las operaciones cuestan igual: cada llamada consume solo los créditos que su propio trabajo justifica.

Validar CSF (extracción + SAT)10 créditos
Revalidar / refrescar por QR5 créditos
Consultar lista negra 69-B1 crédito

Cargando planes...

¿Prefieres pago único? Paquetes prepago que no caducan

Cargando paquetes...

Preguntas frecuentes

¿En qué países funciona?

Hoy solo México, validando contra el SAT. Es el primer país que soportamos; nada de lo que integres hoy se rompe si se agregan más adelante.

¿Qué pasa si se me acaban los créditos a mitad de mes?

La llamada se rechaza (código 402) sin gastar nada — no se hace ningún cobro ni trabajo parcial. Puedes comprar un paquete prepago en cualquier momento; se suma a tu saldo aunque también tengas un plan activo.

¿Puedo probar la API sin gastar créditos reales?

Sí — crea una API key en modo "prueba" desde el panel. Nunca toca tu saldo real ni llama al SAT en vivo, y regresa respuestas simuladas pero con el mismo formato exacto que producción.

¿Necesito que mi cliente final tenga cuenta con ustedes?

No. La validación normal la haces tú, con tu propia API key, sobre el documento de tu cliente. El widget de autofacturación es la única parte donde el cliente final interactúa directo, y lo hace con una liga pública sin ninguna credencial.

¿Los créditos de los paquetes prepago caducan?

No. Los créditos de un plan de suscripción se renuevan cada ciclo y no se acumulan de un mes a otro, pero los de un paquete prepago no caducan y conviven con los del plan.

¿Por qué un paquete trae miles de créditos, no me van a alcanzar de sobra?

Cada operación consume un número distinto de créditos según el trabajo real que hace: validar una CSF completa (extracción + consulta al SAT) cuesta 10 créditos, revalidar/refrescar por QR cuesta 5, y consultar la lista negra 69-B cuesta 1. Un paquete de 6,000 créditos son ~600 validaciones completas, no 6,000 — la cantidad se ve grande porque el crédito individual vale poco, para que quepan con sentido operaciones más baratas que se agreguen después.

¿Cómo sé si una respuesta fue exitosa o un error?

El código HTTP te dice el tipo (200 éxito, 402 sin saldo, 422 documento no válido, 429 demasiadas peticiones). Cualquier error trae también un campo codigo estable en mayúsculas y un detail legible — revisa la documentación para el listado completo.

Deja de validar Constancias a mano

Crea tu cuenta, prueba en modo sandbox sin gastar nada, y cuando estés listo cambia a producción.

Crear cuenta gratis