KatoShoma のすべての投稿

ニュース

システムメンテナンス(11/21)のお知らせ

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

日時：2023/11/21 (火) 1:00 – 5:00

対象：freee 全サービス（電子公告サービス除く）

メンテナンス中は該当サービスをご利用いただけません。

ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

ニュース

【freee人事労務】API仕様の変更について（勤怠API、勤怠情報サマリAPI）

freee人事労務APIにおいて、以下の仕様変更があります。

  • 勤怠APIのリクエストボディとレスポンス、勤怠情報サマリAPIのレスポンスに変更があります。
  • 勤怠APIで特別休暇および有給休暇（時間休）の勤怠登録が可能になります。
  • 勤怠APIでの有給休暇（半休）の勤怠登録に変更があります。

この変更は2段階に分けて行います。

変更内容①は11月中旬に、破壊的な変更を含む変更②は2024年2月上旬に行います。

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

変更内容①:

freee人事労務 勤怠の取得API、勤怠の更新APIのリクエストボディとレスポンス、および勤怠情報月次サマリの取得API（work_records=trueの場合）のレスポンスに以下の項目を追加します。

  • half_paid_holiday_mins ：有給休暇の半休を利用した時間（分単位）
  • special_holiday ：この日の特別休暇取得数
  • special_holiday_setting_id ：特別休暇設定ID
  • half_special_holiday_mins ：特別休暇の半休を利用した時間（分単位）
  • hourly_special_holiday_mins ：特別休暇の時間休を利用した時間（分単位）

freee人事労務 勤怠の更新APIにおいて、特別休暇の登録が可能になります。

  • 特別休暇（全休）は、special_holiday_setting_idとspecial_holiday=1を指定してください。
  • 特別休暇（半休）は、special_holiday_setting_idとhalf_special_holiday_minsを指定してください。
  • 特別休暇（時間休）は、special_holiday_setting_idとhourly_special_holiday_minsを指定してください。

freee人事労務 勤怠の更新APIにおいて、有給休暇（時間休）の登録が可能になります。

  • hourly_paid_holiday_minsを指定してください。

freee人事労務 勤怠の更新APIにおいて、有給休暇（半休）の登録方法に変更があります。

  • half_paid_holiday_minsを指定してください。
  • なお非推奨ではありますが、現行の有給休暇（半休）登録方法も引き続き使用できます。
    • normal_work_mins_by_paid_holiday（有給によって計上される所定労働時間（分））を指定します。paid_holiday（この日の有給休暇取得数）=0.5は入力不要です（入力してもエラーにはなりません）。

対象エンドポイント:

  • 勤怠の取得API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
  • 勤怠の更新API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
  • 勤怠情報月次サマリの取得API（/api/v1/employees/{employee_id}/work_record_summaries/{year}/{month}）

変更理由:

  • freee人事労務の特別休暇をAPIで登録できるようにするためです。
  • freee人事労務の有給休暇（時間休）をAPIで登録できるようにするためです。
  • 有給休暇（半休）登録方法の移行期間を設けます。現行の登録方法も利用可能とするこの期間内に、アプリの改修など必要な対応を完了していただくためです。

変更の実施時期:

  • 2023年11月中旬

変更内容②:（破壊的な変更を含む）

freee人事労務 勤怠の取得API、勤怠の更新API、勤怠情報月次サマリの取得API(work_records)のレスポンスから、以下の項目を廃止します。

  • normal_work_mins_by_paid_holiday：有給によって計上される所定労働時間（分）

freee人事労務 勤怠の更新APIのリクエストボディから、以下の項目を廃止します。

  • normal_work_mins_by_paid_holiday：有給によって計上される所定労働時間（分）
  • このため、現行の有給休暇（半休）登録方法が使用できなくなります。
  • normal_work_mins_by_paid_holidayに時間を指定しても、有給休暇（半休）の登録はできなくなります。
  • paid_holiday（この日の有給休暇取得数）は1（全休）以外を指定するとエラーになります。

対象エンドポイント:

  • 勤怠の取得API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
  • 勤怠の更新API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
  • 勤怠情報月次サマリの取得API（/api/v1/employees/{employee_id}/work_record_summaries/{year}/{month}）

変更理由:

  • 勤怠APIの有給休暇（半休）登録方法の変更に伴う移行対応期間を終了します。
  • ※変更の実施時期までに、アプリの改修など必要な対応を完了してください。

変更の実施時期:

  • 2024年2月上旬
リリースノート

【重要】 freee工数管理APIの仕様変更について

freee工数管理のPublic APIにおいて、一部エンドポイントのパラメーターを廃止します。
freee工数管理は、これまで提供していた一部の機能の提供を終了します。
※提供を終了する機能の詳細については、下記ページをご参照ください。
freee工数管理の提供機能の変更について

