2026年8月の更新情報

(8/3)[会計]freee会計 APIにおいて、請求書APIのレスポンス定義が変更

変更対象API:

  • GET /api/1/invoices – 請求書一覧の取得
  • GET /api/1/invoices/{id} – 請求書の取得

変更種別: 破壊的変更なし

変更内容:

請求書の各種レスポンスにおいて、以下のプロパティが必須項目に変更されました。

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:

  • POST /api/1/user_matchers – 自動登録ルールの作成
  • GET /api/1/user_matchers/{id} – 自動登録ルールの取得
  • PUT /api/1/user_matchers/{id} – 自動登録ルールの更新

変更種別: 破壊的変更なし

変更内容:

自動登録ルールの各種レスポンスから、任意のプロパティ user_matcher_diff_deals が削除されました。


(8/4)[会計]freee会計 APIにおいて、経費申請の承認者の対象リソース種別が追加

変更対象API:

  • POST /api/1/expense_applications – 経費申請の作成
  • GET /api/1/expense_applications/{id} – 経費申請詳細の取得
  • PUT /api/1/expense_applications/{id} – 経費申請の更新
  • POST /api/1/expense_applications/{id}/actions – 経費申請の承認操作
  • PUT /api/1/expense_applications/{id}/parent_approvable_requests – 経費申請に関連付ける各種申請の更新

変更種別: 破壊的変更なし

変更内容:

経費申請の各種レスポンスの approvers 内 resource_type に、列挙値 switchable が追加されました。


(8/5)[会計]freee会計 APIにおいて、申請経路APIの用途に購買申請が追加およびレスポンス定義の変更

変更対象API:

  • GET /api/1/approval_flow_routes – 申請経路一覧の取得
  • GET /api/1/approval_flow_routes/{id} – 申請経路の取得

変更種別: 破壊的変更なし

変更内容:

申請経路の各種レスポンスの 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:

  • GET /api/1/account_items – 勘定科目一覧の取得
  • POST /api/1/account_items – 勘定科目の作成
  • PUT /api/1/account_items/code/upsert – 勘定科目の更新(存在しない場合は作成)
  • GET /api/1/account_items/{id} – 勘定科目の取得
  • PUT /api/1/account_items/{id} – 勘定科目の更新

変更種別: 破壊的変更なし

変更内容:

勘定科目の作成・更新・取得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:

  • GET /api/1/banks – 連携サービス一覧の取得
  • GET /api/1/banks/{id} – 連携サービスの取得

変更種別: 破壊的変更なし

変更内容:

連携サービスの各種レスポンスにおいて、name、name_kana、type が必須項目に変更されました。


(8/6)[会計]freee会計 APIにおいて、事業所APIのレスポンス定義が変更

変更対象API:

  • GET /api/1/companies/{id} – 事業所の取得

変更種別: 破壊的変更なし

変更内容:

事業所の取得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:

  • GET /api/1/expense_application_line_templates – 経費科目一覧の取得
  • POST /api/1/expense_application_line_templates – 経費科目の作成
  • GET /api/1/expense_application_line_templates/{id} – 経費科目の取得
  • PUT /api/1/expense_application_line_templates/{id} – 経費科目の更新

変更種別: 破壊的変更なし

変更内容:

経費科目の各種レスポンスにおいて、description と line_description が nullable に変更されました。

経費科目の各種レスポンスにおいて、account_item_id、description、line_description、required_receipt、tax_code が必須項目に変更されました。


(8/6)[会計]freee会計 APIにおいて、固定資産一覧APIのレスポンス定義が変更

変更対象API:

  • GET /api/1/fixed_assets – 固定資産一覧の取得

変更種別: 破壊的変更なし

変更内容:

固定資産一覧の取得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:

  • GET /api/1/receipts – ファイルボックス(証憑ファイル)一覧の取得
  • POST /api/1/receipts – ファイルボックス(証憑ファイル)のアップロード
  • GET /api/1/receipts/{id} – ファイルボックス(証憑ファイル)の取得
  • PUT /api/1/receipts/{id} – ファイルボックス(証憑ファイル)の更新

変更種別: 破壊的変更なし

変更内容:

