【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月初旬(変更①実施後)