法人番号APIの活用ガイド【国税庁・与信チェック・法人検索の自動化】

法人番号APIとは

法人番号は国税庁が日本の全法人（株式会社・一般社団法人・行政機関等）に付与する13桁の番号です。法人番号公表サイトAPIを使うことで、法人番号から法人名・住所・法人種別などの基本情報をプログラムから取得できます。取引先の与信チェック・フォームの入力補完・コンプライアンス管理に活用されています。

利用開始手順

1. 法人番号公表サイト（houjin-bangou.nta.go.jp）にアクセス
2. WebAPIの利用申請フォームに必要事項を入力
3. 審査後（通常数日以内）にアクセスキーが送付される

法人番号による検索

// 法人番号から法人情報を取得
const getCorporationByNumber = async (number) => {
  const url = new URL('https://api.houjin-bangou.nta.go.jp/4/num');
  url.searchParams.set('id', process.env.HOUJIN_API_KEY);
  url.searchParams.set('number', number);
  url.searchParams.set('type', '12'); // JSON形式
  url.searchParams.set('history', '0'); // 最新のみ
  
  const response = await fetch(url.toString());
  const data = await response.json();
  return data.corporations?.[0] || null;
};

// 使用例
const corp = await getCorporationByNumber('1234567890123');
if (corp) {
  console.log(`法人名: ${corp.name}`);
  console.log(`住所: ${corp.prefecture_name}${corp.city_name}${corp.street_number}`);
  console.log(`種別: ${corp.kind}`); // 301=株式会社
  console.log(`状態: ${corp.status}`); // 01=現存
}

法人名での検索

// 法人名で検索
GET https://api.houjin-bangou.nta.go.jp/4/name
  ?id=YOUR_KEY
  &name=株式会社〇〇
  &type=12
  &mode=2   // 2=前方一致, 1=完全一致
  &target=1 // 1=JIS第一・二水準, 2=外字含む
  &kind=301 // 301=株式会社のみ

取引先フォームへの法人番号入力補完

// フォームに法人番号を入力すると自動で社名・住所を補完
const handleCorporationNumberInput = async (e) => {
  const number = e.target.value.replace(/[^0-9]/g, '');
  if (number.length === 13) {
    const corp = await getCorporationByNumber(number);
    if (corp) {
      setFormData({
        ...formData,
        corporationName: corp.name,
        prefecture: corp.prefecture_name,
        city: corp.city_name,
        address: corp.street_number,
        corporationKind: corp.kind,
        status: corp.status
      });
      // 解散済みの法人は警告を表示
      if (corp.status !== '01') {
        alert('この法人は現在存在しない可能性があります（解散・合併等）');
      }
    }
  }
};

与信管理システムへの活用

新規取引先登録フォームに法人番号を入力させ、APIで実在確認を行うことで、架空法人との取引リスクを軽減できます。法人の状態（現存・解散・休眠等）も自動チェックし、取引可否判断の参考にします。

まとめ

法人番号APIは日本の法人情報を自動取得するための貴重な公共APIです。取引先の実在確認・入力補完・コンプライアンス管理に積極的に活用し、業務の自動化と信頼性向上を実現してください。