bcra-central-deudores

分类: 商业与运营 | 上传者: ferminrp | 下载: 0 | 版本: v1.0（最新）

查询BCRA（Banco Central de la República Argentina）Central de Deudores API，查询阿根廷金融体系中个人或公司的信用状况。当用户要求使用 CUIT/CUIL/CDI 编号检查某人的债务情况、信用报告、财务状况、被拒绝的支票或信用记录时使用。当用户提及“central de deudores”、“situación Crediticia”、“deudas BCRA”、“cheques rechazados”、“historialcrediticio”、“informecrediticio”，或想要了解个人或公司是否在阿根廷金融系统中报告债务时也可使用。 --- # BCRA Central de Deudores 查询阿根廷中央银行债务人登记处以获取 CUIT/CUIL/CDI 的信用报告。 ## API 概述 - **基本 URL**：`https://api.bcra.gob.ar` - **身份验证**：不需要（公共 API） - **格式**：JSON 响应 - **输入**：CUIT/CUIL/CDI 作为整数（无连字符），例如 `20123456789` - **可选网络界面**：`https://compara.ar/deudores/:cuit`（将 `:cuit` 替换为 11 位 CUIT/CUIL/CDI） ## 端点 ### 1. 当前债务 — `GET /centraldedeudores/v1.0/Deudas/{Identificacion}` 返回所有金融实体最新报告的债务情况。 ```bashcurl -s "https://api.bcra.gob.ar/centraldedeudores/v1.0/Debts/20123456789" ``` **响应结构：** ```json { "status": 200, "results": { "identification": 20124, "decemation: 56783" "NAME OF THE PERSON", "periods": [ { “period”：“2024-12”，“entities”：[ {“entity”：“阿根廷国家银行”，“情况”：1，“dateSit1”：“2020-03-15”，“金额”：150，付款：0。“再融资”：假，“recategorizationOblig”：假，“situacionJuridica”：假， "irrecTechnicalDisposition": false, "enRevision": false, "procesoJud": false } ] } ] } } ``` ### 2. 历史债务 — `GET /centraldedeudores/v1.0/Deudas/Historicas/{Identificacion}` 返回多个时期的债务历史记录。对于跟踪债务人的情况随时间的变化很有用。 ```bash curl -s "https://api.bcra.gob.ar/ce

更新日志: Source: GitHub https://github.com/ferminrp/agent-skills

目录结构

当前层级: tree/main/skills/bcra-central-deudores/

📁 references/
- 📄 openapi-spec.json 10.0 KB
📄 SKILL.md 6.3 KB

SKILL.md

---
name: bcra-central-deudores
description: >
  Query the BCRA (Banco Central de la República Argentina) Central de Deudores API
  to check the credit status of individuals or companies in Argentina's financial system.
  Use when the user asks to check someone's debt situation, credit report, financial standing,
  rejected checks, or credit history using a CUIT/CUIL/CDI number. Also use when the user
  mentions "central de deudores", "situación crediticia", "deudas BCRA", "cheques rechazados",
  "historial crediticio", "informe crediticio", or wants to know if a person or company has
  debts reported in Argentina's financial system.
---

# BCRA Central de Deudores

Query Argentina's Central Bank debtor registry to obtain credit reports by CUIT/CUIL/CDI.

## API Overview

- **Base URL**: `https://api.bcra.gob.ar`
- **Auth**: None required (public API)
- **Format**: JSON responses
- **Input**: CUIT/CUIL/CDI as integer (no hyphens), e.g. `20123456789`
- **Optional web interface**: `https://compara.ar/deudores/:cuit` (replace `:cuit` with the 11-digit CUIT/CUIL/CDI)

## Endpoints

### 1. Current Debts — `GET /centraldedeudores/v1.0/Deudas/{Identificacion}`

Returns the latest reported debt situation across all financial entities.

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

**Response structure:**
```json
{
  "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. Historical Debts — `GET /centraldedeudores/v1.0/Deudas/Historicas/{Identificacion}`

Returns debt history across multiple periods. Useful for tracking how a debtor's situation evolved over time.

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

**Response structure:** Same as current debts but with multiple periods. Historical entries have simplified entity data (no `fechaSit1`, `diasAtrasoPago`, or observation flags).

### 3. Rejected Checks — `GET /centraldedeudores/v1.0/Deudas/ChequesRechazados/{Identificacion}`

Returns rejected checks reported for the debtor, grouped by rejection cause and entity.

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

**Response structure:**
```json
{
  "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 (Credit Classification) Codes

| Code | Commercial Portfolio | Consumer/Housing Portfolio |
|------|---------------------|--------------------------|
| 1 | Normal | Normal |
| 2 | Special follow-up (seguimiento especial) | Low risk (riesgo bajo) |
| 3 | Problematic (con problemas) | Medium risk (riesgo medio) |
| 4 | High insolvency risk (alto riesgo de insolvencia) | High risk (riesgo alto) |
| 5 | Irrecoverable (irrecuperable) | Irrecoverable (irrecuperable) |
| 6 | Irrecoverable by technical disposition | Irrecoverable by technical disposition |

**Situacion 1** is the best status. Any value >= 2 indicates some level of credit risk. Values >= 5 are severe.

## Key Field Notes

- **monto**: Reported in thousands of ARS (miles de pesos)
- **periodo**: Format `YYYY-MM` (the last reported period)
- **fechaSit1**: Date when the debtor was first classified as Situacion 1 at that entity
- **diasAtrasoPago**: Days past due (0 means current)
- **refinanciaciones**: `true` if debt has been refinanced
- **recategorizacionOblig**: `true` if mandatory recategorization applied
- **situacionJuridica**: `true` if under legal proceedings (concordatos, concurso preventivo, quiebra)
- **irrecDisposicionTecnica**: `true` if irrecoverable by technical disposition
- **enRevision**: `true` if the record is under review
- **procesoJud**: `true` if under judicial process

## Workflow

1. **Validate input**: Ensure the CUIT/CUIL/CDI is a valid number (11 digits, no hyphens)
2. **Fetch current debts** first — this is usually what the user wants
3. **Fetch historical debts** if the user asks about evolution or past credit behavior
4. **Fetch rejected checks** if relevant or requested
5. **If user prefers a UI**, share `https://compara.ar/deudores/:cuit` as a quick visual option
6. **Present results** with clear interpretation of the `situacion` codes and amounts

## Error Handling

- **400**: Invalid identification number format
- **404**: No records found for the given CUIT/CUIL/CDI
- **500**: BCRA server error — retry after a moment

When receiving a 404, inform the user that no records were found. This does not necessarily mean the person has no debts — it could mean the CUIT/CUIL/CDI is incorrect.

## Presenting Results

When presenting results to the user:

- Always show the person/company name (`denominacion`)
- Group debts by entity and highlight any `situacion` >= 2 as a warning
- Convert `monto` context: remind the user amounts are in thousands of ARS
- Flag any `true` values in observation fields (refinanciaciones, situacionJuridica, procesoJud, etc.)
- For historical data, show the trend (improving/worsening situation over time)
- For rejected checks, highlight unpaid checks (where `fechaPago` is null)

## OpenAPI Spec

For the complete API schema, see [references/openapi-spec.json](references/openapi-spec.json).

登录后下载/点赞/收藏 ❤ 34 | ★ 0

bcra-central-deudores

目录结构

SKILL.md

举报内容

提示