郵便番号から住所を自動入力！日本郵便公式APIプラグインの使い方

日本郵便の公式APIで都道府県・市区町村・町域を自動入力できるプラグインです。

公式APIを利用して郵便番号から住所を検索したい

住所入力の「地味なストレス」、感じていませんか？

kintoneで日常的にレコードを入力している方の中には、こんなシーンに心当たりがあるのではないでしょうか。

• 顧客情報の登録時に、郵便番号と住所をそれぞれ手で打ち込む
• 転記ミスや表記ゆれ（「漢字」と「カナ」など）が発生してデータが乱れる
• 引っ越しなどで住所が変わったとき、古いデータが残ったままになる

住所入力は「一見かんたん、でも積み重なると大変」な作業の代表格です。特に件数が多くなるほど、入力ミスのリスクも高まります。

郵便番号を入れるだけで住所が埋まるプラグインです

今回ご紹介するプラグインを使えば、7桁の郵便番号を入力するだけで、都道府県・市区町村・町域が自動でフィールドへ入力されます。

手動で住所を打ち込む必要がなくなるため、

• ✅ 入力時間の短縮
• ✅ 転記ミスの防止
• ✅ 表記ゆれのないクリーンなデータ管理

が実現できます。

データは日本郵便が提供する公式の郵便番号・デジタルアドレスAPIから取得するため、常に正確な情報をもとに住所を自動入力できます。

郵便番号・デジタルアドレスAPIとは？

日本郵便が2025年5月から無料提供を開始した公式API

このプラグインが利用しているのは、日本郵便株式会社が提供する「郵便番号・デジタルアドレスAPI」です。
2025年5月から「無料」での提供が開始されました。

APIとはシステム同士がデータをやりとりするための「窓口」のようなものです。このプラグインは、kintoneと日本郵便局の郵便番号・デジタルアドレスAPIでつなぐことで、リアルタイムに正確な住所データを取得しています。

郵便局APIならではの3つの特徴

① 1つのAPIで郵便番号とデジタルアドレスの両方に対応

郵便番号・デジタルアドレスAPIは、郵便番号からの住所検索と、デジタルアドレス（短縮コード）からの住所検索の両方を1つのAPIで提供しています。

デジタルアドレスとは、住所を短いコード（例：A7E-2FK2）で表現する新しい仕組みです。マンションの部屋番号まで含めた細かい住所をコンパクトに表せるため、今後の活用が期待されています。本プラグインは郵便番号での検索に対応しています。

② 常に最新の郵便番号データ

日本国内の郵便番号は、新たな住所の設定や町名変更、区画整理などにより定期的に更新されています。郵便局が公開する郵便番号データは更新頻度が高く、常に最新の状態に保たれています。このAPIを使うことで、古い情報を参照してしまうリスクがなくなります。

③ 漢字・カナ・ローマ字に対応

APIのレスポンス（返ってくるデータ）には、住所の漢字表記・カタカナ表記・ローマ字表記がすべて含まれていますので、多言語対応が必要なアプリや、帳票にローマ字住所を印字したい場合にも活用できます。
※本プラグインでは、カタカナ、ローマ字の値をフィールドに出力する機能はありません。

表記	例
漢字	東京都千代田区岩本町
カタカナ	トウキョウト チヨダク イワモトチョウ
ローマ字	TOKYO / CHIYODA-KU / IWAMOTOCHO

デモ画面

本プラグインを適用すると、郵便番号とデジタルアドレスの両方で、住所データを自動セットできるので、住所入力の作業を効率化できます。以下の画像は、プラグインを適用したアプリのレコード作成画面です。

郵便番号（7桁）で、検索結果に複数候補がある場合は、ダイアログ表示の一覧から選択できます。

🛠️ プラグインの設定項目の説明

プラグインをkintoneに追加したら、設定画面で以下の項目を設定します。
難しいコード知識は不要です。画面の案内に従って入力・選択するだけで完了します。

① API認証情報の設定（必須）

日本郵便APIを利用するために必要なクレデンシャル「認証情報」を入力します。
本プラグインを利用する事前準備として、自社用にAPI利用の認証情報を取得して頂く必要があります。

API利用に必要な情報は、日本郵便の「郵便番号・デジタルアドレスAPI」に利用申請を行うと即日発行されます。
申請・発行手順については、こちらの記事をご参照ください。

設定項目	内容
クライアントID	日本郵便APIポータルで取得したID
シークレットキー	日本郵便APIポータルで取得したキー（パスワードのようなもの）

💡 ポイント： クライアントIDとシークレットキーはkintoneのプラグイン設定として安全に保存されます。kintoneの画面やブラウザの管理コンソールには表示されません。アプリのプラグイン設定画面でも「シークレットキー」はマスク表示されてますので値の確認はできません。

② フィールドコード設定（必須）

