/freee-api-skill

tax_return API v3 帳票項目マッピング

freee申告（法人税）の帳票取得 API が返す XML と、紙の帳票の項目名との対応表。 各ファイルの xpath 列はレスポンス XML に対してそのまま評価できる。 単独の帳票は {sheet_code}.md、別表の系列（別表一・四・五・十一・十六）・内訳書・税務代理権限証書は 1 ファイルに複数の帳票をまとめている（帳票ごとに ## 見出しで区切られ、直下に sheet_code と 様式ID がある）。

使い方: 調べたい帳票の sheet_code または帳票名で下表を引き、該当ファイルだけを開く。 複数の帳票をまとめたファイルでは、sheet_code でファイル内を検索して該当帳票の位置を探す。 XTX/XBRL のタグ名から項目の意味を調べる場合も、タグ名でファイル内を検索すれば項目名に辿り着ける。

出典と注意事項

• freee の帳票定義（電子申告タグ定義・帳票項目定義）と、e-Tax / eLTAX が配布する様式仕様書をもとに、機械的に生成している
• 対象の様式バージョン: 202512 / 202604
• 各表は様式のテンプレートであり、実際のレスポンスには値が未入力の項目が現れないことがある。ページ番号は代表値として 1 ページ目を表示している

帳票一覧

帳票 56 件。

xpath 表記の規則: 国税 (e-Tax) / 地方税 (eLTAX) の XTX

各帳票ファイルの「項目マッピング」表の xpath 列は、帳票 API が返す XTX(XML) に対してそのまま評価できる形式。

• 単純タグ: //様式ID[@page='1']/タグ（page は 1 始まり。マッピングはテンプレートのため代表値 1 を表示）
• グループ要素: 様式の入れ子をそのまま辿る //様式ID[@page='1']/グループ/タグ（国税は BGA00000 等のグループ要素が挟まる。地方税はフラット）
• サブキー（日付・区分等）: 親要素の子ノード //様式ID[@page='1']/…/親タグ/gen:サブキー。kubun_CD / kubun_NM のみ国税では接頭辞なし。表では項目名を空にして xpath 列の頭に └ を付ける
• 繰り返しグループ: 配列要素を [n] で表記 //様式ID[@page='1']/…/ラッパー[n]/子タグ。表では項目名を 【繰り返しグループ】 とし、その配下の項目は └ を付ける
• 「区分値 / envelope」列が envelope.KEY の項目は、様式部の要素が空で値は envelope 側にある。直下の └ 行に envelope の xpath //IT/KEY を示す
• 「型」列が API出力対象外 の項目は、紙の様式には存在するがレスポンスには出力されない
• 値が未入力の項目は要素ごとレスポンスに現れないことがある
• 名前空間: 国税は既定 http://xml.e-tax.nta.go.jp/XSD/hojin / gen=http://xml.e-tax.nta.go.jp/XSD/general、地方税は様式要素が既定 http://eltax.jp/HOJIN_DOFUKEN / gen=http://eltax.jp/general。xpath 評価時は既定名前空間の束縛が必要

xpath 表記の規則: 決算書 (XBRL)

決算書は国税/地方税と異なり XBRL タクソノミで、レスポンスは XBRL インスタンスの XML。

• 勘定科目（値ノード）: /XBRL2_1/XBRL2_1_INSTANCE[@page='1']/xbrli:xbrl/{prefix}:{要素名}[@contextRef='…']
• 要素名は名前空間接頭辞付きの QName（例: jpfr-t-cte:CashAndDeposits）。定義上の xbrl_id は jpfr-t-cte_CashAndDeposits のように _ 区切りだが、XML 上は : 区切りになる
• contextRef は期間区分で決まる。期間値=CurrentYearNonConsolidatedDuration、時点値=CurrentYearNonConsolidatedInstant。ただし S/S の「当期首残高」と注記表の「前期末…」は前期時点 Prior1YearNonConsolidatedInstant
• 「（タプル）」は子ファクトを内包する入れ物要素。自身は値も contextRef も持たず、繰り返し出現しうるため [n] で表記し、配下のファクトはその子になる
• 抽象要素（見出し・区分行）は XBRL ファクトを持たないため xpath なし。子を持つ科目でも抽象要素でなければ自身の金額ファクトを出力する（例: 現金及び預金）
• 値が未入力の科目は要素ごとレスポンスに現れない
• タプルは定義上は多段に入れ子になっているが、インスタンス上の入れ子は 1 段のみ（例: ItemsTransactions は BreakdownRelatedPartyTransactions の子ではなく xbrli:xbrl 直下に出力される）
• contextRef='DocumentInfo' のファクト（EntityName / ExtendedLinkRole… / …DocInfo 等）は帳票項目ではなく、XBRL インスタンスの書類メタ情報。各帳票の表には含めない
• 名前空間: xbrli=http://www.xbrl.org/2003/instance。jpfr-t-cte / jpfr-etax-t-cte 等はインスタンス冒頭の宣言を参照。xpath 評価時は接頭辞の束縛が必要

