SAT1 tokenPOST

Certificados de Persona Moral

Consulta los certificados digitales que una persona moral tiene registrados ante el SAT a partir de su RFC. Devuelve, por cada certificado, su número de serie, tipo (FIEL o SELLO), estado (Activo, Revocado o Caduco) y su periodo de vigencia.

Endpoint

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

Parámetros

json

{
  "rfc": "NKO080220554"
}

ParámetroTipoRequeridoDescripción

rfcstringSíRFC de la persona moral cuyos certificados se desean consultar (exactamente 12 caracteres).

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/certificados-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",
  "certificados": [
    {
      "numeroSerie": "00001000000511706145",
      "tipo": "FIEL",
      "estado": "Activo",
      "fechaInicio": "2022-03-02T05:04:08Z",
      "fechaFin": "2026-03-02T05:04:48Z"
    },
    {
      "numeroSerie": "00001000000401234567",
      "tipo": "SELLO",
      "estado": "Revocado",
      "fechaInicio": "2020-01-01T00:00:00Z",
      "fechaFin": "2024-01-01T00:00:00Z",
      "error": "El certificado no está disponible debido a su antigüedad."
    }
  ]
}

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. Exactamente 12 caracteres: 3 letras, 6 dígitos de fecha y 3 de homoclave.

Campos de respuesta

CampoTipoDescripción

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

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

rfcstringRFC consultado (12 caracteres).

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

certificadosarrayLista de certificados registrados ante el SAT para el RFC. Solo está presente cuando status es found.

certificados[].numeroSeriestringNúmero de serie del certificado asignado por el SAT.

certificados[].tipostringTipo de certificado. Ver catálogo Tipo.

certificados[].estadostringEstado actual del certificado ante el SAT. Ver catálogo Estado.

certificados[].fechaIniciostringInicio de vigencia del certificado en formato RFC3339.

certificados[].fechaFinstringFin de vigencia del certificado en formato RFC3339.

certificados[].errorstringDetalle cuando un certificado no pudo recuperarse por completo. Solo está presente en los certificados que reportan un problema.

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 SAT tiene certificados registrados para el RFC. La respuesta incluye el arreglo certificados.

not_foundEl SAT no tiene certificados registrados para el RFC. La respuesta incluye el campo message.

Tipo

Valores posibles del campo certificados[].tipo.

ValorDescripción

FIELCertificado de la e.firma (Firma Electrónica Avanzada) del contribuyente.

SELLOCertificado de Sello Digital (CSD) usado para timbrar CFDI.

Estado

Valores posibles del campo certificados[].estado.

ValorDescripción

ActivoEl certificado está vigente y puede utilizarse.

RevocadoEl certificado fue revocado ante el SAT y ya no es válido.

CaducoEl certificado expiró al alcanzar su fecha de fin de vigencia.

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sat/certificados-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/certificados-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 →