(6/3)［会計］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} – 振替伝票の更新

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

変更内容：
振替伝票の各種レスポンスにおいて、txn_number が必須から任意（optional）に変更されました。

振替伝票の更新（PUT）リクエストにおいて、各種コード（勘定科目、品目、部門、セグメントタグ）による指定が可能となり、これに伴い account_item_id が必須項目から任意に変更されました。

---

(6/11)［工数管理］共通 error スキーマの type enum に bad_request が追加

変更対象API：
error レスポンスを返す全エンドポイント共通

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

変更内容：
共通 error スキーマの type enum に bad_request が追加されました。

---

(6/8)［IT管理］IT管理 APIにおいて、アプリケーションアカウント管理関連のエンドポイントのAPIタグが変更されました。

変更対象API：

• GET /hub/it_management/application_accounts
• POST /hub/it_management/application_accounts
• DELETE /hub/it_management/application_accounts/{id}
• GET /hub/it_management/application_accounts/{id}
• PATCH /hub/it_management/application_accounts/{id}

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

変更内容：
アプリケーションアカウント（application_accounts）に関する各種エンドポイントにおいて、APIタグが it_management_application_account から it_management_application_accounts（複数形）へ変更・統一されました。

---

(6/9)［IT管理］IT管理 APIにおいて、一覧取得系APIに検索用のクエリパラメータが追加されました。

変更対象API：

• GET /hub/it_management/application_accounts – アプリケーションアカウント一覧の取得
• GET /hub/it_management/assets – 資産一覧の取得
• GET /hub/it_management/members – メンバー一覧の取得

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

変更内容：
「アプリケーションアカウント一覧の取得」および「資産一覧の取得」APIにおいて、特定のメンバーで絞り込みを行うための任意のクエリパラメータ member_id が追加されました。

「メンバー一覧の取得」APIにおいて、以下の任意の絞り込み用クエリパラメータが追加されました。

• employment_type_id （雇用形態IDでの絞り込み）
• entered_since / entered_until （入社日の期間指定）
• resigned_since / resigned_until （退職日の期間指定）

---

(6/18)［請求書］freee請求書 APIにおいて、発注書関連APIおよび各種帳票のキャンセル機能が追加

変更対象API：

• GET, POST /purchase_orders – 発注書の取得・作成
• GET /purchase_orders/templates – 発注書テンプレート一覧の取得
• GET, PUT /purchase_orders/{id} – 発注書の詳細取得・更新
• PUT /purchase_orders/{id}/cancel, uncancel – 発注書のキャンセル・キャンセル取消
• PUT /delivery_slips/{id}/cancel, uncancel – 納品書のキャンセル・キャンセル取消
• PUT /invoices/{id}/cancel, uncancel – 請求書のキャンセル・キャンセル取消
• PUT /quotations/{id}/cancel, uncancel – 見積書のキャンセル・キャンセル取消
• PUT /receipts/{id}/cancel, uncancel – 領収書のキャンセル・キャンセル取消

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

変更内容：
発注書（purchase_orders）の作成、取得、更新などを行う一連のエンドポイントが新設されました。

各種帳票（納品書、請求書、見積書、領収書、発注書）に対して、ステータスをキャンセルにする（cancel）、およびキャンセル状態を取り消す（uncancel）ためのアクション系エンドポイントが追加されました。

---

(6/23)［人事労務］各種申請APIにおける代理申請者IDの追加および手当APIのタグ更新

変更対象API：

• GET /api/v1/allowances – 手当一覧の取得
• POST /api/v1/allowances – 手当の作成
• GET /api/v1/allowances/{id} – 手当の取得
• GET /api/v1/approval_requests/monthly_attendances – 月次勤怠申請一覧の取得
• POST /api/v1/approval_requests/monthly_attendances – 月次勤怠申請の作成
• GET /api/v1/approval_requests/monthly_attendances/{id} – 月次勤怠申請の取得
• PUT /api/v1/approval_requests/monthly_attendances/{id} – 月次勤怠申請の更新
• POST /api/v1/approval_requests/monthly_attendances/{id}/actions – 月次勤怠申請に対するアクションの実行
• GET /api/v1/approval_requests/overtime_works – 残業申請一覧の取得
• POST /api/v1/approval_requests/overtime_works – 残業申請の作成
• GET /api/v1/approval_requests/overtime_works/{id} – 残業申請の取得
• PUT /api/v1/approval_requests/overtime_works/{id} – 残業申請の更新
• POST /api/v1/approval_requests/overtime_works/{id}/actions – 残業申請に対するアクションの実行
• GET /api/v1/approval_requests/paid_holidays – 有休申請一覧の取得
• POST /api/v1/approval_requests/paid_holidays – 有休申請の作成
• GET /api/v1/approval_requests/paid_holidays/{id} – 有休申請の取得
• PUT /api/v1/approval_requests/paid_holidays/{id} – 有休申請の更新
• POST /api/v1/approval_requests/paid_holidays/{id}/actions – 有休申請に対するアクションの実行
• GET /api/v1/approval_requests/special_holidays – 特別休暇申請一覧の取得
• POST /api/v1/approval_requests/special_holidays – 特別休暇申請の作成
• GET /api/v1/approval_requests/special_holidays/{id} – 特別休暇申請の取得
• PUT /api/v1/approval_requests/special_holidays/{id} – 特別休暇申請の更新
• POST /api/v1/approval_requests/special_holidays/{id}/actions – 特別休暇申請に対するアクションの実行
• GET /api/v1/approval_requests/work_times – 勤務時間申請一覧の取得
• POST /api/v1/approval_requests/work_times – 勤務時間申請の作成
• GET /api/v1/approval_requests/work_times/{id} – 勤務時間申請の取得
• PUT /api/v1/approval_requests/work_times/{id} – 勤務時間申請の更新
• POST /api/v1/approval_requests/work_times/{id}/actions – 勤務時間申請に対するアクションの実行

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

