bcra-central-deudores

BCRA 债务人中央登记处

查询阿根廷中央银行的债务人登记处，按 CUIT/CUIL/CDI 获取信用报告。

API 概览

• 基础 URL：https://api.bcra.gob.ar
• 身份验证：无需身份验证（公共 API）
• 格式：JSON 响应
• 输入：整数形式的 CUIT/CUIL/CDI（不含连字符），例如 20123456789
• 可选 Web 界面：https://compara.ar/deudores/:cuit（将 :cuit 替换为 11 位 CUIT/CUIL/CDI）

端点

1. 当前债务 — GET /centraldedeudores/v1.0/Deudas/{Identificacion}

返回所有金融机构报告的最新债务情况。

curl -s "https://api.bcra.gob.ar/centraldedeudores/v1.0/Deudas/20123456789"

响应结构：

{
  "status": 200,
  "results": {
    "identificacion": 20123456789,
    "denominacion": "NOMBRE DE LA PERSONA",
    "periodos": [
      {
        "periodo": "2024-12",
        "entidades": [
          {
            "entidad": "BANCO DE LA NACION ARGENTINA",
            "situacion": 1,
            "fechaSit1": "2020-03-15",
            "monto": 150.0,
            "diasAtrasoPago": 0,
            "refinanciaciones": false,
            "recategorizacionOblig": false,
            "situacionJuridica": false,
            "irrecDisposicionTecnica": false,
            "enRevision": false,
            "procesoJud": false
          }
        ]
      }
    ]
  }
}

2. 历史债务 — GET /centraldedeudores/v1.0/Deudas/Historicas/{Identificacion}

返回多个时期的债务历史。适用于跟踪债务人的情况如何随时间变化。

curl -s "https://api.bcra.gob.ar/centraldedeudores/v1.0/Deudas/Historicas/20123456789"

**响应结构：**与当前债务相同，但包含多个时期。历史条目中的机构数据已简化（不包含 fechaSit1、diasAtrasoPago 或观察标志）。

3. 被拒支票 — GET /centraldedeudores/v1.0/Deudas/ChequesRechazados/{Identificacion}

返回报告的债务人被拒支票，并按拒绝原因和机构分组。

curl -s "https://api.bcra.gob.ar/centraldedeudores/v1.0/Deudas/ChequesRechazados/20123456789"

响应结构：

{
  "status": 200,
  "results": {
    "identificacion": 20123456789,
    "denominacion": "NOMBRE DE LA PERSONA",
    "causales": [
      {
        "causal": "SIN FONDOS SUFICIENTES",
        "entidades": [
          {
            "entidad": 44,
            "detalle": [
              {
                "nroCheque": 12345678,
                "fechaRechazo": "2024-05-10",
                "monto": 50000.0,
                "fechaPago": null,
                "fechaPagoMulta": null,
                "estadoMulta": null,
                "ctaPersonal": true,
                "denomJuridica": null,
                "enRevision": false,
                "procesoJud": false
              }
            ]
          }
        ]
      }
    ]
  }
}

Situacion（信用分类）代码

代码	商业贷款组合	消费／住房贷款组合
1	正常	正常
2	特别跟进（seguimiento especial）	低风险（riesgo bajo）
3	有问题（con problemas）	中等风险（riesgo medio）
4	高资不抵债风险（alto riesgo de insolvencia）	高风险（riesgo alto）
5	无法收回（irrecuperable）	无法收回（irrecuperable）
6	因技术性处置而无法收回	因技术性处置而无法收回

Situacion 1 是最佳状态。任何 >= 2 的值都表示存在一定程度的信用风险。>= 5 的值表示严重风险。

关键字段说明

• monto：以千阿根廷比索为单位报告（miles de pesos）
• periodo：格式为 YYYY-MM（最近报告的时期）
• fechaSit1：债务人在该机构首次被归类为 Situacion 1 的日期
• diasAtrasoPago：逾期天数（0 表示当前无逾期）
• refinanciaciones：若债务已重新安排，则为 true
• recategorizacionOblig：若已进行强制重新分类，则为 true
• situacionJuridica：若正处于法律程序中（concordatos、concurso preventivo、quiebra），则为 true
• irrecDisposicionTecnica：若因技术性处置而无法收回，则为 true
• enRevision：若记录正在审核中，则为 true
• procesoJud：若正处于司法程序中，则为 true

工作流

1. 验证输入：确保 CUIT/CUIL/CDI 是有效号码（11 位，不含连字符）
2. 先获取当前债务——这通常是用户想要的信息
3. 如果用户询问变化趋势或过往信用行为，则获取历史债务
4. 如果相关或用户有要求，则获取被拒支票
5. 如果用户更喜欢使用界面，可分享 https://compara.ar/deudores/:cuit，作为快速查看的选项
6. 展示结果，并清楚解读 situacion 代码和金额

错误处理

• 400：识别号码格式无效
• 404：未找到该 CUIT/CUIL/CDI 的记录
• 500：BCRA 服务端错误——稍后重试

收到 404 时，告知用户未找到记录。这并不一定意味着此人没有债务——也可能是 CUIT/CUIL/CDI 不正确。

展示结果

向用户展示结果时：

• 始终显示个人／公司名称（denominacion）
• 按实体对债务分组，并将所有 situacion >= 2 的情况标记为警告
• 转换 monto 上下文：提醒用户金额以千阿根廷比索计
• 标记观察字段（refinanciaciones、situacionJuridica、procesoJud 等）中的所有 true 值
• 对于历史数据，展示趋势（情况随时间改善／恶化）
• 对于被拒付的支票，突出显示未付款的支票（fechaPago 为 null）

OpenAPI 规范

如需查看完整的 API 架构，请参阅 references/openapi-spec.json。