← Back to Skills Marketplace
ferminrp

Central de Deudores BCRA

cross-platform ✓ Security Clean
607
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install 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 financ...
README (SKILL.md)

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.

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

Response structure:

{
  "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.

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.

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

Response structure:

{
  "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.

Usage Guidance
This skill appears coherent and limited to querying BCRA's public endpoints, but consider privacy and legality before looking up someone else's CUIT/CUIL/CDI: ensure you have permission, avoid storing or logging personal financial data unnecessarily, and verify API availability, rate limits, and that the official BCRA domain (api.bcra.gob.ar) is the intended endpoint.
Capability Analysis
Type: OpenClaw Skill Name: bcra-central-deudores Version: 1.0.0 The skill bundle is designed to query a legitimate public API (api.bcra.gob.ar) for credit information. All instructions in SKILL.md are aligned with the stated purpose, and there are no signs of data exfiltration, malicious execution, persistence mechanisms, or obfuscation. The workflow explicitly instructs the AI agent to 'Validate input: Ensure the CUIT/CUIL/CDI is a valid number (11 digits, no hyphens)', which mitigates potential shell injection vulnerabilities if the agent correctly implements this validation.
Capability Assessment
Purpose & Capability
Name and description match the actual behavior: SKILL.md and the included OpenAPI spec define GET endpoints on https://api.bcra.gob.ar for current, historical debts and rejected checks. No unexplained credentials, binaries, or unrelated capabilities are requested.
Instruction Scope
Runtime instructions are limited to validating CUIT/CUIL/CDI input, calling the listed BCRA endpoints (curl examples), interpreting response fields, and presenting results. The instructions do not direct reading system files, extra environment variables, or transmitting data to unexpected endpoints.
Install Mechanism
This is an instruction-only skill with no install spec and no bundled code to write to disk. No external downloads or package installs are requested.
Credentials
The skill declares no required environment variables or credentials; the documented API is public (no auth). There are no disproportionate secret requests or config path access.
Persistence & Privilege
Skill is not always-enabled and does not request modifications to other skills or system-wide settings. Autonomous invocation is allowed by default but is typical and not combined with other red flags.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bcra-central-deudores
  3. After installation, invoke the skill by name or use /bcra-central-deudores
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the "bcra-central-deudores" skill. - Enables credit status and debt checks in Argentina via the public BCRA API. - Supports queries using CUIT, CUIL, or CDI for individuals or companies. - Provides access to current and historical debts, and reports on rejected checks. - Results include interpretation of credit situation codes and highlight key risk indicators.
Metadata
Slug bcra-central-deudores
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Central de Deudores BCRA?

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 financ... It is an AI Agent Skill for Claude Code / OpenClaw, with 607 downloads so far.

How do I install Central de Deudores BCRA?

Run "/install bcra-central-deudores" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Central de Deudores BCRA free?

Yes, Central de Deudores BCRA is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Central de Deudores BCRA support?

Central de Deudores BCRA is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Central de Deudores BCRA?

It is built and maintained by Fermin Rodriguez Penelas (@ferminrp); the current version is v1.0.0.

💬 Comments