2019/9/30の21:10-21:34、および10/01の0:40-02:08、人事労務freeeAPIへ接続できない事象が発生しました。

現在は復旧対応が完了しており、全ての機能をご利用いただけます。

APIご利用の皆様に多大なご迷惑をおかけしましたことをお詫び申し上げます。再発防止の対策を進めてまいりますので、ご容赦賜りますようお願い申し上げます。

2019年11月中旬以降に、会計freeeの請求書APIに関わるエンドポイントに対して、仕様変更が行われます。請求書APIを利用したアプリ開発者の皆様は、変更点をご確認いただき、アプリプログラムの改修をご検討ください。

仕様変更の理由：

会計freeeの機能改善を行うため。

仕様変更リリース予定日：

2019年11月中旬以降

影響範囲：

請求書発行のエンドポイント

• /invoices
• /docs
• /partners

を利用したアプリの一部に対して影響が発生します。

仕様変更内容：

1 請求書作成時に、[partner_id] もしくは [partner_code] が必須となります。

これまでは、[partner_id]/[partner_code] がなくても請求書発行の操作が可能でした。改修後は、[partner_id] もしくは [partner_code] が必須パラメーターになります。

2 請求書に記載する取引先を事前に作成する必要があります

これまでは請求書作成時に取引先情報を入れて請求書と取引先を同時に登録できました。
改修後は、事前に partner API から取引先と [partner_id] を作成後、[partner_id]/[partner_code] を利用して請求書を作成する必要があります。

3 取引先の情報を更新した際、必要に応じて請求書の取引先情報も更新ください。

アプリの変更について：

1. 請求書関連のエンドポイント

• /invoices
• /docs

に対して、POSTメソッドをリクエストしているアプリは、［partner_id］ もしくは [partner_code] を付与するように変更をお願いいたします。

2. 取引先関連のエンドポイント

• /partners

に対してPUTによる情報更新を行った後、必要に応じて請求書の取引先情報を更新してください。

いつまでに対処すれば良いのか:

freeeの仕様変更は、2019年11月中旬以降に仕様変更予定となっています。このため、上記エンドポイントを利用するアプリは、2019年11月初旬までにご対応ください。

開発者の皆様にはお手数をおかけしますが、何卒ご理解とご了承をいただきたく、よろしくお願い申し上げます。

(2019年10月25日追記：必須パラメーターを[partner_id] [partner_code] のいずれか、と修正しました。)

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

• 日時：2019年9月26日（木）1:00-5:00
• 対象：全サービス

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

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

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

freee developer support

会計freeeAPIでのエラーメッセージの具体化とエラーコードの最適化についてご連絡いたします。

概要

今までのエラーメッセージでは判別できなかった、アプリの権限設定の問題、ユーザーの権限の問題が判別できるようになります。

ユーザーに特定の情報に対する参照または更新権限がない

エラーコードは401となり、認可を行った（アクセストークンを取得した）ユーザーのユーザー権限を正しく設定する必要があるというメッセージがAPIレスポンスに入ります。
■ 解決方法：概要ユーザーに必要なアクセス権を付与するには、事業所の管理者ユーザーが会計freeeにアクセスして設定>メンバー招待・権限管理>メンバー管理で正しい権限を割り当ててください。

アプリに特定の情報に対する参照または更新権限がない

エラーコードは403となり、アプリケーションにアクセス権がないとうメッセージがAPIレスポンスに入ります。

■ 解決方法：freee アプリストアでアプリ管理者がfreeeアプリケーションの権限設定を正しく行います。
アプリストア>アプリ管理>アプリ詳細>権限設定

■ 新仕様リリース予定日
2019年9月11日(水)

================================================
freee developer support

AWSのシステム障害により、freeeのAPIを含めた各サービスにもエラーが多発しております。ご不便・迷惑おかけして申し訳ございません。

リリース概要

従来会計freeeでは「取引先名」をキーにデータの作成/更新を行っていましたが、多様なユーザー様にご導入いただく中で取引先名の重複などが発生するようになりました。
そこでユーザーが任意に指定できる取引先コードを用意し、取引先コードをキーにデータの作成/更新ができるようになりました。

1. 取引先コードは事業所の詳細設定から有効化を行えます。
2. デフォルトでは「使用しない」になっています。

リリース日

5/22(水)にリリース済み

リリースによる取引先APIへの影響について

1. 1. 取引先コードを「使用する」にすることで、新規作成時に取引先コードが必須になります。

1. 「使用する」に設定した状態で取引先APIのPOSTを利用すると『”Codeを入力してください。”』の400エラーを返却します。

リリース伴って各社へお願いしたいこと

1. 1. 取引先コードへの対応状況をヘルプページなどにご記載ください。

