SAT1 tokenPOST

Datos del RFC — Persona moral

Consulta los datos registrados ante el SAT para el RFC de una persona moral (12 caracteres). Devuelve la razón social, el correo electrónico y la CURP y RFC del representante legal cuando existe registro.

Endpoint

POSThttps://api.datosnonstop.com/v1/sat/datos-rfc-persona-moral

Parámetros

json

{
  "rfc": "NKO080220554"
}

ParámetroTipoRequeridoDescripción

rfcstringSíRFC de la persona moral a consultar (exactamente 12 caracteres: 3 letras, 6 dígitos y 3 caracteres de homoclave).

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/datos-rfc-persona-moral \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"NKO080220554"}'

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": "NKO080220554",
  "razonSocial": "NKONECT SA DE CV",
  "email": "contacto@nkonect.com",
  "curpRepresentanteLegal": "AISC830531MDFRSY07",
  "rfcRepresentanteLegal": "AISC830531I14"
}

Respuestas en error

JSON

400 Bad Request

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

Campos

Campos de entrada

CampoTipoDescripción

rfcstringRFC de la persona moral. 12 caracteres: 3 letras iniciales, 6 dígitos de fecha de constitución y 3 caracteres de homoclave.

Campos de respuesta

CampoTipoDescripción

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

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

rfcstringRFC consultado.

razonSocialstringRazón social de la persona moral registrada ante el SAT. Solo está presente cuando status es found.

emailstringCorreo electrónico registrado ante el SAT. Solo está presente cuando status es found.

curpRepresentanteLegalstringCURP del representante legal. Solo está presente cuando status es found.

rfcRepresentanteLegalstringRFC del representante legal. Solo está presente cuando status es found.

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.

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 fue localizado en el SAT. La respuesta incluye razonSocial, email, curpRepresentanteLegal y rfcRepresentanteLegal.

not_foundEl RFC no fue localizado en el SAT con los datos enviados. La respuesta incluye el campo message con el detalle.

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sat/datos-rfc-persona-moral

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/datos-rfc-persona-moral \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"NKO080220554"}'

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

CasoCamporfc

Caso exitoso — EncontradorfcNKO080220554

Caso exitoso — No encontradorfcXAX010101000

Sin tokensrfcSIN010101SN1

Error internorfcERR010101ER1

Unavailable servicerfcUNA010101UN1

Empezar gratis →