SAT1 tokenPOST

Artículo 69

Verifica si un RFC aparece en alguna de las 14 listas de "contribuyentes publicados" del Artículo 69 del CFF (firmes, cancelados, no localizados, exigibles, sentencias, condonados, etc.). Devuelve un arreglo con un elemento por cada lista donde el RFC aparezca; los campos de cada elemento varían según el listado.

Endpoint

POSThttps://api.datosnonstop.com/v1/sat/articulo-69

Parámetros

json

{
  "rfc": "AAA010101AA1"
}

ParámetroTipoRequeridoDescripción

rfcstringSíRFC del contribuyente a consultar (persona física 13 o moral 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/articulo-69 \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"AAA010101AA1"}'

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": "7a3b912e4d8f1c5a9e27b055",
  "status": "found",
  "rfc": "AAA010101AA1",
  "resultados": [
    {
      "listado": "firmes",
      "rfc": "AAA010101AA1",
      "razonSocial": "EMPRESA EJEMPLO SA DE CV",
      "tipoPersona": "M",
      "supuesto": "FIRMES",
      "fechaDePrimeraPublicacion": "2014-01-01",
      "entidadFederativa": "CIUDAD DE MEXICO"
    },
    {
      "listado": "cancelados",
      "rfc": "AAA010101AA1",
      "razonSocial": "EMPRESA EJEMPLO SA DE CV",
      "tipoPersona": "M",
      "supuesto": "CANCELADOS POR INSOLVENCIA",
      "fechaDeCancelacion": "2019-05-28",
      "monto": "1,390,273",
      "fechaDePublicacion": "2019-08-20",
      "entidadFederativa": "MORELOS"
    }
  ]
}

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 del contribuyente. 12 caracteres para personas morales, 13 para personas físicas (6 dígitos de fecha + homoclave de 3 caracteres).

Campos de respuesta

CampoTipoDescripción

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

statusstringResultado de la consulta del RFC en las listas del Artículo 69 del SAT. Ver catálogo Status.

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

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

resultadosarrayLista de coincidencias, una por cada listado del Art. 69 donde aparece el RFC. Los campos de cada elemento varían según el listado: solo listado, rfc, razonSocial y tipoPersona son constantes; el resto depende de la lista. Vacía o ausente cuando no hay coincidencias.

resultados[].listadostringIdentificador de la lista del Art. 69 en la que aparece el RFC. Ver catálogo Listado.

resultados[].rfcstringRFC del contribuyente publicado.

resultados[].razonSocialstringNombre o razón social del contribuyente.

resultados[].tipoPersonastringTipo de persona: F (física) o M (moral). Ver catálogo Tipo de persona.

resultados[].supuestostringSupuesto o motivo de la publicación (varía por listado).

resultados[].entidadFederativastringEntidad federativa asociada al registro.

resultados[].fechaDePrimeraPublicacionstringFecha (YYYY-MM-DD) de primera publicación. Presente según el listado.

resultados[].fechaDeCancelacionstringFecha (YYYY-MM-DD) de cancelación. Presente según el listado.

resultados[].fechaDePublicacionstringFecha (YYYY-MM-DD) de publicación. Presente según el listado.

resultados[].montostringMonto asociado (p. ej. crédito cancelado/condonado). Presente según el listado.

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 aparece en al menos una de las listas del Artículo 69 del SAT. La respuesta incluye el arreglo resultados con un elemento por cada lista donde aparece.

not_foundEl RFC no aparece en ninguna de las listas del Artículo 69 del SAT. La respuesta incluye el campo message con el detalle.

Tipo de persona

Valores posibles del campo tipoPersona en cada elemento de resultados.

ValorDescripción

FPersona física

MPersona moral

Listado

Las 14 listas de "contribuyentes publicados" del Artículo 69 del CFF. El valor del campo listado identifica en cuál aparece el RFC.

ValorDescripción

canceladosCréditos cancelados

reduccion_multas_art74Reducción de multas (art. 74 CFF)

condonados_concurso_mercantil_art146bCondonados por concurso mercantil (art. 146-B CFF)

reduccion_recargos_art21Reducción de recargos (art. 21 CFF)

condonados_por_decretoCondonados por decreto

condonados_2007_2015Condonados 2007-2015

cancelados_146a_2007_2015Cancelados art. 146-A 2007-2015

retorno_inversionesRetorno de inversiones

exigiblesCréditos exigibles

firmesCréditos firmes

no_localizadosNo localizados

sentenciasSentencias

csd_sin_efectosCertificados de sello digital (CSD) sin efectos

entes_publicos_gobierno_omisosEntes públicos y de gobierno omisos

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sat/articulo-69

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/articulo-69 \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"AAA010101AA1"}'

Casos de prueba

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

CasoRFC

Caso exitoso — EncontradoAAA010101AA1

Caso exitoso — No encontradoZZZ990101ZZ9

Sin tokensTOK010101TK1

Error internoERR010101ER1

Unavailable serviceUNA010101UN1

Empezar gratis →