(4/6)［会計］freee会計APIにおいて、自動登録ルール関連のエンドポイントが追加されました

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

これらのエンドポイントにより、APIを通じて自動登録ルールの管理が可能になります。

(4/7)［請求書］freee請求書 APIにおいて、領収書関連のエンドポイントが追加されました。

• GET /receipts – 領収書一覧の取得
• POST /receipts – 領収書の作成
• GET /receipts/templates – 使用可能な領収書の帳票テンプレート一覧の取得
• GET /receipts/{id} – 領収書詳細の取得
• PUT /receipts/{id} – 領収書の更新

これらのエンドポイントにより、APIを通じて領収書の管理が可能になります。

(4/8)［会計］freee会計 APIにおいて、支払依頼一覧取得APIの機能が拡張されました。

変更対象API： 支払依頼一覧の取得 – GET /api/1/payment_requests
変更種別： 破壊的変更なし
変更内容：

クエリパラメータ section_id が追加されました。
部門IDによる支払依頼の絞り込みが可能になります。

(4/23)［会計］freee会計 APIにおいて、取引先APIの送信方法オプションが追加されました。

変更対象API： 以下の取引先関連エンドポイント

• POST /api/1/partners – 取引先の作成
• GET /api/1/partners/{id} – 取引先の取得
• PUT /api/1/partners/{id} – 取引先の更新
• PUT /api/1/partners/code/{code} – 取引先の更新（取引先コード指定）
• PUT /api/1/partners/upsert_by_code – 取引先の作成・更新（取引先コード指定）

変更種別： 破壊的変更なし
変更内容：
リクエストパラメータとレスポンスプロパティの partner_doc_setting_attributes/sending_method に、以下の新しい列挙値が追加されました：

• pdf_delivery（メール（PDFファイル添付））
• pdf_delivery_and_posting（メール（PDFファイル添付）と郵送）

これにより、取引先への書類送信方法として、新たに上記２つが選択可能になります。

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

(4/30)［販売］freee販売 APIにおいて、事業所コードのバリデーションが強化されました。

変更対象API：
POST /businesses – 案件登録
PATCH /businesses/{id} – 案件更新
変更種別： 破壊的変更あり
変更内容：
リクエストプロパティ code（案件コード）について、以下の変更が行われました：

• null値が許可されなくなりました（必須項目になりました）
• 最小文字数が0文字から1文字に変更されました（空文字列が許可されなくなりました）

注意： 既存のコードで code に null または空文字列を送信している場合、バリデーションエラーが発生します。

(4/30)［販売］freee販売 APIにおいて、納品APIのレスポンスが拡張されました。

変更対象API：
GET /deliveries – 納品一覧の取得
GET /deliveries/{id} – 納品詳細取得
変更種別： 破壊的変更なし
変更内容：
レスポンスに business/closed プロパティが追加されました（案件のロック状態）
GET /deliveries/{id} の詳細レスポンスでは、以下のプロパティが必須項目になりました：

• 会計計上部門の情報（id、name）
• 明細取引タイプの情報（id、name）
• 会計品目タグの情報（id、name）
• 商品情報の情報（id、name）
• メモタグの情報（id、name）
• 税区分の情報（code、name）
• 売上APIのレスポンス拡張

(4/30)［販売］freee販売 APIにおいて、売上APIのレスポンスが拡張されました。

変更対象API：
GET /sales – 売上一覧の取得
GET /sales/{id} – 売上の取得
変更種別： 破壊的変更なし
変更内容：
レスポンスに business/closed プロパティが追加されました（案件のロック状態）
GET /sales/{id} の詳細レスポンスでは、以下のプロパティが必須項目になりました：

• 明細取引タイプの情報（id、name）
• 取引行種別の情報（id、name）
• 会計品目タグの情報（id、name）
• 商品情報の情報（id、name）
• メモタグの情報（id、name）
• 税区分の情報（code、name）
• 勘定科目の情報（id、name）
• 受注APIのレスポンス拡張

(4/30)［販売］freee販売 APIにおいて、受注APIのレスポンスが拡張されました。

変更対象API：
GET /sales_orders – 受注一覧の取得
GET /sales_orders/{id} – 受注の取得
変更種別： 破壊的変更なし
変更内容：
レスポンスに business/closed プロパティが追加されました（案件のロック状態）
GET /sales_orders/{id} の詳細レスポンスでは、以下のプロパティが必須項目になりました：

