ShuheiMuto のすべての投稿

freee会計APIの仕様変更について

下記の通り、freee会計APIの仕様変更を予定しています。
freee会計APIをご利用されている開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

変更の詳細:

取引に対する+更新時に、+更新対象の取引明細行の備考欄が、+更新により作成する取引明細行の備考欄にコピーされなくなります。

例えば、以下のような仕訳の前受金に対して売上高で+更新を行った場合

現金(備考:なし)前受金(備考:手付金)

今までは以下のように前受金行の備考がコピーされていました。

現金(備考:なし)前受金(備考:手付金)
前受金(備考:手付金売上高(備考:なし)

今後は以下のように前受金行の備考がコピーされなくなります。

現金(備考:なし)前受金(備考:手付金)
前受金(備考:なし売上高(備考:なし)

対象のエンドポイント:

  • POST /api/1/deals/{id}/renews:取引(収入/支出)に対する+更新の作成

変更の理由:

freee会計Web画面の仕様変更によるもの。

変更の実施予定時期:

2022年7月中旬

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

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2022年6月23日(木)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

【重要】freeeプロジェクト管理APIの仕様変更について

下記の通り、freeeプロジェクト管理APIの仕様変更を予定しています。
ご利用されている開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

変更の詳細:

工数登録時のリクエストパラメータ「工数タグID(workload_tags.tag_id)」が必須項目になります。

変更の理由:

freeeプロジェクト管理Web画面との仕様ギャップを無くすため。

変更の実施予定時期:

2022年7月11日

システムメンテナンス(6/9) のお知らせ

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2022年6月9日(木)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

システムメンテナンス(5/26) のお知らせ

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2022年5月26日(木)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

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

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年11月17日(水)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

[復旧済] freeeAPIの動作が不安定な状況です

本事象について、現在は復旧対応が完了しており、安定的な稼働状況に戻っていることを確認しております。
ご迷惑をおかけし、大変申し訳ございませんでした。
引き続き、よろしくお願い申し上げます。[2021年11月9日9時15分更新]

本事象について、17時22分より安定的な稼働状況に戻っていることを確認しております。
また、念の為稼働状況のモニタリングを続けております。ご迷惑をおかけし大変申し訳ございません。[2021年11月8日19時30分更新]

本日16時22分頃より、freeeAPIの動作が不安定な状況が確認されており、現在、復旧に向けた対応を行っております。

ご迷惑をおかけし、大変申し訳ございません。
逐次、状況をお知らせいたします。

システムメンテナンス(10/22) のお知らせ

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年10月22日(金)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

システムメンテナンス(9/22) のお知らせ

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年9月22日(水)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

各種申請APIのHTTPステータスコード変更について

下記の通り、各種申請APIの仕様変更を予定しています。
各種申請APIをご利用の開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

変更の実施予定時期:

2021年10月

変更内容:

各種申請APIで申請の承認操作を行う際、指定した申請が存在しなかった場合または指定した申請を操作する権限が無い場合に返却されるHTTPステータスコードが変更されます。

変更前:

指定した申請が存在しなかった場合または指定した申請を操作する権限が無い場合に返却されるHTTPステータスコードは[400]です。

変更後:

指定した申請が存在しなかった場合または指定した申請を操作する権限が無い場合に返却されるHTTPステータスコードは[404]です。

対象エンドポイント:

  • POST /api/1/approval_requests/{id}/actions

変更理由:

適切なHTTPステータスコードを返却するため。

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

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年8月24日(火)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

freee人事労務APIの仕様変更について

下記の通り、freee人事労務APIの仕様変更を予定しています。
freee人事労務APIをご利用の開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

変更の実施予定時期:

2021年12月

変更内容:

給与明細APIで従業員の給与明細を取得する際、配列[overtime_pays]に含まれる内容が下記のように変更されます。

変更前:

name(項目名), time(時間[分]) ,amount(手当金額)の3項目が返却され、固定残業代および固定残業代の超過額は「固定割増手当」および「固定割増手当超過額」という項目名で返却されます。

レスポンスデータ例

overtime_pays: [
  {
    name: '法定内残業',
    time: '600.0'
    amount: '12350.0'
  },
  {
     name: '固定割増手当',
     time: null,
     amount: '100000.0'
  },
  {
     name: '固定割増手当超過額',
     time: null,
     amount: '0.0'
  }

変更後:

変更前の3項目に加え、事業所毎に任意に設定可能な小文字英数最大10桁のcode(コード)が返却され、固定残業代および固定残業代の超過額にも事業所毎でユーザーが設定した任意の項目名(最大20文字)で返却されます。
code(コード)には固定残業代および固定残業代の超過額場合にname(項目名)に対応する値が入り、それ以外の場合はnullが返却されます。

レスポンスデータ例

overtime_pays: [
  {
    name: '法定内残業',
    time: '600.0'
    amount: '12350.0',
    code: null
  },
  {
     name: 'カスタム固定残業代1',
     time: null,
     amount: '100000.0',
     code: 'a001'
  },
  {
     name: 'カスタム固定残業代1超過分',
     time: null,
     amount: '0.0',
     code: 'a001'
  },
 {
     name: 'カスタム固定残業代2',
     time: null,
     amount: '100000.0',
     code: 'a002'
  },
  {
     name: 'カスタム固定残業代2超過分',
     time: null,
     amount: '0.0',
     code: 'a002'
  },
  ...

対象エンドポイント:

  • GET /api/v1/salaries/employee_payroll_statements
  • GET /api/v1/salaries/employee_payroll_statements/{employee_id}

変更理由:

固定残業代付与に関する機能改善のため。(freee人事労務の仕様変更によるもの)

改訂履歴:

2021年11月17日

  • 変更の実施予定時期を2021年10月から2021年12月に変更しました
  • 変更後の記載をより詳細化しました
  • 変更前・変更後それぞれのレスポンスサンプルを記載しました

[復旧済] ファイルボックスAPIの障害について

本事象について、2021年8月2日 15時50分頃に復旧対応が完了し、現在は解消しております。

ファイルボックスAPIが正常に動作しないケースが発生しております

【発生日時】
2021年7月15日(木)以降

【発生事象】
ファイルボックスAPI(POST /api/1/receipts)をコールする際、HTTP request header に Transfer-Encoding: chunked を指定してリクエストを送った場合に正常に処理が完了しません。

現在、復旧に向けた対応を行っております。
ご迷惑をおかけし、大変申し訳ございません。

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

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年7月21日(水)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

[復旧済] freeeAPIのWebhook通知の障害について

freeeAPIのWebhook通知が正常に動作していなかった時間帯がありました。

現在は復旧対応が完了しており、影響を受けたアプリケーションのオーナー開発者さまにはご連絡済みです。

【発生日時】
2021年7月12日(月)17:15 ~ 2021年7月13日(火)09:03

【発生事象】
freeeAPIのWebhook通知が正常に動作せず、上記の時間帯においてWebhook通知が送信されていませんでした。
対象は、経費精算・各種申請・支払依頼の全てです。

ご迷惑をおかけしましたことをお詫びいたします。
再発防止の対策を進めてまいります。

「アプリストア決済機能」リリースのお知らせ

2021年7月8日に新機能「アプリストア決済機能」がリリースされました。
「アプリストア決済機能」を利用することで、freee APIを活用したサービスをfreeeアプリストア上で有料販売することが可能です。

ご利用方法については、下記サポートドキュメントをご参照ください。

アプリケーションを有料で販売する

システムメンテナンス(6/24) のお知らせ

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年6月24日(木)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

システムメンテナンス(5/19) のお知らせ

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年5月19日(水)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support

システムメンテナンス(4/22) のお知らせ

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時:2021年4月22日(木)1:00-5:00

対象:全サービス

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

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

================================================

freee developer support