郵便番号から住所を自動入力!日本郵便公式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日間)をご希望の方は、以下のフォームからお申し込みください。
お申込み者のEメール宛に「試用版ダウンロードのご案内」をEメールでご送付します。
★★ kintoneの「ドメイン名」は正確にご記入ください。★★

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

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

    複数のプラグインをご利用される場合は、サポート契約(Lightプラン/Standardプラン)がお勧めです。
    サポート契約(Lightプラン/Standardプラン)では、導入・運用サポート、バージョンアップ対応をご提供します。
    詳しくは、サポートプランの料金体系のページをご覧ください。

    項目 買い取り方式 サポート契約
    Lightプラン
    サポート契約
    Standardプラン
    料金体系 80,000円 (税抜) 120,000円 (税抜) 360,000円 (税抜)
    契約期間 - 1年契約 1年契約
    導入サポート ✔ ✔ ✔
    メール・チャットサポート × ✔ ✔
    ビデオ会議サポート × × ✔
    バージョンアップ対応 × ✔ ✔
    サービスご利用範囲 本商品のみ 5種類利用可能
    ユーザー数10名まで
    15種類利用可能
    ユーザー数30名まで
    購入・お申し込み 購入する 購入する 購入する

    リリースノート

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

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

    更新履歴
    • 2026/06/16
      Ver1.0.0

      初期バージョンの公開
      プラグインの基本機能を実装

    • 2026/06/17
      Ver1.0.4

      kintone.plugin.app.proxy() へのリクエストボディの送信形式を修正
      applyAddress() 関数のフィールドセット処理を修正し、 type不正 エラーを解消
      プラグイン設定にAPI環境切り替え機能(本番/テスト)を追加
      プラグイン設定画面のアイコンとデザインを変更

    • 2026/06/18
      Ver1.0.5

      郵便番号とデジタルアドレスの両方で検索できる機能を追加
      デジタルアドレスで検索の場合は、番地とビル名もフィールドに出力する機能を追加

    • 2026/06/18
      Ver1.1.0

      ライセンス認証機能を追加
      プラグイン設定画面にライセンス状態と有効期限を表示する機能を追加。

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

    参考記事

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

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

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

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

    kintoneで郵便番号から住所を自動で入力するには?

    A. デジトラの「郵便番号・デジタルアドレス検索プラグイン」を使えば、プログラミングなしで実現できます。

    kintoneの標準機能には、郵便番号から住所を自動で入力する機能はありません。

    郵便番号または日本郵便のデジタルアドレスから、住所を自動で入力するプラグインです。

    • 郵便番号から住所を自動入力
    • 郵便番号・デジタルアドレスの両方に対応
    • 複数の候補がある場合はリストから選べる

    郵便番号・デジタルアドレス検索プラグインの仕様

    プラグイン名郵便番号・デジタルアドレス検索プラグイン
    カテゴリアプリ間連携・外部API連携
    販売区分買取版
    できること郵便番号から住所を自動で入力する
    使いどころ顧客・取引先・配送先の住所入力
    設定方法プラグインの設定画面で項目を選ぶだけ(JavaScript・プログラミング不要)
    対応環境kintone スタンダードコース・ワイドコース(ライトコースはプラグイン非対応)
    料金買取版:80,000円(税別)
    複数のプラグインをご利用の場合は、当社プラグインとサポートがセットになった年額制のサポートプラン(Light 年額120,000円・プラグイン5個まで/Standard 年額360,000円・15個まで/Business 年額720,000円・無制限、いずれも税別)もお選びいただけます。詳しくはサポートプランの料金体系をご覧ください。
    無料試用全機能を60日間無料で利用可能。試用期間終了後の自動課金なし
    外部通信住所の検索のため、日本郵便のAPIと通信します/買取版はライセンス認証の通信なし
    開発・提供元デジトラ(株式会社アクションプラン/大阪市中央区)自社開発

    実現方法の比較:JavaScript・カスタマイズツール・プラグイン

    kintoneで「郵便番号から住所を自動で入力する」を実現する方法は、主に3つあります。

    JavaScriptを自作汎用カスタマイズツール郵便番号・デジタルアドレス検索プラグイン
    必要なスキルJavaScriptとkintone APIの知識ツールの操作方法の習得不要(設定画面で選ぶだけ)
    費用の目安開発者の工数・外注費ツールの月額利用料買い取りで、その後の費用なし。60日間無料で試せる
    kintone仕様変更時の保守自社で修正が必要ツール提供元が対応開発元のデジトラが対応
    向いている会社社内に開発者がいる多くのカスタマイズをまとめて作りたいこの機能を手早く、確実に使いたい(IT担当者がいない会社にも)

    導入の流れ(コード不要・3ステップ)

    1. 試用版をダウンロード:このページから無料試用版(60日間・全機能)を入手します。
    2. kintoneに読み込む:kintoneシステム管理の「プラグイン」から読み込み、使いたいアプリに追加します。
    3. 設定して保存:プラグインの設定画面で対象のフィールドなどを選び、アプリを更新すれば使えます。

    よくある質問

    kintoneの標準機能で郵便番号から住所を自動で入力することはできますか?

    kintoneの標準機能には、郵便番号から住所を自動で入力する機能はありません。 デジトラの「郵便番号・デジタルアドレス検索プラグイン」を使えば、プログラミングなしで実現できます。

    JavaScriptやプログラミングの知識は必要ですか?

    不要です。プラグインの設定画面で項目を選ぶだけで使えます。社内にIT担当者がいない会社でも導入できます。

    無料で試せますか?

    全機能を60日間無料で試せます。試用期間が終わっても自動で課金されることはありません。

    どのkintoneのプランで使えますか?

    プラグインが使える、kintoneのスタンダードコースとワイドコースで利用できます。ライトコースではプラグインを利用できません。

    外部へデータを送信していますか?

    住所の検索のため、日本郵便のAPIと通信します。買取版は、ライセンス認証のための外部通信は発生しません。

    ほかのプラグインも一緒に使いたい場合は?

    当社プラグイン・アプリテンプレートの利用権とサポートをセットにした、年額制のサポートプランがあります。Light(年額120,000円・プラグイン5個まで・ユーザー10名まで)、Standard(年額360,000円・プラグイン15個まで・ユーザー30名まで)、Business(年額720,000円・プラグイン無制限・ユーザー50名まで)の3段階です(いずれも税別)。 詳しくはサポートプランの料金体系をご覧ください。

    アプリの作成やプラグインの設定を代わりにお願いできますか?

    はい、可能です。プラグインの導入サポート(初期設定)は、各プラグインの価格に含まれています。

    アプリの作成もご希望の場合は、アプリの作成支援をご覧ください。

    開発・提供:デジトラ(株式会社アクションプラン)

    大阪市中央区のkintone導入支援会社です。kintoneプラグインを50種類以上自社開発し、社員10〜50名の中小企業の業務改善を、導入・研修・運用サポートまで支援しています。経営革新等認定支援機関/スマートSMEサポーター(経済産業省認定)。

    TEL 06-6360-4575(平日9:00〜18:00)/info@dejitora.jp

    最終更新日:

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

    おすすめ記事「AI時代の人材戦略」

    デジトラ−業務のデジタル化にトライする

    事例紹介

    ACHIEVEMENTS
    kintoneの作業日報で作業状態の「見える化」を実現
    まちライブラリーのkintone活用
    製造業の受注データ管理をエクセルから移行

    Tips

    TIPS
    kintone
    テーブル項目の色を自由に変更!新APIでアプリ画面を見やすく便利にする方法
    kintone
    kintoneで作る「AI日報アプリ」と新APIの活用術
    kintone
    kintone全体検索ボックスをポータルに置いてみた
    補助金の活用についてもご相談ください

    中小企業のデジタル化に利用できる補助金や助成金があります。
    補助金や助成金は申請できる企業や用途に要件があったり、事業計画書を作成する必要があったりします。
    必要な手続きをサポートさせていただきますので、お気軽にご相談ください。

    お気軽にご相談ください。

    オンライン可
    無料相談
    デジタル化
    診断チャート
    簡易診断

    デジタル化による
    コスト削減効果を算出