/freee-api-skill

freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告・サイン（電子契約）の詳細APIリファレンスと使い方ガイドを提供。freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・SaaSアカウント管理・備品管理・固定資産管理・業務委託先の企業ユーザー/部門管理・サーベイ企画/実施回の取得・開業申請用データの参照/更新・人事評価結果の取得・法人税申告データや帳票の参照・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、IT管理、固定資産管理、業務委託管理、サーベイ、開業、人事評価、申告、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。

184 files
2 MB
Apache-2
Updated 3 weeks ago
GitHub
1 warning

Ask your Agent

Use this Skill: https://skilld.dev/gh/freee/freee-mcp/freee-api-skill

This session only. Nothing lands on disk.

tax-return-referencesbeppyo-11.md

15.9 KB raw

≈4.1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

別表十一

複数の帳票を 1 ファイルにまとめている。帳票ごとに ## 見出しで区切られ、見出しの直下に sheet_code と 様式ID がある。目的の帳票は sheet_code で検索する。共通仕様（xpath 表記の規則・名前空間・共通ヘッダ）は index.md を参照。

収録帳票

sheet_code	様式ID	帳票名
`11100100`	`HOC110`	別表十一（一）個別評価金銭債権に係る貸倒引当金の損金算入に関する明細書
`11100120`	`HOC112`	別表十一（一の二）一括評価金銭債権に係る貸倒引当金の損金算入に関する明細書

別表十一（一）個別評価金銭債権に係る貸倒引当金の損金算入に関する明細書

sheet_code: 11100100
様式ID: HOC110
電子申告: e-Tax（国税）
取得API: GET /hub/tax_return/corporate/sheet/national/{tax_return_id}/11100100
レスポンス: XTX(XML)
xpath ルート: //HOC110[@page='1']
共通仕様（xpath 表記の規則・名前空間・共通ヘッダ）は index.md を参照。

項目マッピング

帳票項番	項目名	xpath	型	区分値 / envelope
	事業年度（自） - 元号	`//HOC110[@page='1']/FFA00000/FFA00010/FFA00020`	区分	`envelope.JIGYO_NENDO_FROM`
		└ `//IT/JIGYO_NENDO_FROM/gen:era`		1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
		└ `//IT/JIGYO_NENDO_FROM/gen:yy`		和暦年(2桁)
		└ `//IT/JIGYO_NENDO_FROM/gen:mm`		月(2桁)
		└ `//IT/JIGYO_NENDO_FROM/gen:dd`		日(2桁)
	事業年度（至） - 元号	`//HOC110[@page='1']/FFA00000/FFA00010/FFA00030`	区分	`envelope.JIGYO_NENDO_TO`
		└ `//IT/JIGYO_NENDO_TO/gen:era`		1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
		└ `//IT/JIGYO_NENDO_TO/gen:yy`		和暦年(2桁)
		└ `//IT/JIGYO_NENDO_TO/gen:mm`		月(2桁)
		└ `//IT/JIGYO_NENDO_TO/gen:dd`		日(2桁)
	法人名	`//HOC110[@page='1']/FFA00000/FFA00035/FFA00040`	文字	`envelope.NOZEISHA_NM`
		└ `//IT/NOZEISHA_NM`
	【繰り返しグループ】（繰り返しグループラッパー: 債務者）	`//HOC110[@page='1']/FFB00000/FFB00010[n]`	Array
1	└ 債務者 - 住所又は所在地	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00020/FFB00030`	文字
2	└ - 氏名又は名称	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00020/FFB00040/FFB00050`	文字
2	└ - 外国政府等の別	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00020/FFB00040/FFB00060`	文字
3	└ 個別評価の事由 - 号	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00070/FFB00080`	文字
3	└ - 名称	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00070/FFB00090`	文字
4	└ 同上の発生時期 - 元号	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00100`	区分
		└ `//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00100/gen:era`		1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
		└ `//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00100/gen:yy`		和暦年(2桁)
		└ `//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00100/gen:mm`		月(2桁)
		└ `//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00100/gen:dd`		日(2桁)