変更内容：
各種申請（月次勤怠、残業、有休、特別休暇、勤務時間）およびそのアクションのレスポンスに、任意プロパティとして proxy_applicant_id（代理申請者ID）が追加されました。

手当API（allowances）のOpenAPIタグにおいて、「手当」が削除され「その他手当」が追加されました。

---

(6/26)［販売］仕入・発注関連エンドポイントの追加およびレスポンス構造の仕様変更

変更対象API：

• GET /businesses – 案件一覧の取得
• GET /businesses/{id} – 案件の取得
• GET /cost_budgets – 原価予算一覧の取得
• GET /cost_budgets/{id} – 原価予算の取得
• GET /deliveries – 納品一覧の取得
• GET /deliveries/{id} – 納品の取得
• GET /master/items – 品目一覧の取得
• GET /other_costs – その他原価一覧の取得
• GET /other_costs/{id} – その他原価の取得
• GET /procurements – 仕入一覧の取得
• POST /procurements – 仕入の登録
• GET /procurements/{id} – 仕入詳細の取得
• PATCH /procurements/{id} – 仕入の更新
• POST /procurements/{id}/cancellation – 仕入の取消
• GET /purchase_orders – 発注一覧の取得
• POST /purchase_orders – 発注の登録
• GET /purchase_orders/{id} – 発注詳細の取得
• PATCH /purchase_orders/{id} – 発注の更新
• POST /purchase_orders/{id}/cancellation – 発注の取消
• GET /quotations – 見積一覧の取得
• GET /quotations/{id} – 見積の取得
• GET /sales – 売上一覧の取得
• GET /sales/{id} – 売上の取得
• GET /sales_orders – 受注一覧の取得
• GET /sales_orders/{id} – 受注の取得

変更種別： 破壊的変更あり

変更内容：
■ 一覧・取得APIの OpenAPI Schema の定義変更
案件、納品、見積、売上、受注などの各レスポンスにおいて、取引先や担当者情報の構造が変更されました。
該当の破壊的変更についての詳細は以下をご確認ください。
https://developer.freee.co.jp/sm/sm-improvement/8071

■ その他の変更・新機能

• 新機能（仕入・発注APIの追加）
  仕入（procurements）および発注（purchase_orders）を管理する各種エンドポイント（一覧取得、登録、詳細取得、更新、取消）が新設されました。
• 一覧取得APIの検索パラメータ追加
  案件、原価予算、納品、その他原価、受注などの各一覧取得APIに、最終更新日で絞り込みを行うクエリパラメータ start_last_updated_date および end_last_updated_date が追加されました。
• レスポンス項目の仕様変更（必須化・Nullable化など）
  各種ステータスや金額情報（amount_set, billing_status, total_amount など）が必須項目に変更されました。
  
  源泉徴収税額（amount_of_withholding_tax）や一部の関連ID・メモなどが nullable および任意プロパティに変更されました。
  
  品目マスタ（/master/items）APIにおいて、code および uom_name が nullable に変更されました。

---

(6/26)［人事労務］手当ルール・給与明細備考の管理エンドポイント追加

変更対象API：

• GET /api/v1/employees/{employee_id}/allowance_rules – 手当ルール一覧の取得
• PUT /api/v1/employees/{employee_id}/allowance_rules – 手当ルールの更新
• DELETE /api/v1/employees/{employee_id}/allowance_rules/{id} – 手当ルールの削除
• PUT /api/v1/salaries/employee_payroll_statements/{employee_id}/remark – 給与明細の備考の更新

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

変更内容：
従業員ごとの「手当ルール」を取得、更新、削除するためのエンドポイントが新設されました。

従業員の給与明細の「備考」欄を更新できるエンドポイントが新設されました。

