入力支援 ・ 導入ガイド
郵便番号住所入力プラグイン
Postal Lookup
現場のこんな時に顧客・取引先・配送先など、住所を手入力している画面で、郵便番号から住所を自動で埋めたい時。
郵便番号を入力すると、都道府県・市区町村・町域を対応する項目へ自動入力します。
kintone 標準の入力と何が違う?
標準では郵便番号から住所を自動入力する仕組みがなく、都度手入力になります。郵便番号を入れた時点で住所欄を自動で埋めます。
- 郵便番号から都道府県・市区町村・町域を自動入力する標準機能がない
- 住所を毎回手入力するため、表記ゆれや入力ミスが起きやすい
- 郵便番号と住所の対応を自前でメンテナンスする手段がない
- 郵便番号の入力時に、都道府県・市区町村・町域を対応する項目へ自動入力
- 全角の郵便番号やハイフン付きでも、7桁を判定して住所を取得
- 既存の値を上書きするかどうかを設定で選べる
概要
郵便番号住所入力プラグインは、郵便番号の入力に合わせて都道府県・市区町村・町域を自動で埋め、住所の手入力と表記ゆれを減らすためのものです。住所を入れる項目は名前で選ぶだけで設定でき、コードの知識は要りません。
kintone の標準設定だけでは届かない「郵便番号から住所を補う」場面を、追加開発を増やさず補いたい時にちょうどいい立ち位置です。
できること
郵便番号を入れると、都道府県・市区町村・町域を対応する項目へ自動で入力します。
全角の数字・ハイフン・「〒」が混ざっていても、7桁がそろえば住所を取得します。
空欄だけ埋めるか、既存の値も置き換えるかを設定で選べます。
住所の取得に送るのは郵便番号のみで、レコードの内容は送信しません。
向いている場面
- 顧客・取引先マスタで住所入力の手間を減らす
- 配送先・請求先の住所をすばやく正確に入れる
- 申込・問い合わせ受付で住所の表記ゆれを防ぐ
- 番地・建物名まで自動で分割して入れたい
- 住所から郵便番号を逆引きしたい
- 海外の住所を補完したい
導入手順
はじめてでも迷わないよう、ダウンロードから動作確認までを順に説明します(所要 初期設定 3分前後)。
- 署名付き ZIP をダウンロード:上の「ダウンロード」から署名付き ZIP を保存します。
- kintone にプラグインを読み込む:kintone 画面右上の歯車から「kintone システム管理」→「プラグイン」を開き、「読み込む」で保存した ZIP をアップロードします。これでドメインにプラグインが登録されます。

kintone システム管理:プラグインの読み込み画面 - 使いたいアプリに追加する:対象アプリを開き、「アプリの設定」→「プラグイン」→「プラグインを追加」で「Plumeru 郵便番号住所入力プラグイン」を選びます。

アプリ設定:プラグインを追加 - プラグインを設定する:追加した「Plumeru 郵便番号住所入力プラグイン」の設定(歯車アイコン)を開き、項目を設定して「保存」します。
設定のポイント:「郵便番号の項目」を1つ選び、「都道府県」「市区町村」「町域」を入れる項目をそれぞれドロップダウンで選ぶだけです(フィールドコードの知識は不要)。
設定画面:郵便番号の項目と、住所を入れる項目(都道府県・市区町村・町域)を選ぶ - アプリを更新して反映する:アプリ右上の「アプリを更新」を必ずクリックします(更新しないと変更が反映されません)。
- 動作を確認する(サンプル検証):作成/編集画面を開くと郵便番号の入力時にプラグインが動きます。テスト用のアプリ/レコードで「顧客・取引先・配送先など、住所を手入力している画面で、郵便番号から住所を自動で埋めたい時」を実際に試し、想定どおり動くか確認しましょう。

作成画面:郵便番号を入力すると住所が自動で入る様子
無料プランでは各プラグインを 1アプリまでお試しいただけます(プラグインが動作する画面の上部に小さな「Plumeru 提供」クレジットが表示されます。Pro では非表示)。うまく動かない時は、対象の項目の指定と、「アプリを更新」を実行済みかをご確認ください。
うまく動かない・不具合の通報
郵便番号住所入力プラグインがこのガイドの説明どおりに動かない、または不具合を見つけた場合は、こちらからお知らせください。内容を確認し、できるだけ早く修正します。
不具合を通報する仕様メモと制限
- 作成・編集画面で郵便番号の項目が変わると、住所APIを引いて都道府県・市区町村・町域を自動入力します
- 全角の数字・ハイフン・「〒」が混ざっていても、7桁の数字がそろった時点で住所を取得します
- 住所を入れる項目(都道府県・市区町村・町域)は、それぞれ個別に選べます(使わない項目は指定しなくて構いません)
- 「すでに値が入っている項目も上書きする」の設定で、空欄だけ埋めるか既存値も置き換えるかを選べます
- 住所の取得先(API)は既定で郵便番号検索の公開APIを使い、設定で自社プロキシ等に差し替えできます
- 万一プランの判定ができないときも、通常どおり入力・保存できます(kintone本来の動作を妨げません)
- 対象は作成・編集画面です。一覧画面や詳細画面では動きません
- 郵便番号の項目は文字列または数値、住所の項目は文字列(1行/複数行)に対応します
- 自動入力は都道府県・市区町村・町域までです。番地・建物名は手入力になります
- 住所の取得に外部の郵便番号検索APIへ通信します(郵便番号のみを送信し、レコードの内容は送信しません)。通信できないときは自動入力を行わず、手入力はそのまま可能です
- 1つの郵便番号に複数の住所が対応する場合は、先頭の住所を採用します
変更履歴
- 初版公開。郵便番号を入力すると都道府県・市区町村・町域を自動入力します。