Referencia
- https://api.csfacturacion.com/csblacklist
API REST application/json
Credenciales de contratación vigente mediante Http Headers.
usuario: RFC de contratación.
password: Password de contratación.
Consultar RFC en blacklist
/publicados/{RFC} Consulta el RFC en lista negra
Petición
Tipo
application/json
Cuerpo
| URL PATH | Descripción | Tipo |
|---|---|---|
| RFC* | RFC a consultar | String |
Ejemplo
GET /publicados/AAA010101AAA HTTP/1.1
Authorization: Basic QUFBMDEwMTAxQUFBOkllaGVlKnRoMjAzNg==
Host: api.csfacturacion.com
Content-Length: 47
Response
200 Encontrado
application/json
Ejemplo
{
"contribuyente": {
"rfc": "AAA010101AAA",
"razonSocial": "DEMO S.A",
"tipoPersona": null,
"incidencias": {
"creditos": [
{
"supuesto": "CANCELADO",
"fechaPrimeraPublicacion": "2018-07-01",
"fechaRegistroMonto": "2018-07-01",
"monto": 44580,
"eliminadoDeListado": true,
"fechaActualizacion": "2026-01-09 07:10:26"
},
{
"supuesto": "FIRME",
"fechaPrimeraPublicacion": "2016-02-01",
"fechaRegistroMonto": null,
"monto": null,
"eliminadoDeListado": true,
"fechaActualizacion": "2026-01-09 07:10:26"
},
{
"supuesto": "EXIGIBLE",
"fechaPrimeraPublicacion": "2016-02-01",
"fechaRegistroMonto": null,
"monto": null,
"eliminadoDeListado": true,
"fechaActualizacion": "2026-01-09 07:10:26"
},
{
"supuesto": "SENTENCIA",
"fechaPrimeraPublicacion": "2016-02-01",
"fechaRegistroMonto": null,
"monto": null,
"eliminadoDeListado": true,
"fechaActualizacion": "2026-01-09 07:10:26"
},
{
"supuesto": "RETORNO_INVERSIONES",
"fechaPrimeraPublicacion": "2016-02-01",
"fechaRegistroMonto": null,
"monto": null,
"eliminadoDeListado": true,
"fechaActualizacion": "2026-01-09 07:10:26"
},
{
"supuesto": "CONDONADO",
"fechaPrimeraPublicacion": "2016-02-01",
"fechaRegistroMonto": null,
"monto": null,
"eliminadoDeListado": true,
"fechaActualizacion": "2026-01-09 07:10:26"
}
],
"operacionInexistente": [
{
"fechaActualizacionPresuntos": "2026-01-23 07:11:59",
"fechaActualizacionOperacion": "2026-01-23 07:11:59",
"fechaActualizacionSentencia": "2026-01-23 07:11:59",
"situacion": "SENTENCIA_FAVORABLE",
"numeroOficioPresuncion": "500-05-2016-6378",
"fechaOficioPresuncion": "2016-01-29",
"fechaPublicadoSatPresunto": "2016-02-01",
"fechaPublicadoDofPresunto": "2016-02-11",
"numeroOperacion": "500-05-2017-2736",
"fechaOperacion": "2017-04-12",
"fechaPublicadoSatOperacion": "2017-04-16",
"fechaPublicadoDofOperacion": "2017-04-27",
"eliminadoDeListado": true,
"sentenciaDesde": "DEFINITIVO",
"numeroOficioSentencia": "500-05-2018-14368",
"fechaOficioSentencia": "2018-06-22",
"fechaPublicadoSatSentencia": "2018-06-22",
"fechaPublicadoDofSentencia": "2018-07-19"
}
],
"localizacion": [
{
"supuesto": "NO_LOCALIZADO",
"motivo": null,
"eliminadoDeListado": true,
"fechaNoLocalizacion": "2016-06-16",
"fechaEliminadoNoLocalizacion": null,
"fechaActualizacion": "2026-01-17 07:10:37"
},
{
"supuesto": "ELIMINADO",
"motivo": "estaba comiendo",
"eliminadoDeListado": true,
"fechaNoLocalizacion": "2016-08-16",
"fechaEliminadoNoLocalizacion": null,
"fechaActualizacion": "2026-01-17 07:10:37"
}
],
"certificadosSinEfectos": [
{
"supuesto": "FRACCIÓN X",
"responsableCancelacion": "AGR",
"eliminadoDeListado": true,
"fechaCancelacion": "2024-06-21",
"fechaPublicacion": "2024-10-01",
"fechaActualizacion": "2025-12-04 07:10:14"
}
]
}
}
}
200 No Encontrado
application/json
No encontrado
{
"noEncontrado": "El rfc BBB010101BBB no se encuentra en la lista negra del sat"
}
422 Datos Inválidos
Tipo
application/json
Cuerpo
Ejemplo
{
"error": {
"message": "Please check your input",
}
}
Schema
error: Objeto JSON
Representa un error en la petición HTTP.message: String
Resumen/descripción del errordetails: Objeto JSON
Representa los detalles del error. Aplica para código422message: String
Indica por que el campo es erróneo.field: String
El campo con dato erróneo.
401 Sin Credenciales
Tipo
application/json
Cuerpo
Ejemplo
{
"error": {
"message": "Provide a supported auth schema",
}
}
Schema
error: Objeto JSON
Representa un error en la petición HTTP.message: String
Resumen/descripción del errordetails: Objeto JSON
Representa los detalles del error. Aplica para código422message: String
Indica por que el campo es erróneo.field: String
El campo con dato erróneo.
Descripción de la respuesta
Contribuyente
Nodo raiz: Contribuyente
Datos relacionados al contribuyente que figura en la lista negra del SAT
| nodo | valor |
|---|---|
| rfc | El RFC del contribuyente |
| razonSocial | Denominación por la cual se conoce colectivamente a una empresa |
| tipoPersona | Moral o física |
Incidencias
Un contribuyente en la lista negra del SAT puede tener una o más incidencias (crédito incumplido, no localización o alguna operación inexistente ( o al menos la presunción de la misma).
| nodo | valor |
|---|---|
| creditos | Créditos incumplidos con los que cuenta un contribuyente. |
| localización | Actual situación de acuerdo a la localización de un contribuyente: NO_LOCALIZADO ELIMINADO |
| operacionInexistente | Situación actual del contribuyente respecto al proceso del artículo 69-b del DFF: PRESUNTO- |
DESVIRTUADO DEFINITIVO SENTENCIA_FAVORABLE |
Créditos
| nodo | valor |
|---|---|
| supuesto | CANCELADO,FIRME,EXIGIBLE,SENTENCIA,CONDONADO,RETORNO_INVERSIONES |
| fechaPrimeroPublicacion | Fecha de publicación del crédito en el DOF |
| fechaRegistroMonto | Fecha en la que el SAT realizó la publicación del monto que el contribuyente debe pagar por la penalización |
| monto | Monto que el contribuyente debe pagar por la penalización. |
| fechaActualizacion | Fecha de última actualización del listado de créditos incumplidos |
Localización
| nodo | valor |
|---|---|
| supuesto | NO_LOCALIZADO: El contribuyente no pudo ser localizado ELIMINADO: Fue localizado posteriormente |
| motivo | Motivo del supuesto, puede ser null o empty('') |
| fechaNoLocalizacion | Fecha en la que se determina el supuesto NO_LOCALIZADO |
| fechaEliminadoNoLocalizacion | Fecha en la que se determina el supuesto ELIMINADO |
Operación Inexistente
| nodo | valor |
|---|---|
| situación | PRESUNTO, DESVIRTUADO, DEFINITIVO, SENTENCIA_FAVORABLE |
| numeroOficioPresuncion | número del oficio global de presuntos. |
| fechaOficioPresuncion | fecha de publicación del oficio global de presuntos. |
| fechaPublicadoSatPresunto | fecha de publicación en el SAT del oficio global de presuntos |
| fechaPublicadoDofPresunto | fecha de publicación en el DOF del oficio global de presuntos |
| numeroOperacion | número del oficio global de desvirtuados o definitivos, según sea el caso |
| fechaOperacion | fecha de publicación del oficio global de desvirtuados o definitivos, según sea el caso |
| fechaPublicadoSatOperacion | fecha de publicación en el SAT del oficio global de desvirtuados o definitivos, según sea el caso |
| fechaPublicadoDofOperacion | fecha de publicación en el DOF del oficio global de desvirtuados o definitivos, según sea el caso |
| fechaActualizacionOperacion | Fecha de última actualización del listado de Operación (Desvirtuado o Definitivo) |
| sentenciaDesde | Estado de procedencia de una sentencia favorable (cuando aplique) |
| numeroOficioSentencia | número del oficio global del listado de Sentencias favorables |
| fechaOficioSentencia | fecha del oficio global del listado de Sentencias favorables |
| fechaPublicadoSatSentencia | fecha de publicación en el SAT del oficio global del listado de Sentencias favorables |
| fechaPublicadoDofSentencia | fecha de publicación en el DOF del oficio global del listado de Sentencias favorables |
| fechaActualizacionSentencia | Fecha de última actualización del listado de Sentencias Favorables |
| eliminadoDeListado | true: El RFC fue borrado de los listados por parte del SAT pero formo parte en las fechas que - |
se muestran. false: EL RFC sigue estando en los listados. |
CSD Sin Efectos Fiscales
| nodo | valor |
|---|---|
| supuesto | Fundamento legal de la suspención del CSD |
| responsableCancelacion | Quién o qué emitio la cancelación del CSD |
| fechaCancelacion | Cuando se emitio la cancelación del CSD |
| fechaPublicacion | Cuando el SAT lo publicó en sus fuentes oficiales |
Campos comúnes
En todos los nodos de incidencias notaras los siguientes campos:
eliminadoDeListado: Indica si esta incidencia ya no figura en los CSV al momento de la consulta
fechaActualizacion: Fecha en que el sistema detecta un cambio en el CSV origen (hash)