SAT1 tokenPOST

Validar RFC y datos

Consulta directamente con el servicio oficial del SAT si un RFC está registrado y si el código postal y el nombre o razón social proporcionados coinciden con los datos del padrón de contribuyentes. Devuelve el estatus de la consulta y el mensaje textual que reporta el SAT.

Endpoint

POSThttps://api.datosnonstop.com/v1/sat/validar-rfc-y-datos

Parámetros

json

{
  "rfc": "MAMA900119U24",
  "cp": "09810",
  "nombre": "Jose Montes"
}

ParámetroTipoRequeridoDescripción

rfcstringSíRFC a validar (12 caracteres para personas morales, 13 para personas físicas).

cpstringSíCódigo postal de 5 dígitos registrado ante el SAT.

nombrestringSíNombre completo o razón social del contribuyente, tal como aparece en el SAT.

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/sat/validar-rfc-y-datos \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"MAMA900119U24","cp":"09810","nombre":"Jose Montes"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "63b5c073cd0f651ec4322403",
  "status": "found",
  "rfc": "MAMA900119U24",
  "cp": "09810",
  "nombre": "Jose Montes",
  "resultado": "RFC válido, y susceptible de recibir facturas"
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "rfc"
  },
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "cp"
  },
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "nombre"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

rfcstringRFC del contribuyente. 12 caracteres para personas morales, 13 para personas físicas.

cpstringCódigo postal de 5 dígitos registrado ante el SAT.

nombrestringNombre completo o razón social del contribuyente, tal como está registrado en el SAT.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringResultado de la consulta del RFC y sus datos en el SAT. Ver catálogo Status.

rfcstringRFC consultado, tal como se envió en la solicitud.

cpstringCódigo postal consultado, tal como se envió en la solicitud.

nombrestringNombre o razón social consultado, tal como se envió en la solicitud.

resultadostringMensaje textual que devuelve el SAT sobre la coincidencia del RFC y los datos.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

foundEl RFC está registrado y los datos enviados coinciden con el padrón del SAT.

not_foundEl RFC no fue localizado, o el código postal o el nombre no coinciden con el padrón del SAT. El detalle aparece en el campo resultado.

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sat/validar-rfc-y-datos

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/sat/validar-rfc-y-datos \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"MAMA900119U24","cp":"09810","nombre":"Jose Montes"}'

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de MAMA900119U24.

CasoCamporfc

Caso exitoso — EncontradorfcMAMA900119U24

Caso exitoso — No encontradorfcXAXX010101000

Sin tokensrfcSINX010101SN1

Error internorfcERRX010101ER1

Unavailable servicerfcUNAX010101UN1

Empezar gratis →