ファイルボックスの各種レスポンスにおいて、receipt_metadatum が nullable に変更されました。


(8/6)[会計]freee会計 APIにおいて、自動登録ルールAPIのIDプロパティのフォーマットが変更

変更対象API:

  • GET /api/1/user_matchers – 自動登録ルール一覧の取得
  • POST /api/1/user_matchers – 自動登録ルールの作成
  • GET /api/1/user_matchers/{id} – 自動登録ルールの取得
  • PUT /api/1/user_matchers/{id} – 自動登録ルールの更新

変更種別: 破壊的変更なし

変更内容:

自動登録ルールの各種レスポンスにおいて、id と card_label_id のフォーマットが int64 に変更されました。作成・取得・更新APIでは origin_deal_id も同様に変更されました。


(8/12)[会計]freee会計 APIにおいて、取引(収入・支出)のレスポンスに債権債務行・各種コード・証憑情報が追加

変更対象API:

  • GET /api/1/deals – 取引(収入・支出)一覧の取得
  • POST /api/1/deals – 取引(収入・支出)の作成
  • GET /api/1/deals/{id} – 取引(収入・支出)の取得
  • PUT /api/1/deals/{id} – 取引(収入・支出)の更新
  • POST /api/1/deals/{id}/payments – 取引(収入・支出)の支払行の作成
  • PUT /api/1/deals/{id}/payments/{payment_id} – 取引(収入・支出)の支払行の更新
  • POST /api/1/deals/{id}/renews – 取引(収入・支出)の+更新の作成
  • DELETE /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の削除
  • PUT /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の更新

変更種別: 破壊的変更なし

変更内容:

取引の各種レスポンス(作成を除く)に、任意のプロパティ 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:

  • GET /api/1/expense_applications – 経費申請一覧の取得
  • POST /api/1/expense_applications – 経費申請の作成
  • GET /api/1/expense_applications/{id} – 経費申請詳細の取得
  • PUT /api/1/expense_applications/{id} – 経費申請の更新
  • POST /api/1/expense_applications/{id}/actions – 経費申請の承認操作
  • PUT /api/1/expense_applications/{id}/parent_approvable_requests – 経費申請に関連付ける各種申請の更新

変更種別: 破壊的変更なし

変更内容:

経費申請の作成・更新APIに、任意のリクエストプロパティ parent_type(親申請の種別。ApprovalRequest または PurchaseRequest)が追加されました。

経費申請の各種レスポンスに、任意のプロパティ parent_type と proxy_applicant_id(代理申請者のユーザーID)が追加されました。


(8/12)[会計]freee会計 APIにおいて、ユーザーAPIに権限フラグとロールが追加およびレスポンス定義の変更

変更対象API:

  • GET /api/1/users – 事業所に所属するユーザー一覧の取得
  • GET /api/1/users/capabilities – ログインユーザーの権限の取得
  • GET /api/1/users/me – ログインユーザーの取得
  • PUT /api/1/users/me – ログインユーザーの更新

変更種別: 破壊的変更なし

変更内容:

ログインユーザーの権限の取得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:

  • GET /api/1/walletables – 口座一覧の取得
  • POST /api/1/walletables – 口座の作成
  • GET /api/1/walletables/{type}/{id} – 口座の取得
  • PUT /api/1/walletables/{type}/{id} – 口座の更新

変更種別: 破壊的変更なし

変更内容:

口座一覧の取得・口座の取得APIのレスポンスにおいて、update_date が必須項目に変更されました。

口座の更新APIのレスポンスにおいて、last_balance と walletable_balance が必須項目に変更されました。

口座の作成APIのレスポンスにおいて、bank_id が nullable に変更されました。


(8/12〜8/26)[会計]freee会計 APIにおいて、試算表APIのIDプロパティの最小値が変更