• 会計計上部門の情報（id、name）
• 明細取引タイプの情報（id、name）
• 会計品目タグの情報（id、name）
• 商品情報の情報（id、name）
• メモタグの情報（id、name）
• 税区分の情報（code、name）

（3/17）[販売] freee販売APIにおいて、事業所情報のレスポンスにプロパティが追加されました。

変更対象API：事業所一覧・詳細 – GET /businesses, GET /businesses/{id}
変更種別：破壊的変更なし
変更内容：

• GET /businesses のレスポンスに任意プロパティ businesses/items/closed（ロック状態）が追加されました
• GET /businesses/{id} のレスポンスに closed（ロック状態、BusinessDigest スキーマ内）が追加されました

（3/18）[販売] freee販売APIにおいて、カスタムフィールド定義に新しい対象タイプが追加されました。
変更対象API：カスタムフィールド定義 – GET /master/custom_fields/business/definitions
変更種別：破壊的変更なし
変更内容：

レスポンスの custom_field_definitions/items/type に以下の新しいenum値が追加されました：

• partner（取引先）
• employee（従業員）
• section（部門）
• master_item（商品）

新しいスキーマ定義として以下が追加されました：

• PartnerCustomFieldDefinition
• EmployeeCustomFieldDefinition
• SectionCustomFieldDefinition
• MasterItemCustomFieldDefinition

上記スキーマに対応するdiscriminatorマッピングキー（employee, section, partner, master_item）が追加されました

（3/18）[販売] freee販売APIにおいて、事業所詳細のカスタムフィールド値にマスタ型が追加されました。

変更対象API：事業所詳細 – GET /businesses/{id}
変更種別：破壊的変更なし
変更内容：

レスポンスの custom_fields/items/value の anyOf リストに CustomFieldMasterValue（マスタ型カスタム項目の値）が追加されました

（3/26）[人事労務] 人事労務APIにおいて、子ども・子育て支援金に関するプロパティが追加されました。
変更対象API：従業員・健康保険ルール

• GET /api/v1/employees
• POST /api/v1/employees
• GET /api/v1/employees/{id}
• PUT /api/v1/employees/{id}
• GET /api/v1/employees/{employee_id}/health_insurance_rule
• PUT /api/v1/employees/{employee_id}/health_insurance_rule

変更種別：破壊的変更なし
変更内容：
以下のプロパティが追加されました：

• child_support_fund_bonus_calc_type（賞与の子ども・子育て支援金計算区分）
• child_support_fund_salary_calc_type（給与の子ども・子育て支援金計算区分）
• manual_child_support_fund_amount_of_company_bonus（会社負担の賞与子ども・子育て支援金額）
• manual_child_support_fund_amount_of_company_salary（会社負担の給与子ども・子育て支援金額）
• manual_child_support_fund_amount_of_employee_bonus（従業員負担の賞与子ども・子育て支援金額）
• manual_child_support_fund_amount_of_employee_salary（従業員負担の給与子ども・子育て支援金額）

追加された対象は以下の通りです：

• レスポンスのみ：GET /api/v1/employees、POST /api/v1/employees、GET /api/v1/employees/{id}、PUT /api/v1/employees/{id}、GET /api/v1/employees/{employee_id}/health_insurance_rule
• リクエストおよびレスポンス：PUT /api/v1/employees/{employee_id}/health_insurance_rule

（2/16）[販売]販売APIに納品と売上の管理APIが追加されました。

変更対象API：販売 API
変更種別：破壊的変更なし
変更内容：

• GET /deliveries（納品の一覧取得）
• POST /deliveries（納品の登録）
• GET /deliveries/{id}（納品の詳細取得）
• PATCH /deliveries/{id}（納品の更新）
• GET /sales（売上の一覧取得）
• POST /sales（売上の登録）
• GET /sales/{id}（売上の詳細取得）
• PATCH /sales/{id}（売上の更新）

（1/13）[販売]販売APIで案件、受注の部分更新が可能になりました。
変更対象API：販売 API
変更種別：破壊的変更なし
変更内容：
以下の2つの新しいAPIエンドポイントが追加されました：

• PATCH /businesses/{id}（案件の部分更新）
  • 案件の部分的な更新が可能になります
