All posts by freee

2026年4月の更新情報

(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ファイル添付)と郵送)

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

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

(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)

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

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

・日時: 2026/05/19 (火) 1:00 – 5:00
・対象: freee 全サービス(電子公告サイト含まず)

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

【重要】【freee会計】自動登録ルールAPIが新たに公開されました

freee会計APIにおいて、自動登録ルールの操作が可能になりました。

freee会計APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、必要に応じてアプリへの組み込みをご検討いただきますよう、よろしくお願い申し上げます。

概要
━━━━━━━━━━━━━━━━━━━━━━

freee会計APIに自動登録ルール(user_matchers)エンドポイントが新たに公開されました。 

自動登録ルールの取得・作成・更新・削除をAPIから操作できるようになります。

■ 対象エンドポイント
━━━━━━━━━━━━━━━━━━━━━━

– 自動登録ルールの削除(DELETE /api/1/user_matchers/{id})

– 自動登録ルール一覧の取得(GET /api/1/user_matchers) 

– 自動登録ルールの更新(GET /api/1/user_matchers/{id}) 

– 自動登録ルールの作成(POST /api/1/user_matchers) 

– 自動登録ルールの更新(PUT /api/1/user_matchers/{id}) 

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

2026/04/06(リリース済み)

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

新規エンドポイントの追加のため、既存のAPI利用に影響はありません。

自動登録ルールの操作をアプリに組み込む場合は、APIリファレンスをご参照ください。

【重要】freee会計のAPIの仕様変更のお知らせ

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

取引(収入・支出)の作成・更新時における明細行の上限を、40行から100行へ拡大いたしました。

これまで最大40行だった取引の明細行が、最大100行まで操作可能になります。

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

変更対象API:

  • POST /api/1/deals 取引(収入・支出)の作成
  • PUT /api/1/deals 取引(収入・支出)の更新

変更種別:Non-Breaking Change

変更内容:

 – 作成・更新時における明細行の上限を、40行から100行へ拡大いたしました。

変更理由:

 – 業務要件上、40明細では足りないケースが増えてきたため

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

アナウンス日:2026/04/27
変更リリース予定日:2026/04/23
旧バージョン廃止予定日:該当しない

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

エンドポイント:/api/1/deals(変更なし)

2026年3月の更新情報

(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

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

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

・日時: 2026/04/23 (木) 1:00 – 5:00
・対象: freee 全サービス(電子公告サイト含む)

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

【重要】アプリの権限(Scope)更新時の挙動変更

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

freeeアプリストアにおいて、アプリの権限(Scope)更新時における既存アクセストークンの挙動を変更します。

freee APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

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

変更種別:[Breaking Change]
変更内容:

アプリのScope(権限)追加を含む変更申請がfreeeによって承認された際の、既存アクセストークンの扱いを以下のとおり変更します。

【現在】
変更申請の承認時に、そのアプリに紐づく全利用者のアクセストークンが即座に無効化されます。利用者は再認可を行うまでアプリから全てのAPIを利用できません。

ステータスコード:401

エラーメッセージ:「アプリのバージョンが更新されてデータアクセス範囲が追加されています。再度認可をしてください。」

【変更後】
変更申請の承認後も、既存のアクセストークンは有効なまま維持されます。利用者が新しいScopeを必要とする機能を利用するタイミングで、初めて再認可が必要となります。

ステータスコード:403

エラーメッセージ:「このアプリケーションにはアクセス権限がないエンドポイントです」

変更理由:

現在の仕様では、Scope更新の承認直後に全トークンが無効化されるため、バッチ処理を行うアプリにおいて処理が突然失敗するなど、利用者の業務に影響を与えるケースが発生しておりました。本変更により、既存機能の利用を中断することなく、利用者が任意のタイミングで新しい権限を認可できるようになります。

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

アナウンス日:2026/04/08
変更リリース予定日:2026/04/08

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

変更後は、利用者が新しいScopeを必要とするAPIエンドポイントを呼び出した際に、403エラーが返却されます。このエラーを検知した場合に、利用者を認可画面へ適切にリダイレクトする実装をお願いいたします。

【重要】販売案件登録・変更APIにおける案件コードの必須項目変更のお知らせ

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

案件登録と案件更新の任意項目「code : 案件コード」が必須項目になります。

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

変更対象API:freee販売APIの案件登録と案件更新
変更種別:Breaking Change
変更内容:


 – 案件登録の任意項目「code : 案件コード」が必須項目になります。
 – 案件更新の任意項目「code : 案件コード」が必須項目になります。


変更理由:freee販売の案件登録・編集時の案件コードの入力が必須になるため

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

アナウンス日:2026/03/31
変更リリース予定日:2026/04/30

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

今後は案件コードを指定していただく必要があります。
案件コードの自動採番設定がONの場合は、コードを指定しなければ自動採番されたコードが活用されます。

ただし更新APIについては既に販売案件に案件コードが入っている場合は指定していなくても問題ないです。

サービスメンテナンス(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対応時期は未定です。

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

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

③勤怠情報サマリの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の全サービス (電子公告サービス除く)

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