本レシピはStandardプラン以上の有償プランでご利用いただけます。ご利用をご希望の場合は下記よりお問い合わせください。
SmartHR上の従業員情報の年末調整データを自動取得してXMLデータを出力する方法を解説します。
レシピを使用するには事前にSmartHRの利用契約が必要となります。
■はじめに
ActRecipeではSmartHRを便利に活用する様々な機能をご提供しております。
主な特徴を動画にまとめておりますのでご覧ください。
■人気SmartHR連携レシピ
SmartHRと連携するレシピのうち、特に人気のあるレシピは下記の通りです。
※ 本レシピは有償プランの方のみがご利用いただけます。本レシピのに関するお問い合わせは、お問い合わせフォームよりご連絡ください。
- SmartHR - メールアラート：SmartHRの期日情報を担当者に通知できるレシピです。
- SmartHR - メールアラート (カスタム版)：カスタム従業員項目を含む従業員情報の期日を担当者へ通知できるレシピです。
- SmartHR - 従業員メールアラート：カスタム従業員項目を含む従業員情報の期日を従業員本人やその上長に通知するレシピです。
- SmartHR - 従業員督促：SmartHR上の従業員情報および各種期限情報を自動取得し、メール等で通知とタスク管理を行うレシピです。
- SmartHR - CSVファイル出力 (統合)：従業員情報・家族情報・産休育休情報を1つのファイルで出力できるレシピです。
- SmartHR - CSVファイル出力 (産休育休情報)：標準ではSmartHRから出力ができない産休育休情報をCSVファイルで出力できるレシピです。
- CSVファイル - SmartHR連携 (従業員情報)：外部の人事給与ソフト等のファイルを加工不要でアップロードできるレシピです。
■レビュー投稿のお願い
ActRecipeは企業規模を問わず数多くのお客様にご利用いただいており、お客様のお声をサービス内容に反映をしております。今後の更なるサービス向上のために皆様のご意見を頂戴したく、実際に利用されたご感想等をレビューとして投稿していただけますでしょうか。
ここからは、SmartHRの年末調整データを用いて国税庁が定める「年末調整申告書XMLデータ」を出力する方法を解説します（注１）。レシピを使用するには事前にSmartHRの利用契約が必要になります。
注１：SmartHRから取得できる項目と国税庁が提供する「年末調整控除申告書作成用ソフトウェア」では取得できる項目に差異があります。詳細は本ページ下部にあります「【重要】SmartHRの年末調整の項目および仕様について」をご確認ください。
対応可能な給与ソフトは下部のFAQ「Q3.検証済みの給与ソフトを教えてください。」に記載しておりますのでご覧ください。
0.事前準備
- 「SmartHR - 年調ソフトXML形式 年末調整連携 [2026年版](機能拡張)」レシピを使用するには、事前にSmartHR Plusでのアプリの登録が必要となります。
-
以下のSmartHR Plusにアクセスし、画面右上の「ログイン」ボタンよりSmartHRへログインします。
https://www.smarthr.plus/apps/actrecipe - 続いて「連携をはじめる」ボタン(青色)を押下しますアプリのインストール確認画面にて「連携をはじめる」ボタンを押下します
- アプリの連携が完了しますと上記「2」のボタンが「アプリを開く」に変わりますので、同ボタンを押下します。
-
以下の確認画面が表示されますので「連携を許可」を押下します。
(※)連携するユーザはSmartHRの「管理者」権限を保持している必要があります。
※
ActRecipeのアカウントを保持しておりActRecipeにログインしていない場合にはログインをしてください。
ActRecipeのアカウントが未作成の場合は「無料ではじめる」ボタンよりアカウントを作成し、通知メールに従ってください。
1.マイレシピへの登録
メニューの「シェアレシピ」から、「SmartHR - 年調ソフトXML形式 年末調整連携 [2026年版](機能拡張)」にチェックを入れ、画面下にある登録ボタンを押下します。
メニューの「マイレシピ」から、コピーしたレシピ名を押下します。
「レシピ情報」ではレシピ名とレシピ説明を任意の値に変更することができます。変更後は保存ボタンを押下します。
2.SmartHRの連携設定
タスクより「SmartHR - 年末調整書類一覧取得」を押下し、設定を展開します。
SmartHRと未接続の場合は「SmartHRへ接続する」ボタンよりSmartHRとの連携を開始します。正しく連携が行われますと「サブドメイン(自動入力)」にSmartHRのサブドメイン名が表示されます。サブドメイン名が表示される場合には追加の対応は不要です。
続いて以下の項目に設定を行い、保存ボタンを押下します。
-
依頼グループ名 (オプション)：SmartHRの依頼グループ名を入力します。取得するデータは下記の「フリーワード検索」で絞り込まれた従業員データのうち、指定した依頼グループに含まれる従業員データのみが対象となります。この項目がブランクの場合は全ての依頼グループを対象にデータが取得されます。処理対象に比例して処理時間が増大するため、フリーワード検索と依頼グループ名を組み合わせて対象データを絞り込みことを推奨いたします。
※ 半角・全角の違い、余分なスペース混入等にご注意ください -
フリーワード検索 (オプション)：SmartHRからの取得データ件数に比例して、レシピの処理時間は増大します。
そのような場合に、取得データを絞り込んでデータを取得できるオプションです。例えば、社員番号の「0001」を指定しますと「00001」および「00010〜00019」が取得対象となります。他にも氏名、ビジネスネーム、部署名、役職名、事業所でも絞り込むことができます。上記の「依頼グループ名」と組み合わせて絞り込むこともできるのですが、「依頼グループ名」だけを指定した場合は事前に全件のデータ取得が行われてしまうため、社員番号や部署名等での絞り込みをご検討ください。本項目に値がある場合には下記の「詳細検索」の設定が無効となりますのでご留意ください。 -
詳細検索 (オプション)：フリーワード検索よりも細かな条件で対象データを絞り込むことができます。条件指定は最大10件まで行うことができます。
[社員番号, ユーザーID, 従業員のID, 戸籍上の性別, 雇用形態, 在籍状況, 入社年月日-開始日, 入社年月日-終了日, 部署ID, フリーワード検索]
3.出力ファイル内容の設定
タスクより「SmartHR - 年末調整申告書生成」を押下し、設定を展開します。
このタスクでは、出力ファイルの内容を設定を行います。変更後は保存ボタンを押下します。
- 住所選択：年末調整申告書に使用する住所を「現住所」または「住民票住所」より選択します。
-
出力フォルダ構成：出力ファイルのフォルダ構成を「従業員ごとにフォルダを分ける」または「申告書ごとにフォルダを分ける」より選択します。各フォルダ構成は以下の通りです。
【従業員ごとにフォルダを分ける】
出力ファイル：年末調整{対象の手続きの年}_{テナントID}_{依頼グループ名}_{レシピ実行日時}.zip
以下は出力ファイルを解凍した後のフォルダ構成です。
1階層目：社員番号_pass.zip、または、社員番号_nopass.zip (複数ある場合は社員番号ごとにzipファイルを生成)
→パスワード設定されている場合：社員番号_pass.zip
→パスワード設定されていない場合：社員番号_nopass.zip
2階層目：[社員番号]フォルダ
3階層目：
fuyo07_[社員番号].xml
fuyo08_[社員番号].xml
hoken07_[社員番号].xml
haigusha07_[社員番号].xml
jutaku07_[社員番号].xml
kiso07_[社員番号].xml
shotoku07_[社員番号].xml
tokutei07_[社員番号].xml
→「jutaru-fuyo07_[社員番号].xml」は出力されません。
上記xmlデータと申告書の内容は下記の [申告書の内容と申告書フォルダ名の組み合わせ] をご覧ください。
【申告書ごとにフォルダを分ける】
以下は出力ファイルを解凍した後のフォルダ構成です。
1階層目：申告書フォルダ名 (※)
2階層目：
[申告書フォルダ名]_[社員番号1].xml
[申告書フォルダ名]_[社員番号2].xml
[申告書フォルダ名]_[社員番号3].xml
※ [申告書の内容と申告書フォルダ名の組み合わせ][申告書の内容：申告書フォルダ名]
給与所得者の扶養控除等(異動)申告書 令和7年分：fuyo07
給与所得者の扶養控除等(異動)申告書 令和8年分：fuyo08
給与所得者の保険料控除申告書：hoken07
給与所得者の配偶者控除等申告書：haigusha07
住宅借入金等特別控除申告書：jutaku07
給与所得者の基礎控除申告書：kiso07
所得金額調整控除申告書：shotoku07
特定親族特別控除申告書：tokutei07
→「従たる給与についての扶養控除等(異動) 申告書： jutaru-fuyo07フォルダ」は出力されません。 - zipパスワード (オプション)：出力されるzipファイルにパスワードを設定する場合はパスワードの文字列を入力します。値がブランクの場合はパスワードなしのzipファイルが生成されます。
- 翌年分の扶養控除等申告書の出力を除外する (オプション)：「fuyo08_[社員番号].xml」のみを出力ファイルから除外されたい場合はチェックを付けます。
-
続柄を変換しない (オプション)：”SmartHR年末調整>扶養家族情報>続柄”を年調ソフトXML項目に対応させず連携したい場合はチェックを付けます。
【例】SmartHR上の続柄が”実父”
・無効時：続柄コードは”4(親)”、続柄名称は”空欄”
・有効時：続柄コードは”99(その他)”、続柄名称は”実父”
対象項目は以下となっております
xml001_D00060 扶養親族との続柄コード
xml001_D00070 扶養親族との続柄名称
xml003_C00188 23歳未満の扶養親族との続柄コード
xml003_C00189 23歳未満の扶養親族との続柄名称
xml007_C00090 23歳未満の扶養親族との続柄コード
xml007_C00100 23歳未満の扶養親族との続柄名称
xml007_C00290 特別障害者である同一生計配偶者／扶養親族との続柄コード
xml007_C00300 特別障害者である同一生計配偶者／扶養親族との続柄名称
xml008_C00060 特定親族との続柄コード
xml008_C00070 特定親族との続柄名称
SmartHR年末調整項目と年調ソフトXML項目の対応表 - 2026年版.pdf
次のマッピング設定は通常は不要ですのでスキップしてください。
続いて「入力設定」についてご説明します。
以下のようなケースにおいて、標準出力したXMLデータでは給与ソフトへのインポートでエラーとなってしまうことがあります。そのような場合に本マッピングで出力値を変更することができます。
以下は出力値の変換例となります。
【例】出力ファイル名及びXMLデータ内の社員番号をSmartHRのカスタム従業員項目上の値に変換したい場合
(fuyo07_AA29487.xml → fuyo07_AA0001.xml)
- 項目名：社員番号
- 型：文字列
- 桁数：（ブランク）
- 出力区分：参照
-
出力指定：#(検証項目.項目A) ※ #([カスタム項目グループ名].[カスタム項目名])
【例】ファイル名を”AA＋社員番号”の形で出力する場合
(fuyo07_0001.xml → fuyo07_AA0001.xml)
- 項目名：社員番号
- 型：文字列
- 桁数：（ブランク）
- 出力区分：計算式
- 出力指定：AA&#(社員番号)
【例】XMLファイル内項目の値を変換する場合
本年中の所得の見積額”580000”を”58万”に変換
(580000 → 58万)
- 項目名：xml001_D00160
- 型：文字列
- 桁数：（ブランク）
- 出力区分：計算式
- 出力指定：TEXT(#(xml001_D00160)/10000,"0.0")&"万"
【例】「個人番号提供済み」を常に「1:提出済み」とする場合
- 項目名：xml001_D00031
- 型：文字列
- 桁数：（ブランク）
- 出力区分：固定値
- 出力指定：1
【例】現在の”Ver.6.0.0”を”Ver.6.0.1”に変更する場合
- 項目名：ver
- 型：文字列
- 桁数：（ブランク）
- 出力区分：固定値
- 出力指定：6.0.1
上記における「xml001_D00160」「xml001_D00031」は出力されるXMLデータのタグの名称となります。項目名とタグの紐づけは以下のファイルをご覧ください。
SmartHR年末調整項目と年調ソフトXML項目の対応表 - 2026年版.pdf
計算式には以下の関数をご利用いただけます。
下記のような出力値の変更をご希望の場合はサポートまでお問い合わせください。
- SmartHRでは取得していない項目への値を追加したい場合 他
レシピを実行する (自動実行はこちら)
レシピ編集画面の上部から「レシピ実行」ボタンを押下、または、マイレシピに戻り「操作」メニューから「実行」を押下します。 レシピの実行は何度でも行うことができ、その度にSmartHRから最新の情報を取得します。
レシピ実行履歴>実行ログから、レシピの実行状況及び出力ファイル名が確認できます。
処理対象が多い場合は、レシピの実行履歴が分割されます。
個別の履歴を確認される場合は、赤枠ボタンから実行履歴を展開してください。
※この際、警告が発生することがございますが、所望のデータが出力されている場合は無視して問題ありません。
詳細についてはFAQ「Q11.以下の画像のように一部警告となる原因を教えてください」をご確認ください。
レシピの実行に成功すると「ファイル一覧」メニュー内に以下のようにzipファイルが出力されます。
ローカル環境に保存するには操作メニューよりダウンロードを選択します。
zipファイルダウンロード後にzipファイルを解凍し、解凍後のzipファイルを給与ソフト等へアップロードしてご利用ください。ファイルを解凍する場合は、OS標準の圧縮解凍機能、または、サードパーティー製の圧縮解凍ソフトをご利用ください。
レシピ実行の失敗・警告について
レシピの実行が失敗または警告となった場合は「レシピ実行履歴メニュー＞実行ログ」をご覧ください。主なエラーログと原因は以下の通りです。
【エラーログ】
ステータス：失敗
サーバー応答コード: 400
エラー内容: SmartHR Plus上でActRecipeのアプリをインストールしてレシピを再実行してください。
【原因】
SmartHR Plus上でActRecipeアプリの連携が行われていない場合に発生します。
下記URLからActRecipeのアプリ連携をお試しください。
https://www.smarthr.plus/apps/actrecipe 【エラーログ】
ステータス：警告
サーバーメッセージ：処理対象のデータがありません。依頼グループや詳細検索の条件を見直してください。
【原因】
指定された条件に処理対象となる従業員情報がない場合に発生します。
依頼グループ名・フリーワード検索・詳細検索が正しく入力されているのかご確認ください。
依頼状況が、下記に示されている取得可能なステータスであるのかを確認ください。【重要】生成ファイルについて
- 出力対象のデータ：SmartHRから取得される年末調整データは、依頼状況が「回答済み～確定」の全てのデータとなり、「確定」のものだけを対象にする等の特定のステータスに限定した取得することができません。そのため、対象となる方の年末調整の作成や修正がすべて確定してからレシピを実行をお願いします。本レシピは重複取得の制御を行っておりませんので、同一のデータであっても再取得が可能です。
-
生成ファイルの形式：生成されたファイルはデフォルトではパスワードなしのzip形式で出力されます。zipファイルには「1. 各xmlデータを含むzipファイル」と「2. 処理結果をまとめたzipファイル」の2ファイルが出力されます。このうち「1. 各xmlデータを含むzipファイル」は依頼グループ単位で出力され、「2. 処理結果をまとめたzipファイル」は1つのzipファイル内に依頼グループ単位の処理結果のcsvファイルが含まれます。ファイル名フォーマットは以下の通りです。
- 1. 各xmlデータを含むzipファイル：年末調整{対象の手続きの年}_{テナントID}_{依頼グループ名}_{レシピ実行日時}.zip
-
2. 処理結果をまとめたzipファイル：処理結果_{レシピ実行日時}.zip
人事給与システムへのXMLデータのアップロードの仕様については、各システムベンダーへお問い合わせください。
- zipファイルのパスワード：「出力フォルダ構成」より【従業員ごとにフォルダを分ける】を選択しますと、社員番号ごとにzipファイルが生成されます。この時に、パスワードを設定していますと出力される「年末調整{対象の手続きの年}_{テナントID}_{依頼グループ名}_{レシピ実行日時}.zip」と、「社員番号_pass.zip」に同一のパスワードが設定されます。また「出力フォルダ構成」の種類に関係なく、「処理結果_{レシピ実行日時}.zip」にも同一のパスワードが設定されます。
【重要】SmartHRの年末調整の項目および仕様について
以下はSmartHRの年末調整項目とXMLの対応表となりますので内容をご確認ください。
SmartHR年末調整項目と年調ソフトXML項目の対応表 - 2026年版.pdf
また、下記は国税庁が公開しておりますXMLの定義書のページとなりますので適宜ご覧ください。
控除申告書データに係る仕様公開｜国税庁
以下はSmartHRの年末調整データの仕様となります。出力ファイルに影響しますので内容をご確認ください。
| 1 | 情報連携の前提 | SmartHR年末調整（以下SmartHR）で、書類が存在しない場合は、その書類に紐づく情報は連携しない |
| 2 | 情報連携の前提 |
SmartHRで、従業員の依頼ステータスが以下の場合は、その従業員の情報は連携しない ・依頼ステータスが回答期限切れ ・依頼ステータスが対象外（候補も含む） ・前職情報に「源泉徴収票：入手不可」が存在する |
| 3 | 情報連携の前提 | SmartHRの依頼ステータスが「未依頼」または「入力中」の場合でも、書類が存在する場合はその書類に紐づく情報を連携する |
| 4 | 情報連携の前提 | SmartHRで提供していない書類の情報は連携しない（従たる給与についての扶養控除等（異動）申告書） |
【注意事項】SmartHRから取得可能な従業員情報の取扱いについて
-
取得できる従業員の範囲・項目は、設定時に利用したSmartHRのアカウントの権限設定を反映します。目的と用途に応じた権限のSmartHRのアカウントを使って設定を行なってください。
詳しくは、*従業員関連の閲覧・作成・更新・削除の権限を設定する* を参照してください。
https://support.smarthr.jp/ja/help/articles/1500001368101/
FAQ
Q1. WindowsでZIPファイルを解凍しようとすると「
A1. お使いのOSはActRecipeがZIPファイルの圧縮に用いている暗号化形式の解凍に対応しておりません。サードパーティー製の圧縮解凍ソフトをご利用ください。Windows OSの場合ですと「7-Zip」でしたら正常に解凍できることを確認できております。
https://7-zip.opensource.jp/
(サードパーティー製アプリケーションのサポートは致しかねますのでご了承ください)
Q2. レシピの実行ステータス「警告」とは何を意味していますか？
A2. レシピの実行は成功したものの、一部の従業員データが取得できない場合にはステータスが「警告」となります。出力ファイルをご確認いただき、XMLデータが欠落している従業員を特定後にSmartHR上での年末調整処理をご対応ください。
Q4.レシピ実行時に以下のようなエラーが表示されます。
サーバーメッセージ:出力フォルダ構成が設定されておりません
サーバー応答コード:400A4.レシピの設定項目のうち「SmartHR - 年末調整申告書生成」タスクが未設定のために生じております。同タスクを設定後にレシピの実行をお試しください。
Q5.ActRecipeから出力したZIPファイルを国税庁が提供する年調ソフトへ取り込む方法を教えてください。
A5.国税庁が提供する下記のマニュアルのP38以降をご覧ください。取り込めるファイル形式は「[社員番号]_pass.zip」または「[社員番号]_nopass.zip」となりますので、ActRecipeからダウンロードしたZIPファイルは一度解凍をお願いします。
年調ソフトの操作マニュアル
Q6.ActRecipeから出力したXMLデータでは「○○」の値がブランクになってしまいます。
A6.SmartHRの仕様によって出力対象外となっている項目については出力ができません。上記「Q5」の内容をご参考に国税庁の年調ソフトでの補完をお願いいたします。出力項目一覧は下記ドキュメントをご覧ください。
SmartHR年末調整項目と年調ソフトXML項目の対応表 - 2026年版.pdf
Q7.ActRecipeからの出力データに前職情報は含まれますか？
A7.出力されるXMLデータには前職情報は含まれません。下記のSmartHRのヘルプページをご参考に個別にデータ出力をお願いいたします。
【一覧】前職情報CSV凡例
Q8.レシピの実行ステータスが警告となってファイル一覧にzipファイルが出力されません。
A8.指定された「依頼グループ」または「詳細検索」の内容に該当する対象データがない場合はレシピの実行ステータスが警告となります。依頼グループや検索条件をリセットしてレシピを再実行するか、SmartHR上に該当の年末調整データがあるかをご確認ください。
Q9.給与ソフトへの取込方法を教えてください
A8.ActRecipeでは、給与計算ソフトウェアの操作方法に関するサポートは提供しておりません。ActRecipeが出力するXMLデータは、国税庁提供の「年末調整控除申告書作成用ソフトウェア」が出力する形式と同一です。つきましては、お使いの給与計算ソフトウェアのベンダー様に、国税庁の「年末調整控除申告書作成用ソフトウェア」から出力されたXMLデータをどのように取り込むかをご確認ください。その後、ActRecipeが出力したXMLデータにつきましても、同じ手順で給与計算ソフトウェアへ取り込んでいただきますようお願いいたします。
Q10.”処理結果_・・”、”年末調整2026_・・”のどちらを給与ソフトに取込めるのかを教えてください
A10.”年末調整2026_・・”のファイルをご利用ください。
Q11.以下の画像のように一部警告となる原因を教えてください。
A11.レシピの実行履歴が分割された際（依頼グループ数または処理対象従業員が多い場合など）に、一部の処理にて依頼グループ内に処理する申告書等が存在しなかったことを示すものです。所望の従業員が出力されている場合、この警告は無視していただいて問題ありません。
有償プランについて
このレシピはActRecipeの有償プランでご利用いただけます。料金プランは下記をご覧ください。