プラグインがどのフィールドに住所を入力するかを指定します。kintoneアプリに作成済みのフィールドをドロップダウンから選ぶだけです。

設定項目	選択するフィールド
郵便番号フィールド	郵便番号を入力する文字列1行型フィールド
都道府県フィールド	都道府県を表示する文字列1行型フィールド
市区町村フィールド	市区町村を表示する文字列1行型フィールド
町域フィールド	町名を表示する文字列1行型フィールド
番地フィールド	番地とビル名前の入力フィールド（任意） ※デジタルアドレスで検索時に値が取得されます
住所全体フィールド	住所全体（都道府県＋市区町村＋町域）を表示するフィールド（任意）
検索ボタン配置スペースID	「住所を検索」ボタンを表示したいスペースフィールドのID（任意）

💡 ポイント： 「番地」「住所全体」フィールドと「検索ボタン用スペース」は任意設定です。使いたい場合のみ設定してください。

③ API環境設定

本番環境とテスト環境を切り替えられます。

選択肢	説明
本番環境	正式な認証情報を使って全国の郵便番号を検索できます（通常はこちら）
テスト環境	テスト用の認証情報を使って動作確認ができます（限定した郵便番号のみ検索可）

はじめて導入する際はテスト環境で動作確認を行い、問題がなければ本番環境に切り替えることをおすすめします。

④ デバッグ設定（任意）

「コンソールにデバッグログを出力する」にチェックを入れると、ブラウザの開発者ツールに詳細なログが出力されます。通常利用では不要です。不具合が発生した際に管理者が調査するための機能です。

これで設定は完了です！郵便番号フィールドに7桁を入力して、住所が自動入力されることを確認してみましょう。

1. 「保存する」ボタンをクリック
2. kintoneアプリの「アプリを更新」を実行

まとめ

今回ご紹介した「郵便番号住所検索プラグイン」は、日本郵便の公式APIを活用してkintoneに住所の自動入力機能を追加するプラグインです。

こんなアプリに特におすすめ

• 👤 顧客管理アプリ（取引先・会員情報）
• 📦 受発注・配送管理アプリ
• 📋 申込フォームや問い合わせ管理
• 🏢 施設・拠点管理アプリ

住所の入力は「手間がかかるわりに地味な作業」ですが、データの正確性はあとあと大きく効いてきます。このプラグインを一度導入すれば、入力担当者の負担を減らしながら、データ品質の向上も同時に実現できます。

---

💻 試用版プラグインのお申込み

本プラグインの試用版（60日間）をご希望の方は、以下のフォームからお申し込みください。
お申込み者のＥメール宛に「試用版ダウンロードのご案内」をＥメールでご送付します。
★★ kintoneの「ドメイン名」は正確にご記入ください。★★

📬 お問い合わせ・料金体系

本プラグインは、下記の料金プランで販売しています。
ご購入を希望される場合は、各プランの「購入する」ボタンからお申込みください。

簡易サポート契約では、当サイトのアプリテンプレートとプラグインを合計6種類までご利用できます。
会員サポート契約では、導入支援から運用ヘルプデスク対応をフルサービスでご提供します。

リリースノート

【名称】郵便番号・デジタルアドレス検索プラグイン

【概要】郵便局デジタルアドレスAPIを利用して住所を自動入力するプラグインです。

このプラグインで利用しているOSSのライセンスはありません。
このプラグインが使用している外部APIの概要は、以下の通りです。

参考記事

以下の記事は、郵便番号・デジタルアドレスAPIのアカウント申請・登録方法とカスタマイズ事例の紹介記事です。

郵便局公式APIで郵便番号→住所の自動入力をkintoneに実装する

日本郵便の公式API「郵便番号・デジタルアドレスAPI」を使い、kintoneで郵便番号から住所を自動入力する仕組みを、アカウント登録からkintone用のサンプルコードまで解説します。 日本郵便の公式APIは、日本郵便が直接提供する無料サービスです。信頼性が高く、継続的なデータ更新が保証されています。

dejitora.jp

2026.06.18

以下の記事は、国税局の法人番号APIを利用したカスタマイズ事例の紹介記事です。

kintone×国税庁API連携で法人情報を自動取得！

取引先をkintoneに登録するとき、「社名と住所を入力したけれど、正しい名称と住所を入力出来ていなかった」「インボイス番号を調べるのに時間がかかる…」といった経験はないでしょうか。このカスタマイズは、そんな取引先入力の悩みを一気に解決します。国税庁の公式APIとkintoneを連携することで、ボタンひとつで法人番号・インボイス番号・住所情報を自動取得 できるようになります。1. 法人名で「法人番号」と「インボイス番号」を一括検索このカスタマイズで実現することは、とてもシンプ…

dejitora.jp

2026.06.10

---

#kintone #plugin #API連携 #郵便局デジタルアドレスAP　#住所変換