bcra-central-deudores

BCRA 中央債務者登録簿

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}

すべての金融機関から報告された最新の債務状況を返します。

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：ARS の千単位（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. ユーザーが UI を希望する場合は、手早く視覚的に確認できる方法として https://compara.ar/deudores/:cuit を共有します
6. situacion コードと金額を明確に解釈して、結果を提示する

エラー処理

• 400：識別番号の形式が無効です
• 404：指定された CUIT/CUIL/CDI の記録が見つかりません
• 500：BCRA サーバーエラー — 少し待ってから再試行してください

404 を受け取った場合、記録が見つからなかったことをユーザーに伝えてください。これは必ずしも、その人に債務がないことを意味するわけではありません。CUIT/CUIL/CDI が誤っている可能性もあります。

結果の提示

ユーザーに結果を提示する際は、次の点に注意してください。

• 個人名／会社名（denominacion）は必ず表示してください
• 債務は事業体ごとにまとめ、situacion が 2 以上の場合は警告として強調してください
• monto の単位に関する注意として、金額が ARS の千単位であることをユーザーに伝えてください
• 備考フィールド（refinanciaciones、situacionJuridica、procesoJud など）の値が true の場合は、その旨を明示してください
• 過去のデータについては、状況の推移（時間の経過に伴う改善または悪化）を示してください
• 不渡り小切手については、未払いの小切手（fechaPago が null のもの）を強調してください

OpenAPI 仕様

API スキーマの全体については、references/openapi-spec.json を参照してください。