SAT1 tokenPOST

Constancia de Situación Fiscal

Consulta la Constancia de Situación Fiscal (CSF) de una persona física o moral en el SAT a partir del RFC y la CIEC. Obtén los datos de identificación del contribuyente, domicilio fiscal registrado, régimenes vigentes, actividades económicas, obligaciones fiscales y el PDF oficial codificado en base64.

Endpoint

POSThttps://api.datosnonstop.com/v1/sat/constancia-situacion-fiscal

Parámetros

json

{
  "rfc": "AAAA010123AB1",
  "ciec": "12345678"
}

ParámetroTipoRequeridoDescripción

rfcstringSíRFC del contribuyente cuya constancia se desea obtener (12 caracteres para personas morales, 13 para personas físicas).

ciecstringSíContraseña CIEC del contribuyente registrada ante el SAT.

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/constancia-situacion-fiscal \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"AAAA010123AB1","ciec":"12345678"}'

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": "64821d23824123766beac2be",
  "status": "found",
  "rfc": "AAAA010123AB1",
  "datosIdentificacionContribuyente": {
    "rfc": "AAAA010123AB1",
    "curp": "AAAA010123HDFBB01",
    "nombres": "NOMBRE DE ALGUIEN",
    "primerApellido": "ALGUNO",
    "segundoApellido": "ALGUN",
    "nombreComercial": "",
    "estatusPadron": "ACTIVO",
    "fechaInicioOperaciones": "2023-01-01",
    "fechaUltimoCambioEstado": "2023-06-11"
  },
  "datosDomicilioRegistrado": {
    "codigoPostal": "06500",
    "tipoVialidad": "AVENIDA (AV.)",
    "nombreVialidad": "PASEO DE LA REFORMA",
    "numeroExterior": "403",
    "numeroInterior": "8",
    "colonia": "CUAUHTEMOC",
    "nombreLocalidad": "CUAUHTEMOC",
    "municipio": "CUAUHTEMOC",
    "nombreEntidadFederativa": "CIUDAD DE MEXICO",
    "entreCalle": "RIO LERMA",
    "entreCalle2": "RIO NILO"
  },
  "actividadesEconomicas": [
    {
      "orden": "1",
      "actividadEconomica": "Asalariado",
      "porcentaje": "100",
      "fechaInicio": "2023-01-01",
      "fechaFin": ""
    }
  ],
  "regimenes": [
    {
      "regimen": "Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios",
      "fechaInicio": "2023-01-01",
      "fechaFin": ""
    }
  ],
  "obligaciones": [
    {
      "descripcionObligacion": "Declaración anual de ISR. Personas Físicas.",
      "descripcionVencimiento": "A más tardar el 30 de abril del ejercicio siguiente.",
      "fechaInicio": "2023-01-01",
      "fechaFin": ""
    }
  ],
  "pdfBase64": "JVBERi0xLjUKJafj8"
}

Respuestas en error

JSON

400 Bad Request

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

Campos

Campos de entrada

CampoTipoDescripción

rfcstringRFC del contribuyente cuya constancia se desea obtener. 12 caracteres para personas morales, 13 para personas físicas.

ciecstringContraseña CIEC del contribuyente registrada ante el SAT. Es la misma que se utiliza para acceder al portal del SAT.

Campos de respuesta

CampoTipoDescripción

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

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

rfcstringRFC consultado. Cuando status es found ecoa el RFC tal como aparece en la CSF; cuando status es not_found ecoa el valor enviado en la consulta.

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found. Ver catálogo Mensajes not_found.

datosIdentificacionContribuyenteobjectDatos de identificación del contribuyente registrados en el padrón del SAT. Solo está presente cuando status es found.

datosIdentificacionContribuyente.rfcstringRFC del contribuyente tal como aparece en la CSF.

datosIdentificacionContribuyente.curpstringCURP asociada al RFC (solo aplica para personas físicas; cadena vacía para personas morales).

datosIdentificacionContribuyente.nombresstringNombres de pila del contribuyente. Para personas morales contiene la denominación o razón social.

datosIdentificacionContribuyente.primerApellidostringPrimer apellido del contribuyente (solo personas físicas; cadena vacía para personas morales).

datosIdentificacionContribuyente.segundoApellidostringSegundo apellido del contribuyente (solo personas físicas; cadena vacía para personas morales).

