SAT1 tokenPOST

Generar RFC Persona Física

Genera el Registro Federal de Contribuyentes (RFC) de 13 caracteres con homoclave de una persona física a partir de sus nombres, apellidos y fecha de nacimiento, siguiendo el algoritmo oficial del SAT. El cálculo es determinístico: los mismos datos producen siempre el mismo RFC.

Endpoint

POSThttps://api.datosnonstop.com/v1/sat/generar-rfc-persona-fisica

Parámetros

json

{
  "nombres": "ROBERTO",
  "primerApellido": "GOMEZ",
  "segundoApellido": "GONZALEZ",
  "fechaNacimiento": "1991-12-05"
}

ParámetroTipoRequeridoDescripción

nombresstringSíNombre(s) de pila de la persona física.

primerApellidostringNoApellido paterno. Es obligatorio al menos uno de primerApellido o segundoApellido.

segundoApellidostringNoApellido materno. Es obligatorio al menos uno de primerApellido o segundoApellido.

fechaNacimientostringSíFecha de nacimiento en formato YYYY-MM-DD.

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/generar-rfc-persona-fisica \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"nombres":"ROBERTO","primerApellido":"GOMEZ","segundoApellido":"GONZALEZ","fechaNacimiento":"1991-12-05"}'

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",
  "rfc": "GOGR911205JG7",
  "nombres": "ROBERTO",
  "primerApellido": "GOMEZ",
  "segundoApellido": "GONZALEZ",
  "fechaNacimiento": "1991-12-05"
}

Respuestas en error

JSON

400 Bad Request

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

Campos

Campos de entrada

CampoTipoDescripción

nombresstringNombre(s) de pila de la persona física.

primerApellidostringApellido paterno. Debe enviarse al menos uno de primerApellido o segundoApellido.

segundoApellidostringApellido materno. Debe enviarse al menos uno de primerApellido o segundoApellido.

fechaNacimientostringFecha de nacimiento en formato YYYY-MM-DD (ISO 8601).

Campos de respuesta

CampoTipoDescripción

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

rfcstringRFC con homoclave de 13 caracteres calculado para la persona física.

nombresstringNombre(s) enviado(s) en la solicitud.

primerApellidostringApellido paterno enviado en la solicitud.

segundoApellidostringApellido materno enviado en la solicitud.

fechaNacimientostringFecha de nacimiento enviada en la solicitud.

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sat/generar-rfc-persona-fisica

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/generar-rfc-persona-fisica \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"nombres":"ROBERTO","primerApellido":"GOMEZ","segundoApellido":"GONZALEZ","fechaNacimiento":"1991-12-05"}'

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 ROBERTO.

CasoCamponombres

Caso exitoso — GeneradonombresROBERTO

Sin tokensnombresSINTOKENS

Error internonombresERRORINTERNO

Unavailable servicenombresNODISPONIBLE

Empezar gratis →