5	└ 当期繰入額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00110`	数値
6	└ 個別評価金銭債権の額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00130`	数値
7	└ （6）のうち5年以内に弁済される金額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00140`	数値
8	└ （6）のうち取立て等の見込額 - 担保権の実行による取立て等の見込額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00150/FFB00160`	数値
9	└ - 他の者の保証による取立て等の見込額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00150/FFB00170`	数値
10	└ - その他による取立て等の見込額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00150/FFB00180`	数値
11	└ - (8)+(9)+(10)	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00150/FFB00190`	数値
12	└ （6）のうち実質的に債権とみられない部分の金額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00200`	数値
13	└ (6)-(7)-(11)-(12)	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00120/FFB00210`	数値
14	└ 繰入限度額 - 令第96条第1項第1号該当	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00220/FFB00230`	数値
15	└ - 令第96条第1項第2号該当	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00220/FFB00240`	数値
16	└ - 令第96条第1項第3号該当	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00220/FFB00250`	数値
17	└ - 令第96条第1項第4号該当	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00220/FFB00260`	数値
18	└ 繰入限度超過額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00270`	数値
19	└ 貸倒れによる損失の額等の合計額に加える金額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00280/FFB00290`	数値
20	└ 貸倒れによる損失の額等の合計額から控除する金額 - 前期の個別評価金銭債権の額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00280/FFB00300/FFB00310`	数値
21	└ - （20）の個別評価金銭債権が売掛債権等である場合の当該個別評価金銭債権に係る損金算入額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00280/FFB00300/FFB00330`	数値
22	└ - （21）に係る売掛債権等が当期において貸倒れとなった場合のその貸倒れとなった金額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00280/FFB00300/FFB00340`	数値
23	└ - （21）に係る売掛債権等が当期においても個別評価の対象となった場合のその対象となった金額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00280/FFB00300/FFB00350`	数値
24	└ - （22）又は（23）に金額の記載がある場合の（21）の金額	`//HOC110[@page='1']/FFB00000/FFB00010[n]/FFB00280/FFB00300/FFB00360`	数値
5	計 - 当期繰入額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00380`	数値
6	- 個別評価金銭債権の額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00390/FFB00400`	数値
14	- 令第96条第1項第1号該当	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00390/FFB00410/FFB00420`	数値
15	- 令第96条第1項第2号該当	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00390/FFB00410/FFB00430`	数値
16	- 令第96条第1項第3号該当	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00390/FFB00410/FFB00440`	数値
17	- 令第96条第1項第4号該当	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00390/FFB00410/FFB00450`	数値
18	- 繰入限度超過額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00460`	数値
19	- 貸倒れによる損失の額等の合計額に加える金額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00470/FFB00480`	数値
20	- 前期の個別評価金銭債権の額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00470/FFB00490/FFB00500`	数値
21	- （20）の個別評価金銭債権が売掛債権等である場合の当該個別評価金銭債権に係る損金算入額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00470/FFB00490/FFB00520`	数値
22	- （21）に係る売掛債権等が当期において貸倒れとなった場合のその貸倒れとなった金額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00470/FFB00490/FFB00530`	数値
23	- （21）に係る売掛債権等が当期においても個別評価の対象となった場合のその対象となった金額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00470/FFB00490/FFB00540`	数値
24	- （22）又は（23）に金額の記載がある場合の（21）の金額	`//HOC110[@page='1']/FFB00000/FFB00370/FFB00470/FFB00490/FFB00550`	数値
	適用事業年度等	`//HOC110[@page='1']/FFC00000`	文字

別表十一（一の二）一括評価金銭債権に係る貸倒引当金の損金算入に関する明細書

sheet_code: 11100120
様式ID: HOC112
電子申告: e-Tax（国税）
取得API: GET /hub/tax_return/corporate/sheet/national/{tax_return_id}/11100120
レスポンス: XTX(XML)
xpath ルート: //HOC112[@page='1']
共通仕様（xpath 表記の規則・名前空間・共通ヘッダ）は index.md を参照。

項目マッピング

帳票項番	項目名	xpath	型	区分値 / envelope
	事業年度（自） - 元号	`//HOC112[@page='1']/CNA00000/CNA00010/CNA00020`	区分	`envelope.JIGYO_NENDO_FROM`
		└ `//IT/JIGYO_NENDO_FROM/gen:era`		1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
		└ `//IT/JIGYO_NENDO_FROM/gen:yy`		和暦年(2桁)
		└ `//IT/JIGYO_NENDO_FROM/gen:mm`		月(2桁)
		└ `//IT/JIGYO_NENDO_FROM/gen:dd`		日(2桁)
	事業年度（至） - 元号	`//HOC112[@page='1']/CNA00000/CNA00010/CNA00030`	区分	`envelope.JIGYO_NENDO_TO`
		└ `//IT/JIGYO_NENDO_TO/gen:era`		1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
		└ `//IT/JIGYO_NENDO_TO/gen:yy`		和暦年(2桁)
		└ `//IT/JIGYO_NENDO_TO/gen:mm`		月(2桁)
		└ `//IT/JIGYO_NENDO_TO/gen:dd`		日(2桁)
	法人名	`//HOC112[@page='1']/CNA00000/CNA00035/CNA00040`	文字	`envelope.NOZEISHA_NM`
		└ `//IT/NOZEISHA_NM`
