【2026年最新版】法人番号APIとは？国税庁APIの使い方・制約とデータ補完の実践ガイド

本記事はBtoB営業組織やプロダクト開発者で、フォーム・CRM・SFAに会社情報を自動投入する仕組みを設計したい方に向けて、法人番号APIで何が取得できて何が取れないのか、どう企業情報APIと組み合わせるべきかを実践ガイドとして解説します。

法人番号は、国税庁が日本国内のすべての法人に付与する13桁の一意な番号です。この法人番号をプログラムから取得できるのが法人番号API（国税庁法人番号システムWeb-API）ですが、取得できるデータ項目は法人名・所在地・変更履歴に限定されます。営業やマーケティングで実際に必要となる売上高・従業員数・業種・電話番号などは含まれないため、企業情報APIとの組み合わせが不可欠です。

本記事では、法人番号APIの仕様・使い方・制約を解説した上で、SalesNow APIなどの企業情報APIで補完する実践的なデータ連携手法、3つのCRM/SFA環境での実装例（Salesforce APIフォーム・Salesforce/Account Engagement×イチサンフォーム・HubSpot×イチサンフォーム）、AIから直接APIを呼び出すMCP連携までを実画面スクショ付きで紹介します。関連する深掘り記事は次のとおりです。

• 料金0円で使える無料の企業情報APIは「無料で使える企業情報API 10選｜法人番号・gBizINFO・EDINET・BizData等を徹底比較」でまとめています
• 有料含む企業情報APIの違いと選び方は「企業情報API比較8選｜選び方・用途別おすすめを解説」で解説しています
• 法人番号を名寄せキーに使う具体的手順は「名寄せとは？やり方5ステップとExcel・ツール活用を徹底解説」で確認できます
• CRM/SFA側の名寄せ機能の差は「名寄せ機能とは？CRM・SFAの仕組みと活用法を解説」で比較しています

法人番号APIとは？基本概念と国税庁Web-APIの概要

法人番号APIとは、国税庁が運営する法人番号公表サイトのデータをプログラムから取得できるWeb APIのことを指します。2015年10月のマイナンバー制度開始に伴い法人番号が付番されて以降、約500万件の法人データを無料で取得できる公的APIとして広く活用されています。

法人番号は日本における企業データ統合の共通キーです。

法人番号制度の背景と目的

法人番号制度は、行政手続きの効率化と法人情報の透明性向上を目的として2015年に開始されました。国税庁から全法人に13桁の番号が付与され、「1法人1番号」の原則で管理されています。株式会社・合同会社・一般社団法人・国の機関・地方公共団体など、法人格を持つすべての組織が付番対象です。2026年3月時点で約500万件の法人番号が公開されています。

法人番号の最大の特徴は、誰でも自由に利用できるオープンデータであることです。利用に際してライセンス費用は発生せず、商用利用も認められています。この特性により、法人番号はCRM/SFAのレコード統合やデータベース間の名寄せにおけるユニークキーとして広く採用されています。

法人番号APIの利用申請と認証方式

法人番号APIを利用するには、国税庁の法人番号公表サイトからアプリケーションIDを取得する必要があります。申請手続きは無料で、メールアドレスの登録と利用規約への同意のみで完了します。取得したアプリケーションIDをリクエストパラメータに含めることで、APIにアクセスできるようになります。APIキーの有効期限は設けられておらず、一度取得すれば継続的に利用可能です。

法人番号APIでできること｜3つの取得機能と主な活用ユースケース

「法人番号APIで結局なにができるのか」は、公式サイトの仕様書を読んでもすぐには掴みにくい部分です。ここでは、国税庁が提供する3つの取得機能と、それぞれが実務のどの場面に効くのかを先に整理しておきます。

法人番号APIの機能は「番号で引く・名前で探す・期間で差分を取る」の3つに集約されます。

提供されている3つの取得機能

国税庁の法人番号システムWeb-API（Ver.4.0）が提供する機能は、以下の3つです。どの機能を使うかによってエンドポイントと指定できる条件が変わります。

なお、Web-APIから法人データを全件一括で取得することはできません。全件データが必要な場合は、法人番号公表サイトが別途提供しているダウンロード機能を併用します。機能の詳細と利用規約は国税庁 法人番号システムWeb-APIで公開されています。

実務で使われる5つの活用ユースケース

