(6/3)[会計]freee会計 APIにおいて、振替伝票APIのコード指定対応(更新)およびレスポンスの仕様変更
変更対象API:
- GET /api/1/manual_journals – 振替伝票一覧の取得
- POST /api/1/manual_journals – 振替伝票の作成
- GET /api/1/manual_journals/{id} – 振替伝票の取得
- PUT /api/1/manual_journals/{id} – 振替伝票の更新
変更種別: 破壊的変更なし
変更内容:
振替伝票の各種レスポンスにおいて、txn_number が必須から任意(optional)に変更されました。
振替伝票の更新(PUT)リクエストにおいて、各種コード(勘定科目、品目、部門、セグメントタグ)による指定が可能となり、これに伴い account_item_id が必須項目から任意に変更されました。
(6/11)[工数管理]共通 error スキーマの type enum に bad_request が追加
変更対象API:
error レスポンスを返す全エンドポイント共通
変更種別: 破壊的変更なし
変更内容:
共通 error スキーマの type enum に bad_request が追加されました。
(6/8)[IT管理]IT管理 APIにおいて、アプリケーションアカウント管理関連のエンドポイントのAPIタグが変更されました。
変更対象API:
- GET /hub/it_management/application_accounts
- POST /hub/it_management/application_accounts
- DELETE /hub/it_management/application_accounts/{id}
- GET /hub/it_management/application_accounts/{id}
- PATCH /hub/it_management/application_accounts/{id}
変更種別: 破壊的変更なし
変更内容:
アプリケーションアカウント(application_accounts)に関する各種エンドポイントにおいて、APIタグが it_management_application_account から it_management_application_accounts(複数形)へ変更・統一されました。
(6/9)[IT管理]IT管理 APIにおいて、一覧取得系APIに検索用のクエリパラメータが追加されました。
変更対象API:
- GET /hub/it_management/application_accounts – アプリケーションアカウント一覧の取得
- GET /hub/it_management/assets – 資産一覧の取得
- GET /hub/it_management/members – メンバー一覧の取得
変更種別: 破壊的変更なし
変更内容:
「アプリケーションアカウント一覧の取得」および「資産一覧の取得」APIにおいて、特定のメンバーで絞り込みを行うための任意のクエリパラメータ member_id が追加されました。
「メンバー一覧の取得」APIにおいて、以下の任意の絞り込み用クエリパラメータが追加されました。
- employment_type_id (雇用形態IDでの絞り込み)
- entered_since / entered_until (入社日の期間指定)
- resigned_since / resigned_until (退職日の期間指定)
(6/18)[請求書]freee請求書 APIにおいて、発注書関連APIおよび各種帳票のキャンセル機能が追加
変更対象API:
- GET, POST /purchase_orders – 発注書の取得・作成
- GET /purchase_orders/templates – 発注書テンプレート一覧の取得
- GET, PUT /purchase_orders/{id} – 発注書の詳細取得・更新
- PUT /purchase_orders/{id}/cancel, uncancel – 発注書のキャンセル・キャンセル取消
- PUT /delivery_slips/{id}/cancel, uncancel – 納品書のキャンセル・キャンセル取消
- PUT /invoices/{id}/cancel, uncancel – 請求書のキャンセル・キャンセル取消
- PUT /quotations/{id}/cancel, uncancel – 見積書のキャンセル・キャンセル取消
- PUT /receipts/{id}/cancel, uncancel – 領収書のキャンセル・キャンセル取消
変更種別: 破壊的変更なし
変更内容:
発注書(purchase_orders)の作成、取得、更新などを行う一連のエンドポイントが新設されました。
各種帳票(納品書、請求書、見積書、領収書、発注書)に対して、ステータスをキャンセルにする(cancel)、およびキャンセル状態を取り消す(uncancel)ためのアクション系エンドポイントが追加されました。
(6/23)[人事労務]各種申請APIにおける代理申請者IDの追加および手当APIのタグ更新
変更対象API:
- GET /api/v1/allowances – 手当一覧の取得
- POST /api/v1/allowances – 手当の作成
- GET /api/v1/allowances/{id} – 手当の取得
- GET /api/v1/approval_requests/monthly_attendances – 月次勤怠申請一覧の取得
- POST /api/v1/approval_requests/monthly_attendances – 月次勤怠申請の作成
- GET /api/v1/approval_requests/monthly_attendances/{id} – 月次勤怠申請の取得
- PUT /api/v1/approval_requests/monthly_attendances/{id} – 月次勤怠申請の更新
- POST /api/v1/approval_requests/monthly_attendances/{id}/actions – 月次勤怠申請に対するアクションの実行
- GET /api/v1/approval_requests/overtime_works – 残業申請一覧の取得
- POST /api/v1/approval_requests/overtime_works – 残業申請の作成
- GET /api/v1/approval_requests/overtime_works/{id} – 残業申請の取得
- PUT /api/v1/approval_requests/overtime_works/{id} – 残業申請の更新
- POST /api/v1/approval_requests/overtime_works/{id}/actions – 残業申請に対するアクションの実行
- GET /api/v1/approval_requests/paid_holidays – 有休申請一覧の取得
- POST /api/v1/approval_requests/paid_holidays – 有休申請の作成
- GET /api/v1/approval_requests/paid_holidays/{id} – 有休申請の取得
- PUT /api/v1/approval_requests/paid_holidays/{id} – 有休申請の更新
- POST /api/v1/approval_requests/paid_holidays/{id}/actions – 有休申請に対するアクションの実行
- GET /api/v1/approval_requests/special_holidays – 特別休暇申請一覧の取得
- POST /api/v1/approval_requests/special_holidays – 特別休暇申請の作成
- GET /api/v1/approval_requests/special_holidays/{id} – 特別休暇申請の取得
- PUT /api/v1/approval_requests/special_holidays/{id} – 特別休暇申請の更新
- POST /api/v1/approval_requests/special_holidays/{id}/actions – 特別休暇申請に対するアクションの実行
- GET /api/v1/approval_requests/work_times – 勤務時間申請一覧の取得
- POST /api/v1/approval_requests/work_times – 勤務時間申請の作成
- GET /api/v1/approval_requests/work_times/{id} – 勤務時間申請の取得
- PUT /api/v1/approval_requests/work_times/{id} – 勤務時間申請の更新
- POST /api/v1/approval_requests/work_times/{id}/actions – 勤務時間申請に対するアクションの実行
変更種別: 破壊的変更なし
変更内容:
各種申請(月次勤怠、残業、有休、特別休暇、勤務時間)およびそのアクションのレスポンスに、任意プロパティとして proxy_applicant_id(代理申請者ID)が追加されました。
手当API(allowances)のOpenAPIタグにおいて、「手当」が削除され「その他手当」が追加されました。
(6/26)[販売]仕入・発注関連エンドポイントの追加およびレスポンス構造の仕様変更
変更対象API:
- GET /businesses – 案件一覧の取得
- GET /businesses/{id} – 案件の取得
- GET /cost_budgets – 原価予算一覧の取得
- GET /cost_budgets/{id} – 原価予算の取得
- GET /deliveries – 納品一覧の取得
- GET /deliveries/{id} – 納品の取得
- GET /master/items – 品目一覧の取得
- GET /other_costs – その他原価一覧の取得
- GET /other_costs/{id} – その他原価の取得
- GET /procurements – 仕入一覧の取得
- POST /procurements – 仕入の登録
- GET /procurements/{id} – 仕入詳細の取得
- PATCH /procurements/{id} – 仕入の更新
- POST /procurements/{id}/cancellation – 仕入の取消
- GET /purchase_orders – 発注一覧の取得
- POST /purchase_orders – 発注の登録
- GET /purchase_orders/{id} – 発注詳細の取得
- PATCH /purchase_orders/{id} – 発注の更新
- POST /purchase_orders/{id}/cancellation – 発注の取消
- GET /quotations – 見積一覧の取得
- GET /quotations/{id} – 見積の取得
- GET /sales – 売上一覧の取得
- GET /sales/{id} – 売上の取得
- GET /sales_orders – 受注一覧の取得
- GET /sales_orders/{id} – 受注の取得
変更種別: 破壊的変更あり
変更内容:
■ 一覧・取得APIの OpenAPI Schema の定義変更
案件、納品、見積、売上、受注などの各レスポンスにおいて、取引先や担当者情報の構造が変更されました。
該当の破壊的変更についての詳細は以下をご確認ください。
https://developer.freee.co.jp/sm/sm-improvement/8071
■ その他の変更・新機能
- 新機能(仕入・発注APIの追加)
仕入(procurements)および発注(purchase_orders)を管理する各種エンドポイント(一覧取得、登録、詳細取得、更新、取消)が新設されました。 - 一覧取得APIの検索パラメータ追加
案件、原価予算、納品、その他原価、受注などの各一覧取得APIに、最終更新日で絞り込みを行うクエリパラメータ start_last_updated_date および end_last_updated_date が追加されました。 - レスポンス項目の仕様変更(必須化・Nullable化など)
各種ステータスや金額情報(amount_set, billing_status, total_amount など)が必須項目に変更されました。
源泉徴収税額(amount_of_withholding_tax)や一部の関連ID・メモなどが nullable および任意プロパティに変更されました。
品目マスタ(/master/items)APIにおいて、code および uom_name が nullable に変更されました。
(6/26)[人事労務]手当ルール・給与明細備考の管理エンドポイント追加
変更対象API:
- GET /api/v1/employees/{employee_id}/allowance_rules – 手当ルール一覧の取得
- PUT /api/v1/employees/{employee_id}/allowance_rules – 手当ルールの更新
- DELETE /api/v1/employees/{employee_id}/allowance_rules/{id} – 手当ルールの削除
- PUT /api/v1/salaries/employee_payroll_statements/{employee_id}/remark – 給与明細の備考の更新
変更種別: 破壊的変更なし
変更内容:
従業員ごとの「手当ルール」を取得、更新、削除するためのエンドポイントが新設されました。
従業員の給与明細の「備考」欄を更新できるエンドポイントが新設されました。
(6/26)[会計]事業所APIへの期末日情報追加および支払依頼の検索条件拡張
変更対象API:
- GET /api/1/companies/{id} – 事業所の詳細取得
- GET /api/1/payment_requests – 支払依頼一覧の取得
変更種別: 破壊的変更なし
変更内容:
事業所詳細取得APIのレスポンス内 fiscal_years(事業年度)リストに、以下の必須プロパティが追加されました。
- is_closed:締め済み判定
- month_end_date:期末日
- temp_month_end_date:仮期末日
支払依頼一覧取得APIの検索パラメータに、approval_flow_route_id(承認経路ID)、observing(閲覧可能フラグ)、partner_name(取引先名)が追加され、より詳細な検索が可能になりました。
内部コンポーネントスキーマから purchaseRequestActionCreateParams が削除されました。
(6/29)[人事労務]freee人事労務 APIにおいて、従業員の手当ルールおよび給与明細の備考関連エンドポイントが追加されました。
変更対象API:
- GET, PUT, DELETE /api/v1/employees/{employee_id}/allowance_rules – 従業員手当ルール
- PUT /api/v1/salaries/employee_payroll_statements/{employee_id}/remark – 給与明細の備考
変更種別: 破壊的変更なし
変更内容:
特定の従業員(employee_id)に対して、個別の手当ルールを取得・作成・削除するための各種エンドポイントが新設されました。
従業員の給与明細に対して、備考(remark)の文言を更新するためのエンドポイントが新設されました。
(6/29)[会計]freee会計 APIにおいて、事業所詳細への決算期情報の追加および支払依頼APIの検索パラメータ拡張が行われました。
変更対象API:
- GET /api/1/companies/{id} – 事業所の詳細取得
- GET /api/1/payment_requests – 支払依頼一覧の取得
変更種別: 破壊的変更なし
変更内容:
事業所の詳細取得レスポンスに含まれる決算期情報(fiscal_years)に、決算完了フラグ(is_closed)、期末日(month_end_date)、仮期末日(temp_month_end_date)の各プロパティが必須項目として追加されました。
支払依頼の一覧取得APIにおいて、より柔軟な絞り込みができるよう、クエリパラメータに承認経路ID(approval_flow_route_id)、閲覧のみフラグ(observing)、取引先名(partner_name)が追加されました。
不要となったコンポーネントスキーマ purchaseRequestActionCreateParams が削除されました。