kintoneアプリに世界の祝日を自動登録するプラグイン

holiday APIから世界の祝日データを取得し、kintoneアプリに自動登録するプラグインです。

このプラグインで解決できる課題

「また祝日の手入力作業の時期が来た……」を卒業する

　kintoneで勤怠管理・スケジュール管理・営業日計算などを運用していると、毎年必ず発生する作業があります。それが祝日データの登録作業です。

　年末になると担当者は翌年の祝日一覧を内閣府サイトで調べ、kintoneに一件ずつ手入力——こんな光景に心当たりはないでしょうか。この作業には、いくつかの深刻な問題が潜んでいます。

　祝日自動登録プラグインを導入すれば、これらの課題をすべて解消できます。年度を入力してボタンをクリックするだけで、正確な祝日データが自動的にkintoneアプリへ自動登録されます。

主な機能と特徴

GET https://date.nager.at/api/v3/PublicHolidays/{year}/{countryCode}

本プラグインは、kintoneの祝日カレンダーの手作業登録ミスで受注アプリの動作（納期予定から仕入発注日を逆算する機能）に異常が発生したので「祝日登録を自動で一括登録したい」ニーズに基づいて開発しました。

デモ画面動画

下記のデモ画面では、プラグイン設定画面で選択したレコード一覧表のヘッダー部分にに表示される「年度（西暦）」に”2026″と入力して「祝日登録」のボタンをクリックすると、その年の祝日を取得してレコードを自動作成します。

登録された祝日データは、カレンダービューに表示することも可能です。

🛠️ プラグインの設定方法

kintoneアプリの準備

まず、祝日データを登録するkintoneアプリに以下のフィールドを作成してください。

⚠️ 重要：「祝日キー」フィールドの「値の重複を禁止する」は必須設定です。UPSERTの更新キーして使用するため、この設定がないとエラーが発生します。

さらに、プラグインで「祝日の登録」ボタンを表示・実行させたい一覧表を1つ作成してください。

プラグイン設定画面での操作

アプリのプラグイン設定画面を開くと、下記の設定項目が表示されます。

Step 1：取得設定

Step 2：フィールドコード設定

各フィールドはドロップダウンに「ラベル名（フィールドコード）」形式で表示されますので、フィールドコードを覚えていなくても設定できます。

主な活用例のご紹介

祝日データがkintoneに蓄積されると、さまざまな業務アプリの「日付処理の精度」が一気に向上します。
以下の活用事例を参考にしてください。

活用事例①：勤怠管理アプリ ── 休日・残業の自動判定

　勤怠アプリで「この日は祝日だから出勤すると休日出勤扱いにする」処理をするには、システムが祝日を知っている必要があります。本プラグインで祝日データを蓄積しておくと、勤怠アプリが登録済みの祝日を参照して「休日出勤か否かの判定」「割増賃金の自動計算」「年間カレンダーの自動生成」を正確に動かし続けられます。毎年の更新もボタン1つで完了するため、担当者交代時の引き継ぎ漏れも防げます。

活用事例②：プロジェクト管理アプリ ── 営業日ベースの納期計算

　「受注から5営業日後を納期にしたい」「祝日が挟まる場合は自動的に翌営業日に繰り越してほしい」という要件は、プロジェクト管理や受発注管理で頻出します。kintoneの祝日データを参照することで、土日・祝日・振替休日・国民の休日すべてを除外した正確な営業日計算が実現し、締切の見落としや「実は祝日だった」というミスを未然に防げます。

　とくに本プラグインは振替休日と国民の休日まで登録するため、「5月3日〜6日の連休」のような複合的な連休も正確に処理できます。

活用事例③：業務カレンダーのビジュアル表示

　kintoneのカレンダービューと組み合わせると、祝日レコードをカレンダー上に視覚的に表示できます。「祝日名（日本語）」フィールドをカレンダーのタイトルフィールドに設定すれば、どの日が何の祝日かが一目でわかる業務カレンダーが完成します。

さらに「祝日判定理由」フィールドを活用すれば、「振替休日のみ色分け表示する」「国民の休日をハイライトする」といった条件付き表示も実現できます。

活用事例④：顧客対応・問い合わせ管理 ── SLA期限の自動計算

「お問い合わせから3営業日以内に回答する」というSLA（サービスレベル合意）を管理しているカスタマーサポートチームでは、祝日を考慮した対応期限の計算が不可欠です。本プラグインで蓄積した祝日データを参照することで、問い合わせ登録日を起点に正確な「回答期限日」を自動計算してフィールドにセットできます。対応漏れやSLA違反のリスクを減らし、顧客満足度の向上につなげられます。

活用事例⑤：お知らせ・リマインダー ── 祝日前日の自動通知

　kintoneの自動化機能（またはkintone連携ツール）と組み合わせることで、「祝日の前営業日に自動でお知らせメール・チャット通知を送る」しくみが作れます。「翌日が祝日なので締切に注意してください」「明日は祝日のため窓口対応はできません」といった通知を手動で送っている担当者の負担を大幅に削減できます。

　本プラグインが振替休日・国民の休日まで登録しているため、通知の自動化も連休の初日前日まで正確に対応できます。

活用事例⑥：給与・経費精算 ── 締め日・支払日の自動補正

　「毎月25日が給与支払日だが、祝日の場合は前営業日に繰り上げる」「月末締めの経費精算が祝日と重なった場合の処理」といったルールは、手動管理では見落としが起こりがちです。祝日データを連携することで「支払日が祝日 → 直前の営業日を自動計算してセット」という処理が実現し、経理担当者が毎月カレンダーを確認して手動で日付を変更する作業がなくなります。

活用事例⑦：休日判定プラグインとの組み合わせ

　本プラグインで構築した祝日アプリは、「休日判定＆営業日計算プラグイン」（別途提供）と組み合わせることで真価を発揮します。祝日アプリを「マスタ」として参照することで、任意の日付に対して「翌営業日」「前営業日」「N営業日後」を自動計算するフィールドを別アプリに組み込めます。

　自社独自の特別休日（創立記念日・年末年始の独自日程など）を祝日アプリに追加登録しておけば、会社固有の営業日カレンダーとして機能します。勤怠・受発注・顧客管理・工程管理など、日付を扱うすべてのアプリに対して「1つの祝日マスタを共有する」設計が実現します。

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

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

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

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

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

リリースノート

【名称】kintoneアプリに世界の祝日を自動登録するプラグイン

【概要】holiday APIから世界の祝日データを取得し、kintoneアプリに自動登録するプラグインです。

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

参考記事（Javascriptカスタマイズ事例）

以下の記事は、本プラグインの機能を活用した事例の紹介記事です。
本プラグインの色々な活用事例も紹介していますので、ご参考にしてください。

kintoneで「祝日」の管理─ Holiday APIで年間の祝日データを自動取得しよう

「kintoneアプリに祝日を登録しておきたいけど、毎年手作業で入力するのが大変……」そんな悩みを持つ方に、ぜひ知っていただきたいのがHoliday API（Nager.Date）です。ユーザー登録不要、完全無料で、世界中の祝日データを自動取得できるこのAPIを活用すれば、祝日管理の手間を大幅に削減できます。本記事は、技術的な話は省略して「Holiday APIを使うと何がうれしいのか」「どんな業務に活用できるのか」を、kintone初心者の方にもわかりやすく説明します。1….

dejitora.jp

2026.06.03

#kintone #plugin #API連携 #祝日の取得