1	当期繰入額	`//HOC112[@page='1']/CNB00000/CNB00010`	数値
2	繰入限度額の計算 - 期末一括評価金銭債権の帳簿価額の合計額	`//HOC112[@page='1']/CNB00000/CNB00020/CNB00030`	数値
3	- 貸倒実績率	`//HOC112[@page='1']/CNB00000/CNB00020/CNB00040`	数値
4	- 実質的に債権とみられないものの額を控除した期末一括評価金銭債権の帳簿価額の合計額	`//HOC112[@page='1']/CNB00000/CNB00020/CNB00050`	数値
5	- 法定の繰入率＿*1000 分子	`//HOC112[@page='1']/CNB00000/CNB00020/CNB00060/CNB00070`	数値
6	繰入限度額 - 区分	`//HOC112[@page='1']/CNB00000/CNB00020/CNB00080/CNB00083`	区分
		└ `//HOC112[@page='1']/CNB00000/CNB00020/CNB00080/CNB00083/kubun_CD`		1=(2)x(3)の算式を採用, 2=(4)x(5)の算式を採用 ※括弧内は帳票項番
		└ `//HOC112[@page='1']/CNB00000/CNB00020/CNB00080/CNB00083/kubun_NM`		kubun_CDに対応する名称(最大30文字)
6	- 金額	`//HOC112[@page='1']/CNB00000/CNB00020/CNB00080/CNB00086`	数値
7	繰入限度超過額	`//HOC112[@page='1']/CNB00000/CNB00100`	数値
8	貸倒実績率の計算 - 前３年内事業年度（設立事業年度である場合には当該事業年度）の（２）の合計額	`//HOC112[@page='1']/CNC00000/CNC00010`	数値
9	- (8)/前３年内事業年度における事業年度の数	`//HOC112[@page='1']/CNC00000/CNC00020`	数値
10	前３年内事業年度（設立事業年度である場合には当該事業年度）の - 売掛債権等の貸倒れによる損失の額の合計額	`//HOC112[@page='1']/CNC00000/CNC00030/CNC00040`	数値
11	- 別表十一(一)「19の計」の合計額	`//HOC112[@page='1']/CNC00000/CNC00030/CNC00050`	数値
12	- 別表十一(一)「24の計」の合計額	`//HOC112[@page='1']/CNC00000/CNC00030/CNC00060`	数値
13	- 貸倒れによる損失の額等の合計額	`//HOC112[@page='1']/CNC00000/CNC00030/CNC00080`	数値
14	- (13)*12/前３年内事業年度における事業年度の月数の合計	`//HOC112[@page='1']/CNC00000/CNC00030/CNC00090`	数値
15	- 貸倒実績率	`//HOC112[@page='1']/CNC00000/CNC00030/CNC00100`	数値
	【繰り返しグループ】（繰り返しグループラッパー: 一括評価金銭債権の明細の繰り返し）	`//HOC112[@page='1']/CND00000/CND00010[n]`	Array
	└ 一括評価金銭債権の明細の繰り返し - 勘定科目	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00020`	文字
16	└ - 期末残高	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00030`	数値
17	└ - 売掛債権等とみなされる額及び貸倒否認額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00040`	数値
18	└ - (16)のうち税務上貸倒れがあったものとみなされる額及び売掛債権等に該当しないものの額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00050`	数値
19	└ - 個別評価の対象となった売掛債権等の額及び非適格合併等により合併法人等に移転する売掛債権等の額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00060`	数値
20	└ - 法第52条第1項第3号に該当する法人の令第96条第9項各号の金銭債権以外の金銭債権の額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00063`	数値
21	└ - 完全支配関係がある他の法人に対する売掛債権等の額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00065`	数値
22	└ - 期末一括評価金銭債権の額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00070`	数値
23	└ - 実質的に債権とみられないものの額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00080`	数値
24	└ - 差引期末一括評価金銭債権の額	`//HOC112[@page='1']/CND00000/CND00010[n]/CND00090`	数値
16	計 - 期末残高	`//HOC112[@page='1']/CND00000/CND00100/CND00110`	数値
17	- 売掛債権等とみなされる額及び貸倒否認額	`//HOC112[@page='1']/CND00000/CND00100/CND00120`	数値
18	- (16)のうち税務上貸倒れがあったものとみなされる額及び売掛債権等に該当しないものの額	`//HOC112[@page='1']/CND00000/CND00100/CND00130`	数値
19	- 個別評価の対象となった売掛債権等の額及び非適格合併等により合併法人等に移転する売掛債権等の額	`//HOC112[@page='1']/CND00000/CND00100/CND00140`	数値
20	- 法第52条第1項第3号に該当する法人の令第96条第9項各号の金銭債権以外の金銭債権の額	`//HOC112[@page='1']/CND00000/CND00100/CND00143`	数値
21	- 完全支配関係がある他の法人に対する売掛債権等の額	`//HOC112[@page='1']/CND00000/CND00100/CND00145`	数値
22	- 期末一括評価金銭債権の額	`//HOC112[@page='1']/CND00000/CND00100/CND00150`	数値
23	- 実質的に債権とみられないものの額	`//HOC112[@page='1']/CND00000/CND00100/CND00160`	数値
24	- 差引期末一括評価金銭債権の額	`//HOC112[@page='1']/CND00000/CND00100/CND00170`	数値
25	基準年度の実績により実質的に債権とみられないものの額を計算する場合の明細 - 平成27年4月1日から平成29年3月31日までの間に開始した各事業年度末の一括評価金銭債権の額の合計額	`//HOC112[@page='1']/CNE00000/CNE00010`	数値
26	- 同上の各事業年度末の実質的に債権とみられないものの額の合計額	`//HOC112[@page='1']/CNE00000/CNE00020`	数値
27	- 債権からの控除割合	`//HOC112[@page='1']/CNE00000/CNE00030`	数値
28	- 実質的に債権とみられないものの額	`//HOC112[@page='1']/CNE00000/CNE00040`	数値
	適用事業年度等	`//HOC112[@page='1']/CNF00000`	文字