変更対象API:

  • GET /api/1/reports/trial_bs – 貸借対照表の取得
  • GET /api/1/reports/trial_bs_two_years – 貸借対照表(前年比較)の取得
  • GET /api/1/reports/trial_bs_three_years – 貸借対照表(3期間比較)の取得
  • GET /api/1/reports/trial_pl – 損益計算書の取得
  • GET /api/1/reports/trial_pl_two_years – 損益計算書(前年比較)の取得
  • GET /api/1/reports/trial_pl_three_years – 損益計算書(3期間比較)の取得
  • GET /api/1/reports/trial_pl_sections – 損益計算書(部門比較)の取得
  • GET /api/1/reports/trial_pl_segment_1_tags – 損益計算書(セグメント1比較)の取得
  • GET /api/1/reports/trial_pl_segment_2_tags – 損益計算書(セグメント2比較)の取得
  • GET /api/1/reports/trial_pl_segment_3_tags – 損益計算書(セグメント3比較)の取得
  • GET /api/1/reports/trial_cr – 製造原価報告書の取得
  • GET /api/1/reports/trial_cr_two_years – 製造原価報告書(前年比較)の取得
  • GET /api/1/reports/trial_cr_three_years – 製造原価報告書(3期間比較)の取得
  • GET /api/1/reports/trial_cr_sections – 製造原価報告書(部門比較)の取得
  • GET /api/1/reports/trial_cr_segment_1_tags – 製造原価報告書(セグメント1比較)の取得
  • GET /api/1/reports/trial_cr_segment_2_tags – 製造原価報告書(セグメント2比較)の取得
  • GET /api/1/reports/trial_cr_segment_3_tags – 製造原価報告書(セグメント3比較)の取得

変更種別: 破壊的変更なし

変更内容:

試算表の各種レスポンスにおいて、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:

  • GET /api/1/journals – 仕訳帳のダウンロード要求
  • GET /api/1/journals/reports/{id}/status – 仕訳帳のステータスの取得

変更種別: 破壊的変更なし

変更内容:

仕訳帳のダウンロード要求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:

  • GET /api/1/wallet_txns – 口座明細一覧の取得

変更種別: 破壊的変更なし

変更内容:

口座明細一覧の取得APIに、任意のクエリパラメータ sort_type(並び順の指定。未指定の場合は取引日の降順)が追加されました。


(8/17)[会計]freee会計 APIにおいて、各種申請・経費申請・支払依頼に部門役職の承認ステップ向けパラメータが追加

変更対象API:

  • POST /api/1/approval_requests – 各種申請の作成
  • PUT /api/1/approval_requests/{id} – 各種申請の更新
  • POST /api/1/approval_requests/{id}/actions – 各種申請の承認操作
  • POST /api/1/expense_applications – 経費申請の作成
  • PUT /api/1/expense_applications/{id} – 経費申請の更新
  • POST /api/1/expense_applications/{id}/actions – 経費申請の承認操作
  • POST /api/1/payment_requests – 支払依頼の作成
  • PUT /api/1/payment_requests/{id} – 支払依頼の更新
  • POST /api/1/payment_requests/{id}/actions – 支払依頼の承認操作

変更種別: 破壊的変更なし

変更内容:

各種申請・経費申請・支払依頼の作成・更新APIに、任意のリクエストプロパティ applicant_group_id(申請者の所属部門ID)と approval_flow_group_id(申請経路の承認部門ID)が追加されました。

各種申請・経費申請・支払依頼の承認操作APIに、任意のリクエストプロパティ next_group_id(次の承認ステップの承認部門ID)が追加されました。


(8/17)[会計]freee会計 APIにおいて、申請経路の承認ステップに承認者決定方法・役職・分岐ルールが追加

変更対象API:

  • GET /api/1/approval_flow_routes/{id} – 申請経路の取得

変更種別: 破壊的変更なし

変更内容:

申請経路の取得APIのレスポンスの steps に、任意のプロパティ approver_determination_type、group、position_types、switching_rules が追加されました。


(8/17)[会計]freee会計 APIにおいて、品目APIのレスポンス定義が変更

変更対象API:

  • GET /api/1/items – 品目一覧の取得
  • POST /api/1/items – 品目の作成
  • PUT /api/1/items/code/upsert – 品目の更新(存在しない場合は作成)
  • GET /api/1/items/{id} – 品目の取得
  • PUT /api/1/items/{id} – 品目の更新

変更種別: 破壊的変更なし

変更内容:

品目の各種レスポンスにおいて、shortcut1 と shortcut2 が必須項目に変更されました。