1. 任意のコードを貴社システムで持たれている場合は、ぜひ取引先コードへの対応をご検討ください

廃止予定API

• 税区分一覧取得
• GET /taxes

この変更に伴い、インパクトがあるアプリケーション

税区分一覧(/taxes)で取得したtax_idを活用しているアプリケーション

依頼事項

サポート終了予定日までに税区分コード一覧(/taxes/codes)への移行と税区分一覧の利用停止をお願いいたします。

税区分一覧APIサポート終了予定日

2019/9/30（月）

この日以降は税区分一覧に関する問い合わせ対応や不具合改修は予定しておりません。

API廃止予定日

2019/12/2(月)

この日以降はAPIコールに対してエラーで応答します。

今後の対応について

2019/9/30までに税区分コードを利用して必要な情報を取得できるようにアプリケーションの改修をお願いいたします。必要に応じて、開発者環境を活用してテストを行ってください。

また、移行先の税区分コード一覧における新消費税率や軽減税率に伴う税区分コード一覧での新税区分コードの追加と詳細はこちらを参照してください。

新規追加される各税区分の、税区分コード（code）税区分名（name）日本語税区分名（name_ja）についてのお知らせです。

2019年10月1日から消費税及び地方消費税の税率が8％から10％に引き上げられると同時に、消費税の軽減税率制度が実施されるため、以下の追加を行います。

軽減税率による税率8%につきましては、現在ある消費税8%の区分とは別で軽減税率用のものを準備しましたので、使い分けてご利用ください。

freee APIを利用した多くのアプリケーションに影響がございますので、 開発者の皆さまには必ず以下の内容をご確認いただき、必要なご対応をお願いいたします。

変更内容、影響範囲は4月のニュースをご確認ください。

本件リリース予定は7月初旬となっております。リリースが完了しましたら、別途お知らせをさせていただきます。

※（7/8更新）2019/7/8にリリース完了いたしました。

新規追加税区分コード一覧

税区分コード(code)	税区分名（name）	日本語税区分名（name_ja）
129	sales_with_tax_10	課税売上10%
130	sales_with_tax_10_simple_1	課売上一10%
131	sales_with_tax_10_simple_2	課売上二10%
132	sales_with_tax_10_simple_3	課売上三10%
133	sales_with_tax_10_simple_4	課売上四10%
134	sales_with_tax_10_simple_5	課売上五10%
135	sales_with_tax_10_simple_6	課売上六10%
136	purchase_with_tax_10	課対仕入10%
137	purchase_with_no_tax_10	非対仕入10%
138	purchase_with_common_10	共対仕入10%
139	import_tax_10	課対輸税10%
140	import_tax_no_tax_10	非対輸税10%
141	import_tax_common_10	共対輸税10%
142	import_local_tax_10	地消貨割10%
143	return_of_sales_with_tax_10	課税売返10%
144	return_of_sales_with_tax_10_simple_1	課売返一10%
145	return_of_sales_with_tax_10_simple_2	課売返二10%
146	return_of_sales_with_tax_10_simple_3	課売返三10%
147	return_of_sales_with_tax_10_simple_4	課売返四10%
148	return_of_sales_with_tax_10_simple_5	課売返五10%
149	return_of_sales_with_tax_10_simple_6	課売返六10%
150	bad_receivable_10	課税売倒10%
151	returned_bad_receivable_10	課税売回10%
152	return_of_purchase_with_tax_10	課対仕返10%
153	return_of_purchase_with_no_tax_10	非対仕返10%
154	return_of_purchase_with_common_10	共対仕返10%
155	taxable_10	課税10%
156	sales_with_tax_reduced_8	課税売上8%（軽）
157	sales_with_tax_reduced_8_simple_1	課売上一8%（軽）
158	sales_with_tax_reduced_8_simple_2	課売上二8%（軽）
159	sales_with_tax_reduced_8_simple_3	課売上三8%（軽）
160	sales_with_tax_reduced_8_simple_4	課売上四8%（軽）
161	sales_with_tax_reduced_8_simple_5	課売上五8%（軽）
162	sales_with_tax_reduced_8_simple_6	課売上六8%（軽）
163	purchase_with_tax_reduced_8	課対仕入8%（軽）
164	purchase_with_no_tax_reduced_8	非対仕入8%（軽）
165	purchase_with_common_reduced_8	共対仕入8%（軽）
166	import_tax_reduced_8	課対輸税8%（軽）
167	import_tax_no_tax_reduced_8	非対輸税8%（軽）
168	import_tax_common_reduced_8	共対輸税8%（軽）
169	import_local_tax_reduced_8	地消貨割8%（軽）
170	return_of_sales_with_tax_reduced_8	課税売返8%（軽）
171	return_of_sales_with_tax_reduced_8_simple_1	課売返一8%（軽）
172	return_of_sales_with_tax_reduced_8_simple_2	課売返二8%（軽）
173	return_of_sales_with_tax_reduced_8_simple_3	課売返三8%（軽）
174	return_of_sales_with_tax_reduced_8_simple_4	課売返四8%（軽）
175	return_of_sales_with_tax_reduced_8_simple_5	課売返五8%（軽）
176	return_of_sales_with_tax_reduced_8_simple_6	課売返六8%（軽）
177	bad_receivable_reduced_8	課税売倒8%（軽）
178	returned_bad_receivable_reduced_8	課税売回8%（軽）
179	return_of_purchase_with_tax_reduced_8	課対仕返8%（軽）
180	return_of_purchase_with_no_tax_reduced_8	非対仕返8%（軽）
181	return_of_purchase_with_common_reduced_8	共対仕返8%（軽）
182	taxable_reduced_8	課税8%（軽）

 

