SmartHR - 年調ソフトXML形式 年末調整連携 [2026年版]

本レシピはFreeプランにて無料でご利用いただけます。アカウント登録が完了されていない場合は下記よりご登録ください。本レシピはFreeプランのレシピ実行回数制限は適用されず、実行回数無制限でご利用いただけます。
本サポートページに関して、ご質問等がございましたら下記フォームよりお問い合わせをお願いいたします。

年末調整レシピお問い合わせ

ActRecipe Freeプラン利用申込フォーム

■はじめに

ActRecipeではSmartHRを便利に活用する様々な機能をご提供しております。
主な特徴を動画にまとめておりますのでご覧ください。

■人気SmartHR連携レシピ

SmartHRと連携するレシピのうち、特に人気のあるレシピは下記の通りです。
※ 本レシピは有償プランの方のみがご利用いただけます。本レシピのに関するお問い合わせは、お問い合わせフォームよりご連絡ください。

1. SmartHR - メールアラート：SmartHRの期日情報を担当者に通知できるレシピです。
2. SmartHR - メールアラート (カスタム版)：カスタム従業員項目を含む従業員情報の期日を担当者へ通知できるレシピです。
3. SmartHR - 従業員メールアラート：カスタム従業員項目を含む従業員情報の期日を従業員本人やその上長に通知するレシピです。
4. SmartHR - 従業員督促：SmartHR上の従業員情報および各種期限情報を自動取得し、メール等で通知とタスク管理を行うレシピです。
5. SmartHR - CSVファイル出力 (統合)：従業員情報・家族情報・産休育休情報を1つのファイルで出力できるレシピです。
6. SmartHR - CSVファイル出力 (産休育休情報)：標準ではSmartHRから出力ができない産休育休情報をCSVファイルで出力できるレシピです。
7. CSVファイル - SmartHR連携 (従業員情報)：外部の人事給与ソフト等のファイルを加工不要でアップロードできるレシピです。

■レビュー投稿のお願い

ActRecipeは企業規模を問わず数多くのお客様にご利用いただいており、お客様のお声をサービス内容に反映をしております。今後の更なるサービス向上のために皆様のご意見を頂戴したく、実際に利用されたご感想等をレビューとして投稿していただけますでしょうか。

ITreview ActRecipeの評判

SmartHR Plus 利用者の声

ここからは、SmartHRの年末調整データを用いて国税庁が定める「年末調整申告書XMLデータ」を出力する方法を解説します。
レシピを使用するには事前にSmartHRの利用契約が必要になります。

注1：SmartHRから取得できる項目と国税庁が提供する「年末調整控除申告書作成用ソフトウェア」では取得できる項目に差異があります。詳細は本ページ下部にあります「【重要】SmartHRの年末調整の項目および仕様について」をご確認ください。
対応可能な給与ソフトは下部のFAQ「Q3.検証済みの給与ソフトを教えてください。」に記載しておりますのでご覧ください。

注2：ActRecipeにおいては、前職情報については取得いたしません。
下記のSmartHRのヘルプページをご参考に個別にデータ出力をお願いいたします。
【一覧】前職情報CSV凡例

0.事前準備

1. 「SmartHR - 年調ソフトXML形式 年末調整連携 [2026年版]」レシピを使用するには、事前にSmartHR Plusでのアプリの登録が必要となります。
2. 以下のSmartHR Plusにアクセスし、画面右上の「ログイン」ボタンよりSmartHRへログインします。
   https://www.smarthr.plus/apps/actrecipe
3. 続いて「連携をはじめる」ボタン(青色)を押下しますアプリのインストール確認画面にて「連携をはじめる」ボタンを押下します
4. アプリの連携が完了しますと上記「2」のボタンが「アプリを開く」に変わりますので、同ボタンを押下します。