それに伴い、freee工数管理のPublic APIからも一部のパラメーターが削除されますのでご連絡いたします。

変更内容

対象エンドポイント一覧

  • GET /projects プロジェクト一覧の取得
  • GET /projects/{id} プロジェクト詳細の取得
  • POST /projects プロジェクトの登録

削除内容詳細

GET /projects プロジェクト一覧の取得

  • projects配下の以下のパラメーター
    • sales_budget (売上・予算)
    • expense_budget (支出・予算)
    • profit_budget(粗利・予算)
    • sales_actual(売上・実績)
    • expense_actual(支出・実績)
    • profit_actual(粗利・実績)

GET /projects/{id} プロジェクト詳細の取得

  • balance配下の以下のパラメーター
    • summary(収支サマリ)
    • monthly_balances(月別収支)
    • expense(経費)

POST /projects プロジェクトの登録

  • balance配下の以下のパラメーター
    • description
    • summary(収支サマリ)
    • labor_costs(人件費)
    • monthly_balances(月別収支)
    • expense(経費)

変更時期

  • 24年4月頃から順次、機能提供を廃止します。
  • 提供の終了は、全ての機能を同時に行うのではなく、数ヶ月かけて順次行っていくため、それに伴いPublic APIの項目削除も行う予定です。
リリースノート

【freee請求書】請求書番号・見積書番号の指定が可能になりました

freee請求書APIにおいて、請求書番号・見積書番号の指定が可能になりました。

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

対象エンドポイント

  • 請求書の作成API（POST /invoices）
  • 見積書の作成API（POST /quotations）

変更内容

  • freee請求書APIにおいて、請求書(invoice_number)・見積書番号(quotation_number)の指定が可能になりました。
  • ユーザーが自動採番の設定を[無効]としている場合は、入力が必須となります。
  • ユーザーが自動採番の設定を[有効]としている場合は、入力はできません。

採番の設定については採番を設定する – freee ヘルプセンターをご確認ください。

ニュース

【freee請求書】API仕様の変更について（請求書API・見積書API）

下記2点、freee請求書 請求書API・見積書APIの仕様変更があります。
freee請求書APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

変更内容①：

  • POST・PUT時のリクエストパラメーター「partner_title（敬称）」について、敬称なしとする場合は、これまで全角のカッコを用いた “（空白）”で受け付けていました。今後、半角のカッコを用いた “(空白)”でもリクエストを受けることとします。

対象エンドポイント：

  • POST /invoices 請求書の作成
  • POST /quotations 見積書の作成
  • PUT /invoices/{id} 請求書の更新
  • PUT /quotations/{id} 見積書の更新

変更理由：

  • freee会計の取引先API・請求書API・見積書APIと敬称についての仕様を揃えるためです。
  • ※なお非推奨ではありますが、全角のカッコを用いた “（空白）”でも指定は可能です。

変更の実施時期：

  • 2023年9月初旬

変更内容②：

  • GET時、またPOST/PUT後のレスポンスパラメーター「partner_title（敬称）」について、敬称なしの場合は、これまで全角のカッコを用いた “（空白）”で返却していました。今後、半角のカッコを用いた “(空白)”でのみレスポンスすることとします。

対象エンドポイント：

  • GET /invoices/{id} 請求書の取得
  • GET /quotations/{id} 見積書の取得

変更理由：

  • freee会計の取引先API・請求書API・見積書APIと仕様を揃えるためです。
  • ※なおPOST/PUT時の指定が全角/半角であったかに関わらず、半角のカッコを用いた “(空白)”でのみレスポンスすることとします。

変更の実施時期：

  • 2023年9月初旬（変更①実施後）
ニュース

システムメンテナンス(8/23)のお知らせ

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

日時：2023/8/23 (水) 1:00 – 5:00

対象：freee 全サービス（電子公告サービス除く）、freeeサイン

メンテナンス中は該当サービスをご利用いただけません。

ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

リリースノート

【freee人事労務】従業員の特別休暇一覧が取得可能になりました

freee人事労務APIにおいて、従業員に付与された「特別休暇」の一覧を取得できるエンドポイントをリリースしました。

対象エンドポイント

  • 従業員の特別休暇一覧取得API（/api/v1/employees/{employee_id}/special_holidays）

変更内容

  • 従業員の特別休暇一覧取得APIは、freee人事労務で従業員に付与された特別休暇の一覧を取得することができます。

従業員は本人に付与された特別休暇の一覧を、管理者は全ての従業員の申請一覧を、対象日または対象期間を指定して取得できます。

特別休暇について

  • 特別休暇とは会社独自の休暇をfreee人事労務の管理者が定義し、従業員ごとに付与したり、残りの日数を管理することができる休暇です。
    特別休暇の詳細は、ヘルプページをご参照ください。
    特別休暇（会社独自の休暇）を管理する