SAT1 tokenPOST

Artículo 69-B (EFOS)

Verifica si un RFC aparece en el listado definitivo de contribuyentes que facturan operaciones simuladas (EFOS) publicado por el SAT conforme al Artículo 69-B del CFF. Devuelve el nombre, la situación y los oficios/fechas de publicación por etapa (presunción, desvirtuados, definitivos, sentencia favorable) en SAT y DOF.

Endpoint

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

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-b \
  -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": "7a3b912e4d8f1c5a9e27b041",
  "status": "found",
  "rfc": "AAA010101AA1",
  "nombreDelContribuyente": "EMPRESA EJEMPLO DEFINITIVA, S.A. DE C.V.",
  "situacionDelContribuyente": "Definitivo",
  "numeroYFechaDeOficioGlobalDePresuncionSat": "500-05-2023-1234 de fecha 15/01/2023",
  "publicacionPaginaSatPresuntos": "2023-01-20",
  "numeroYFechaDeOficioGlobalDePresuncionDof": "500-05-2023-1234 de fecha 15/01/2023",
  "publicacionDofPresuntos": "2023-01-25",
  "numeroYFechaDeOficioGlobalDeDefinitivosSat": "500-05-2023-5678 de fecha 01/04/2023",
  "publicacionPaginaSatDefinitivos": "2023-04-05",
  "numeroYFechaDeOficioGlobalDeDefinitivosDof": "500-05-2023-5678 de fecha 01/04/2023",
  "publicacionDofDefinitivos": "2023-04-10"
}

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 el listado del Artículo 69-B 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.

nombreDelContribuyentestringNombre o razón social del contribuyente como aparece en el listado del SAT.

situacionDelContribuyentestringEtapa en la que se encuentra el contribuyente dentro del procedimiento del Artículo 69-B (por ejemplo Presunto, Desvirtuado, Definitivo o Sentencia Favorable).

numeroYFechaDeOficioGlobalDePresuncionSatstringNúmero y fecha del oficio global de presunción publicado en la página del SAT. Se presenta según la etapa/estado del contribuyente.

publicacionPaginaSatPresuntosstringFecha de publicación en la página del SAT del listado de presuntos, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

numeroYFechaDeOficioGlobalDePresuncionDofstringNúmero y fecha del oficio global de presunción publicado en el DOF. Se presenta según la etapa/estado del contribuyente.

publicacionDofPresuntosstringFecha de publicación en el DOF del listado de presuntos, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

numeroYFechaDeOficioGlobalDeContribuyentesQueDesvirtuaronSatstringNúmero y fecha del oficio global de contribuyentes que desvirtuaron, publicado en la página del SAT. Se presenta según la etapa/estado del contribuyente.

publicacionPaginaSatDesvirtuadosstringFecha de publicación en la página del SAT del listado de desvirtuados, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

numeroYFechaDeOficioGlobalDeContribuyentesQueDesvirtuaronDofstringNúmero y fecha del oficio global de contribuyentes que desvirtuaron, publicado en el DOF. Se presenta según la etapa/estado del contribuyente.

publicacionDofDesvirtuadosstringFecha de publicación en el DOF del listado de desvirtuados, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

numeroYFechaDeOficioGlobalDeDefinitivosSatstringNúmero y fecha del oficio global de definitivos publicado en la página del SAT. Se presenta según la etapa/estado del contribuyente.

publicacionPaginaSatDefinitivosstringFecha de publicación en la página del SAT del listado de definitivos, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

numeroYFechaDeOficioGlobalDeDefinitivosDofstringNúmero y fecha del oficio global de definitivos publicado en el DOF. Se presenta según la etapa/estado del contribuyente.

publicacionDofDefinitivosstringFecha de publicación en el DOF del listado de definitivos, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

numeroYFechaDeOficioGlobalDeSentenciaFavorableSatstringNúmero y fecha del oficio global de sentencia favorable publicado en la página del SAT. Se presenta según la etapa/estado del contribuyente.

publicacionPaginaSatSentenciaFavorablestringFecha de publicación en la página del SAT del listado de sentencia favorable, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

numeroYFechaDeOficioGlobalDeSentenciaFavorableDofstringNúmero y fecha del oficio global de sentencia favorable publicado en el DOF. Se presenta según la etapa/estado del contribuyente.

publicacionDofSentenciaFavorablestringFecha de publicación en el DOF del listado de sentencia favorable, en formato YYYY-MM-DD. Se presenta según la etapa/estado del contribuyente.

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 el listado del Artículo 69-B del SAT. La respuesta incluye el nombre, la situación y los oficios/fechas de publicación por etapa.

not_foundEl RFC no aparece en el listado del Artículo 69-B del SAT. La respuesta incluye el campo message con el detalle.

Sandbox

Endpoint

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

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-b \
  -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 →