3つの機能を組み合わせると、BtoB営業やデータ基盤の現場では次のような使われ方をします。いずれも「法人番号を軸に、散らばった企業データを1本の線に揃える」という発想が共通しています。

• CRM/SFAレコードへの法人番号付与：社名だけで登録されている取引先レコードに /name で法人番号を付与し、以降の統合キーとして使えるようにします
• 入力フォームの会社名サジェスト・自動入力：問い合わせフォームで会社名を入力した瞬間に候補を提示し、所在地まで自動補完してフォーム離脱を減らします
• データベース間の名寄せ・重複排除：MA・SFA・請求システムなどID体系が異なるシステム間で、法人番号を共通キーとしてレコードを突合します
• 新設法人のウォッチと営業ターゲット化：/diff で期間指定の差分を定期取得し、新たに登記された法人をいち早く営業リストに載せます
• 取引先の状態モニタリング：社名変更・本店移転・閉鎖（清算結了・吸収合併）を差分から検知し、CRM上の古い情報や休眠先へのアプローチを防ぎます

ただし、これらのユースケースはいずれも「法人番号APIだけでは完結しない」点に注意が必要です。たとえば新設法人をウォッチできても、その企業の従業員数・業種・電話番号は法人番号APIからは取得できず、営業リストとして使うには別のデータソースが必要になります。この補完については後述の「法人番号APIの制約を補完する企業情報API」で詳しく解説します。

国税庁法人番号APIの仕様と使い方

国税庁法人番号APIの仕様とは、リクエスト形式・レスポンス形式・エンドポイント・パラメータなど、APIを実装する際に必要となる技術仕様のことを指します。REST方式でGETリクエストを送信し、CSVまたはXML形式でレスポンスを受け取ります（JSON形式には対応していません）。

APIの仕様理解が正確なデータ取得の第一歩です。

エンドポイントとリクエスト形式

国税庁法人番号APIは、主に3つのエンドポイントを提供しています。「法人番号を指定して取得」するエンドポイントでは、13桁の法人番号をパラメータに指定することで、該当法人の情報を取得します。「法人名で検索」するエンドポイントでは、法人名の部分一致検索が可能です。「期間指定で変更情報を取得」するエンドポイントでは、指定期間内に登記情報が変更された法人を一括取得できます。

リクエストはHTTP GETメソッドで送信し、パラメータはクエリ文字列で指定します。レスポンス形式は type パラメータで指定し、CSV（Shift-JIS）・CSV（Unicode）・XMLの3種類から選択します。JSON形式は提供されていないため、JSONで扱いたい場合はアプリケーション側でXMLまたはCSVを変換する実装が必要です。

レスポンスのデータ構造

法人番号APIのレスポンスには、法人番号・法人名（商号）・所在地・法人種別・変更年月日・変更事由などが含まれます。以下は主要な返却フィールドの一覧です。

リクエスト制限と実装上の注意

国税庁法人番号APIには、リクエスト数の上限が設けられています。公式ドキュメントでは明確な数値は公表されていませんが、短時間に大量のリクエストを送信するとエラーが返却されるケースが報告されています。安定した運用のためには、リクエスト間隔を1秒以上空ける、バッチ処理では1回あたりの取得件数を最大値（10件）に設定する、エラー時のリトライロジックを実装するなどの対策が必要です。

法人番号APIのリクエスト・レスポンス実例

仕様書を読み込む前に、実際のリクエストが1本通るところまで動かしてしまうのが最短ルートです。ここでは、アプリケーションIDを取得した直後に試せるcurlコマンドと、返ってくるレスポンスの中身を具体的に見ていきます。

法人番号APIは id と検索条件を並べたGETリクエスト1本で呼び出せます。

curlによるリクエスト例

法人番号を指定して1社の基本情報を取得する場合は、以下の形式になります。type=12 はXML形式での取得を意味します。

curl "https://api.houjin-bangou.nta.go.jp/4/num?id=YOUR_APP_ID&number=7000012050002&type=12&history=0"

社名から法人番号を引き当てたい場合は /name を使います。mode で前方一致／部分一致を、target であいまい検索／完全一致を切り替えます。

curl "https://api.houjin-bangou.nta.go.jp/4/name?id=YOUR_APP_ID&name=SalesNow&type=12&mode=2&target=1&close=0"

