【重要】freee販売 API仕様変更およびメンバーID追加のお知らせ

【重要】freee販売 API仕様変更およびメンバーID追加のお知らせ

■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

freeeにおける「メンバー管理方法」の変更に伴い、freee販売APIにおいてプロダクト共通の「メンバーID」の追加、および関連するAPI仕様の変更を行います

■ 変更・追加内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

対象API：freee販売 公開API（全12ドメイン、および新規マスタAPI）

変更種別：Breaking Change

内容：

  • 共通のメンバー情報を取得するためのAPI GET /api/public/master/members を新設します。
  • 既存の従業員情報を取得するAPI GET /api/public/master/employees は非推奨（廃止時期未定）となります。
  • freee販売の各ドメインAPIのリクエストに、charge_member_id および charge_member_ids[] 等を追加します。
  • freee販売の各ドメインAPIのレスポンスに、charge_member / registered_by_member / last_updated_by_member を追加します。
  • 既存の従業員IDに関連するリクエストおよびレスポンスフィールド（charge_employee_id 等）は非推奨（廃止時期未定）となります。

▼ 背景・理由

表示名・従業員番号・所属といったメンバーの「基本情報」をプロダクト共通で利用・管理できるようにするための変更です。

■ スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2026/07/23

リリース予定日：2026年9月上旬～中旬（予定）

旧バージョン廃止予定日：未定（旧パラメータの完全廃止時期は、決定次第追ってお知らせいたします）

■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

本リリース以降に新しく招待・追加されたメンバーには、従来の「旧従業員ID（employee_id）」が発番されなくなります。

そのため、新しく追加されたメンバーに対してAPI経由で「担当者の割り当て（POST/PATCH）」や「担当者での絞り込み（GET）」を行う場合、旧API仕様のままでは対象者が表示されないといった影響が発生します。

開発者の皆様におかれましては、リリース予定日以降、以下の通りシステム改修をお願いいたします。

  1. 新設される GET /api/public/master/members より「メンバーID（id）」を取得するように処理を変更してください。
  2. 各業務APIへのリクエスト時、従来の charge_employee_id に代わり、新設される charge_member_id （および一覧取得時は charge_member_ids[] ）にメンバーIDを指定するように実装を変更してください。

※既存メンバーのデータのみを参照・更新し、新しく追加されるメンバーを考慮しない場合は、直ちに影響はありません。ただし、今後の新規メンバー追加に対応するため、お早めにメンバーIDへの移行をお願いいたします。

■ 変更・追加後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

各ドメインAPI（GET/POST/PATCH）において、以下の通りパラメータが追加・変更されます 。

  1. 新規追加されるAPI
    • マスタAPI（メンバー）
      • GET /api/public/master/members (新設)
  2. 仕様が変更されるドメインAPI（計12ドメイン）
    ※GET（一覧）のリクエストに charge_member_ids[] が追加されます。
    また、GET（一覧/詳細）のレスポンスに charge_member / registered_by_member / last_updated_by_member が追加されます。
    POST / PATCHのリクエストには charge_member_id が追加されます。
    • 案件API（Businesses）
      • 案件一覧 GET /api/public/businesses
      • 案件登録 POST /api/public/businesses
      • 案件詳細取得 GET /api/public/businesses/{id}
      • 案件更新 PATCH /api/public/businesses/{id}
    • 原価予算API（Cost Budgets）
      • 原価予算一覧 GET /api/public/cost_budgets
      • 原価予算登録 POST /api/public/cost_budgets
      • 原価予算詳細取得 GET /api/public/cost_budgets/{id}
      • 原価予算更新 PATCH /api/public/cost_budgets/{id}
    • 納品API（Deliveries）
      • 納品一覧 GET /api/public/deliveries
      • 納品登録 POST /api/public/deliveries
      • 納品詳細取得 GET /api/public/deliveries/{id}
      • 納品更新 PATCH /api/public/deliveries/{id}
    • 関連マスタAPI（Master）
      • 案件カスタム項目定義一覧 GET /api/public/master/custom_fields/business/definitions　（input形式として「member」が設定されたカスタム項目が登録されている場合、レスポンスにその項目が含まれるようになります ）
    • その他原価API（Other Costs）
      • その他原価一覧 GET /api/public/other_costs (レスポンスに registered_by_member 他を追加)
      • その他原価詳細取得 GET /api/public/other_costs/{id}
    • 定期売上API（Periodic Sales）
      • 定期売上一覧 GET /api/public/periodic_sales
      • 定期売上登録 POST /api/public/periodic_sales
      • 定期売上取得 GET /api/public/periodic_sales/{id}
      • 定期売上更新 PATCH /api/public/periodic_sales/{id}
      • 売上計上状況取得 GET /api/public/periodic_sales/{id}/sales_entries
    • 仕入API（Procurements）
      • 仕入一覧 GET /api/public/procurements
      • 仕入登録 POST /api/public/procurements
      • 仕入詳細取得 GET /api/public/procurements/{id}
      • 仕入更新 PATCH /api/public/procurements/{id}
    • 発注API（Purchase Orders）
      • 発注一覧 GET /api/public/purchase_orders
      • 発注登録 POST /api/public/purchase_orders
      • 発注詳細取得 GET /api/public/purchase_orders/{id}
      • 発注更新 PATCH /api/public/purchase_orders/{id}
    • 見積API（Quotations）
      • 見積一覧 GET /api/public/quotations
      • 見積登録 POST /api/public/quotations
      • 見積詳細取得 GET /api/public/quotations/{id}
      • 見積更新 PATCH /api/public/quotations/{id}
    • 売上API（Sales）
      • 売上一覧 GET /api/public/sales
      • 売上一覧 POST /api/public/sales
      • 売上詳細取得 GET /api/public/sales/{id}
      • 売上更新 PATCH /api/public/sales/{id}
    • 受注API（Sales Orders）
      • 受注一覧 GET /api/public/sales_orders
      • 受注一覧 POST /api/public/sales_orders
      • 受注詳細取得 GET /api/public/sales_orders/{id}
      • 受注更新 PATCH /api/public/sales_orders/{id}
    • 売上予定API（Sales Schedules）
      • 売上予定一覧 GET /api/public/sales_schedules
      • 売上予定詳細取得 GET /api/public/sales_schedules/{id}
      • 売上予定更新 PATCH /api/public/sales_schedules/{id}
    • 前受金API（Advance Receipts）★2026年7月末リリース予定
      • GET /api/public/advance_receipts
      • POST /api/public/advance_receipts
      • GET /api/public/advance_receipts/{id}
      • PATCH /api/public/advance_receipts/{id}
      • POST /api/public/advance_receipts/{id}/reduction
      • POST /api/public/advance_receipts/{id}/periodic_reduction
  3. 【参考】新規追加されるレスポンスの構造イメージ（charge_member 等）
    【参考】案件詳細取得API（GET /api/public/businesses/{id}）などのレスポンス追加イメージ

    JSON
"charge_member": {
  "id": "DSDDDRWTNKL...",
  "display_name": "田中太郎"
}