datosIdentificacionContribuyente.nombreComercialstringNombre comercial registrado por el contribuyente. Cadena vacía cuando no se ha registrado.

datosIdentificacionContribuyente.estatusPadronstringEstatus del contribuyente en el padrón del RFC. Ver catálogo Estatus en el padrón.

datosIdentificacionContribuyente.fechaInicioOperacionesstringFecha en que el contribuyente inició operaciones ante el SAT (formato ISO YYYY-MM-DD).

datosIdentificacionContribuyente.fechaUltimoCambioEstadostringFecha del último cambio de estado registrado en el padrón (formato ISO YYYY-MM-DD).

datosDomicilioRegistradoobjectDomicilio fiscal registrado por el contribuyente ante el SAT. Solo está presente cuando status es found.

datosDomicilioRegistrado.codigoPostalstringCódigo postal de 5 dígitos del domicilio fiscal.

datosDomicilioRegistrado.tipoVialidadstringTipo de vialidad del domicilio (AVENIDA, CALLE, BOULEVARD, etc.) tal como lo registra el SAT.

datosDomicilioRegistrado.nombreVialidadstringNombre de la vialidad del domicilio fiscal.

datosDomicilioRegistrado.numeroExteriorstringNúmero exterior del inmueble del domicilio fiscal.

datosDomicilioRegistrado.numeroInteriorstringNúmero interior del inmueble (cuando aplica). Cadena vacía si no se registró.

datosDomicilioRegistrado.coloniastringColonia o asentamiento del domicilio fiscal.

datosDomicilioRegistrado.nombreLocalidadstringNombre de la localidad del domicilio fiscal.

datosDomicilioRegistrado.municipiostringMunicipio o demarcación territorial del domicilio fiscal.

datosDomicilioRegistrado.nombreEntidadFederativastringNombre de la entidad federativa del domicilio fiscal.

datosDomicilioRegistrado.entreCallestringPrimera calle de referencia del domicilio fiscal. Cadena vacía si no se registró.

datosDomicilioRegistrado.entreCalle2stringSegunda calle de referencia del domicilio fiscal. Cadena vacía si no se registró.

actividadesEconomicasarrayActividades económicas registradas por el contribuyente. Solo está presente cuando status es found.

actividadesEconomicas[].ordenstringOrden de prelación de la actividad económica.

actividadesEconomicas[].actividadEconomicastringDescripción de la actividad económica registrada.

actividadesEconomicas[].porcentajestringPorcentaje de ingresos que representa la actividad respecto al total.

actividadesEconomicas[].fechaIniciostringFecha de inicio de la actividad (formato ISO YYYY-MM-DD).

actividadesEconomicas[].fechaFinstringFecha de fin de la actividad. Cadena vacía cuando la actividad sigue vigente.

regimenesarrayRégimenes fiscales en los que está inscrito el contribuyente. Solo está presente cuando status es found.

regimenes[].regimenstringNombre del régimen fiscal.

regimenes[].fechaIniciostringFecha en que el contribuyente se inscribió al régimen (formato ISO YYYY-MM-DD).

regimenes[].fechaFinstringFecha de baja del régimen. Cadena vacía cuando el régimen sigue vigente.

obligacionesarrayObligaciones fiscales asociadas al contribuyente. Solo está presente cuando status es found.

obligaciones[].descripcionObligacionstringDescripción de la obligación fiscal.

obligaciones[].descripcionVencimientostringDescripción del plazo o fecha de vencimiento de la obligación.

obligaciones[].fechaIniciostringFecha de inicio de la obligación (formato ISO YYYY-MM-DD).

obligaciones[].fechaFinstringFecha de fin de la obligación. Cadena vacía cuando la obligación sigue vigente.

pdfBase64stringPDF oficial de la Constancia de Situación Fiscal codificado en base64. Solo está presente cuando status es 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

foundSe obtuvo la Constancia de Situación Fiscal del contribuyente. La respuesta incluye los datos de identificación, domicilio, régimenes, actividades, obligaciones y el PDF oficial.

not_foundNo se pudo obtener la constancia con los datos enviados. La respuesta incluye el campo message con el detalle.

Mensajes not_found

Mensajes posibles del campo message cuando status es not_found.

MensajeDescripción

El RFC no fue localizado en el padrón del SATEl RFC enviado no existe en el padrón del SAT.

