入力支援 ・ 導入ガイド
郵便番号住所入力プラグイン
Postal Lookup
現場のこんな時に顧客・取引先・配送先など、住所を手入力している画面で、郵便番号から住所を自動で埋めたい時。
郵便番号を入力すると、都道府県・市区町村・町域と、そのよみがなを対応する項目へ自動入力します。
使い始めの30日間は全アプリ・全ユーザーで使い放題。30日を過ぎても、各プラグイン1アプリなら期限なしでずっと¥0。
社内稟議・上長への共有には、製品概要(PDF・1枚/印刷対応)をご利用ください。
サイボウズ オフィシャルプロダクトパートナー
Plumeru を提供する株式会社スターフィッシュは、サイボウズ株式会社のオフィシャルパートナー制度(Cybozu Partner Network)にプロダクトパートナーとして加入しています。
kintone 標準の入力と何が違う?
標準では郵便番号から住所を自動入力する仕組みがなく、都度手入力になります。郵便番号を入れた時点で住所欄を自動で埋めます。
- 郵便番号から都道府県・市区町村・町域を自動入力する標準機能がない
- 住所を毎回手入力するため、表記ゆれや入力ミスが起きやすい
- 郵便番号と住所の対応を自前でメンテナンスする手段がない
- 郵便番号の入力時に、都道府県・市区町村・町域を対応する項目へ自動入力
- 住所のよみがな(全角カタカナ/ひらがな)も、まとめて1項目または都道府県・市区町村・町域ごとに自動入力(まとめては含める部分とつなぎ文字を選択可)
- 全角の郵便番号やハイフン付きでも、7桁を判定して住所を取得
- 既存の値を上書きするかどうかを設定で選べる
同じ目的の製品を探す方へ:入力支援・入力規則のkintoneプラグイン比較(価格・無料枠・試用を公式情報で確認)
概要
郵便番号住所入力プラグインは、郵便番号の入力に合わせて都道府県・市区町村・町域を自動で埋め、住所の手入力と表記ゆれを減らすためのものです。住所を入れる項目は名前で選ぶだけで設定でき、コードの知識は要りません。
kintone の標準設定だけでは届かない「郵便番号から住所を補う」場面を、追加開発を増やさず補いたい時にちょうどいい立ち位置です。
できること
郵便番号を入れると、都道府県・市区町村・町域を対応する項目へ自動で入力します。
全角の数字・ハイフン・「〒」が混ざっていても、7桁がそろえば住所を取得します。
空欄だけ埋めるか、既存の値も置き換えるかを設定で選べます。
住所の取得に送るのは郵便番号のみで、レコードの内容は送信しません。
実際の画面でできることを確認
向いている場面
- 顧客・取引先マスタで住所入力の手間を減らす
- 配送先・請求先の住所をすばやく正確に入れる
- 申込・問い合わせ受付で住所の表記ゆれを防ぐ
- 番地・建物名まで自動で分割して入れたい
- 住所から郵便番号を逆引きしたい
- 海外の住所を補完したい
導入手順
はじめてでも迷わないよう、ダウンロードから動作確認までを順に説明します(所要 初期設定 3分前後)。
- 署名付き ZIP をダウンロード:上の「ダウンロード」から署名付き ZIP を保存します。
- kintone にプラグインを読み込む:kintone 画面右上の歯車から「kintone システム管理」→「プラグイン」を開き、「読み込む」で保存した ZIP をアップロードします。これでドメインにプラグインが登録されます。

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

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