xpath 表記の規則: 電子申告未対応帳票

電子申告（XTX）に対応していない帳票は、様式仕様書ではなく freee 内部の項目定義がそのまま要素名になる。

• 項目: /data/{ルートキー}/{項目キー}。XTX タグ名ではなく意味のある英語キーが要素名になる
• 日付など複数の値を持つ項目は {項目キー}_{サブキー} の要素に分かれる（例: submission_date_year）
• 値が nil の項目は <要素 nil="true"/> の空要素として出力される
• 名前空間は使用しない

共通ヘッダ: 国税 (e-Tax) の envelope / IT セクション

納税者・代表者・税理士・事業年度など、国税(e-Tax)の全帳票のレスポンスに共通で出力される部分。 各帳票の様式部にある IDREF 項目（「区分値 / envelope」列が envelope.XXX の行）は、ここの同名要素を参照する。 手続き要素 (RHO0012 等) は帳票により変わるため //IT を起点に表記する。 値が未設定の項目は要素ごと出力されないことがある（例: ゆうちょ銀行の項目は銀行口座指定時には出力されない）。

共通ヘッダ: 地方税 (eLTAX) の構成管理情報 / KOUSEI_KANRI_INF

納税者・代表者・税理士・事業年度など、地方税(eLTAX)の全帳票のレスポンスに共通で出力される部分。 国税の //IT にあたるもので、様式部（//{様式ID}[@page='1'] 配下）の外にある。 提出様式の数だけ FORM_ATTR が繰り返される点に注意。 固定資産税・個人住民税(特別徴収)専用の分岐（KOTEI / KOJIN_TOKUCYO）は法人税目では出力されないため省略している。

決算書 (XBRL) のカスタム項目（独自勘定科目）

画面で追加したカスタム項目は XBRL タクソノミに存在しない科目のため、各帳票の勘定科目マッピング表には現れない。 レスポンスには独自名前空間の要素として、以下の 4 箇所に分かれて出力される。

• 名前空間: c-tax-{取得日}（http://xbrlsoft.e-tax.nta.go.jp/XSD/c-tax-YYYY-MM-DD）。API を呼び出した日の日付が入るため、同じ申告でも取得日が変わると接頭辞が変わる
• 要素名: {親科目の xbrl_id}_{階層}_{表示順}_{連番}（フロントで自動採番。科目名は含まれない）
• (1) インスタンス（金額）: /XBRL2_1/XBRL2_1_INSTANCE[@page='1']/xbrli:xbrl/c-tax-{取得日}:{要素名}[@contextRef='…']。型は常に monetaryItemType（unitRef="JPY" / decimals="0"）、contextRef は親科目の期間区分を継承する
• (2) タクソノミ: xsd:element で要素を宣言（xbrli:periodType は親から継承、xbrli:balance は画面で選んだ借方/貸方がそのまま入る。親科目の貸借とは独立）
• (3) presentation linkbase: link:presentationArc（parent-child）で親科目 → カスタム項目を関連付け。order 属性が表示順
• (4) label linkbase: カスタム項目が 1 件でもある場合にのみ追加されるセクション（<XBRL2_1_LINKBASE id="c-tax-{取得日}-label.xml">）。科目名はインスタンスには出力されず、ここの link:label にのみ存在するため、名称を得るには label linkbase を引く必要がある

出力例（貸借対照表の「預金」配下にカスタム項目「隠し口座」100,000 円を追加した場合）:

<!-- (1) インスタンス -->
<c-tax-2026-07-31:jpfr-etax-t-cte_Deposits_1_5_150001 decimals="0" unitRef="JPY"
    contextRef="CurrentYearNonConsolidatedInstant">100000</c-tax-2026-07-31:jpfr-etax-t-cte_Deposits_1_5_150001>

<!-- (2) タクソノミ -->
<xsd:element id="c-tax-2026-07-31_jpfr-etax-t-cte_Deposits_1_5_150001"
    name="jpfr-etax-t-cte_Deposits_1_5_150001" type="xbrli:monetaryItemType"
    substitutionGroup="xbrli:item" nillable="true" xbrli:periodType="instant" xbrli:balance="credit"/>

<!-- (3) presentation linkbase -->
<link:presentationArc xlink:arcrole="http://www.xbrl.org/2003/arcrole/parent-child"
    xlink:from="jpfr-etax-t-cte_Deposits" xlink:to="c-tax-2026-07-31_jpfr-etax-t-cte_Deposits_1_5_150001"
    order="15.0001"/>

<!-- (4) label linkbase（科目名はここにだけ現れる） -->
<link:label xlink:role="http://www.xbrl.org/2003/role/label" xml:lang="ja"
    xlink:label="label_c-tax-2026-07-31_jpfr-etax-t-cte_Deposits_1_5_150001">隠し口座</link:label>