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

概要

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

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

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

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

エラーコードは403となり、アプリケーションにアクセス権がないとうメッセージがAPIレスポンスに入ります。 ■ 解決方法：freee アプリストアでアプリ管理者がfreeeアプリケーションの権限設定を正しく行います。 アプリストア>アプリ管理>アプリ詳細>権限設定 ■ 新仕様リリース予定日 2019年9月11日(水) ================================================ freee developer support

2019/8/23の13:45～18:15の間、AWSのシステム障害により、会計freeeを含む全てのサービスにアクセスしずらい事象が発生しておりましたが、復旧対応が完了しており、現在は全ての機能をご利用いただけます。

この度は、多大なご迷惑をおかけしましたこと、改めてお詫び申し上げます。

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

2019年7月24日（水）1：00〜5：00に予定していた、会計freee、人事労務freeeを含むfreeeサービスと各モバイルアプリのシステムメンテナンスですが、 弊社の都合により、中止となりました。
どうぞよろしくお願いいたします。

—

freee Developers Community 運営事務局・技術サポート https://support.freee.co.jp/hc/ja/requests/new

 

リリース概要

従来会計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%（軽）

 

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

日時 : 2019/6/19 (水) 1:00 – 5:00

対象: 全サービス

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

—

freee Developers Community 運営事務局・技術サポート https://support.freee.co.jp/hc/ja/requests/new

2019/6/4の17:40～18:47の間「会計freeeを含む全てのサービスにログインできない」事象が発生しておりましたが、復旧対応が完了しており、現在は全ての機能をご利用いただけます。
この度は、多大なご迷惑をおかけしましたことあらためてお詫び申し上げます。
再発防止の対策を進めてまいりますので、何卒ご容赦賜りますようお願い申し上げます。

2019年6月4日現在 現在会計freeeを含む全てのサービスでアクセスし辛い問題が発生しております。

ご不便をおかけして申し訳ございませんが、原因の調査を行っておりますので、今しばらくお待ち下さい。

2019年5月23日（木）1：00〜5：00の間で、会計freee、人事労務freeeを含むfreeeサービスと各モバイルアプリでシステムメンテナンスを行います。メンテナンス中は該当サービスをご利用いただけません。ご迷惑をおかけしますが、よろしくお願いいたします。 https://secure.freee.co.jp/system_messages

2019/04/18 (木) 1:00 – 5:00の間で、会計freee、人事労務freeeを含むfreeeサービスと各モバイルアプリでシステムメンテナンスを行います。メンテナンス中は該当サービスをご利用いただけません。ご迷惑をおかけしますが、よろしくお願いいたします。

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

2019年10月より実施される消費税率変更、及び軽減税率制度導入に伴い、 会計freeeでは新制度に対応した新税区分の追加リリースを平成31年7月初旬に予定しています。

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

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

仕様変更理由

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

仕様変更リリース予定日

2019年7月初旬

仕様変更内容

会計freeeの税区分に、次の税率を追加します

• 税率8% （軽減税率対象）
• 税率10%

影響範囲

各種GETレスポンス内容に新税区分(tax_code)が追加されます。

• 税区分コード一覧（/taxes/codes）のGET
• 事業所の詳細情報（/companies/{id}）のGET
• 取引（/deals）のGET
• 請求書（/invoice）のGET
• 振替伝票（/manual_journals）のGET

各種POST/PUTリクエストのパラメータで、新税区分(tax_code)を指定して送信が可能です。

• 取引（/deals）のPOST/PUT
• 取引の＋更新（/deals/{id}/renews）のPOST/PUT
• 振替伝票（/manual_journals）のPOST/PUT
• 請求書（/invoice）のPOST
• 勘定科目（/account_items）のPOST/PUT

※ただし、発生日（issue_date）を2019年10月1日より前に指定した各APIのPOST/PUTリクエストにて、税区分（tax_code）に新税区分を指定した場合はエラーとなります。

なお、リリース日時や、追加される各税区分の、税区分コード（code）税区分名（name）日本語税区分名（name_ja）については確定次第お知らせいたします。

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

freee developer support <dev-support@freee.co.jp>

本日お知らせしました「旧エンドポイントでのアクセストークン取得、破棄ができない事象」について、 調査の結果、APIの利用自体には問題ありませんでした。正常に動作しております。

お騒がせしまして申し訳ございません。

引き続きfreeeAPIをよろしくお願いいたします。

現在「旧エンドポイントでのアクセストークン取得、破棄」ができない事象が発生しております。修正対応完了まで今しばらくお待ち下さい。

現在利用できない処理

• 認可コードによるアクセストークンの取得
• リフレッシュトークンによるアクセストークンの取得
• アクセストークンの破棄
• リフレッシュトークンの破棄

 

本日11:27頃まで、「取引先情報」の新規登録・編集が出来ない事象が発生しておりました。 現在、復旧対応が完了しており通常どおり機能をご利用いただけます。 ご迷惑をおかけしまして、大変申し訳ございません。