━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee工数管理APIにおいて、勤怠情報の一括登録・更新ができるエンドポイントをリリースしました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：
勤怠情報の一括登録・更新（PUT /daily_attendances/bulk）
変更種別：
Non-Breaking Change
変更内容：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更リリース日：2026/09/30
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee工数管理APIにおいて、プロジェクトタググループの取得が
できるエンドポイントをリリースしました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：
プロジェクトタググループの取得API（GET /project_tag_groups）
変更種別：
Non-Breaking Change
変更内容：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更リリース予定日：2026/09/28
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
売上・前受金・仕入の決済ステータスの操作が可能なAPIを
新規公開しました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：
変更種別：
Non-Breaking Change
会計未連携の売上・前受金・仕入データの決済ステータス変更が
可能になりました。
変更内容：
売上・前受金・仕入の決済ステータス変更が可能になりました。
変更理由：API経由での会計未連携の売上・前受金・仕入データの
決済ステータス変更を可能にし、利便性を向上させるため。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/29
リリース日：2026/9/24
旧バージョン廃止予定日：なし
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee販売の見積APIにおいて、見積明細の原価・社内メモの登録、
更新、取得機能および見積一覧での粗利情報の取得・絞り込み機能を追加しました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：
変更種別：Non-Breaking Change
変更内容：
変更理由：
見積の原価管理機能をpublic apiでも提供し利便性を向上させるため
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/28
リリース日：2026/9/17
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
本変更に伴う既存機能への影響はありません（後方互換性が保たれています）。見積明細における原価・社内メモの管理や、一覧での粗利情報の取得・絞り込みを利用される場合のみ、新しいパラメータおよびレスポンスフィールドをご活用ください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
下記の通り、freee会計APIの仕様変更を予定しております。
ご迷惑をおかけし大変恐れ入りますが、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：[PUT] /api/1/payment_requests/{id}: 支払依頼の更新
変更種別：[Breaking Change]
変更内容：
変更理由：
支払依頼に登録された支払先口座情報が、意図しない形で書き換わることを防ぐためです。
現在は更新のたびに、支払先の取引先のメイン口座の値で支払先口座情報を上書きしています。そのため、支払先を変更していない更新でも、取引先マスタ側でメイン口座が変更されていると口座情報が入れ替わります。
本変更では、支払先が変わらない更新では上書きを行いません。支払先を変更した場合は、これまでどおり変更後の取引先のメイン口座の値を設定します。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/15
変更リリース予定日：2026/10下旬頃
旧バージョン廃止予定日：2026/10下旬頃（リリースと同時に一斉適用となります）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
対象となるアプリケーション：
支払依頼の更新（PUT）APIのレスポンスに含まれる支払先口座情報が、常に「取引先の最新のメイン口座」と一致する前提で処理・保存を行っている呼び出し元アプリケーション。
必要な対応：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：[PUT] /api/1/payment_requests/{id}
リクエスト：※変更ありません
レスポンス：※フィールド構成に変更はありません
リクエストで指定する支払先と、支払依頼に保存される支払先口座情報の関係は、変更後は次のとおりとなります。
| リクエスト条件 | 変更後の挙動 （支払先口座情報） | 従来との違い |
|---|---|---|
| 支払先が更新前と 同じ取引先 | 更新前の値を そのまま維持 | 従来は取引先のメイン口座で 上書きされていました（変更点） |
| 支払先が更新前と 異なる取引先 | 変更後の取引先の メイン口座で更新 | 変更なし |
| 支払先を指定しない（partner_id, partner_codeをどちらも指定しない） | リクエストで 指定された口座情報(bank_*)を保存 | 変更なし |
（例）取引先Aを支払先とする支払依頼を登録したのち、取引先Aの
メイン口座を口座1から口座2へ変更し、その支払依頼を更新した場合
– 変更前：支払先口座情報が口座2の値に書き換わります。
– 変更後：支払先口座情報は口座1の値のまま維持されます。
■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整において、家族情報の「住民税のみの控除対象かどうか」の入力（保存・更新）受付を停止します。また、データ取得時のレスポンスからも同項目が削除されます。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
対象API：
変更種別：Breaking Change
変更内容：
変更理由：
2026年以降の年末調整では、家族情報の「住民税のみの控除対象かどうか」の入力を受付停止し、入力された所得額から住民税の控除対象かどうかを自動判定する仕様に変更されるためです。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/14
変更リリース予定日：2026/10 中旬
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整データを取得・更新するアプリ開発者が影響を受けます。以下の対応・確認をお願いいたします。
GETリクエストの改修・確認（対応必須）
is_resident_tax_only_deduction の値を取得・参照してロジックを組んでいる場合、フィールドの欠損によるエラーが発生しないようアプリ側での改修・ご確認をお願いいたします。
PUTリクエストを利用している場合（対応不要）
同パラメータを送信している場合はパラメータが無視されるようになります。APIのリクエスト自体はエラーにはならないため、アプリ側の改修は不要です。
2025年以前のデータへの影響
yearパラメータに2025年以前を指定する場合は、本仕様変更の影響を受けません。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：/api/v1/yearend_adjustments/{year}/employees/{employee_id}
リクエスト：GET
【変更前】（yearパラメータが2025年以前の場合）
{
"employee": {
// ... (中略：変更はありません) ...
},
"dependents": [
{
"id": 1,
"last_name": "山田",
"first_name": "花子",
// ... (中略) ...
"annual_remittance_amount": 0,
"non_resident_dependents_reason": "none",
"is_resident_tax_only_deduction": true, // ← 2025年以前の場合は返却されます
"retirement_income": 0
}
],
"insurances": [
// ... (中略：変更はありません) ...
]
}【変更後】（yearパラメータに2026年以降を指定した場合）
{
"employee": {
// ... (中略：変更はありません) ...
},
"dependents": [
{
"id": 1,
"last_name": "山田",
"first_name": "花子",
// ... (中略) ...
"annual_remittance_amount": 0,
"non_resident_dependents_reason": "none",
// ← is_resident_tax_only_deduction フィールドは返却されません
"retirement_income": 0
}
],
"insurances": [
// ... (中略：変更はありません) ...
]
}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：/api/v1/yearend_adjustments/{year}/dependents/{employee_id}
リクエスト：PUT
year が 2026年以降の場合、リクエストボディに is_resident_tax_only_deduction を含めても無視されます（API自体はエラーにならず、他の値は正常に保存されます）。
【リクエストボディ例】
{
"dependent": {
"last_name": "山田",
"first_name": "花子",
"relationship": "spouse",
// ... (中略：その他のパラメータ) ...
"is_resident_tax_only_deduction": true // ← 2026年以降の場合、送信しても無視（破棄）されます
}
}(8/3)［会計］freee会計 APIにおいて、請求書APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
請求書の各種レスポンスにおいて、以下のプロパティが必須項目に変更されました。
booking_date、company_address1、company_address2、company_contact_info、company_prefecture_code、company_prefecture_name、company_zipcode、deal_id、description、due_date、invoice_contents、mail_sent_at、message、notes、partner_address1、partner_address2、partner_code、partner_contact_info、partner_display_name、partner_name、partner_prefecture_code、partner_prefecture_name、partner_title、partner_zipcode、payment_bank_info、payment_date、payment_status、sub_total、title、total_vat、web_confirmed_at、web_downloaded_at、web_published_at
請求書の取得APIのレスポンスにおいて、related_quotation_ids が必須項目に変更されました。
請求書一覧の取得APIのレスポンスにおいて、invoice_contents 内の order のフォーマットが int64 に変更されました。
(8/4)［会計］freee会計 APIにおいて、自動登録ルールの差額取引情報が削除
変更対象API：
変更種別： 破壊的変更なし
変更内容：
自動登録ルールの各種レスポンスから、任意のプロパティ user_matcher_diff_deals が削除されました。
(8/4)［会計］freee会計 APIにおいて、経費申請の承認者の対象リソース種別が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
経費申請の各種レスポンスの approvers 内 resource_type に、列挙値 switchable が追加されました。
(8/5)［会計］freee会計 APIにおいて、申請経路APIの用途に購買申請が追加およびレスポンス定義の変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
申請経路の各種レスポンスの usages に、列挙値 PurchaseRequest が追加されました。
申請経路の各種レスポンスにおいて、definition_system、description、first_step_id、name、usages、user_id が必須項目に変更されました。あわせて、一覧の取得では request_form_ids が、取得では steps が必須項目に変更されました。
申請経路の取得APIのレスポンスにおいて、steps 内の承認者ユーザーIDのプロパティ名が user_ids から users_ids に変更されました。
申請経路一覧の取得APIのクエリパラメータ request_form_id、および申請経路の取得APIのパスパラメータ id とクエリパラメータ company_id のフォーマットが int64 に変更されました。
(8/6)［会計］freee会計 APIにおいて、勘定科目APIにカテゴリー階層とデフォルト税区分コードが追加およびレスポンス定義の変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
勘定科目の作成・更新・取得APIのレスポンスに、任意のプロパティ categories（勘定科目カテゴリーの階層）と default_tax_code（デフォルト設定がされている税区分コード）が追加されました。値が返却されるのは勘定科目の取得APIのみです。
勘定科目の作成・更新・取得APIのレスポンスにおいて、shortcut と shortcut_num が nullable に変更されました。
勘定科目の各種レスポンスにおいて、以下のプロパティが必須項目に変更されました。
corresponding_expense_id、corresponding_income_id、group_id、group_name、shortcut、shortcut_num
一覧の取得ではあわせて corresponding_expense_name、corresponding_income_name、update_date が、作成・更新・取得では accumulated_dep_account_item_id、accumulated_dep_account_item_name、items、partners が必須項目に変更されました。
(8/6)［会計］freee会計 APIにおいて、連携サービスAPIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
連携サービスの各種レスポンスにおいて、name、name_kana、type が必須項目に変更されました。
(8/6)［会計］freee会計 APIにおいて、事業所APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
事業所の取得APIのレスポンスにおいて、default_wallet_account_id と display_name が nullable に変更されました。
事業所の取得APIのレスポンスにおいて、default_wallet_account_id、および fiscal_years 内の id、start_date、end_date が必須項目に変更されました。
(8/6)［会計］freee会計 APIにおいて、経費科目APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
経費科目の各種レスポンスにおいて、description と line_description が nullable に変更されました。
経費科目の各種レスポンスにおいて、account_item_id、description、line_description、required_receipt、tax_code が必須項目に変更されました。
(8/6)［会計］freee会計 APIにおいて、固定資産一覧APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
固定資産一覧の取得APIのレスポンスにおいて、life_years と undepreciated_balance が nullable に変更されました。
固定資産一覧の取得APIのレスポンスにおいて、depreciation_account_item_id の最小値が 1 から 0 に変更されました。
固定資産一覧の取得APIのレスポンスにおいて、以下のプロパティが必須項目に変更されました。
account_item_id、acquisition_cost、acquisition_date、city_name、closing_accumulated_depreciation、company_id、created_at、depreciation_account_item_id、depreciation_amount、depreciation_method、depreciation_status、id、item_id、life_years、management_number、name、opening_accumulated_depreciation、opening_balance、prefecture_code、retire_date、section_id、undepreciated_balance
(8/6)［会計］freee会計 APIにおいて、ファイルボックスAPIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
ファイルボックスの各種レスポンスにおいて、receipt_metadatum が nullable に変更されました。
(8/6)［会計］freee会計 APIにおいて、自動登録ルールAPIのIDプロパティのフォーマットが変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
自動登録ルールの各種レスポンスにおいて、id と card_label_id のフォーマットが int64 に変更されました。作成・取得・更新APIでは origin_deal_id も同様に変更されました。
(8/12)［会計］freee会計 APIにおいて、取引（収入・支出）のレスポンスに債権債務行・各種コード・証憑情報が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
取引の各種レスポンス（作成を除く）に、任意のプロパティ accruals（債権債務行）が追加されました。一覧の取得または取得APIでクエリパラメータ accruals=with を指定し、かつ債権債務行が存在する場合のみ含まれます。
取引の各種レスポンス（作成を除く）の details に、任意のプロパティ account_item_code、item_code、section_code、segment_1_tag_code、segment_2_tag_code、segment_3_tag_code が追加されました。
取引の各種レスポンスの receipts に、任意のプロパティ document_type、invoice_registration_number、qualified_invoice が追加されました。
取引の各種レスポンスにおいて、due_date、ref_number、および receipts 内の issue_date が nullable に変更されました。
取引の作成APIのレスポンスにおいて、receipts 内の file_src が必須項目に変更されました。
+更新の作成・更新・削除APIに、404 のエラーレスポンスが追加されました。
+更新の削除APIのクエリパラメータ company_id のフォーマットが int64 に修正されました。
(8/12)［会計］freee会計 APIにおいて、経費申請に親申請の種別および代理申請者IDが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
経費申請の作成・更新APIに、任意のリクエストプロパティ parent_type（親申請の種別。ApprovalRequest または PurchaseRequest）が追加されました。
経費申請の各種レスポンスに、任意のプロパティ parent_type と proxy_applicant_id（代理申請者のユーザーID）が追加されました。
(8/12)［会計］freee会計 APIにおいて、ユーザーAPIに権限フラグとロールが追加およびレスポンス定義の変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
ログインユーザーの権限の取得APIのレスポンスに、以下の必須プロパティが追加されました。
consolidation、currencies、deal_linkage、division_tag_1、division_tag_2、division_tag_3、entries_reviews、freee_cards_stream、manage_bulk_expense_application_approvals、payment_request_templates、proxy_application_settings、purchase_requests、reports_managements_introduction、reports_purchase_budgets、suspense_payments
ログインユーザーの取得APIのレスポンスの companies 内 role に、列挙値 product_linkage が追加されました。
ユーザーの各種レスポンスにおいて、display_name、first_name、first_name_kana、last_name、last_name_kana が必須項目に変更されました。ログインユーザーの更新APIでは user 自体も必須項目に変更されました。
事業所に所属するユーザー一覧の取得APIのクエリパラメータ limit に、デフォルト値 50 が明記されました。
(8/12)［会計］freee会計 APIにおいて、口座APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
口座一覧の取得・口座の取得APIのレスポンスにおいて、update_date が必須項目に変更されました。
口座の更新APIのレスポンスにおいて、last_balance と walletable_balance が必須項目に変更されました。
口座の作成APIのレスポンスにおいて、bank_id が nullable に変更されました。
(8/12〜8/26)［会計］freee会計 APIにおいて、試算表APIのIDプロパティの最小値が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
試算表の各種レスポンスにおいて、IDを表すプロパティ（item_id、partner_id、section_id、および balances 内の items、partners、sections、segment_1_tags、segment_2_tags、segment_3_tags の id）の最小値が 1 から 0 に変更されました。貸借対照表は 8/12、損益計算書は 8/17、製造原価報告書は 8/26 に反映されています。
(8/14)［会計］freee会計 APIにおいて、仕訳帳APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
仕訳帳のダウンロード要求APIのレスポンスにおいて、download_type、encoding、end_date、messages、start_date、status_url、up_to_date、up_to_date_reasons が必須項目に変更されました。
仕訳帳のステータスの取得APIのレスポンスにおいて、encoding が必須項目に変更されました。
(8/14)［会計］freee会計 APIにおいて、口座明細一覧に並び順の指定が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
口座明細一覧の取得APIに、任意のクエリパラメータ sort_type（並び順の指定。未指定の場合は取引日の降順）が追加されました。
(8/17)［会計］freee会計 APIにおいて、各種申請・経費申請・支払依頼に部門役職の承認ステップ向けパラメータが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
各種申請・経費申請・支払依頼の作成・更新APIに、任意のリクエストプロパティ applicant_group_id（申請者の所属部門ID）と approval_flow_group_id（申請経路の承認部門ID）が追加されました。
各種申請・経費申請・支払依頼の承認操作APIに、任意のリクエストプロパティ next_group_id（次の承認ステップの承認部門ID）が追加されました。
(8/17)［会計］freee会計 APIにおいて、申請経路の承認ステップに承認者決定方法・役職・分岐ルールが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
申請経路の取得APIのレスポンスの steps に、任意のプロパティ approver_determination_type、group、position_types、switching_rules が追加されました。
(8/17)［会計］freee会計 APIにおいて、品目APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
品目の各種レスポンスにおいて、shortcut1 と shortcut2 が必須項目に変更されました。
(8/17)［会計］freee会計 APIにおいて、見積書APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
見積書の各種レスポンスの quotation_status から、列挙値 all が削除されました。
見積書の各種レスポンスにおいて、以下のプロパティが必須項目に変更されました。
company_address1、company_address2、company_contact_info、company_prefecture_code、company_prefecture_name、company_zipcode、description、mail_sent_at、message、notes、partner_address1、partner_address2、partner_code、partner_contact_info、partner_display_name、partner_name、partner_prefecture_code、partner_prefecture_name、partner_zipcode、quotation_contents、sub_total、title、total_vat、web_confirmed_at、web_downloaded_at、web_published_at
見積書の取得APIのレスポンスにおいて、related_invoice_id と related_quotation_ids が必須項目に変更されました。
(8/19)［会計］freee会計 APIにおいて、各種申請の申請項目にチェックボックス型が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
各種申請の作成・更新APIのリクエストプロパティ request_items 内 type に、列挙値 checkbox が追加されました。
各種申請の各種レスポンスの request_items 内 type、および approval_request_form の parts 内 type に、列挙値 checkbox が追加されました。
(8/24)［会計］freee会計 APIにおいて、部門APIのリクエスト・レスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
部門の作成・更新APIのリクエストプロパティ code、long_name、parent_id、shortcut1、shortcut2 が nullable に変更されました。部門の更新（存在しない場合は作成）APIでは long_name、parent_code、shortcut1、shortcut2 が nullable に変更されました。
部門の各種レスポンスにおいて、long_name、shortcut1、shortcut2 が必須項目に変更されました。
部門の作成・更新・削除および更新（存在しない場合は作成）APIに、404 のエラーレスポンスが追加されました。
(8/24)［会計］freee会計 APIにおいて、セグメントタグAPIのリクエスト・レスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
セグメントタグの作成・更新APIのリクエストプロパティ code、description、shortcut1、shortcut2 が nullable に変更されました。セグメントタグの更新（作成）APIでは description、shortcut1、shortcut2 が nullable に変更されました。
セグメントタグの各種レスポンスにおいて、update_date が必須項目に変更され、フォーマットが date に変更されました。
セグメントタグの更新・削除APIに、404 のエラーレスポンスが追加されました。
(8/25)［会計］freee会計 APIにおいて、取引（収入・支出）の支払行に品目・取引先・部門・セグメントタグ・メモタグの情報が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
取引の各種レスポンスの payments に、必須プロパティ item_id、item_code、partner_id、partner_code、section_id、section_code、tag_ids が追加されました。
取引の各種レスポンスの payments に、任意のプロパティ segment_1_tag_id、segment_1_tag_code、segment_2_tag_id、segment_2_tag_code、segment_3_tag_id、segment_3_tag_code が追加されました。
(8/26)［会計］freee会計 APIにおいて、勘定科目一覧にキーワード検索が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
勘定科目一覧の取得APIに、任意のクエリパラメータ keyword（勘定科目コード・勘定科目名・ショートカット1・2 に対する部分一致検索）が追加されました。
(8/26)［会計］freee会計 APIにおいて、振替伝票APIのレスポンス定義が変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
振替伝票の各種レスポンスにおいて、receipt_ids、ref_number、および details 内の partner_code が必須項目に変更されました。
(8/28)［申告］freee申告 APIにおいて、帳票の識別子が sheet_key から sheet_code に移行
変更対象API：
変更種別： 破壊的変更なし
変更内容：
申告一覧取得APIのレスポンスの available_sheets において、sheet_code が必須項目に変更され、sheet_key が必須項目から任意項目に変更されました。
決算書取得・国税帳票取得・地方税帳票取得APIのレスポンスの tax_data において、sheet_key が必須項目から任意項目に変更され、非推奨（廃止予定）になりました。今後は sheet_code を利用してください。
不要となったコンポーネントスキーマ TaxReturn.Corporate.FinancialStatementSheetKey が削除されました（8/31）。
(8/25)［固定資産］freee固定資産 APIにおいて、固定資産に関するエンドポイントが公開
変更対象API：
変更種別： 破壊的変更なし
変更内容：
固定資産の一覧取得、登録、詳細取得、更新および削除を行う一連のエンドポイントが新設されました。
(8/7)［販売］freee販売 APIにおいて、案件への案件マスタIDの追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
案件登録・案件更新APIに、任意のリクエストプロパティ common_business_id（紐付ける案件マスタID。ULID形式）が追加されました。紐付けの指定は案件登録時のみ可能で、案件更新では既存と異なる値を指定するとエラーになります。
案件詳細取得APIのレスポンスに、任意のプロパティ common_business_id が追加されました。
(8/14〜8/25)［工数管理］freee工数管理 APIにおいて、エラーレスポンスの共通化およびステータスコードの整理
変更対象API：
変更種別： 破壊的変更なし
変更内容：
各エンドポイントのエラーレスポンスが共通の error スキーマ（status_code、errors）を参照する形に統一されました。
400 のエラーレスポンスに、バリデーション対象の項目を示す任意のプロパティ fields（name、message の配列）が追加されました。
共通 error スキーマの status_code に、列挙値 400、401、402、403、404、500 が追加されました。
共通 error スキーマの errors 内 type に、列挙値 forbidden、internal_server_error、resource_not_found が追加されました。
以下のエンドポイントに、403 のエラーレスポンスが追加されました。
プロジェクト詳細の取得APIに 404、プロジェクトの登録APIに 402 のエラーレスポンスが追加されました。
ログインユーザー情報の取得APIから 401、人件費予算一覧の取得APIから 402 のエラーレスポンスが削除されました。
(8/21)［工数管理］freee工数管理 APIにおいて、プロジェクトの編集・削除エンドポイントが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
プロジェクトの編集および削除を行うエンドポイントが新設されました。
下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee工数管理APIにおいて、受注ステータス一覧の取得ができるエンドポイントをリリースしました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象：受注ステータス一覧の取得API（GET /sales_order_statuses）
変更種別：[Non-Breaking Change]
変更内容：
工数管理APIリファレンス-freee Developers Community
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/08
変更リリース日：2026/09/08
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
下記の通り、freee会計APIの仕様変更を実施いたしました
新仕様の確認ならびに、必要に応じてアプリ側での対応をご検討いただきますようお願いいたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象：経費申請のWebhook通知
変更種別：[Non-breaking Change（機能追加）]
変更内容：
経費申請のWebhook通知において、承認時修正（承認者が金額や勘定科目などを修正して承認する操作）が行われた際にも通知が送信されるようになります。
承認時修正のWebhook通知内容：
・リソース: accounting:expense_application
・アクション: updated
・承認アクション: approval_action: approval_modify
・含まれる情報:
– id: 経費申請ID
– company_id: 事業所ID
– status: ステータス
– approval_action: 承認アクション（approval_modify が設定されます）
– applicant_id: 申請者ID
– actor_id: 承認者（操作者）ID
変更理由：
経費申請の承認フローにおいて、承認者による修正が行われたタイミングを外部システムで正確に把握できるようにするため、承認時修正についてもWebhook通知を送信するよう仕様を変更いたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/03
変更リリース日：2026/08/25
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Webhook通知を受信していない場合：
本変更による影響はありません。対応は不要です。
既にWebhook通知を受信している場合：
Webhook設定が有効な事業所では、今後 approval_action: approval_modify を含むイベントが追加で通知されるようになります。
承認時修正のイベントを識別するには：
Webhookのペイロードに含まれる approval_action フィールドが approval_modify であるかを確認してください。
既存の通知への影響：
通常の承認、差戻し等の既存の通知には影響ありません。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
承認時修正が行われた場合の通知例：
{
“resource”: “accounting:expense_application”,
“action”: “updated”,
“details”: {
“expense_application”: {
“id”: 12345,
“company_id”: 67890,
“status”: “approved”,
“approval_action”: “approval_modify”,
“applicant_id”: 111,
“actor_id”: 222
}
}
}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
発注書Public APIにおける取引先の指定条件を変更し、従来の「顧客かつ見込み顧客ではないこと」からWeb版と同じ「仕入先であること」を必須としました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
対象API：
変更種別：Breaking Change
内容：
背景・理由：これまではPublic APIにおいて、顧客・見込み顧客の属性がオフの場合には「指定された partner_id は 存在しません。」とエラーが発生しておりました。
これはWeb版と異なっており、仕入先属性がオンの取引先であれば、顧客・見込み顧客の属性のオン・オフにに関わらず発注書が作成できるというWebの挙動にPublic APIの挙動を統一するための変更となります。
Web版で選択可能な仕入先を指定した際、その取引先が顧客に設定されていない場合に「指定された partner_id は 存在しません。」エラーが発生する不具合を修正し、Web版の取引先選択条件（仕入先属性）へ統一するため。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/02
リリース日：2026/09/02
旧バージョン廃止予定日：なし
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
発注書APIをご利用中のアプリケーションにおいて、仕入先に設定されていない取引先を指定してAPIを呼び出している場合、リリース以降はエラーとなります。 必要に応じて、取引先マスタのWeb画面または取引先API等から対象取引先の属性設定（仕入先フラグ）をご確認・修正いただきますようお願いいたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：
リクエスト：仕様の変更はありません（取引先の判定条件のみ変更）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee工数管理APIにおいて、プロジェクトの編集と削除ができるエンドポイントをリリースしました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：
変更種別：[Non-Breaking Change]
変更内容：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更リリース日：2026/08/26
■概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee申告 法人税にて帳票の値を取得可能なAPIを公開いたします。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：freee申告 法人税API
変更種別：Non-Breaking Change
変更内容：
変更理由：
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/08/28
変更リリース日：2026/08/28
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
本追加に伴う既存APIへの影響はないため、特に必要な対応はありません。
新たに追加されたAPIをご利用いただくことで、申告書チェック業務の効率化が可能になりますので、ぜひご活用ください。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee固定資産において、固定資産の登録、取得及び更新・削除ができるエンドポイントをリリースしました。
■変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：freee固定資産API
変更種別：Non-Breaking Change
変更内容：
変更理由：
■変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/08/28
変更リリース日：2026/08/28
■対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
特に必要な対応はありません。
新たに追加された機能をご利用になる場合は、各エンドポイントの仕様をご確認の上、実装をお願いいたします。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
日頃よりfreeeアプリストアをご利用いただき、誠にありがとうございます。
freeeアプリストアでは、これまでも長期間ご利用のない開発用環境（テスト事業所等）や未稼働アプリの整理をお願いしてまいりました。
この度、デベロッパーの皆様により透明性の高い運用をご提供するため、対象となる基準をガイドラインとして明確化するとともに、「freeeアプリストアデベロッパー規約」に明記する改定を行います。 また、本改定に伴い、未利用環境の整理をシステムによる自動対応（自動定期削除）へ移行いたします。
詳細につきましては、以下の内容をご確認ください。
■ 規約改定日（効力発生日）
2026年9月24日（木）
■ 規約の主な改定箇所
これまで運用方針としてご案内していた内容について、以下の通り規約上に明記いたします。
1. 開発用環境の取り扱いに関する明記（第10条の2 新設）
一定期間APIの利用実績がない場合等の条件に該当した場合、開発用環境の提供終了および削除を行う場合がある旨を明記いたします。
第10条の2（開発用環境の提供および削除等）
１ 当社は、デベロッパーに対し、アプリの開発およびテストを目的とした環境（テスト事業所等を含み、以下「開発用環境」といいます。）を無償で提供する場合があります。
２ 当社は、開発用環境について、当社が別途定める条件に該当すると判断した場合、デベロッパーに対して事前に通知することなく、当該開発用環境の提供を終了し、データを削除することができるものとします。
３ 当社は、前項に基づく開発用環境の提供の終了またはデータの t削除等によりデベロッパーに生じた損害について、一切の責任を負わないものとします。
2. アプリの公開停止・提供終了条件の明記（第21条第1項第3号 追記）
作成されたアプリについて、弊社側の基準にて提供の終了や公開停止を行う場合がある旨を追記いたします。
第21条（アプリの提供終了）
１ 当社は、デベロッパーの提供するアプリの全部またはその一部が以下のいずれかに該当することを当社が知った場合、自身の裁量において、本アプリストアでのアプリの提供を終了し、または公開を停止することができるものとします。
（1）アプリにアプリユーザーの端末やデータに深刻な損害を与える可能性のある要素が含まれている場合
（2）法令に違反している場合
（3）その他当社が別途定める条件に該当すると判断した場合
※改定後の規約全文は、2026年9月24日より規約ページへ反映されます。
・ https://app.secure.freee.co.jp/terms-developers.html
■ 自動定期削除の基準・詳細について
対象となる具体的な基準や、環境を維持するための手順につきましては、以下のガイドラインをご確認ください。
[開発用テスト事業所およびアプリの定期削除について]
■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
前受金の操作が可能なAPIを新規公開しました。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：
前受金
変更種別：[Non-Breaking Change]
変更内容：
変更理由：API経由での前受金の利用を可能にし、他システムとの連携利便性を向上させるため。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/08/14
変更リリース日：2026/07/29
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。
■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
売上予定の操作が可能なAPIを新規公開しました。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：[API名とバージョン]
売上予定
変更種別：[Non-Breaking Change]
変更内容：
変更理由：API経由での売上予定の利用を可能にし、他システムとの連携利便性を向上させるため。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/08/13
変更リリース日：2026/07/15
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。
■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
定期売上の操作が可能なAPIを新規公開しました。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：[API名とバージョン]
定期売上
変更種別：[Non-Breaking Change]
変更内容：
変更理由：API経由での定期売上の利用を可能にし、他システムとの連携利便性を向上させるため。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/08/12
変更リリース日：2026/07/15
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。
下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。
(7/14)［工数管理］freee工数管理 APIにおいて、プロジェクトへの共通業務IDの追加およびコード指定の仕様変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
プロジェクトの登録APIに、任意のリクエストプロパティ common_business_id が追加されました。
プロジェクトの登録APIのリクエストプロパティ code が、必須項目から任意項目に変更されました。
プロジェクトの登録・詳細取得APIのレスポンスに、任意のプロパティ common_business_id が追加されました。
(7/17)［工数管理］freee工数管理 APIにおいて、人件費予算に関するエンドポイントが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
人件費予算の一覧取得および更新を行うエンドポイントが新設されました。
(7/29)［工数管理］freee工数管理 APIにおいて、プロジェクトへの工数タググループの追加および取得エンドポイントが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
プロジェクトの登録APIに、任意のリクエストプロパティ workload_tag_groups が追加されました。
プロジェクトの一覧取得・登録・詳細取得APIのレスポンスに、任意のプロパティ workload_tag_groups が追加されました。
工数タググループを取得するエンドポイントが新設されました。
(7/3)［会計］freee会計 APIにおいて、振替伝票の管理番号に対応
変更対象API：
変更種別： 破壊的変更なし
変更内容：
振替伝票一覧の取得APIに、任意のクエリパラメータ ref_number が追加されました。
振替伝票の作成・更新APIに、任意のリクエストプロパティ ref_number が追加されました。
振替伝票の各種レスポンスに、任意のプロパティ ref_number が追加されました。
(7/16)［会計］freee会計 APIにおいて、適格請求書発行事業者以外からの課税仕入れに関する税率・税区分が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
選択項目の取得APIのレスポンスに、以下の税率が追加されました。
総勘定元帳の取得APIのクエリパラメータ tax_rate に、同じ値が追加されました。
税区分の取得APIのレスポンスプロパティ display_category と同名のクエリパラメータに、対応する tax_e30 および tax_e70 の値が追加されました。
(7/17)［会計］freee会計 APIにおいて、取引（振替）のレスポンスが複数口座に対応
変更対象API：
変更種別： 破壊的変更なし
変更内容：
取引（振替）の各種レスポンスに、必須プロパティ to_walletables が追加されました。
レスポンスの amount、description、to_walletable_id、to_walletable_type が非推奨になりました。
(7/23)［会計］freee会計 APIにおいて、自動登録ルールの差額取引情報が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
自動登録ルールの各種レスポンスに、任意のプロパティ user_matcher_diff_deals が追加されました。
(7/27)［会計］freee会計 APIにおいて、承認経路の対象リソース種別が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
承認経路の取得APIのレスポンスプロパティ resource_type に、列挙値 switchable が追加されました。
(7/27)［会計］freee会計 APIにおいて、取引（振替）の作成・更新時に複数口座を指定可能に変更
変更対象API：
変更種別： 破壊的変更なし
変更内容：
取引（振替）の作成・更新APIに、任意のリクエストプロパティ to_walletables が追加されました。
作成・更新APIのリクエストプロパティ amount、to_walletable_id、to_walletable_type が、必須項目から任意項目に変更されました。
作成・更新APIのリクエストプロパティ amount、description、to_walletable_id、to_walletable_type が非推奨になりました。
(7/30)［会計］freee会計 APIにおいて、購買申請に関するエンドポイントが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
購買申請の一覧取得、作成、取得、更新、削除およびアクションの実行を行う一連のエンドポイントが新設されました。
購買申請フォームの一覧取得および取得を行うエンドポイントが新設されました。
(7/3)［請求書］freee請求書 APIにおいて、支払通知書に関するエンドポイントが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
支払通知書の一覧取得、作成、取得、更新、キャンセルおよびキャンセル取消を行う一連のエンドポイントが新設されました。
支払通知書テンプレートの一覧を取得するエンドポイントが新設されました。
(7/13)［請求書］freee請求書 APIにおいて、決済ステータスおよび決済方法の選択肢が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
請求書の各種レスポンスの payment_status に、列挙値 failed と unprocessed が追加されました。
請求書の作成・更新APIのレスポンスの payment_type に、列挙値 card が追加されました。
請求書一覧の取得APIのクエリパラメータ payment_status に、failed と unprocessed が追加されました。
請求書の作成・更新APIのリクエストプロパティ payment_type に、card が追加されました。
(7/7)［人事労務］freee人事労務 APIにおいて、その他控除および従業員の控除情報に関するエンドポイントが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
その他控除の一覧取得、作成および取得を行うエンドポイントが新設されました。
従業員ごとの控除情報を取得、更新および削除するためのエンドポイントが新設されました。
(7/14)［販売］freee販売 APIにおいて、前受金取崩、定期売上および売上予定に関するエンドポイントが追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
前受金の定期取崩、定期売上および売上予定を管理する各種エンドポイントが新設されました。
上記の案件、原価予算、納品、その他原価、仕入、発注、見積、売上および受注に関するAPIにおいて、IDを表すリクエストプロパティの最小値が 1 に設定されました。
対象となるリクエストプロパティには、company_id、customer_id、supplier_id、reporting_section_id、billing_partner_id、collecting_partner_id、item_tag_id、segment_tag_1_id、segment_tag_2_id、segment_tag_3_id および各種テンプレートIDが含まれます。
(7/28)［販売］freee販売 APIにおいて、前受金に関するエンドポイントおよび売上のレスポンス項目が追加
変更対象API：
変更種別： 破壊的変更なし
変更内容：
前受金の一覧取得、登録、取得、更新、取消および取崩を行う一連のエンドポイントが新設されました。
売上一覧の取得・売上の取得APIのレスポンスに、請求・回収・前受金・定期売上などに関するプロパティが追加されました。
売上の各種レスポンスに、必須プロパティ collection_method_type と invoice_template_name が追加されました。