5. 以下の確認画面が表示されますので「連携を許可」を押下します。

   (※)連携するユーザは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階層目：
  　fuyo08_[社員番号].xml
  　fuyo09_[社員番号].xml
  　hoken08_[社員番号].xml
  　haigusha08_[社員番号].xml
  　jutaku08_[社員番号].xml
  　kiso08_[社員番号].xml
  　shotoku08_[社員番号].xml
  　tokutei08_[社員番号].xml 
  　→「jutaru-fuyo08_[社員番号].xml」は出力されません。
  
  　上記xmlデータと申告書の内容は下記の [申告書の内容と申告書フォルダ名の組み合わせ] をご覧ください。
  
  【申告書ごとにフォルダを分ける】
  以下は出力ファイルを解凍した後のフォルダ構成です。
  1階層目：申告書フォルダ名 (※)
  2階層目：
  　[申告書フォルダ名]_[社員番号1].xml
  　[申告書フォルダ名]_[社員番号2].xml
  　[申告書フォルダ名]_[社員番号3].xml
  
  ※ [申告書の内容と申告書フォルダ名の組み合わせ][申告書の内容：申告書フォルダ名]
  給与所得者の扶養控除等(異動)申告書 令和7年分：fuyo08
  給与所得者の扶養控除等(異動)申告書 令和8年分：fuyo09
  給与所得者の保険料控除申告書：hoken08
  給与所得者の配偶者控除等申告書：haigusha08
  住宅借入金等特別控除申告書：jutaku08
  給与所得者の基礎控除申告書：kiso08
  所得金額調整控除申告書：shotoku08
  特定親族特別控除申告書：tokutei08
  →「従たる給与についての扶養控除等(異動) 申告書： jutaru-fuyo07フォルダ」は出力されません。
• zipパスワード (オプション)：出力されるzipファイルにパスワードを設定する場合はパスワードの文字列を入力します。値がある場合は従業員それぞれに共通のパスワードが設定され、値がブランクの場合はパスワードなしのzipファイルが生成されます。
   
• 翌年分の扶養控除等申告書の出力を除外する (オプション)：「fuyo08_[社員番号].xml」のみを出力ファイルから除外されたい場合はチェックを付けます。

次のマッピング設定は通常は不要ですのでスキップしてください。

続いてコンバート設定についてご説明します。
標準出力したXMLデータでは給与ソフト側との社員番号とSmartHR側の社員番号等が異なるため、給与ソフトへのインポート時にエラーとなってしまうことがあります。そのような場合に本コンバート設定にて出力値を変更することができます。

以下は出力値の変換例となります。

【例】出力ファイル名及び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から最新の情報を取得します。

XMLファイルのダウンロード

レシピ実行履歴>実行ログから、レシピの実行状況及び出力ファイル名、処理結果ファイル名が確認できます。

処理対象が多い場合は、レシピの実行履歴が分割されます。
個別の履歴を確認される場合は、赤枠ボタンから実行履歴を展開してください。
※この際、警告が発生することがございますが、所望のデータが出力されている場合は無視して問題ありません。
詳細についてはFAQ「Q11.以下の画像のように一部警告となる原因を教えてください」をご確認ください。

レシピの実行に成功すると「ファイル一覧」メニュー内に以下のようにzipファイルが出力されます。
ローカル環境に保存するには操作メニューよりダウンロードを選択します。

zipファイルダウンロード後にzipファイルを解凍し、解凍後のzipファイルを給与ソフト等へアップロードしてご利用ください。ファイルを解凍する場合は、OS標準の圧縮解凍機能、または、サードパーティー製の圧縮解凍ソフトをご利用ください。

レシピ実行の失敗・警告について

レシピの実行が失敗または警告となった場合は「レシピ実行履歴メニュー＞実行ログ」をご覧ください。主なエラーログと原因は以下の通りです。

【エラーログ】
ステータス：失敗
サーバー応答コード: 400 
エラー内容: SmartHR Plus上でActRecipeのアプリをインストールしてレシピを再実行してください。

