BCRA · Central de Deudores

Situación crediticia informada por las entidades financieras al Banco Central: deudas vigentes, histórico y cheques rechazados. Es la única fuente LIVE del catálogo: se consulta al organismo en el momento del request.

Slug	bcra
Modo	LIVE (consulta al origen, con caché corta)
Clase de sujeto	Derivada del CUIT
Claves aceptadas	cuit
Claves obligatorias	cuit
Payload	bcra.credit.v1
Scopes	sources:read + provider:bcra
Endpoint	POST /api/v1/sources/bcra/query

POSTProbar la consulta a BCRA→

Consulta

curl -X POST https://tu-host/api/v1/sources/bcra/query \
  -H "Authorization: Bearer ilk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "keys": { "cuit": "20111111112" } }'

Sin cuit la consulta no puede ejecutarse y la respuesta es 400 (no un resultado vacío): la Central de Deudores sólo resuelve por identificador fiscal.

Payload bcra.credit.v1

{
  "identificacion": "20111111112",
  "denominacion": "JUAN EJEMPLO",
  "situacionActualPeor": 2,
  "deudas": { "periodos": [] },
  "historicas": { "periodos": [] },
  "chequesRechazados": { "causales": [] }
}

Campo	Descripción
identificacion	CUIT/CUIL/CDI consultado.
denominacion	Titular según el BCRA.
situacionActualPeor	Peor situación (1..5) del período más reciente. Señal rápida de riesgo.
deudas	Deudas informadas por período y entidad, con monto, situación y días de atraso.
historicas	Serie histórica de situaciones por período y entidad.
chequesRechazados	Cheques rechazados agrupados por causal y entidad, con su detalle.

Comportamiento en vivo

• Sin registros ≠ error. Un sujeto sin información en la Central devuelve 200 con las secciones en null o vacías: no tener deudas informadas es un resultado válido.
• Caída o timeout del organismo. La respuesta llega con partial: true y las secciones que no se pudieron traer quedan vacías. La consulta no se cae por un fallo del origen.
• Secciones secundarias. El histórico y los cheques son best-effort: si fallan, la respuesta conserva las deudas y marca la parcialidad.
• Caché corta. Las consultas repetidas del mismo CUIT en una ventana breve pueden servirse de caché. Eso reduce el costo técnico, no el precio comercial.

En Person Search

La misma dimensión se obtiene con el modelo PERSON_ADVANCED, que además exige CUIT entre las claves. Consultá la fuente directamente cuando sólo te interesa el crediticio y no necesitás el resto del enriquecimiento.

Ver también: Catálogo de fuentes · Payloads por dominio.