---

(6/26)［会計］事業所APIへの期末日情報追加および支払依頼の検索条件拡張

変更対象API：

• GET /api/1/companies/{id} – 事業所の詳細取得
• GET /api/1/payment_requests – 支払依頼一覧の取得

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

変更内容：
事業所詳細取得APIのレスポンス内 fiscal_years（事業年度）リストに、以下の必須プロパティが追加されました。

• is_closed：締め済み判定
• month_end_date：期末日
• temp_month_end_date：仮期末日
  支払依頼一覧取得APIの検索パラメータに、approval_flow_route_id（承認経路ID）、observing（閲覧可能フラグ）、partner_name（取引先名）が追加され、より詳細な検索が可能になりました。
  
  内部コンポーネントスキーマから purchaseRequestActionCreateParams が削除されました。

---

(6/29)［人事労務］freee人事労務 APIにおいて、従業員の手当ルールおよび給与明細の備考関連エンドポイントが追加されました。

変更対象API：

• GET, PUT, DELETE /api/v1/employees/{employee_id}/allowance_rules – 従業員手当ルール
• PUT /api/v1/salaries/employee_payroll_statements/{employee_id}/remark – 給与明細の備考

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

変更内容：
特定の従業員（employee_id）に対して、個別の手当ルールを取得・作成・削除するための各種エンドポイントが新設されました。

従業員の給与明細に対して、備考（remark）の文言を更新するためのエンドポイントが新設されました。

---

(6/29)［会計］freee会計 APIにおいて、事業所詳細への決算期情報の追加および支払依頼APIの検索パラメータ拡張が行われました。

変更対象API：

• GET /api/1/companies/{id} – 事業所の詳細取得
• GET /api/1/payment_requests – 支払依頼一覧の取得

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

変更内容：
事業所の詳細取得レスポンスに含まれる決算期情報（fiscal_years）に、決算完了フラグ（is_closed）、期末日（month_end_date）、仮期末日（temp_month_end_date）の各プロパティが必須項目として追加されました。

支払依頼の一覧取得APIにおいて、より柔軟な絞り込みができるよう、クエリパラメータに承認経路ID（approval_flow_route_id）、閲覧のみフラグ（observing）、取引先名（partner_name）が追加されました。

不要となったコンポーネントスキーマ purchaseRequestActionCreateParams が削除されました。

(5/7)［会計］freee会計 APIにおいて、取引・振替伝票APIで「コード指定」および「取引先情報」に対応しました。

変更対象API：

• POST /api/1/manual_journals – 振替伝票の作成
• GET /api/1/manual_journals/{id} – 振替伝票の取得（レスポンス）
• 取引（deals）取得系API（レスポンス）

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

変更内容：

• 振替伝票の作成リクエストで、明細をコードで指定できるようになりました（account_item_code／item_code／section_code／segment_1_tag_code／segment_2_tag_code／segment_3_tag_code を追加）。あわせて必須項目から account_item_idが外れ、ID・コードのどちらでも指定可能になりました。
• 振替伝票のレスポンス明細にも上記のコード系プロパティ（nullable）が追加されました。
• 取引（deal）のレスポンス明細に partner_id／partner_code（取引先情報、nullable）が追加されました。

---

(5/8)［会計］freee会計 APIにおいて、取引（収入・支出）APIの明細に取引先指定が追加されました。

変更対象API：

• POST /api/1/deals – 取引の作成
• PUT /api/1/deals/{id} – 取引の更新
• POST /api/1/deals/{id}/renews – 取引（収入・支出）の+更新の作成
• PUT /api/1/deals/{id}/renews/{renew_id} – 取引（収入・支出）の+更新の更新

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

変更内容：

• リクエストの明細（details）に partner_id（取引先ID、nullable）が追加されました。取引の作成（dealCreateParams）ではあわせてpartner_code（取引先コード）も追加され、明細行ごとに取引先を指定できるようになりました。

---

(5/14)［販売］freee販売 APIにおいて、原価管理関連のエンドポイントが追加されました。

変更対象API：

• GET /cost_budgets – 原価予算一覧
• POST /cost_budgets – 原価予算登録
• GET /cost_budgets/{id} – 原価予算詳細取得
• PATCH /cost_budgets/{id} – 原価予算更新
• POST /cost_budgets/{id}/cancellation – 原価予算取消
• GET /other_costs – その他原価一覧
• POST /other_costs – その他原価登録
• GET /other_costs/{id} – その他原価詳細取得
• PATCH /other_costs/{id} – その他原価更新
• POST /other_costs/{id}/restoration – その他原価復元
• POST /other_costs/{id}/cancellation – その他原価取消

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

変更内容：