作成画面:郵便番号を入力すると住所が自動で入る様子 画像を原寸で開く
無料プランでは各プラグインを 1アプリまでお試しいただけます(プラグインが動作する画面の上部に小さな「Plumeru 提供」クレジットが表示されます。Pro では非表示)。うまく動かない時は、対象の項目の指定と、「アプリを更新」を実行済みかをご確認ください。
うまく動かない・不具合の通報
郵便番号住所入力プラグインがこのガイドの説明どおりに動かない、または不具合を見つけた場合は、こちらからお知らせください。内容を確認し、できるだけ早く修正します。
不具合を通報する仕様メモと制限
- 作成・編集画面で郵便番号の項目が変わると、住所APIを引いて都道府県・市区町村・町域を自動入力します
- 全角の数字・ハイフン・「〒」が混ざっていても、7桁の数字がそろった時点で住所を取得します
- 住所を入れる項目(都道府県・市区町村・町域)は、それぞれ個別に選べます(使わない項目は指定しなくて構いません)
- 住所のよみがなも自動入力できます。「まとめて1項目」または「都道府県・市区町村・町域ごと」に入れる項目を選び、表記は全角カタカナ/ひらがなから選べます(よみがなは町域までが対象です)。「まとめて1項目」は含める部分(都道府県・市区町村・町域)の組み合わせと、つなぎ文字(なし/半角スペース/全角スペース/ハイフン/アンダースコア)を指定できます
- 郵便番号→住所の組(セット)は複数設定できます。引っ越し前/引っ越し先、自宅/勤務先のように、1つのアプリに住所が複数あっても、それぞれの郵便番号から対応する住所へ自動入力できます(同じ郵便番号の項目を複数のセットで使うことはできません)
- 「すでに値が入っている項目も上書きする」の設定で、空欄だけ埋めるか既存値も置き換えるかを選べます
- 住所の取得先(API)は既定で郵便番号検索の公開APIを使い、設定で自社プロキシ等に差し替えできます
- 万一プランの判定ができないときも、通常どおり入力・保存できます(kintone本来の動作を妨げません)
- 対象は作成・編集画面です。一覧画面や詳細画面では動きません
- 郵便番号の項目は文字列または数値、住所の項目は文字列(1行/複数行)に対応します
- 自動入力は都道府県・市区町村・町域(と、そのよみがな)までです。番地・建物名とそのよみがなは手入力になります
- 住所の取得に外部の郵便番号検索APIへ通信します(郵便番号のみを送信し、レコードの内容は送信しません)。通信できないときは自動入力を行わず、手入力はそのまま可能です
- 1つの郵便番号に複数の住所が対応する場合は、先頭の住所を採用します
- パソコン版とモバイル版の作成・編集画面で利用できます
変更履歴
- スマートフォン・タブレットの kintone モバイル画面でも、郵便番号から住所を自動入力できるようにしました。現場でスマホから登録するときに使えます。
- 設定画面に、そのプラグインで最初に知っておきたい点を表示するようにしました(設定画面のみの変更で、通常画面の動作は変わりません)。
過去の変更履歴を表示(残り25件)
- 設定画面のお知らせ先の登録に、確認メールの手順を追加しました。メール内のボタンを押すと登録が完了します(設定画面のみの変更で、通常画面の動作は変わりません)。
- 設定画面に、不具合や重要な更新のお知らせ先(メールアドレス)を登録できる欄を追加しました(設定画面のみの変更で、通常画面の動作は変わりません)。
- 設定画面の改善要望・不具合報告の案内に、不具合のご報告には原則1営業日以内に受付のご連絡をする旨を明記しました。
- 不具合の原因調査に使う診断情報に、kintone が返すエラーコードと発生箇所を含めるようにしました(通常画面の動作は変わりません)。
- 設定画面に、創業期 導入パートナーの募集案内を表示するようにしました(設定画面のみの変更で、通常画面の動作は変わりません)。
- 設定画面の下部にある改善要望・不具合報告の案内に、いただいた内容は開発者が直接確認し、不具合は優先してすみやかに修正している旨を追記しました(設定画面のみの変更で、通常画面の動作は変わりません)。
- トライアル残日数を確認できない画面で「残り0日」と誤表示される問題を修正しました。
- お知らせ表示と設定画面の一部の色をPlumeru共通のブランド配色に統一しました。動作は変わりません。
- プラグイン内部の共通処理を他のプラグインとそろえました。動作は変わりません。
- 画面を開いた時点で郵便番号が既に入っている場合にも、住所・よみがなを自動入力するようにしました。REST APIで作成・更新されたレコードや、別のカスタマイズ・プラグインが入れた郵便番号は「項目を変更したとき」のイベントが発生しないため、これまで自動入力が動きませんでした。表示時の自動入力は空欄の項目だけが対象で、入力済みの値は「上書きする」設定に関わらず書き換えません(編集画面を開くたびに手修正した住所が書き戻ることを防ぐためです)。
- 「よみがな(まとめて)」に入れる内容を選べるようにしました。含める部分(都道府県・市区町村・町域)を組み合わせられるほか、つなぎ文字(なし/半角スペース/全角スペース/ハイフン/アンダースコア)も指定できます。例えば市区町村と町域だけを半角スペースでつないで1項目に入れる、といった使い方ができます。既存の設定はこれまでどおり「3つ全部・つなぎ文字なし」で動きます。
- 同じ項目を複数の入れ先(住所・よみがな)に選んだまま保存できないようにしました(実行時に後から入る値が先の値を静かに上書きしてしまうため。どのセットのどの欄が重複しているかを保存時に表示します)。あわせて、郵便番号の項目そのものを入れ先に選ぶこともできないようにしました。
- 設定画面の項目選択プルダウンの幅を、選択肢の項目名の長さに合わせて自動で広げるようにしました(これまで一律幅のため、画面に余白があっても長い項目名が「…」に省略されることがありました)。設定画面のみの変更で、通常画面の動作は変わりません。
- 設定画面の項目選択プルダウンで、長い項目名が途中で切れて読めないことがある問題を修正しました(候補一覧を項目名の長さに合わせて広げるほか、選択中の値は末尾を「…」で省略しつつマウスオーバーで全文を表示します)。設定画面のみの変更で、通常画面の動作は変わりません。
- 住所のよみがなを自動入力できるようにしました。セットごとに「よみがな(まとめて1項目)」または「都道府県・市区町村・町域のよみがな」の項目を選ぶと、住所と一緒によみがなも入ります(町域までが対象)。表記は全角カタカナ/ひらがなから選べます。
- 郵便番号→住所の組(セット)を複数設定できるようにしました。引っ越し前/引っ越し先、自宅/勤務先のように1つのアプリに住所が複数ある場合、設定画面の「セットを追加」からそれぞれの組を登録できます(既存の設定はそのまま「セット1」として引き継がれます)。
- 設定画面のプラン表示を正確にしました(Pro・トライアル契約中でも「Plumeru Free」と表示されることがあった問題の修正。トライアル中は残り日数も表示)。管理者向け表示のみで、通常画面の動作は変わりません。
- 郵便番号を続けて変更したとき、先に入力した番号の遅い検索結果で住所が上書きされることがある問題を修正しました。
- ライセンス状態の表示名を修正(無料時に「Pro」と出ていた設定画面・ヘッダーの表示を「Free」等の正しい名称へ。管理者向け表示のみで、通常画面の動作は変わりません)。
- 設定画面に、新しい版が公開されているときのお知らせを表示するようにしました(管理者向け。通常画面の動作は変わりません)。
- プラグインの説明文を、機能がより伝わるように書き直しました(動作の変更はありません)。
- 設定画面で項目(プルダウン)を選ぶとき、選択肢が多い場合は名前の一部を入力して絞り込めるようにしました(部分一致の検索付き)。選択肢が少ないものは従来どおりです。
- 設定画面のデザインを共通ベースへ統一(ブランド差し色の保存ボタン・全操作要素のフォーカス表示・入力欄やメッセージの体裁を全プラグインで揃える)。
- ライセンス判定をsessionStorage短TTLキャッシュ+裏リフレッシュ化。
- currentAppId をモバイル対応(kintone.mobile.app.getId フォールバック)に統一。
- 設定画面の文言を統一・是正。
- 初版公開。郵便番号を入力すると都道府県・市区町村・町域を自動入力します。