(8/17)[会計]freee会計 APIにおいて、見積書APIのレスポンス定義が変更

変更対象API:

  • GET /api/1/quotations – 見積書一覧の取得
  • GET /api/1/quotations/{id} – 見積書の取得

変更種別: 破壊的変更なし

変更内容:

見積書の各種レスポンスの 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:

  • GET /api/1/approval_requests – 各種申請一覧の取得
  • POST /api/1/approval_requests – 各種申請の作成
  • GET /api/1/approval_requests/forms/{id} – 各種申請の申請フォームの取得
  • GET /api/1/approval_requests/{id} – 各種申請の取得
  • PUT /api/1/approval_requests/{id} – 各種申請の更新
  • POST /api/1/approval_requests/{id}/actions – 各種申請の承認操作

変更種別: 破壊的変更なし

変更内容:

各種申請の作成・更新APIのリクエストプロパティ request_items 内 type に、列挙値 checkbox が追加されました。

各種申請の各種レスポンスの request_items 内 type、および approval_request_form の parts 内 type に、列挙値 checkbox が追加されました。


(8/24)[会計]freee会計 APIにおいて、部門APIのリクエスト・レスポンス定義が変更

変更対象API:

  • GET /api/1/sections – 部門一覧の取得
  • POST /api/1/sections – 部門の作成
  • PUT /api/1/sections/code/upsert – 部門の更新(存在しない場合は作成)
  • DELETE /api/1/sections/{id} – 部門の削除
  • GET /api/1/sections/{id} – 部門の取得
  • PUT /api/1/sections/{id} – 部門の更新

変更種別: 破壊的変更なし

変更内容:

部門の作成・更新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:

  • GET /api/1/segments/{segment_id}/tags – セグメントタグ一覧の取得
  • POST /api/1/segments/{segment_id}/tags – セグメントタグの作成
  • PUT /api/1/segments/{segment_id}/tags/code/upsert – セグメントタグの更新(作成)
  • DELETE /api/1/segments/{segment_id}/tags/{id} – セグメントタグの削除
  • PUT /api/1/segments/{segment_id}/tags/{id} – セグメントタグの更新

変更種別: 破壊的変更なし

変更内容:

セグメントタグの作成・更新APIのリクエストプロパティ code、description、shortcut1、shortcut2 が nullable に変更されました。セグメントタグの更新(作成)APIでは description、shortcut1、shortcut2 が nullable に変更されました。

セグメントタグの各種レスポンスにおいて、update_date が必須項目に変更され、フォーマットが date に変更されました。

セグメントタグの更新・削除APIに、404 のエラーレスポンスが追加されました。


(8/25)[会計]freee会計 APIにおいて、取引(収入・支出)の支払行に品目・取引先・部門・セグメントタグ・メモタグの情報が追加

変更対象API:

  • GET /api/1/deals – 取引(収入・支出)一覧の取得
  • POST /api/1/deals – 取引(収入・支出)の作成
  • GET /api/1/deals/{id} – 取引(収入・支出)の取得
  • PUT /api/1/deals/{id} – 取引(収入・支出)の更新
  • POST /api/1/deals/{id}/payments – 取引(収入・支出)の支払行の作成
  • PUT /api/1/deals/{id}/payments/{payment_id} – 取引(収入・支出)の支払行の更新
  • POST /api/1/deals/{id}/renews – 取引(収入・支出)の+更新の作成
  • DELETE /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の削除
  • PUT /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の更新

変更種別: 破壊的変更なし

変更内容:

取引の各種レスポンスの 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:

  • GET /api/1/account_items – 勘定科目一覧の取得

変更種別: 破壊的変更なし

変更内容:

勘定科目一覧の取得APIに、任意のクエリパラメータ keyword(勘定科目コード・勘定科目名・ショートカット1・2 に対する部分一致検索)が追加されました。


(8/26)[会計]freee会計 APIにおいて、振替伝票APIのレスポンス定義が変更

変更対象API:

  • GET /api/1/manual_journals – 振替伝票一覧の取得
  • POST /api/1/manual_journals – 振替伝票の作成
  • GET /api/1/manual_journals/{id} – 振替伝票の取得
  • PUT /api/1/manual_journals/{id} – 振替伝票の更新