• 原価予算（基本原価予算・調達原価予算）および「その他原価」を管理するエンドポイントが新設されました。
• あわせて案件（Business / BusinessDigest）レスポンスのcode（案件コード）が必須かつ非nullになりました（4/30の案件コード必須化に対応するレスポンス側の変更）。

---

(5/15)［請求書］freee請求書 APIにおいて、帳票への詳細ページURL付与とfreee販売連携フィルタが追加されました。

変更対象API：

• GET /delivery_slips（納品書一覧）、GET /invoices（請求書一覧）、GET /quotations（見積書一覧）
• 上記＋領収書を含む各帳票の取得・詳細レスポンス（納品書／請求書／見積書／領収書）

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

変更内容：

• 一覧取得API（納品書・請求書・見積書）にクエリパラメータ sales_management_originが追加されました（trueでfreee販売から作成された帳票も含める。指定にはfreee販売へのアクセス権限が必要）。
• 各帳票のレスポンスに report_url（帳票詳細ページのURL、必須項目）が追加されました。
• 一覧（Index）および詳細（Show）レスポンス（納品書・請求書・見積書）に sales_management_origin（freee販売から作成された帳票かどうか）が追加されました。

---

(5/20)［会計］freee会計 APIにおいて、取引先APIの請求書送付方法の選択肢が拡張されました。

変更対象API： 取引先取得系API（partnersResponse）

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

変更内容：

• sending_method（請求書送付方法）の列挙値に以下が追加されました：
• pdf_delivery（メール（PDFファイル添付））
• pdf_delivery_and_posting（メール（PDFファイル添付）と郵送）
• ※ これらは2026年5月末頃に利用可能となる予定です。

注意： 送信方法の列挙値チェックを厳密に行っている場合、新しい値の追加により想定外の動作が発生する可能性があります。

---

(5/20)［販売］freee販売 APIにおいて、見積関連のエンドポイントが追加され、受注と見積が連携できるようになりました。

変更対象API：

• GET /quotations – 見積一覧
• POST /quotations – 見積登録
• GET /quotations/{id} – 見積詳細取得
• PATCH /quotations/{id} – 見積更新
• PUT /quotations/{id}/quotation_status – 見積ステータス変更
• POST /quotations/{id}/cancellation – 見積取消
• POST /sales_orders – 受注登録（変更）
• GET /sales_orders 系（レスポンス変更）

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

変更内容：

• 見積（quotations）を管理するエンドポイントが新設されました。
• 受注の登録リクエスト（SalesOrderRequestBase）にquotation_id（見積ID、nullable）が追加され、受注を見積に紐づけられるようになりました。受注レスポンス（SalesOrderDigest）にもquotation_id が追加されました。

---

(5/21)［人事労務］freee人事労務 APIにおいて、手当関連のエンドポイントが追加されました。

変更対象API：

• GET /api/v1/allowances – 手当一覧の取得
• POST /api/v1/allowances – 手当の作成
• GET /api/v1/allowances/{id} – 手当の取得

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

変更内容：

• 手当（allowances）を管理するエンドポイントが新設されました（いずれも管理者権限を持つユーザーのみ実行可能）。
• 一覧取得には frequency（支給頻度：salary / salary_monthly / salary_this_month / bonus）、is_active（表示状態）などの絞り込みパラメータが利用できます。
• あわせて「勤怠タグ月次サマリの取得（GET /api/v1/employees/{employee_id}/attendance_tag_summaries/{year}/{month}）」の説明文が実態に合わせて修正されました（機能変更なし）。

---

(5/27)［会計］freee会計 APIにおいて、固定資産一覧取得APIの説明が補足されました。

変更対象API： GET /api/1/fixed_assets – 固定資産一覧の取得

変更種別： 破壊的変更なし（ドキュメントのみ）

変更内容：

• 「本APIはfreee会計の固定資産台帳を取得するものであり、freee固定資産で登録した固定資産は取得できない」旨の注意書きが説明に追加されました。
  スキーマ自体の変更はありません。

---

(5/29)［販売］freee販売 APIにおいて、各種ステータス変更・取消のエンドポイントが追加されました。

変更対象API：

• POST /businesses/{id}/cancellation – 案件取消
• POST /businesses/{id}/close – 案件ロック
• POST /businesses/{id}/reopen – 案件ロック解除
• POST /sales_orders/{id}/cancellation – 受注取消
• POST /deliveries/{id}/cancellation – 納品取消
• PUT /deliveries/{id}/delivery_status – 納品ステータス変更
• PUT /deliveries/{id}/acceptance_status – 検収ステータス変更
• POST /sales/{id}/cancellation – 売上取消

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

変更内容：

• 案件のロック／ロック解除／取消、受注・納品・売上の取消、納品ステータス・検収ステータスの変更を行うアクション系エンドポイントが新設されました。
• これにより、APIを通じて案件・受注・納品・売上のライフサイクル（ステータス遷移）を操作できるようになります。