Source: SKILL.md on GitHub

Third-party checks

1 warningtoday5 checks · Risk SAFE

Gen Agent Trust Hubtoday
This skill provides a comprehensive interface for AI agents to interact with the freee suite of APIs (Accounting, HR, Invoices, IT Management, etc.) via the Model Context Protocol (MCP). It includes exhaustive documentation, usage recipes, and security-conscious guidelines that instruct the agent to treat all retrieved financial and tax data as information rather than executable commands.
Sockettoday
No alerts
Snyktoday
Risk: MEDIUM · 1 issue
Runlayer6mo
3/83 files flagged
ZeroLeaks5mo
Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at f5d1212. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 3 weeks ago

Capability

metadata: { "author": "freee_jp", "homepage": "https://github.com/freee/freee-mcp" }

Topics

API
MCP
freee
accounting
hr
invoicing
project-management
expense-tracking
payroll

What it does

Provides detailed API reference and usage guides for freee's accounting, HR, invoicing, project management, sales, and IT management services through the freee-mcp MCP server. Use this skill when you need to query or perform operations on freee data like expense reports, transactions, employee records, timesheets, invoices, or project hours.

Generated from the current SKILL.md.

Frequently asked

Does this skill work with both Remote MCP and local setup?

Yes. The skill supports Remote MCP (recommended, auto-authenticated via browser) and local MCP server setup (requires running `npx freee-mcp configure`). Use `freee_server_info` to check which transport mode is active.

Which freee products does this skill cover?

The skill covers accounting, HR/payroll, invoicing, project time tracking, sales management, IT management, and expense applications. Signing (electronic contracts) requires a separate `freee-sign-mcp` setup.

Do I need to specify a company ID for API calls?

Yes. You must first fetch the current company ID using `freee_get_current_company`, and it must match the company you want to operate on. Use `freee_set_current_company` to switch between companies before making API calls.

What should I do if I get an authentication error?

For Remote MCP, the client will prompt for re-authentication; if that fails, remove and re-add the custom connector. For local mode, use `freee_auth_status` to check status, then run `freee_clear_auth` followed by `freee_authenticate`.

Where do I find API details and usage examples?

The skill includes `recipes/` for common workflows (expense applications, deals, payroll, invoicing, etc.) and `references/` with detailed API parameters and response specs. Start with relevant recipes before consulting references.

Generated from the current SKILL.md. These answers refresh after source changes.

/freee-api-skill

freee-api-skilltax-return-referencesbeppyo-11.md

別表十一

収録帳票

別表十一（一）個別評価金銭債権に係る貸倒引当金の損金算入に関する明細書

項目マッピング

別表十一（一の二）一括評価金銭債権に係る貸倒引当金の損金算入に関する明細書

項目マッピング

Third-party checks

Provenance

Capability

Topics

README badge

What it does

Frequently asked

Related skills

tax-return-referencesbeppyo-11.md