【重要】freee会計 支払依頼の更新に関するAPI仕様変更のお知らせ

■概要

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

下記のfreee会計APIの仕様変更は、2026/10/19(月)に適用いたしましたが、2026/10/20(火)に取りやめ、従来の仕様に戻しました。

現在は従来の仕様で動作しており、アプリの改修などの対応は不要です。

ご迷惑をおかけし大変申し訳ございません。

■ 変更内容(取りやめ)

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

変更対象API:[PUT] /api/1/payment_requests/{id}: 支払依頼の更新

変更種別:[Breaking Change]

変更内容:

  • 支払依頼の更新(PUT)APIにおいて、更新前後で支払先(partner_id または partner_code)が変わらない場合、支払依頼に保存済みの口座情報を維持するよう変更します(「取引先に登録されたメイン口座の値」での上書きを行わなくなります)。
    • ※変更前は、更新を実行するたびに「取引先に登録されたメイン口座の値」で上書きされていました。
  • 対象となる口座情報(9項目):bank_code / bank_name / bank_name_kana / branch_code / branch_name / branch_kana / account_number / account_name / account_type
  • 支払先を別の取引先に変更する場合は、従来どおり変更後の取引先のメイン口座の値で更新されます。
  • 支払先を指定しない(partner_id と partner_code をいずれも送らない)場合は、従来どおりリクエストで指定された口座情報の値が採用されます。
  • 支払先を指定した場合にリクエストの口座情報が無視される点は、従来から変更ありません。
  • ※本変更は支払依頼の更新(PUT)時の挙動のみに影響します。以下のAPIに変更はありません。
    • [POST] /api/1/payment_requests(支払依頼の作成)
    • [GET] /api/1/payment_requests/{id}(支払依頼の取得)
    • [GET] /api/1/payment_requests(支払依頼一覧の取得)
  • リクエストおよびレスポンスのフィールド構成、型、HTTPステータスコード、エラーに変更はありません。レスポンスに含まれる支払先口座情報の値が、取引先の最新のメイン口座ではなく、支払依頼に保存された値になる場合があります。

変更理由:

支払依頼に登録された支払先口座情報が、意図しない形で書き換わることを防ぐためです。

現在は更新のたびに、支払先の取引先のメイン口座の値で支払先口座情報を上書きしています。そのため、支払先を変更していない更新でも、取引先マスタ側でメイン口座が変更されていると口座情報が入れ替わります。

本変更では、支払先が変わらない更新では上書きを行いません。支払先を変更した場合は、これまでどおり変更後の取引先のメイン口座の値を設定します。

■ 変更スケジュール

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

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

変更リリース日:2026/10/19(月)13:00

変更取りやめ日:2026/10/20(火)15:10(従来の仕様に戻しました)

旧バージョン廃止予定日:なし(従来の仕様を継続します)

■ 対応方法

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

必要な対応:

変更を取りやめたため、アプリの改修などの対応は不要です。本変更に合わせて改修済みの場合も、そのままご利用いただけます。

2026/10/19(月)13:00〜2026/10/20(火)15:10 の間に、支払先を変えずに更新した支払依頼は、更新前の口座情報が維持されています。取引先の最新のメイン口座を反映したい場合は、該当の支払依頼を再度更新してください。

■ 変更後のAPI仕様(取りやめ)

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

エンドポイント:[PUT] /api/1/payment_requests/{id}

リクエスト:※変更ありません

レスポンス:※フィールド構成に変更はありません

リクエストで指定する支払先と、支払依頼に保存される支払先口座情報の関係は、変更後は次のとおりとなります。

リクエスト条件変更後の挙動(支払先口座情報)従来との違い
支払先が更新前と同じ取引先更新前の値をそのまま維持従来は取引先のメイン口座で上書きされていました(変更点)
支払先が更新前と異なる取引先変更後の取引先のメイン口座で更新変更なし
支払先を指定しない(partner_id, partner_codeをどちらも指定しない)リクエストで指定された口座情報(bank_*)を保存変更なし

(例)取引先Aを支払先とする支払依頼を登録したのち、取引先Aのメイン口座を口座1から口座2へ変更し、その支払依頼を更新した場合

– 変更前:支払先口座情報が口座2の値に書き換わります。

– 変更後:支払先口座情報は口座1の値のまま維持されます。