All posts by freee

ニュース

サービスメンテナンス（3/18）のお知らせ

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

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

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

リリースノート

2026年2月の更新情報

（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}（売上の更新）
リリースノート

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対応時期は未定です。

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

人事労務APIリファレンス

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

人事労務APIリファレンス

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

人事労務APIリファレンス

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 を省略してリクエストしても、レスポンスには “” が返却されます）