【重要】freee会計 経費申請のWebhook通知に関する仕様変更のお知らせ

■ 概要

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

下記の通り、freee会計APIの仕様変更を実施いたしました

新仕様の確認ならびに、必要に応じてアプリ側での対応をご検討いただきますようお願いいたします。

■ 変更内容

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

変更対象:経費申請のWebhook通知

変更種別:[Non-breaking Change(機能追加)]

変更内容:

経費申請のWebhook通知において、承認時修正(承認者が金額や勘定科目などを修正して承認する操作)が行われた際にも通知が送信されるようになります。

  • これまでの動作:
      – 通常の承認:Webhook通知が送信される
      – 承認時修正:Webhook通知が送信されない
  • 変更後の動作:
      – 通常の承認:Webhook通知が送信される(変更なし)
      – 承認時修正:Webhook通知が送信される(新規追加)

承認時修正のWebhook通知内容:

  ・リソース: accounting:expense_application

  ・アクション: updated

  ・承認アクション: approval_action: approval_modify

  ・含まれる情報:

    – id: 経費申請ID

    – company_id: 事業所ID

    – status: ステータス

    – approval_action: 承認アクション(approval_modify が設定されます)

    – applicant_id: 申請者ID

    – actor_id: 承認者(操作者)ID

変更理由:

経費申請の承認フローにおいて、承認者による修正が行われたタイミングを外部システムで正確に把握できるようにするため、承認時修正についてもWebhook通知を送信するよう仕様を変更いたします。

■ 変更スケジュール

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

アナウンス日:2026/09/03

変更リリース日:2026/08/25     

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Webhook通知を受信していない場合:

本変更による影響はありません。対応は不要です。

既にWebhook通知を受信している場合:

Webhook設定が有効な事業所では、今後 approval_action: approval_modify を含むイベントが追加で通知されるようになります。

承認時修正のイベントを識別するには:

Webhookのペイロードに含まれる approval_action フィールドが approval_modify であるかを確認してください。

既存の通知への影響:

通常の承認、差戻し等の既存の通知には影響ありません。

■ 変更後のWebhookペイロード例

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

承認時修正が行われた場合の通知例:

{

  “resource”: “accounting:expense_application”,

  “action”: “updated”,

  “details”: {

    “expense_application”: {

      “id”: 12345,

      “company_id”: 67890,

      “status”: “approved”,

      “approval_action”: “approval_modify”,

      “applicant_id”: 111,

      “actor_id”: 222

    }

  }

}