1. ホーム
2. 税の情報・手続・用紙
3. 申告手続・用紙
4. マイナポータルを活用した年末調整及び所得税確定申告の簡便化
5. マイナポータルを活用した年末調整及び所得税確定申告のよくある質問（TOP）
6. 会計ソフト等開発者向けよくある質問
7. マイナポータル等連携プラットフォームAPIについて（ソフトウェア開発者の方へ）

おしらせ

令和6年11月12日	利用ガイドラインを更新しました。
令和6年11月12日	公開鍵及び連動テストのデータパターンを追加掲載しました。
令和6年10月25日	XML定義書の補足（TEG912タグ名一部）を修正しました。
令和6年10月1日	XML定義書の補足及び帳票設計書を更新しました。
令和6年9月19日	XML定義書の補足【ドラフト版】（２文字脱字修正）を掲載しました。
令和6年9月19日	連動テストのデータパターン一覧（令和6年9月以降版）を更新しました。
令和6年9月19日	住宅借入金等特別控除証明書サンプルデータ（TEG912）を更新しました。
令和6年8月15日	マイナポータル等連携プラットフォームＡＰＩの利用ガイドラインを更新しました。
令和6年8月15日	マイナポ―タル等連携プラットフォームＡＰＩの外部インターフェース仕様書について、９月に更新予定です。現時点では、ドラフト版を準備しておりますので、必要に応じて「仕様公開申請入力フォーム」からご申請のうえ、変更内容をご確認ください。
令和6年7月25日	住宅借入金等特別控除証明書サンプルデータを掲載しました。
令和6年5月27日	社会保険料控除証明書データ（TEG840）等を掲載しました。
令和6年5月1日	利用ガイドラインを更新しました。
令和6年5月1日	連動テスト実施要領を更新しました。連動テストの申込み方法等が変更となりましたので、今後、連動テストを申し込まれる方は、利用ガイドラインにある問合せ先まで、最新版の提供をご要望ください。

マイナポータル等連携プラットフォームAPIの仕様公開及び公開鍵の提供について

 マイナポータル等連携プラットフォームとは、年末調整や確定申告の手続に利用できる控除証明書等データを、マイナポータルからマイナポータルAPI※を利用して取得するための国税庁が提供するプラットフォームです。
 本ページには、マイナポータル等連携プラットフォームとAPI連携するための、利用ガイドラインや仕様書の公開申請等の手続を掲載しています。

※　マイナポータルAPIは、デジタル庁が提供するものです。

1　マイナポータル等連携プラットフォームAPIの利用ガイドライン及び利用規約

 マイナポータル等連携プラットフォームAPIのご利用にあたり、ガイドライン及び規約を定めておりますので、仕様書の公開申請に先立ちご確認ください。
 公開内容は、今後の検討（法制面を含みます。）や技術動向などにより、変更する場合がありますので、最新の内容をご確認いただきますようお願いいたします。

• 利用ガイドライン（PDF/821KB）
• 利用規約（PDF/199KB）

2　仕様書の公開申請等に係る手続き

（１） 公開の目的
 マイナポータル等連携プラットフォームAPIの外部インターフェース仕様を、年末調整及び確定申告に関するサービスを提供しているソフトウェア開発業者向けに公開することで、当該ソフトウェア開発業者とマイナポータル等との情報連携を容易にすることを目的としています。

（２） 仕様公開に係る留意事項

1. イ　仕様内容の変更
   　公開内容は、今後の検討（法制面を含みます。）や技術動向などにより、変更する場合がありますので、最新の内容をご確認いただきますようお願いいたします。
2. ロ　著作権
   　仕様書の内容は著作権の対象となっており、著作権は日本国著作権法及び国際条約により保護されています。ただし、これらは雇用者等のシステム開発部署や民間のソフトウェア開発業者がこの仕様に基づいたソフトウェアを開発し、市場に供給することを妨げるものではありません。
3. ハ　免責事項
   　マイナポータル等連携プラットフォームの利用に当たり、システム利用者本人又は第三者が被った損害について、国税庁の故意又は重過失によるものである場合を除き、国税庁は責任を負わないものとします。

（３） 仕様書の公開申請及び各種届出

 仕様書の公開申請及びユニークIDに関する届出については、次の入力フォームから手続きを行ってください。

1. 仕様公開申請入力フォーム
2. 利用者情報変更届出入力フォーム
3. ユニークID利用停止届出入力フォーム

3　公開鍵の提供

　マイナポータル等連携プラットフォームでは、２年おきに公開鍵の更新を行いますが、ソフトウェア開発業者等が提供しているアプリへの新たな公開鍵の取込期間を考慮して、１年おきに新たな公開鍵を国税庁ホームページで提供します。
詳しくは、マイナポータル等連携プラットフォーム利用規約をご確認ください。

　なお、公開鍵の取込みが行われていないソフトウェアや、有効期限の切れた公開鍵を取り込んだソフトウェアについては、マイナポータル等連携プラットフォームAPIを利用することはできませんのでご留意ください。

4　連動テストで取得できる控除証明書等のデータパターン

　連動テストで取得可能な控除証明書等のデータパターンを、以下のとおり公開いたします。

• データパターン（令和６年９月〜12月用）（ZIP/35KB）
• データパターン（令和７年１月以降用）（ZIP/37KB）

5　社会保険料控除証明書データ（TEG840）の仕様について

　社会保険料控除証明書データ（ＴＥＧ８４０）について、以下のとおり説明資料及びサンプルデータを公開いたします。

• 資料１_TEG840_XML構造設計書に関する説明（Excel/22KB）
• 資料２_TEG840のサンプルデータに関する補足資料（Excel/33KB）
• TEG840のサンプルデータ（ZIP/18KB）

６　年末調整のための（特定増改築等）住宅借入金等特別控除証明書データの仕様について

　次の住宅借入金等特別控除証明書データについて、以下のとおりサンプルデータを公開いたします。

• 年末調整のための（特定増改築等）住宅借入金等特別控除証明書（ＴＥＧ９１０）
• 年末調整のための住宅借入金等特別控除証明書（令和4年以降居住開始用）（ＴＥＧ９１１）
• 年末調整のための住宅借入金等特別控除証明書（令和5年以降居住開始用）（ＴＥＧ９１２）
• サンプルデータ（ZIP/22KB）