All posts by freee

2026年1月の更新情報

(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 プロパティを追加

サービスメンテナンス(2/4)のお知らせ

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2026/2/4 (水) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

2025年12月の更新情報

(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経由で所定休日の労働時間の取得・更新が可能になります。

サービスメンテナンス(1/22)のお知らせ

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2026/1/22 (木) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

【重要】freee人事労務 API変更のお知らせ

■ 概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2026年1月末頃より、freee人事労務のweb版で休暇の同日取得機能が拡張され、特別休暇を含む以下の組み合わせが新たに登録可能になります。

  • 年次有給休暇 × 特別休暇
  • 特別休暇 × 特別休暇

現時点でpublic APIはこの機能に未対応のため、同日取得されたデータを含むリクエストはエラーとなります。

エラー例

{
    "status_code": 400,
    "errors": [
        {
            "type": "bad_request",
            "messages": [
                "特別休暇が2つ登録されています。Webで確認してください。"
            ]
        }
    ]
}

API対応時期は未定です。

①勤怠の取得では、「特別休暇と特別休暇」の組み合わせの場合で同日取得されたデータはエラーとなります。

②勤怠の更新では、「年次有給休暇と特別休暇」及び「特別休暇と特別休暇」の組み合わせで同日取得されたデータはエラーとなります。

③勤怠情報サマリのgetでwork_recordsオプションをtrueで指定した場合、「特別休暇と特別休暇」の組み合わせで同日取得されたデータが1日でも存在するとエラーとなります。

API対応時期は決まり次第改めてお知らせいたします。

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日:2025/12/22

変更リリース予定日:2026年1月末予定

2025年11月の更新情報

(11/12)[販売]freee販売のAPIスキーマが新規に公開されました。スキーマファイルのtitleには「freee販売 API (β版)」と記載されています。

変更対象API:freee販売 API – https://api.freee.co.jp/sm
変更種別:新規追加
変更内容:

  • freee販売のAPIスキーマが新規に公開されました
  • OAuth2.0による認証
  • JSON形式でのリクエスト・レスポンス

(11/25)[請求書・見積書・納品書]請求書・見積書・納品書APIにおいて、データ型の変更および最大値の変更が行われました。

変更対象API:請求書 – /invoices
変更種別:破壊的変更なし
変更内容:

  • payment_type の enum 値に「card」(カード払い)が追加されました
  • tax_rate プロパティの型が整数型(integer)から数値型(number)に変更されました
  • 複数のプロパティの最大値が「9223372036854774784.00」に変更されました
  • created_at プロパティの型/フォーマットが「string/date-time」から「string」に変更されました


変更対象API:見積書 – /quotations
変更種別:破壊的変更なし
変更内容:

  • tax_rate プロパティの型が整数型(integer)から数値型(number)に変更されました
  • 複数のプロパティの最大値が「9223372036854774784.00」に変更されました
  • created_at プロパティの型/フォーマットが「string/date-time」から「string」に変更されました


変更対象API:納品書 – /delivery_slips
変更種別:破壊的変更なし
変更内容:

  • tax_rate プロパティの型が整数型(integer)から数値型(number)に変更されました
  • 複数のプロパティの最大値が「9223372036854774784.00」に変更されました
  • created_at プロパティの型/フォーマットが「string/date-time」から「string」に変更されました

以上です。
よろしくお願いいたします。

サービスメンテナンス(12/16)のお知らせ

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2025/12/16 (火) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

2025年10月の更新情報

(10/23)[人事労務]freee人事労務APIにおいて、有給申請APIのタグ名が変更され、年末調整APIに団体生命保険に関するプロパティが追加されました。
変更対象API:有給休暇申請API – /api/v1/approval_requests/paid_holidays
変更種別:破壊的変更なし

(10/23)[人事労務]APIタグ名が「有給申請」から「有給休暇申請」に変更されました。
変更対象API:年末調整API – /api/v1/yearend_adjustments/{year}/employees/{employee_id}
変更種別:破壊的変更なし

(10/23)[人事労務]レスポンスに団体生命保険かどうかを示す is_group_insurance プロパティが追加されました。
変更対象API:年末調整保険情報登録API – /api/v1/yearend_adjustments/{year}/insurances/{employee_id}
変更種別:破壊的変更なし

(10/23)[人事労務]リクエストならびにレスポンスに団体生命保険かどうかを示す is_group_insurance プロパティが追加されました。
変更対象API:年末調整保険情報更新API – /api/v1/yearend_adjustments/{year}/insurances/{employee_id}/{id}
変更種別:破壊的変更なし

以上です。
よろしくお願いいたします。

【重要】[人事労務 年末調整API] 仕様変更のお知らせ

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

freee人事労務 年末調整APIのリクエストパラメータ仕様を一部変更します。

従業員の「給与以外の所得」や「その他の事業所の給与収入」、配偶者の「給与収入」「給与以外の所得」にマイナス値を設定できるようになります。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API:freee人事労務 年末調整API
変更種別:Non-Breaking Change
変更内容:

 – 年末調整従業員情報の更新API

  – 「all_other_income(給与以外の所得)」と「other_company_revenue(その他の事業所の給与収入)」の最小値を0から-999999999に変更します

 – 年末調整家族情報の更新API

  – 「all_other_income(給与以外の所得)」と「employment_revenue(給与収入)」の最小値を0から-999999999に変更します

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

アナウンス日:2025/11/19
変更リリース予定日:2025/11/20

サービスメンテナンス(11/26)のお知らせ

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2025/11/26 (水) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

2025年9月の更新情報

(9/18)[会計]廃止済みの以下のAPIの記載をリファレンス上から削除しました

  • 請求書の作成
  • 請求書の更新
  • 請求書の削除
  • 見積書の作成
  • 見積書の更新
  • 見積書の削除

以上です。
よろしくお願いいたします。

サービスメンテナンス(10/23)のお知らせ

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2025/10/23 (木) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

サービスメンテナンス(9/24)のお知らせ

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2025/09/24 (水) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

2025年8月の更新情報

(8/5)[請求書・納品書・見積書]請求書・納品書・見積書APIにおいて、備考欄のパラメータの最小文字数制限が緩和されました。

■ 変更内容
変更内容:

  • 以下のAPIにおいて備考欄パラメータの文字数制限が1文字から0文字に緩和されましたに緩和されました
    • 納品書API(/delivery_slips): delivery_slip_note パラメータ
    • 請求書API(/invoices): invoice_note パラメータ
    • 見積書API(/quotations): quotation_note パラメータ

対象エンドポイント:

  • 納品書の作成(POST /delivery_slips)
  • 納品書の更新(PUT /delivery_slips/{id})
  • 請求書の作成(POST /invoices)
  • 請求書の更新(PUT /invoices/{id})
  • 見積書の作成(POST /quotations)
  • 見積書の更新(PUT /quotations/{id})

以上です。
よろしくお願いいたします。

2025年7月の更新情報

(7/24)[会計]segmentタグAPIのリクエストのnameの最大長が30文字から100文字に変更になりました。

対象エンドポイント:
/api/1/segments/{segment_id}/tags セグメントタグの作成
/api/1/segments/{segment_id}/tags/{id} セグメントタグの更新
/api/1/segments/{segment_id}/tags/code/upsert セグメントタグの更新(作成)

以上です。
引き続きよろしくお願いいたします。

【重要】[人事労務API] ロール識別子の変更のお知らせ

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

勤怠部門管理者の role が self_only から attendance_manager に変更されます。

お客様のアプリケーションに影響を与える可能性があります。お手数ですが、以下の内容をご確認の上、ご対応をお願いいたします。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API:freee人事労務 API
変更種別:Breaking Change

変更内容:

 – /api/v1/users/me (ログインユーザーの取得) のレスポンスが変更されます。

条件: 勤怠部門管理者で当該 API を呼び出した場合
差分: role の値が self_only から attendance_manager に変化

変更理由:利便性のため。これまで一般と勤怠部門管理者は同じ self_only であったため区別が付きませんでした。

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

アナウンス日:2025年8月21日
変更リリース予定日:2025年9月21日以降

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

お使いのアプリケーションで、role の値を確認している箇所がないかご確認いただき、必要に応じて修正をお願いいたします。

GET /api/v1/users/me を利用し、レスポンスに含まれる role の値が self_only であることを前提とした処理を実装している場合に影響があります。

■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

エンドポイント:/api/v1/users/me
リクエスト:GET

勤怠部門管理者が API を呼び出した場合の role が変化します:

修正前:

{
  "id": 1,
  "companies": [
    {
      "id": 100,
      "name": "株式会社フリー",
      "role": "self_only",
      "external_cid": "000-000-000",
      "employee_id": 10,
      "display_name": "フリー太郎"
    }
  ]
}

修正後:

{
  "id": 1,
  "companies": [
    {
      "id": 100,
      "name": "株式会社フリー",
      "role": "attendance_manager",
      "external_cid": "000-000-000",
      "employee_id": 10,
      "display_name": "フリー太郎"
    }
  ]
}

サービスメンテナンス(8/19)のお知らせ

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2025/08/19 (火) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

【重要】[freee人事労務API] 変更のお知らせ

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

従業員番号(num)フィールドが未設定の場合に返却していた null を廃止し、今後は空文字列 (“”) を返却します。

レスポンス型そのものは string のままのため、ほとんどのアプリは改修不要ですが、null を前提に実装している場合はご確認をお願いします。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API:freee人事労務 Public API

変更種別:Non-Breaking Change

変更内容:

1. レスポンスの変更

GET系リクエストおよびPOST/PUT後のレスポンスにおいて、numが未設定の場合はnullではなく空文字列 (“”) を返却します。
POST /employees などでnumを省略して作成した従業員も、取得時には空文字列を返却します。

2. APIリファレンスの更新

現在、nullで返却されているnumは、変更後は空文字で返却されるようになります。
レスポンスのnumは常にstringとなるため、nullable:trueを削除します。

対象エンドポイントは以下の通りです。

  • 賞与明細:
    • GET /bonuses/employee_payroll_statements
    • GET /bonuses/employee_payroll_statements/{id}
  • 従業員:
    • GET /company/employees
    • GET /employees
    • GET /employees/{id}
    • POST /employees
    • PUT /employees/{id}
  • 所属:
    • GET /employee_group_memberships
  • 年末調整:
    • GET /yearend_adjustment/employees
    • GET /yearend_adjustment/employees/{id}
    • PUT /yearend_adjustment/employees/{id}
  • 給与明細:
    • GET /salaries/employee_payroll_statements
    • GET /salaries/employee_payroll_statements/{id}


変更理由:

null と空文字列が混在しているため、未設定値を空文字列に統一します。

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

アナウンス日:2025/07/24

変更リリース予定日:2025/09/01

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

バリデーションやシリアライズで num を optional string として扱っている場合は変更不要です。

SDK/型定義をコード生成している場合、更新後に nullable:false へ変わりますので、 型定義の再生成を推奨します。

■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

エンドポイント例:GET /employees/{id}

【変更前】

{

“id”: 123,

“num”: null,

}

【変更後】

{

“id”: 123,

“num”: “”,

}

(POST /employees で num を省略してリクエストしても、レスポンスには “” が返却されます)

2025年6月の更新情報

(6/5)[人事労務]給与明細の取得で法定福利費の会社負担分の合計(健康保険、厚生年金、雇用保険等)を取得できるようになりました。

対象エンドポイント:
給与明細の取得 – /api/v1/salaries/employee_payroll_statements/{employee_id}

詳細:
レスポンスにtotal_deduction_employer_share(法定福利費の会社負担分の合計(健康保険、厚生年金、雇用保険等))が追加されました。

(6/26)[人事労務]所属一覧の取得で上司IDを取得できるようになりました。

対象エンドポイント:
所属一覧の取得 – /api/v1/employee_group_memberships

詳細:
レスポンスにboss_id(上司ID)が追加されました。

(6/16)[請求書]API使用制限の変更

詳細:
APIリクエストは1時間で3000回、1分で50回を上限から1時間で1500回、1分で30回を上限に変更されました。

(6/25)[会計]取引先コードをキーに、指定した取引先の情報を更新(存在しない場合は作成)できるようになりました。

対象エンドポイント:
取引先の更新(存在しない場合は作成) – /api/1/partners/upsert_by_code

詳細:
取引先の更新(存在しない場合は作成)APIが新規追加されました。

(6/25)[会計]勘定科目一覧の取得において、更新日での期間絞り込みが可能になりました。

対象エンドポイント:
勘定科目一覧の取得 – /api/1/account_items

詳細:
勘定科目一覧の取得時のパラメーターにstart_update_date(更新日で絞込:開始日)、end_update_date(更新日で絞込:終了日)が追加されました。

(6/25)[会計]勘定科目コードをキーに、指定した勘定科目の情報を更新(存在しない場合は作成)できるようになりました。

対象エンドポイント:
勘定科目の更新(存在しない場合は作成) – /api/1/account_items/code/upsert

詳細:
勘定科目の更新(存在しない場合は作成)APIが新規追加されました。

(6/25)[会計]指定した事業所の部門を更新できるようになりました。

対象エンドポイント:
部門の更新(存在しない場合は作成) – /api/1/sections/code/upsert

詳細:
部門の更新(存在しない場合は作成)APIが新規追加されました。

(6/25)[会計]品目コードをキーに、指定した品目の情報を更新(存在しない場合は作成)できるようになりました。

対象エンドポイント:
品目の更新(存在しない場合は作成) – /api/1/items/code/upsert

詳細:
品目の更新(存在しない場合は作成)APIが新規追加されました。

(6/25)[会計]セグメントタグコードをキーに、指定したセグメントタグの情報を更新(存在しない場合は作成)できるようになりました。

対象エンドポイント:
セグメントタグの更新(存在しない場合は作成) – /api/1/segments/{segment_id}/tags/code/upsert

詳細:
セグメントタグの更新(存在しない場合は作成)APIが新規追加されました。

以上です。
引き続きよろしくお願いいたします。

【重要】[請求書API] 変更のお知らせ

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

既定の備考テンプレートがfreee請求書で設定されている場合、その備考テンプレートから備考の内容を補完するようになりました。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API:freee請求書 API v1

変更種別:Non-Breaking Change

変更内容:

 – 各帳票(請求書、納品書、見積書)のPOST時に、各帳票の備考に対応するkeyが存在しておらず、freee請求書で既定の備考テンプレートが設定されている場合、その備考テンプレートから備考の内容を補完する形で各帳票を作成するように変更

変更理由:これまで請求書APIにおいて、freee請求書の既定テンプレートが参照できない状態であり、そのため複数の備考テンプレートを活用しないシンプルな運用であっても、帳票発行元のデータとして備考データを保存する仕組みを開発する必要がありました。これを既定の備考テンプレートを活用可能にすることで、比較的シンプルな利用要件における開発負荷の軽減、及び利用者の便益を向上することを目的としております。

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

アナウンス日:2025/07/17
変更リリース日:2025/07/09

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

今回の変更は破壊的変更ではないため、既存の動作に影響はなく、対応は不要です。

ただし、希望される方は以下の操作を行うことで、freee請求書の既定の備考テンプレートに設定した内容を帳票の備考として補完して帳票を作成できるようになります。

1. freee請求書Webにログインし、各帳票種別ごとに既定の備考テンプレートを設定する

2. 請求書APIにて各帳票の備考に対応するkeyを、空文字やnullでなくkeyとして存在しない形でパラメータとして送信する

※各keyの値を送信すれば、APIの値がfreee請求書Webの既定テンプレートの値よりも優先されます。

各帳票の備考に対応するkeyは以下の通りです。

・納品書: delivery_slip_note

・請求書: invoice_note

・見積書: quotation_note

上記に関して、詳細は以下のヘルプページを御覧ください。

▼ 【ヘルプセンター】備考テンプレートを設定する
https://support.freee.co.jp/hc/ja/articles/18531082542745

■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

エンドポイント:/delivery_slips
リクエスト:POST
key「delivery_slip_note」に「変更内容」に記載した変更が適用されます

エンドポイント:/invoices
リクエスト:POST
key「invoice_note」に「変更内容」に記載した変更が適用されます

エンドポイント:/quotations
リクエスト:POST
key「quotation_note」に「変更内容」に記載した変更が適用されます