Consulta de contribuyentes
Servicio que permite consultar el estado de un Registro Federal de Contribuyentes (RFC) para verificar si se encuentra dentro del listado de contribuyentes con operaciones presuntamente inexistentes (EFOS) emitido por el SAT.
GET Consulta de Contribuyentes (Art. 69-B)
GET un RFC
- GET
/v1/taxpayers/{rfc}Retorna el estatus del contribuyente. Si el RFC consultado se encuentra en la lista negra, devuelve los detalles de sus publicaciones en el SAT y en el Diario Oficial de la Federación (DOF).
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
rfc | string | Sí | El Registro Federal de Contribuyentes (RFC) de persona física o moral a consultar (Ej. AAA151209DYA). |
Estructura respuesta
La respuesta es un objeto JSON que siempre devuelve un código de estado interno y un objeto data.
| Campo | Tipo | Descripción |
|---|---|---|
code | integer | Código de estado de la operación (Ej. 200 para éxito). |
data | object | Objeto principal que contiene la información de la consulta. |
data.isInList | boolean | true si el contribuyente está en la lista negra, false si no lo está. |
data.rfc | string | El RFC que fue consultado. |
data.data | object | (Opcional) Solo aparece si isInList es true. Contiene los detalles legales y fechas de publicación. |
Detalle del objeto data.data (Solo cuando isInList: true)
| Campo | Tipo | Descripción |
|---|---|---|
rfc | string | RFC del contribuyente encontrado. |
nombreContribuyente | string | Razón social o nombre completo del contribuyente. |
situacionContribuyente | string | Estado actual del contribuyente en la lista (Ej. Presunto, Definitivo, Desvirtuado). |
publicacionSATPresuntos | string | Fecha de publicación en la página del SAT como "Presunto" (DD/MM/YYYY). |
publicacionDOFPresuntos | string | Fecha de publicación en el DOF como "Presunto" (DD/MM/YYYY). |
publicacionSATDesvirtuados | string | Fecha de publicación en la página del SAT como "Desvirtuado". |
publicacionDOFDesvirtuados | string | Fecha de publicación en el DOF como "Desvirtuado". |
publicacionSATDefinitivos | string | Fecha de publicación en la página del SAT como "Definitivo". |
publicacionDOFDefinitivos | string | Fecha de publicación en el DOF como "Definitivo". |
publicacionSATSentenciaFavorable | string | Fecha de publicación en la página del SAT con sentencia favorable. |
publicacionDOFSentenciaFavorable | string | Fecha de publicación en el DOF con sentencia favorable. |
Ejemplos de Solicitud y Respuesta
Ejemplo 1: El contribuyente SÍ está en la lista (EFOS)
Petición:
curl 'https://api.bsale.io/v1/taxpayers/AAA091014835.json' \
--header 'access_token: tuTokendeAcceso'