#Listas negras

Consulta si un RFC aparece en las listas negras del SAT y cruza los proveedores de un contribuyente contra ellas. Cubren:

Lista 69-B (EFOS) — empresas que facturan operaciones simuladas.
Artículo 69 — créditos fiscales firmes y contribuyentes no localizados.
CSD sin efectos — certificados de sello digital cancelados.
69-B Bis — transmisión indebida de pérdidas fiscales.

Todos los endpoints cuelgan de https://api.clarisfy.com/api/v1/blacklists/. Los datos son de referencia global (no por organización), salvo /matches, que sí opera sobre una de tus Fiscal Entities.

#Consulta 69-B (EFOS) por RFC

GET/blacklists/69b

Búsqueda exacta por RFC contra el Listado 69-B. Devuelve las coincidencias (normalmente 0 o 1).

Parámetro (query)	Tipo	Descripción
`rfc`	string	Requerido. RFC exacto (10–13 caracteres).

curl "https://api.clarisfy.com/api/v1/blacklists/69b?rfc=AAA080808HL8" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "matches": [
    {
      "rfc": "AAA080808HL8",
      "nombre": "ASESORES EN AVALÚOS, S.A. DE C.V.",
      "situacion": "Definitivo",
      "presuncion_dof_pub": "2018-06-25",
      "definitivo_dof_pub": "2018-10-23",
      "sentencia_dof_pub": null,
      "definitivo_dof_oficio": null
    }
  ]
}

Cada elemento de matches (un registro 69-B):

Campo	Tipo	Descripción
`rfc`	string	RFC listado.
`nombre`	string \| null	Razón social.
`situacion`	string	Situación en la lista (p. ej. `Definitivo`, `Presunto`).
`presuncion_dof_pub`	string \| null	Fecha de publicación DOF de la presunción (YYYY-MM-DD).
`definitivo_dof_pub`	string \| null	Fecha DOF del definitivo.
`sentencia_dof_pub`	string \| null	Fecha DOF de la sentencia.
`definitivo_dof_oficio`	string \| null	Oficio del definitivo.

Si el RFC no está listado, matches es un arreglo vacío.

#Búsqueda 69-B por lote

POST/blacklists/69b/lookup

Cruza una lista de RFCs (p. ej. tus proveedores) contra el Listado 69-B. Máximo 500 RFCs por llamada. Devuelve el mismo objeto { matches: [...] }.

curl -X POST https://api.clarisfy.com/api/v1/blacklists/69b/lookup \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe" \
  -H "Content-Type: application/json" \
  -d '{"rfcs": ["AAA080808HL8", "XAXX010101000"]}'

#Consulta todas las listas por RFC

GET/blacklists/lookup

Búsqueda exacta por RFC contra todas las listas del SAT. Devuelve todas las coincidencias, cada una con su lista de origen.

Parámetro (query)	Tipo	Descripción
`rfc`	string	Requerido. RFC exacto (10–13 caracteres).

curl "https://api.clarisfy.com/api/v1/blacklists/lookup?rfc=AAG090703QT6" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "hits": [
    {
      "source": "art69_firmes",
      "rfc": "AAG090703QT6",
      "nombre": "COMERCIALIZADORA EJEMPLO SA DE CV",
      "estatus": "FIRMES",
      "fecha": "2014-01-01"
    }
  ]
}

Cada elemento de hits:

Campo	Tipo	Descripción
`source`	string	Lista de origen: `69b`, `art69_firmes`, `art69_no_localizados`, `csd_sin_efectos`, `69b_bis`.
`rfc`	string	RFC listado.
`nombre`	string \| null	Razón social.
`estatus`	string \| null	Situación/supuesto en la lista.
`fecha`	string \| null	Fecha relevante (YYYY-MM-DD).

#Búsqueda por lote contra todas las listas

POST/blacklists/lookup

Igual que la anterior, pero por lote. Máximo 500 RFCs. Devuelve { hits: [...] }.

curl -X POST https://api.clarisfy.com/api/v1/blacklists/lookup \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe" \
  -H "Content-Type: application/json" \
  -d '{"rfcs": ["AAG090703QT6", "GTM870825HA7"]}'

#Contrapartes de una Fiscal Entity en listas negras

GET/blacklists/matches

Devuelve los proveedores de un contribuyente (según sus CFDIs) que aparecen en alguna lista negra del SAT — la unión de todas las listas, más recientes primero.

Parámetro (query)	Tipo	Descripción
`fiscalEntityId`	string	Requerido. Identificador de la Fiscal Entity (`fe_…`).

curl "https://api.clarisfy.com/api/v1/blacklists/matches?fiscalEntityId=fe_9a1c2b3d4e5f6071" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "matches": [
    {
      "rfc": "FNI970829JR9",
      "nombre": "ASESORES EN AVALÚOS, S.A. DE C.V.",
      "source": "art69_firmes",
      "list_label": "lista de créditos fiscales firmes (Artículo 69)",
      "status_label": "FIRMES",
      "matched_date": "2014-01-01"
    }
  ]
}

Campo	Tipo	Descripción
`rfc`	string	RFC de la contraparte.
`nombre`	string \| null	Razón social de la contraparte.
`source`	string	Clave de la lista de origen.
`list_label`	string	Nombre de la lista (es-MX).
`status_label`	string \| null	Situación/supuesto de la lista.
`matched_date`	string \| null	Fecha de publicación (YYYY-MM-DD).

Aislamiento por organización: 400 si el fiscalEntityId es inválido y 404 si tu organización no tiene una conexión activa a esa Fiscal Entity.

#Publicaciones recientes

GET/blacklists/publications/recent

Feed global de lo recién publicado por el SAT en todas sus listas, unificado y normalizado, de lo más reciente a lo más antiguo.

Parámetro (query)	Tipo	Descripción
`days`	integer	Ventana en días (1–365, por defecto 30).
`limit`	integer	Máximo de filas (1–500, por defecto 200).

curl "https://api.clarisfy.com/api/v1/blacklists/publications/recent?days=30&limit=200" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "publications": [
    {
      "rfc": "AAA080808HL8",
      "nombre": "ASESORES EN AVALÚOS, S.A. DE C.V.",
      "list_label": "Lista 69-B (EFOS)",
      "status_label": "Definitivo",
      "published_date": "2026-06-05"
    }
  ]
}

Campo	Tipo	Descripción
`rfc`	string	RFC publicado.
`nombre`	string \| null	Razón social.
`list_label`	string	Nombre de la lista (es-MX).
`status_label`	string \| null	Situación/supuesto de la lista.
`published_date`	string	Fecha de publicación (YYYY-MM-DD).