変更種別: 破壊的変更なし

変更内容:

振替伝票の各種レスポンスにおいて、receipt_ids、ref_number、および details 内の partner_code が必須項目に変更されました。


(8/28)[申告]freee申告 APIにおいて、帳票の識別子が sheet_key から sheet_code に移行

変更対象API:

  • GET /hub/tax_return/corporate – 申告一覧取得
  • GET /hub/tax_return/corporate/sheet/financial_statements/{tax_return_id}/{sheet_code} – 決算書取得
  • GET /hub/tax_return/corporate/sheet/national/{tax_return_id}/{sheet_code} – 国税帳票取得
  • GET /hub/tax_return/corporate/sheet/local/{tax_return_id}/{sheet_code}/{prefecture_government_code}/{city_government_code} – 地方税帳票取得

変更種別: 破壊的変更なし

変更内容:

申告一覧取得APIのレスポンスの available_sheets において、sheet_code が必須項目に変更され、sheet_key が必須項目から任意項目に変更されました。

決算書取得・国税帳票取得・地方税帳票取得APIのレスポンスの tax_data において、sheet_key が必須項目から任意項目に変更され、非推奨(廃止予定)になりました。今後は sheet_code を利用してください。

不要となったコンポーネントスキーマ TaxReturn.Corporate.FinancialStatementSheetKey が削除されました(8/31)。


(8/25)[固定資産]freee固定資産 APIにおいて、固定資産に関するエンドポイントが公開

変更対象API:

  • GET /hub/fixed_asset_management/fixed_assets – 固定資産一覧取得
  • POST /hub/fixed_asset_management/fixed_assets – 固定資産登録
  • GET /hub/fixed_asset_management/fixed_assets/{id} – 固定資産詳細取得
  • PUT /hub/fixed_asset_management/fixed_assets/{id} – 固定資産更新
  • DELETE /hub/fixed_asset_management/fixed_assets/{id} – 固定資産削除

変更種別: 破壊的変更なし

変更内容:

固定資産の一覧取得、登録、詳細取得、更新および削除を行う一連のエンドポイントが新設されました。


(8/7)[販売]freee販売 APIにおいて、案件への案件マスタIDの追加

変更対象API:

  • POST /businesses – 案件登録
  • GET /businesses/{id} – 案件詳細取得
  • PATCH /businesses/{id} – 案件更新

変更種別: 破壊的変更なし

変更内容:

案件登録・案件更新APIに、任意のリクエストプロパティ common_business_id(紐付ける案件マスタID。ULID形式)が追加されました。紐付けの指定は案件登録時のみ可能で、案件更新では既存と異なる値を指定するとエラーになります。

案件詳細取得APIのレスポンスに、任意のプロパティ common_business_id が追加されました。


(8/14〜8/25)[工数管理]freee工数管理 APIにおいて、エラーレスポンスの共通化およびステータスコードの整理

変更対象API:

  • error レスポンスを返す全エンドポイント共通

変更種別: 破壊的変更なし

変更内容:

各エンドポイントのエラーレスポンスが共通の 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 のエラーレスポンスが追加されました。

  • GET /partners – 取引先の一覧取得
  • GET /people – 従業員一覧の取得
  • GET /projects – プロジェクト一覧の取得
  • GET /projects/{id} – プロジェクト詳細の取得
  • GET /teams – チームの一覧取得
  • GET /unit_costs – 従業員単価マスタの取得
  • GET /workload_summaries – 工数実績の取得
  • GET /workloads – 工数詳細の取得
  • POST /workloads – 工数登録

プロジェクト詳細の取得APIに 404、プロジェクトの登録APIに 402 のエラーレスポンスが追加されました。

ログインユーザー情報の取得APIから 401、人件費予算一覧の取得APIから 402 のエラーレスポンスが削除されました。


(8/21)[工数管理]freee工数管理 APIにおいて、プロジェクトの編集・削除エンドポイントが追加

変更対象API:

  • PATCH /projects/{id} – プロジェクトの編集
  • DELETE /projects/{id} – プロジェクトの削除

変更種別: 破壊的変更なし

変更内容:

プロジェクトの編集および削除を行うエンドポイントが新設されました。