2019/03/26
現在、「取引先」情報の新規登録・編集が出来ない事象が発生しております。
修正対応完了まで今しばらくお待ち下さい。

12/3(月)に修正対応が必要なアップデートをリリースします。

リリース概要

自動エラーチェックライブラリを導入し、バリデーションチェックの厳格化およびエラーレスポンスの形式統一を行います。

リリースによる変更点

• データ型のバリデーションが強化され、amountへのString型でのリクエストなどができなくなります。正しい指定形式はdeveloperサイトの「パラメータ詳細」欄をご確認ください。なお、修正が必要と思われるユーザー様へは別途個別に必要な変更についてご連絡いたします。
• エラーレスポンスの一部でerrorsのfieldをarrayではなく、文字列で返しておりました。今後はarray形式に統一いたします。
• リクエストヘッダーにて適切なapplication/jsonを指定してください。指定がない場合、エラーレスポンスが適切に返されない場合がございます。

1. (一部パートナー)ファイルボックスAPI：multipart/form-data, boundary=Boundary
2. journals #download：application/csv,application/pdf
3. その他：application/json

詳細はドキュメントにてご確認ください

—

freee Developers Community 運営事務局・技術サポート

https://support.freee.co.jp/hc/ja/requests/new

いつもfreee APIをご利用いただき誠にありがとうございます

freee APIをお使いのユーザー様に影響のある内容ですので、必ず内容をご確認いただき、必要なご対応をお願いいたします。

ご不明な点がございましたらdev-support@freee.co.jpまでご連絡ください。

取引先API GET

================================================
■ 仕様変更内容

(1)取引先API　GET時に返すlimitに制限を入れます。

(2)keywordをパラメータとして追加します。

■ 仕様変更理由
1事業所辺りの取引先件数が多くなる過程での安定した稼働、
またkeyword検索による利便性向上のため。

■ 影響範囲
取引先APIでGETメソッドをご利用のユーザー様

■ 必要なご対応
GETリクエストにlimit,offsetを活用したループ処理の実装をお願いします

■ 新仕様リリース予定日
2018年10月1日(月)
================================================

認証基盤のアップデート

================================================
■ 仕様変更内容

認証に利用しているライブラリのアップデートを行います。
アップデートに伴いパラメータの返し方、およびエラー文が変更になります。
詳細は下記をご参照ください。

■ 仕様変更理由
セキュリティ強化のため

■ 影響範囲
freee APIご利用のユーザー様

■ 新仕様リリース予定日
2018年9月18日(火)-19日(水)
================================================

クライアント認証失敗時のエラーメッセージ変更

client_id / client_secret によるクライアント認証に失敗した場合のエラーメッセージが下記のように変わります。

Authorization code の許可・拒否における挙動の変更

「Web認証用URL」にアクセスし、アプリケーションによるリソースアクセスの許可・拒否を行なった場合の挙動に変更があります。

※authorization_code はaccess token 取得時に code パラメータに渡す値です。

Implicitの許可・拒否における挙動の変更

redirect_uri がテスト用（urn:ietf:wg:oauth:2.0:oob）の場合

• 許可時

リダイレクトされるURL、レスポンスの形式、メッセージの内容が次のように変わります。
テスト用途では特に問題ありません。

• 拒否時

メッセージの値が次のように変わります。

redirect_uri が有効なURL形式の場合

クエリパラメータerror_descriptionに渡されるURLエンコードされた値が次のように変わります。

エンタープライズプランご利用のお客様向けに公開している請求書APIドキュメントを一度非公開とします。
対応予定日：9/3(月)

事由

APIの実装とドキュメントに差異があることが分かっており、
あるべき仕様を検討した際に、破壊的な変更を伴う可能性がある。

今後の対応について