• PATCH /sales_orders/{id}（受注の部分更新）
  • 受注の部分的な更新が可能になります

（1/21）[会計]会計APIで経費科目テンプレートの参照元情報を取得可能になりました。
変更対象API：会計 API
変更種別：破壊的変更なし
変更内容：経費科目テンプレート APIのレスポンスに、新しい必須プロパティ source_line_template_id が追加されます。この変更により、経費科目テンプレートの参照元情報を取得できるようになります。

以下の4つのAPIエンドポイントのレスポンスに、新しい必須プロパティ source_line_template_id が追加されました：

• GET /api/1/expense_application_line_templates（経費科目テンプレート一覧の取得）
  • レスポンスの expense_application_line_templates/items 内に source_line_template_id プロパティを追加
• POST /api/1/expense_application_line_templates（経費科目テンプレートの作成）
  • レスポンスの expense_application_line_template 内に source_line_template_id プロパティを追加
• GET /api/1/expense_application_line_templates/{id}（経費科目テンプレートの取得）
  • レスポンスの expense_application_line_template 内に source_line_template_id プロパティを追加
• PUT /api/1/expense_application_line_templates/{id}（経費科目テンプレートの更新）
  • レスポンスの expense_application_line_template 内に source_line_template_id プロパティを追加

（12/01）[人事労務] 従業員のグループ所属情報の取得APIの追加および年末調整APIにおけるバリデーションの変更が行われました。

変更対象API： 従業員のグループ所属情報の取得 – /api/v1/employees/{employee_id}/group_memberships
変更種別： 新規追加
変更内容：従業員が所属するグループ（部門等）の情報を取得するエンドポイントが新規追加されました。

変更対象API： 年末調整（扶養家族・本人情報） – /api/v1/yearend_adjustments/...
変更種別： 破壊的変更なし
変更内容：

• 以下のプロパティにおいて、最小値（min）が 0.00 から -999999999.00 に引き下げられ、マイナスの値を許容するようになりました。
  • 扶養家族情報：all_other_income（その他の所得合計額）, employment_revenue（給与収入）
  • 本人情報：all_other_income（合計所得金額見積額）, other_company_revenue（他社給与収入）

（12/10, 12/15, 12/22）[販売] freee販売 APIにおいて、ステータス定義の刷新を含む大幅な仕様変更が行われました。

変更対象API： 取引先・受注 – /businesses, /sales_orders
変更種別： 破壊的変更あり
変更内容：代わりに billed, delivered, not_billed, partially_billed など、より詳細な状態を示す値が追加されました。

• ステータスEnumの大幅変更（12/15）各種ステータス（請求、納品、回収、売上）において、従来の todo / doing / done が削除されました。
• リクエストパラメータの任意項目化・Null許容変更（12/10, 12/22）
  • 取引先作成時の name や、受注作成時の customer_id, sales_order_date, lines 等の多くの項目が必須から任意（Optional）に変更されました。
  • 取引先作成時、business_date と code がNull許容となった一方、prospect_sales_order はNull不可となりました。
• レスポンス構造の変更（12/10, 12/15）
  • POST時のレスポンスに id, last_updated_at, registered_at が必須項目として含まれるようになりました。
  • 受注詳細取得において、明細行（lines）の id が必須ではなくなりました。
• 新規プロパティの追加（12/22）
  • 受注情報に canceled（キャンセルフラグ）プロパティが追加されました。
  • 取引先情報に last_updated_by（最終更新者）などの監査用プロパティが追加されました。
    

（12/16）[会計] 事業所詳細取得APIにおいて、会計年度のIDが含まれるようになりました。
変更対象API： 事業所の詳細取得 – /api/1/companies/{id}
変更種別： 破壊的変更なし
変更内容：

• レスポンスの fiscal_years（会計年度）オブジェクトに、年度を特定するための id プロパティが追加されました。

（12/23）[人事労務] 勤怠管理APIにおいて、所定休日労働時間に関するプロパティが追加されました。

変更対象API： 勤怠情報 – /api/v1/employees/{employee_id}/work_records, /work_record_summaries
変更種別： 破壊的変更なし
変更内容：

• 日次の勤怠および月次の勤怠要約情報において、total_prescribed_holiday_work_mins（所定休日労働時間）がリクエストおよびレスポンスに追加されました。これにより、API経由で所定休日の労働時間の取得・更新が可能になります。