指定期間に登記情報が更新された法人の差分を取得する場合は /diff を使い、from／to で期間を指定します（最大50日）。

curl "https://api.houjin-bangou.nta.go.jp/4/diff?id=YOUR_APP_ID&from=2026-07-01&to=2026-07-31&type=12"

主なリクエストパラメータ一覧

XMLレスポンスの構造

type=12 で取得した場合、以下のような構造のXMLが返却されます。実際のレスポンスにはこのほか処理区分・更新年月日・変更年月日・フリガナなどのフィールドも含まれますが、ここでは主要フィールドのみを抜粋しています。

<corporations>
  <count>1</count>
  <divideNumber>1</divideNumber>
  <divideSize>1</divideSize>
  <corporation>
    <sequenceNumber>1</sequenceNumber>
    <corporateNumber>7000012050002</corporateNumber>
    <name>国税庁</name>
    <kind>101</kind>
    <prefectureName>東京都</prefectureName>
    <cityName>千代田区</cityName>
    <streetNumber>霞が関三丁目１番１号</streetNumber>
    <closeDate/>
    <closeCause/>
  </corporation>
</corporations>

ルート要素の count は該当件数、divideNumber / divideSize は分割取得時の何番目／全何分割かを示します。該当件数が一定数を超えると結果は分割して返却される仕様のため、divideSize が2以上のときは divideNumber を繰り上げながら残りのページも取得するループ処理が必要です。

Pythonでの実装例

実際のバッチ処理では、法人番号のリストを10件ずつに分割して順次リクエストする構成が基本になります。

import time
import requests
import xml.etree.ElementTree as ET

APP_ID = "YOUR_APP_ID"
ENDPOINT = "https://api.houjin-bangou.nta.go.jp/4/num"

def fetch(numbers):
    """法人番号を最大10件まとめて取得する"""
    params = {
        "id": APP_ID,
        "number": ",".join(numbers),
        "type": "12",
        "history": "0",
    }
    res = requests.get(ENDPOINT, params=params, timeout=30)
    res.raise_for_status()
    root = ET.fromstring(res.content)
    return [
        {
            "corporate_number": c.findtext("corporateNumber"),
            "name": c.findtext("name"),
            "prefecture": c.findtext("prefectureName"),
            "city": c.findtext("cityName"),
        }
        for c in root.findall("corporation")
    ]

targets = ["7000012050002"]  # 実際はCRMから抽出した法人番号リスト
for i in range(0, len(targets), 10):
    for row in fetch(targets[i:i + 10]):
        print(row)
    time.sleep(1)  # 連続リクエストによるアクセス制限を避ける

国税庁法人番号API単体の申請手順から取得データ項目までを、より簡潔にステップ順で確認したい方は「法人番号APIの使い方｜仕様・取得データ・活用法をわかりやすく解説」をあわせてご覧ください。本記事は以降、企業情報APIと組み合わせたデータ基盤の設計に焦点を当てて解説します。

法人番号APIでつまずきやすいポイントとエラー対処

法人番号APIの実装でハマるポイントは、ほぼパターンが決まっています。「レスポンスがJSONで返ってこない」「急に403が返り始めた」「全件取れると思っていた」——実装前にここを押さえておくと、手戻りをまとめて回避できます。

エラーの大半は、パラメータの指定ミスかリクエスト頻度の出し過ぎに起因します。

HTTPステータスコード別の原因と対処

仕様を誤解しやすい5つのポイント

ステータスコード以前に、仕様の思い込みでつまずくケースも少なくありません。とくに次の5点は、設計段階で必ず確認しておきたい制約です。

• JSON形式では返ってこない：レスポンスはCSV（Shift-JIS／Unicode）とXMLの3種類のみです。JSONを前提にした実装は成立しないため、XMLパーサーまたはCSVパーサーを用意します
• 全件データはAPIでは取得できない：Web-APIは条件を指定して抽出する仕組みです。全法人のマスタが必要な場合は、法人番号公表サイトのダウンロード機能を併用します
• 1リクエストの上限が機能ごとに異なる：法人番号指定は最大10件、期間指定は最大50日です。これを超える範囲はリクエストを分割して処理します
• CSVは文字コードの指定を誤ると文字化けする：type=01 はShift-JIS、type=02 はUnicodeです。日本語環境の表計算ソフトで開くか、プログラムで読むかによって選択が変わります
• 法人名検索は表記ゆれに弱い：「株式会社」の前後位置、旧字体、全角・半角、スペースの有無で結果が変わります。社名だけを頼りに法人番号を付与する運用では、あいまい検索と目視確認を組み合わせる前提で設計します

とくに最後の表記ゆれは、CRM/SFAへの法人番号付与を自動化しようとしたときに必ず突き当たる壁です。

法人番号APIで取得できるデータと制約

法人番号APIで取得できるデータとは、国税庁が公開している法人の基本情報に限定されたデータセットのことを指します。営業やマーケティングで必要となる多くのデータ項目は含まれておらず、この制約を理解した上で活用方法を設計することが重要です。

法人番号APIは万能ではなく、用途に応じた補完が必要です。

取得できるデータと取得できないデータ

上記の通り、法人番号APIで取得できるのは法人番号・法人名・所在地・変更履歴の基本4項目に限定されます。営業活動で必要な電話番号・売上高・従業員数・業種などのデータは一切含まれていません。このギャップを埋める民間提供のAPIが企業情報APIです。仕組み・選定軸・代表サービスは「企業情報APIとは？基本概念・種類・選び方をわかりやすく解説」で解説しています。

データ更新のタイミング

法人番号APIのデータは、登記変更が法務局で処理された後に反映されます。具体的には、設立登記から法人番号の公開まで数日〜2週間程度のタイムラグがあります。リアルタイム性が求められる用途では、この遅延を考慮した設計が必要です。

法人番号APIの制約を補完する企業情報API

法人番号APIの制約を補完する企業情報APIとは、法人番号APIでは取得できない売上高・従業員数・業種・電話番号・組織情報などの営業に必要なデータを提供する民間のAPIサービスのことを指します。法人番号をキーにして両者を連携することで、公的データと民間データの長所を組み合わせたデータ基盤を構築できます。

法人番号APIと企業情報APIの組み合わせがデータ活用の最適解です。

SalesNow APIの特徴とデータ項目

SalesNow APIは、国内1,400万件超の企業・組織データベースにアクセスできる企業情報APIです。法人番号をキーにして、企業の基本情報に加え、売上高・従業員数・業種・代表者名・電話番号・求人情報・ニュースなど、営業・マーケティングに必要な属性データを取得できます。取得可能な項目の範囲は契約プランによって異なるため、必要な項目が含まれるかは事前にご確認ください。

企業情報APIの選定にあたっては、データ網羅性・更新頻度・API仕様・サポート体制が重要な比較軸となります。代表的な企業情報APIの違いを軸ごとに整理した比較表は「企業情報API比較8選｜選び方・用途別おすすめを解説」で確認できます。SalesNow APIは企業データベース収録件数No.1・法人網羅率No.1を誇り、データの鮮度と網羅性において業界をリードしています。

法人番号API vs 企業情報API：使い分けの判断基準

法人番号APIと企業情報APIは、競合するものではなく補完関係にあります。以下の判断基準で使い分けることを推奨します。

• 法人番号の存在確認・基本情報の取得のみ → 法人番号APIで十分
• 営業リストの作成・ターゲティング → 企業情報API（SalesNow API等）が必要
• CRM/SFAのデータエンリッチメント → 法人番号APIで法人番号を付与 → 企業情報APIで属性データを補完
• 名寄せ・重複排除 → 法人番号をユニークキーとして使用し、企業情報APIで最新データに統一

国税庁法人番号API + gBizINFO API の無料組み合わせパターン

商用APIの導入前に、完全無料で構築できる「法人番号API + gBizINFO API」の組み合わせパターンがあります。国税庁法人番号APIで法人番号・商号・所在地などの基本情報を取得し、同じ法人番号を使ってgBizINFO（経済産業省）APIに問い合わせると、補助金採択情報・届出認定情報・財務情報（一部）・職場情報などの行政データが追加で取得できます。

このパターンは、初期投資ゼロで「基本情報＋行政データ」の統合データ基盤を構築できるため、スタートアップや中小企業のPoC段階で特に有効です。ただし、電話番号・部署情報・組織構造・求人情報などは引き続き取得できないため、営業活用の段階では商用API（SalesNow API等）への移行が必要になります。2026年にはgBizINFOの次期システムへの更改が予定されており、メタデータやESGデータの追加により、無料APIだけで取得できる情報の幅がさらに広がる見込みです。

国税庁法人番号API・gBizINFO APIを含む無料APIの詳細な一覧と使い方は「無料で使える企業情報API 10選｜法人番号・gBizINFO・EDINET・BizData等を徹底比較」で解説しています。

法人番号を扱えるAPIの比較｜国税庁・gBizINFO・民間APIの違い

「法人番号 API」で情報を探していくと、国税庁の公式APIだけでなく、法人番号を扱える民間のAPIサービスも複数見つかります。どれを選ぶべきかは、必要なデータ項目とレスポンス形式、そして変更検知をどこまで自動化したいかで決まります。

公的APIは無料で正確、民間APIは扱いやすさとデータの広さで選びます。

主要APIの比較表

選び方の判断軸

この4つは競合というより、担う役割が異なります。用途から逆算すると選択はシンプルになります。

• 登記情報の正確性が最優先で、コストをかけたくない → 国税庁の法人番号システムWeb-API。一次情報源であることが最大の強みです
• 補助金採択や届出認定などの行政データを営業シグナルに使いたい → gBizINFO。民間データベースでは補いにくい領域を無料でカバーできます
• JSONで手軽に扱いたい・変更通知を自前で作りたくない → 民間の法人番号API。公的APIのCSV／XMLパースや差分バッチの実装コストを削減できます
• 営業リスト作成やCRMエンリッチまで一気通貫で行いたい → SalesNow APIのような企業情報API。法人番号だけでは足りない属性データを同一レスポンスで取得できます

gBizINFO側の仕様・取得できる行政データの詳細と、民間APIとの使い分けは「gBizINFO APIとは？仕様・取得データ・活用法と民間APIとの比較を解説」で解説しています。無料APIだけで構成する場合の選択肢を広く見比べたい方は「無料で使える企業情報API 10選｜法人番号・gBizINFO・EDINET・BizData等を徹底比較」もあわせてご参照ください。

法人番号をキーにした名寄せ・データ統合の実践

法人番号をキーにした名寄せとは、13桁の法人番号をユニークキーとして複数のデータベース間で同一企業のレコードを紐づけ、重複を排除する処理のことを指します。企業名の表記ゆれに依存しないため、最も高精度な名寄せ手法として広く採用されています。

法人番号ベースの名寄せは精度99%以上を実現できます。

名寄せの基本ステップ

法人番号を活用した名寄せは、以下の3ステップで実行します。第一に、CRM/SFAの既存レコードに法人番号を付与します。法人番号APIで企業名を検索し、該当する法人番号をレコードに紐づけます。第二に、法人番号をキーにして重複レコードを検出し、統合ルール（最新レコードを正とする等）に基づいてマージします。第三に、SalesNow APIで法人番号をキーに最新の企業属性データを取得し、統合後のレコードにエンリッチメントを施します。

名寄せ専用APIによる照合・統合の自動化フローは「名寄せAPIとは？仕組み・主要サービス比較・導入手順を徹底解説」で詳しく解説しています。法人番号と組み合わせると名寄せ精度をさらに高められます。

バッチ処理による一括名寄せの設計

大量レコードの名寄せを効率的に処理するには、バッチ処理の設計が重要です。法人番号APIのリクエスト制限を考慮し、1秒あたりのリクエスト数を制御するスロットリングを実装します。SalesNow APIは法人番号をキーとした一括取得に対応しているため、名寄せ結果の法人番号リストを一括で送信し、企業属性データをまとめて取得する効率的な処理が可能です。

法人番号API × 企業情報APIの連携アーキテクチャ

法人番号APIと企業情報APIの連携アーキテクチャとは、両APIを組み合わせてデータパイプラインを構築し、CRM/SFAや業務システムに統合する技術設計のことを指します。法人番号を共通キーとすることで、公的データと民間データをシームレスに結合できます。

設計段階でのアーキテクチャ選択が運用コストを大きく左右します。

データパイプラインの基本構成

法人番号APIと企業情報APIを連携するデータパイプラインは、以下の3層構成が基本です。第一層（データ取得層）では、法人番号APIから法人基本情報を取得し、SalesNow APIから企業属性データを取得します。第二層（データ加工層）では、法人番号をキーに両データを結合し、名寄せ・重複排除・データクレンジングを実行します。第三層（データ配信層）では、加工済みデータをCRM/SFAやBIツールに配信します。

リアルタイム連携とバッチ連携の使い分け

連携パターンは、リアルタイム連携とバッチ連携の2種類に大別されます。新規取引先の登録時や問い合わせフォームの受信時には、リアルタイムでAPIをコールし、即座に企業情報を付与するリアルタイム連携が適しています。一方、既存データの定期更新やデータクレンジングには、夜間や週末にまとめて処理するバッチ連携が効率的です。バッチ連携で営業リストを自動生成する具体例は「企業情報APIで営業リストを自動作成する方法と導入手順を解説」で解説しています。

Salesforce / HubSpot連携の実装パターン

CRM/SFAとの連携では、Salesforceであればフローまたは外部サービス（Named Credential + Apex）を使ったAPI呼び出し、HubSpotであればWorkflows + Custom Coded Actionを使った実装が一般的です。いずれの場合も、取引先オブジェクトに法人番号フィールドを追加し、SalesNow APIで企業データを取得・更新する仕組みを構築します。CRMエンリッチメントから営業リスト自動作成までの具体的な実装手順は「企業情報APIの活用シーン5選と実装手順｜CRMデータエンリッチメントから営業リスト自動作成までを徹底解説」で解説しています。

法人番号API活用時の注意点とベストプラクティス

法人番号API活用時の注意点とは、データの制約・APIの仕様上の制限・運用上のリスクなど、実装前に把握しておくべき事項のことを指します。これらを事前に理解しておくことで、導入後のトラブルを防止できます。

事前の制約理解が安定運用への最短ルートです。

個人事業主データは含まれない

法人番号は法人格を持つ組織にのみ付与されるため、個人事業主のデータは法人番号APIからは取得できません。フリーランスや個人商店を取引先に含む業態では、法人番号だけではデータの網羅性に限界がある点に注意が必要です。SalesNow APIは法人データだけでなく組織・部署レベルのデータも1,400万件超で網羅しているため、より広範な取引先管理に対応できます。

閉鎖・休眠法人のデータ管理

法人番号APIには、清算結了や吸収合併により閉鎖された法人のデータも含まれています。閉鎖事由（closeCause）フィールドを確認し、現在活動している法人のみを抽出するフィルタリング処理を実装してください。定期的なバッチ処理で閉鎖法人をCRM/SFAからフラグ付けまたは非表示にすることで、営業チームが休眠法人にアプローチするムダを防げます。

APIバージョン管理とエラーハンドリング

国税庁法人番号APIは、過去にバージョンアップが実施されています。APIの仕様変更によって既存の実装が動作しなくなるリスクがあるため、APIバージョンの固定（バージョニング）とエラーハンドリングの実装が不可欠です。レスポンスのHTTPステータスコードを確認し、5xx系エラー時のリトライ、4xx系エラー時のログ出力とアラート通知を組み込んでおきましょう。

【2026年最新】AIから法人番号API・企業情報APIを呼び出すMCP連携

AIから法人番号API・企業情報APIを呼び出すMCP連携とは、Claude（Anthropic）などの生成AIから SalesNow のデータベースを直接呼び出し、自然言語で条件を伝えるだけで法人番号付きの企業情報を取得できる仕組みのことです。2026年に登場した最新のデータ取得手段で、法人番号API単体では実現できない属性条件付きの抽出を対話形式で実行できます。

従来のAPI実装との違い

法人番号API（国税庁）を単独で利用する場合、開発者はリクエスト用のコードを書き、レスポンスのXML/CSVをパースし、必要な属性データを別APIで補完する一連の処理を実装する必要がありました。SalesNow MCPを使うと、Claude に「東京都の従業員50〜100名のSaaS企業を法人番号付きで50社」と伝えるだけで、580万社+の企業データから絞り込んだリストを取得できます。エンジニアでない営業・マーケ担当者でも、自然言語でデータ取得が可能です。

月500クレジットの無料枠

SalesNow MCPには月500クレジットの無料枠が用意されています。条件検索（リスト取得）は軽量な操作のため、通常の企業データ取得業務であれば月数十回〜数百回の検索を無料枠内でこなせる規模感です。仕様・対応プラン・接続手順などの詳細はSalesNow MCP公式ページをご覧ください。Claude（Anthropic）の有料プラン（Pro以上）が必要な点にはご留意ください。

実装例1：SalesNow APIでフォームに40項目以上のエンリッチを組み込む

SalesNowのカスタマーサクセス担当による実装例として、SalesNow APIを使ってWebフォームに「会社名サジェスト→法人番号自動取得→40項目以上のエンリッチデータ自動入力」の流れを組み込む3ステップを解説します。BtoBリード獲得における「入力項目を減らしながらもデータを充実させる」というトレードオフを、フォーム側のサジェストUIとAPI連携で同時に解決する設計です。

従来は法人番号や業種・売上高などの企業データをユーザーに入力させようとすると入力負担が増え、フォーム離脱が増加していました。本実装では、ユーザーが入力するのは「会社名」だけ。サジェストで候補を選んだ瞬間に、法人番号をキーに40項目以上が自動入力される仕組みを実現します。

SalesNow APIの構成：企業検索APIと企業情報取得APIの2層

SalesNow APIは「企業検索API（会社名サジェスト用）」と「企業情報取得API（詳細データ取得用）」の2つで構成されます。ユーザーがフォームに会社名を入力すると企業検索APIが候補を返し、ユーザーが候補から選んだ瞬間に法人番号をキーに企業情報取得APIが詳細データを取得する流れです。

STEP1：フォームを作成し自動入力フィールドを40項目以上から選ぶ

SalesNowのカスタマーポータルで「フォーム管理」を開き、フォームから取得する企業データを40項目以上から選択します。代表的な取得可能フィールドは「従業員数・売上高・資本金・経常利益・業種分類・SalesNowスコア」など。自社サービスに必要な項目だけを選ぶことで、フォーム経由で投入されるデータの量と精度を設計できます。

STEP2：マッピングとデザインを設定する

「マッピング」タブでSalesNow APIのフィールドとフォーム側のinput要素を紐付けます。例えば「SalesNow_従業員数」→ CRMフォーム側の従業員数フィールドのような形式です。「デザイン」タブではサジェストドロップダウンのカラーやフォントを調整でき、自社サイトのトーン&マナーに合わせられます。

STEP3：埋め込みコードを設置して動作確認する

管理画面で生成されたスクリプトタグを自社サイトに貼り付けます。コードは1行のscriptタグで、フォームページに埋め込むだけです。

<script src="https://cs.salesnow.jp/api/public/form/{orgId}/{slug}"></script>

埋め込み後、フォームで会社名を入力するとサジェストから候補を選択でき、選んだ瞬間に40項目以上のエンリッチデータが自動入力されます。

CRMでは「エンリッチ済み」状態で登録される

フォーム送信後、CRM（Salesforce／HubSpot）に登録される時点で、既に40項目以上のエンリッチデータが揃った状態になっています。営業担当やインサイドセールスが個別にデータを補完する手間がなくなり、初回提案の準備が高速化します。

SalesforceやHubSpotとの連携では、付与された法人番号をキーに既存企業データとの名寄せが100%実行できる状態が作れます。「フォーム入力負担の最小化」と「データの最大化」という従来トレードオフだった2つを同時に実現する設計です。

実装例2：Salesforce／Account Engagement（旧Pardot）×イチサンフォームで法人番号自動取得を組み込む

Salesforce／Account Engagement（旧Pardot）環境で、無料の「イチサンフォーム」を組み合わせて、リードフォームに法人番号自動取得を組み込む5ステップの実装例です。会社名入力時にサジェスト→法人番号を国税庁ベースで自動取得し、Salesforceリードオブジェクトに保存することで、SalesNowとの名寄せ精度を100%に高められます。

STEP1：Salesforceリードオブジェクトに「法人番号」カスタム項目を作成する

Salesforce設定→オブジェクトマネージャー→リードで、カスタム項目「法人番号」（テキスト型、20文字）を追加します。これがフォームから取得した法人番号の格納先になります。

STEP2：Account Engagementのプロスペクト項目「法人番号」を設定する

Account Engagement（旧Pardot）でプロスペクト項目「法人番号」を作成し、Salesforceリード項目「法人番号」と同期させます。これによりフォーム→Pardot→Salesforceの一気通貫でデータが流れる経路ができます。

STEP3：レイアウトテンプレートにイチサンフォームのスクリプトを統合する

Pardotのレイアウトテンプレートに、イチサンフォーム（無料）のスクリプトをJavaScriptで統合します。会社名フィールドにサジェスト機能が追加され、選択時に郵便番号・都道府県・市区町村・法人番号が自動入力されるようになります。

STEP4：フォーム項目8つを設定する

フォームに8項目を設定します：メール・姓・名・会社名（必須）・郵便番号・都道府県・市区町村・法人番号。ユーザーが手で入力するのは「メール・姓・名・会社名」の4項目だけ。会社名選択後、残り4項目（郵便番号・都道府県・市区町村・法人番号）はサジェストから自動入力されます。

STEP5：フォーム動作確認＆Salesforceでの保存確認

公開フォームでテスト送信を行い、会社名サジェスト→自動入力→Salesforceリードに法人番号が保存されることを確認します。Pardotプロスペクトとリードの両方に法人番号が反映されているかをチェックすれば設定完了です。

法人番号が国税庁ベースで自動入力されるため、SalesNowとの連携精度が100%に近い水準まで上がります。「フォーム入力負担を増やさずにデータ品質を上げる」設計が、Salesforce／Pardot環境でもイチサンフォーム経由で実現できます。

実装例3：HubSpot（無料版対応）×イチサンフォームでランディングページに法人番号取得を組み込む

HubSpotの無料版でも法人番号自動取得が組み込める実装例です。イチサンフォームのスクリプトをHubSpotランディングページのフッターHTMLに埋め込み、会社名入力時にサジェストから法人番号を自動入力する設計。コンタクト・会社レコード両方の法人番号プロパティを準備することで、SalesNowとの名寄せ精度が確保できます。

STEP1：HubSpotでコンタクト・会社両オブジェクトに法人番号プロパティを作成する

HubSpotの設定→プロパティで、「コンタクト」と「会社」の両オブジェクトに「法人番号」プロパティを作成します。両方に作る理由は、フォームで取得した法人番号がコンタクトに保存され、その後の名寄せで会社レコードにも反映される設計のためです。

STEP2：HubSpotで旧フォームエディターを使ってフォームを構築する

HubSpotのマーケティング→フォームで新規フォームを作成します。法人番号プロパティをフォーム項目として追加し、レイアウトを整えます。

※本実装では「旧フォームエディター」の使用が必須です。新エディター（モダンフォーム）はカスタムスクリプトの埋め込み挙動が異なる場合があります。

STEP3：ランディングページのフッターHTMLにイチサンフォームのスクリプトを埋め込む

HubSpotランディングページの設定→詳細オプション→フッターHTMLに、イチサンフォームの提供スクリプトを貼り付けます。ページがロードされたタイミングでイチサンフォームライブラリが自動読み込みされ、会社名フィールドにサジェスト機能が追加されます。

STEP4：フォーム動作確認＆HubSpotコンタクト・会社レコードの保存確認

公開ランディングページでテスト送信を行い、会社名サジェスト→法人番号自動入力→HubSpotコンタクトに法人番号が保存されることを確認します。SalesNow側で法人番号プロパティへのマッピング設定をしておけば、コンタクト→会社レコードへの紐付けと SalesNowの企業データの自動投入まで一気通貫で実行されます。

HubSpotの無料版でも法人番号取得＝SalesNow名寄せの一気通貫運用が実現できる構成です。フォーム入力負担を増やさずに、データ品質（特に名寄せ精度）を確保できるため、初期段階のスタートアップから本格運用フェーズの企業まで幅広く活用できます。

まとめ

法人番号APIは、国税庁が提供する無料の公的APIとして、法人番号・法人名・所在地などの基本情報を取得できる便利なツールです。しかし、営業やマーケティングで実際に必要な売上高・従業員数・業種・電話番号・部署情報などのデータは含まれていないため、企業情報APIとの補完関係を理解した上で活用することが重要です。

実務上の最適解は、法人番号APIで取得した法人番号をユニークキーとして、SalesNow APIなどの企業情報APIと連携するアーキテクチャです。法人番号ベースの名寄せで重複を排除し、企業属性データでエンリッチメントを施すことで、CRM/SFAのデータ品質を大幅に向上させることができます。

法人番号APIのリクエスト制限やデータ更新のタイムラグなど、技術的な制約を事前に把握し、バッチ処理とリアルタイム連携を適切に使い分ける設計が安定運用の鍵となります。

よくある質問