【原因】
SmartHR Plus上でActRecipeアプリの連携が行われていない場合に発生します。
下記URLからActRecipeのアプリ連携をお試しください。
https://www.smarthr.plus/apps/actrecipe 

【エラーログ】
ステータス：警告
サーバーメッセージ：処理対象のデータがありません。依頼グループや詳細検索の条件を見直してください。 

【原因】
指定された条件に処理対象となる従業員情報がない場合に発生します。
依頼グループ名・フリーワード検索・詳細検索が正しく入力されているのかご確認ください。
依頼状況が、下記に示されている取得可能なステータスであるのかを確認ください。
※実行履歴が分割されている場合、本警告を無視して問題ない可能性があります。
詳細についてはFAQ「Q11.以下の画像のように一部警告となる原因を教えてください」をご確認ください。

【重要】生成ファイルについて

• 出力対象のデータ：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の年末調整データの仕様となります。出力ファイルに影響しますので内容をご確認ください。

【注意事項】SmartHRから取得可能な従業員情報の取扱いについて

•  取得できる従業員の範囲・項目は、設定時に利用したSmartHRのアカウントの権限設定を反映します。目的と用途に応じた権限のSmartHRのアカウントを使って設定を行なってください。
  詳しくは、*従業員関連の閲覧・作成・更新・削除の権限を設定する* を参照してください。
  https://support.smarthr.jp/ja/help/articles/1500001368101/

FAQ

Q1. WindowsでZIPファイルを解凍しようとすると「エラーコード0x80004005」または「展開を完了できません。展開先ファイルを作成できませんでした。」と表示されてしまいます。

A1. お使いのOSはActRecipeがZIPファイルの圧縮に用いている暗号化形式の解凍に対応しておりません。サードパーティー製の圧縮解凍ソフトをご利用ください。Windows OSの場合ですと「7-Zip」でしたら正常に解凍できることを確認できております。
https://7-zip.opensource.jp/
(サードパーティー製アプリケーションのサポートは致しかねますのでご了承ください)

Q2. レシピの実行ステータス「警告」とは何を意味していますか？

　サーバーメッセージ:出力フォルダ構成が設定されておりません
　サーバー応答コード:400

サポートについて

• サポート対応窓口・対応方法
  本レシピについては全ての利用者様のサポート対応を行っております。
  ご質問等がございましたら下記フォームよりお問い合わせをお願いいたします。
  https://support.actrecipe.com/hc/ja/requests/new
  ※ご質問やエラー調査等の通常サポートにつきましては、ご契約形態（有償・無償）を問わず「上記フォーム」での対応のみとさせていただいており、お電話や個別でのWeb会議等による対応は行っておりません。 
• サポート対応の範囲
  弊社のサポート対象は、ActRecipe内におけるレシピの設定方法や、ActRecipe実行時に発生するエラーの調査に限らせていただいております。 ActRecipeから出力されたデータを給与ソフト（他社システム）へ取り込む際に発生するエラーや設定方法につきましては、各給与ソフトの提供ベンダー様へお問い合わせいただく形となります。 
  ただし、給与ソフト側でのエラーの原因がActRecipeからの出力内容（出力データ等）に起因する場合は、エラー詳細や出力されたデータを共有いただいた上で、弊社にて調査をさせていただきます。

有償プランについて

Freeプランでは、お客様個別のご要件に合わせた対応は行っておりません。下記のような対応をご希望の場合にはお問い合わせフォームよりご連絡ください。

• XMLデータ形式ではなくCSVデータ形式で人事給与システムへ取り込みたい
• 人事給与システム等にAPIでダイレクト連携させたい
• 担当者による導入支援をして欲しい
• レシピの処理内容を変更したい　など

このレシピで連携できるSaaSについて

• SmartHR

その他のSmartHR連携ができるレシピ

• SmartHR連携レシピ