現在開発中の方はお手数ですが9/3(月)までにキャプチャを取るなどのご対応をお願いいたします。
これから開発される方は、弊社営業担当にお問い合わせください。
再公開については、決まり次第改めてお知らせいたします。

会計freeeをより便利に、より多くの業務効率化実現を目指して、中核機能にあたる振替伝票のAPIを9/3(月)にリリースいたします。

リリースに先駆けて、本日振替伝票APIのドキュメントを公開いたしました。

対応するメソッド

• POST
• PUT
• GET #index
• GET #show
• DELETE

利用シーン

前受金の振替、工事台帳との連携、人件費の製品原価 / 仕掛りへの振替、固定資産の減価償却など幅広い用途で利用できます。

いつもfreee APIをご利用いただき誠にありがとうございます。

請求書APIの仕様変更を2018年7月下旬に予定しています。
freee APIをお使いのユーザー様に影響のある内容ですので、必ず内容をご確認いただき、必要なご対応をお願いいたします。

================================================
■仕様変更内容
請求書API POST時に存在しない部門名 / 品目名を指定した場合に、エラーを返すようにエラーハンドリングを拡張します。
存在する部門名 / 品目名を指定した場合には、これまで通り動作します。

また、従来の名前指定に加えてIDでの指定にも近日対応予定です。

■仕様変更理由
APIの利便性向上のため

■影響範囲
請求書APIのPOSTをご利用で、部門 / 品目を指定しているユーザー様すべて

■新仕様リリース予定日
2018年7月26日(木)
================================================

ご利用の皆様にはお手数をおかけいたしますが、ご対応のほどよろしくおねがいします。

平素よりfreeeをご利用いただき、誠にありがとうございます。

現在 freee が対応しておりますTLS 1.0による暗号化方式について、2018年6月14日(木)にヘルプページを、2018年7月18日(水)に freeeサービス への接続を無効化いたします。

これにより、一部のバージョンの古いブラウザやスマートフォンからは、freeeヘルプページ、freeeサービスサイトへの接続ができなくなりますのでご注意ください。

■ 対象となるサービス

freee ヘルプセンター：https://support.freee.co.jp/hc/ja/
freee サービスサイト
会計freee：https://secure.freee.co.jp/
人事労務freee：https://p.secure.freee.co.jp/
マイナンバーfreee：https://m.secure.freee.co.jp/
会社設立freee、開業freee：https://k.secure.freee.co.jp/
その他、アカウントfreeeや申告freeeを含む

■ 影響を受けるOS/ブラウザ

Internet Explorer 10 以下
Windows Vista
Windows XP
Mac OS X 10.8 以下
Android 5.0未満
iOS 5未満

(*)なお、freeeがサポートする動作環境は TLS 1.1 以上をサポートしているため、今回の変更の影響は受けません。セキュアにご利用いただくため、freeeへのアクセスはサポートブラウザをご利用ください。

■ お客様へのお願い

お手元でご利用環境をご確認ください。上記影響のあるOSやブラウザをご利用されている場合は、サポート終了日までに、動作環境にあるバージョンにバージョンアップしてください。
freee サービスサイト上に「セキュリティの強化が必要です」と表示された場合、サポート終了日までに、動作環境にあるバージョンにバージョンアップしてください。
無効化以降に、ヘルプページ、またはサービスサイトにアクセスした際、アクセスができない場合は、動作環境をご確認ください。

※ご参考ヘルプページ「TLS1.0暗号化の無効化への対応」

■ 無効化の背景

今回無効化の対象となります、インターネットで通信内容の保護に使用する暗号化方式「TLS 1.0」は、暗号化技術としては旧方式であり、既にいくつかの脆弱性が報告されています。クレジット決済システムのセキュリティ基準を定める国際機関であるPCI SSCでは、TLS1.0は非推奨とされており、同機関により、2018年6月30日までにTLS 1.0を無効化することが要求されています。

freeeでは、お客様に安心してサービスをご利用いただくためにセキュリティ対策を最重要課題のひとつとして捉えています。そのため、安全性を考慮しTLS 1.0の無効化を行うことといたしました。一部お客様にはご迷惑をおかけいたしますが、どうぞよろしくお願い申し上げます。

ご不明な点がございましたら、こちらのフォームよりお知らせください。
https://support.freee.co.jp/hc/ja/requests/new

下記の日時に、会計freeeを含む freeeの全サービスと各モバイルアプリでシステムメンテナンスを行います。

日時：日時: 4/19 (木) 1:00 – 5:00
対象: 全サービス

メンテナンス中は当該サービスおよびAPIをご利用いただけません。
ご迷惑をおかけしますが、よろしくお願いいたします。

—

freee Developers Community 運営事務局・技術サポート
dev-support@freee.co.jp