La CIEC proporcionada no es válida para el RFC enviadoEl RFC existe en el padrón pero la CIEC no autenticó al contribuyente. Verifica la contraseña con el titular.

Estatus en el padrón

Valores posibles del campo datosIdentificacionContribuyente.estatusPadron que reporta el SAT sobre la situación del contribuyente en el padrón del RFC.

ValorDescripción

ACTIVOEl contribuyente se encuentra activo en el padrón del SAT y puede realizar operaciones.

SUSPENDIDOEl contribuyente solicitó la suspensión temporal de actividades; no genera obligaciones mientras dure la suspensión.

CANCELADOEl RFC fue cancelado por defunción, fusión, liquidación, cese total de operaciones u otra causa registrada por el SAT.

REACTIVADOEl contribuyente reanudó actividades después de un periodo de suspensión.

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/sat/constancia-situacion-fiscal/historico/{id}

El {id} corresponde al campo id devuelto en la respuesta de la consulta principal.

Si necesitas la lista completa de elementos almacenados, accede a tu dashboard.

La respuesta está sujeta al tiempo de almacenamiento de tu plan. Si requieres más tiempo, cambia de plan en tu dashboard.

Respuesta

JSON

200 OK

{
  "id": "64821d23824123766beac2be",
  "status": "found",
  "rfc": "AAAA010123AB1",
  "datosIdentificacionContribuyente": {
    "rfc": "AAAA010123AB1",
    "curp": "AAAA010123HDFBB01",
    "nombres": "NOMBRE DE ALGUIEN",
    "primerApellido": "ALGUNO",
    "segundoApellido": "ALGUN",
    "nombreComercial": "",
    "estatusPadron": "ACTIVO",
    "fechaInicioOperaciones": "2023-01-01",
    "fechaUltimoCambioEstado": "2023-06-11"
  },
  "datosDomicilioRegistrado": {
    "codigoPostal": "06500",
    "tipoVialidad": "AVENIDA (AV.)",
    "nombreVialidad": "PASEO DE LA REFORMA",
    "numeroExterior": "403",
    "numeroInterior": "8",
    "colonia": "CUAUHTEMOC",
    "nombreLocalidad": "CUAUHTEMOC",
    "municipio": "CUAUHTEMOC",
    "nombreEntidadFederativa": "CIUDAD DE MEXICO",
    "entreCalle": "RIO LERMA",
    "entreCalle2": "RIO NILO"
  },
  "actividadesEconomicas": [
    {
      "orden": "1",
      "actividadEconomica": "Asalariado",
      "porcentaje": "100",
      "fechaInicio": "2023-01-01",
      "fechaFin": ""
    }
  ],
  "regimenes": [
    {
      "regimen": "Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios",
      "fechaInicio": "2023-01-01",
      "fechaFin": ""
    }
  ],
  "obligaciones": [
    {
      "descripcionObligacion": "Declaración anual de ISR. Personas Físicas.",
      "descripcionVencimiento": "A más tardar el 30 de abril del ejercicio siguiente.",
      "fechaInicio": "2023-01-01",
      "fechaFin": ""
    }
  ],
  "pdfBase64": "JVBERi0xLjUKJafj8"
}

Respuestas en error

JSON

404 Not Found

[
  {
    "type": "not_found",
    "message": "el id no fue encontrado en el historico"
  }
]

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/sat/constancia-situacion-fiscal

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/constancia-situacion-fiscal \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"rfc":"AAAA010123AB1","ciec":"12345678"}'

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

CasoCamporfc

Caso exitoso — EncontradorfcAAAA010123AB1

Caso exitoso — RFC no encontradorfcABD131110A27

Caso exitoso — CIEC incorrectarfcBBBB010123BC2

Sin tokensrfcEEEE010123EF5

Error internorfcFFFF010123FG6

Unavailable servicerfcGGGG010123GH7

Endpoint histórico

GEThttps://sandbox.api.datosnonstop.com/v1/sat/constancia-situacion-fiscal/historico/{id}

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl https://sandbox.api.datosnonstop.com/v1/sat/constancia-situacion-fiscal/historico/64821d23824123766beac2be \
  -H "x-api-key: tu_api_key_sandbox"

Casos de prueba histórico

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

Casoid

Caso exitoso64821d23824123766beac2be

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →