機能概要
本プラグインは、国税庁の法人番号システム Web-API を利用して、法人番号または法人名（部分一致）から法人情報（商号または名称、所在地ほか）を取得し、kintone アプリのフィールドに自動入力します。
- 法人番号、または法人名のいずれかを入力して検索が可能
- 法人名は部分一致による検索に対応
- 検索ボタンをクリックすると、 API 経由で法人情報を取得し、検索結果のリストを表示
- 検索結果リストからコピーしたい対象を選択し、さらに項目を選びコピーを実行
- 一覧画面で法人番号から完全一致する法人情報で一括で更新
- 一括更新時に更新対象フィールドの選択可能
法人番号 Web-API 公式サイト：https://www.houjin-bangou.nta.go.jp/webapi/index.html
このサービスは、国税庁法人番号システムのWeb-API機能を利用して取得した情報をもとに作成しておりますが、サービスの内容は国税庁によって保証されたものではありません。
動作イメージ
レコード追加／編集画面で、法人番号（13桁）または法人名（部分一致）を入力し、検索ボタンをクリックすると、APIにアクセスして法人情報を取得し、マッピングされたフィールドに自動入力されます。
- ラジオボタンで法人番号、法人名での検索を切り替えます。法人番号が初期選択されています。
- 法人番号は完全一致による検索となります。
- 法人名による検索時は、部分一致となります。
設定方法
このプラグインを使用するには、以下の3ステップで設定を行います。
- APIの認証情報を設定
- 検索ボタンの表示位置を設定
- 法人情報とフィールドのマッピングを設定
1. API認証情報の設定
国税庁の Web-API を利用するには、事前に法人番号システムの アプリケーションID を取得する必要があります。
- 取得方法：国税庁法人番号API 利用申請ページ
- 設定画面の「アプリケーションID設定」欄に、取得したアプリケーションIDを入力してください。
2. 検索ボタンの表示位置の設定
検索ボタンは、kintoneアプリの「スペース」フィールドに設置されます。 フォーム設定でスペースフィールドを配置し、そのフィールドコードを「検索ボタン設置スペース」のドロップダウンから選択してください。
- 例：スペースフィールドのフィールドコードが
search_buttonの場合、「検索ボタン設置スペース」にsearch_buttonを入力
3. 法人情報のマッピング設定
取得された法人情報を、kintoneアプリのどのフィールドに格納するかを指定します。法人番号,名称は動作に必要な設定項目です。それ以外の項目は任意設定です。必要な情報に応じてマッピングしてください。同じフィールドコードを複数の項目に割り当てることはできません。ただし、都道府県名、市区町村名、丁名番地に同じフィールドコードを割り当てた場合は、指定したフィールドに結合したものを保存します。
法人番号指定日、閉鎖日、変更日は日付フィールド。それ以外は文字列（１行）フィールドとなります。
| 項目 | 説明 | 例（フィールドコード） |
|---|---|---|
| 法人番号 | 13桁の法人番号 | houjin_no |
| 名称 | 法人の名称（商号） | name |
| フリガナ | 名称のフリガナ（任意） | furigana |
| 郵便番号 | 所在地の郵便番号 | zip |
| 都道府県名 | 所在地の都道府県 | pref |
| 市区町村名 | 所在地の市区町村 | city |
| 丁名番地 | 番地、建物名など | address_detail |
| 都道府県コード | 都道府県のコード（例：13） | pref_code |
| 市区町村コード | 国税庁基準のコード | city_code |
| 海外所在地 | 海外住所（日本語） | overseas_address |
| 名称（英語） | 英語表記の法人名 | name_en |
| 都道府県名（英語） | 都道府県の英語名 | pref_en |
| 市区町村名（英語） | 市区町村の英語名 | city_en |
| 海外所在地（英語） | 海外住所（英語） | overseas_address_en |
| 法人番号指定日 | 法人番号が付与された日（日付） | houjin_date |
| 変更事由 | 法人情報の変更理由 | reason |
| 閉鎖日 | 閉鎖された日（日付） | closed_date |
| 閉鎖事由 | 閉鎖の理由 | closed_reason |
| 後継法人番号 | 合併等で継承された法人番号 | successor |
| 法人種別コード | 例：株式会社=301 | kind |
| 更新日 | 最後に更新された日（日付） | updated_at |
| 最新レコードフラグ | 1=最新、0=履歴 | latest_flag |
4. 一括更新設定（任意）
一括更新機能を利用する場合は、対象リストの リストID を設定してください。 この設定を行うことで、複数レコードに対して一括で法人情報を更新することができます。
- 一括更新ボタンの配置は別途設定されているビューに依存します
- 更新対象は一覧に表示されているレコードで法人番号がフィールドに保存されているレコードです
- 更新対象を絞り込む場合は一覧の絞り込みで条件を絞り込んでください
補足事項
- 検索対象は「法人番号」または「法人名」のいずれかです
- 法人名検索は部分一致のため、正式名称の一部だけでも検索可能です
- 法人名検索は法人格を含めず検索可能です
- 検索ボタンはkintoneの「スペース」フィールドに表示されます。要素IDの指定をお忘れなく
- 閉鎖済みの法人を検索結果に含めたい場合は、「閉鎖法人を含める」にチェックを入れてください
- 法人種別で絞り込むことができます
- 法人番号は13桁で入力してください。完全一致のため桁数が足りないと検索されません
- 設定の引っ越し機能である設定画面の「設定をファイルにエクスポート」では、「アプリケーションID」は出力されません。「設定をファイルからインポート」実施後に個別にセットしてください
まずは、30日間無料お試し
プラグインをダウンロードしてkintoneで使用開始してから30日間無料ですべての機能をご試用いただけます。