廃止予定API
この変更に伴い、インパクトがあるアプリケーション
税区分一覧(/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
freeeAPIの機能追加についてご連絡いたします。
新たに公開したAPI
請求書API (/invoices)
概要
請求書の作成(POST)や一覧の取得(GET)、更新(PUT)、削除(DELETE)が可能となります。
なお、以前より一部限定公開しておりました見積書・納品書・請求書API(/docs) については本API公開後も引き続きご利用が可能です。
旧請求書API(/docs)からの移行について
旧請求書APIについては、仕様と実装に差異があり、品質の問題から限定公開とさせていただいておりました。今回の新請求書API公開に伴い、旧請求書APIをご利用のアプリ作成者様におきましては、新APIへの移行をご検討ください。
ご利用可能なプラン
請求書API (/invoices)は会計freeeの全プランでご利用可能です。
詳細は「
会計freee APIドキュメント」をご覧ください。
—
freee Developers Community 運営事務局・技術サポート
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の税区分に、次の税率を追加します
影響範囲
各種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をよろしくお願いいたします。
現在「旧エンドポイントでのアクセストークン取得、破棄」ができない事象が発生しております。修正対応完了まで今しばらくお待ち下さい。
現在利用できない処理
- 認可コードによるアクセストークンの取得
- リフレッシュトークンによるアクセストークンの取得
- アクセストークンの破棄
- リフレッシュトークンの破棄
freeeAPIの機能追加についてご連絡いたします。
新たに公開したAPI
従業員情報API・給与明細API・賞与明細API
概要
今までAPIでは取得できなかった、人事労務で用いる従業員情報や給与・賞与の明細がAPI化されました。以下のような情報がAPIから操作可能です。※一部抜粋
従業員情報API (POST/PUT/GET)
- 基本情報(住所等)
- 健康保険情報
- 厚生年金情報
- 扶養家族情報
- 給与振込先情報
- 給与情報
給与明細API (GET)
- 基本情報(基本給・労働・休暇日数等)
- 支給項目
- 控除項目
賞与明細API (GET)
注意事項
今回のリリースにて、より人事労務関連サービスとの便利な連携が実現可能となります。一方で個人情報や給与情報といったセンシティブな情報を扱うAPIであるため、利用に際しては細心の注意を持って情報管理を行なってください。
詳細は「
人事労務freee APIドキュメント」をご覧ください。
—
freee Developers Community 運営事務局・技術サポート
本日11:27頃まで、「取引先情報」の新規登録・編集が出来ない事象が発生しておりました。
現在、復旧対応が完了しており通常どおり機能をご利用いただけます。
ご迷惑をおかけしまして、大変申し訳ございません。
2019/03/26
現在、「取引先」情報の新規登録・編集が出来ない事象が発生しております。
修正対応完了まで今しばらくお待ち下さい。
下記の日時に、会計freeeを含む freeeの全サービスと各モバイルアプリでシステムメンテナンスを行います。
日時:3/26 (火) 1:00 – 5:00
対象: 全サービス
メンテナンス中は当該サービスおよびAPIをご利用いただけません。
ご迷惑をおかけしますが、よろしくお願いいたします。
—
freee Developers Community 運営事務局・技術サポート
https://support.freee.co.jp/hc/ja/requests/new
下記の日時に、freeeの全サービスと各モバイルアプリでシステムメンテナンスを行います。
日時:02/19 (火) 1:00 – 5:00
対象: 全サービス
メンテナンス中は当該サービスおよびAPIをご利用いただけません。
ご迷惑をおかけしますが、よろしくお願いいたします。
—
freee Developers Community 運営事務局・技術サポート
https://support.freee.co.jp/hc/ja/requests/new
下記の日時に、freeeの全サービスと各モバイルアプリでシステムメンテナンスを行います。
日時:02/07 (木) 1:00 – 5:00
対象: 全サービス
メンテナンス中は当該サービスおよびAPIをご利用いただけません。
ご迷惑をおかけしますが、よろしくお願いいたします。
—
freee Developers Community 運営事務局・技術サポート
https://support.freee.co.jp/hc/ja/requests/new
下記の日時に、freeeの全サービスと各モバイルアプリでシステムメンテナンスを行います。
日時:01/24 (木) 1:00 – 5:00
対象: 全サービス
メンテナンス中は当該サービスおよびAPIをご利用いただけません。
ご迷惑をおかけしますが、よろしくお願いいたします。
—
freee Developers Community 運営事務局・技術サポート
https://support.freee.co.jp/hc/ja/requests/new
下記の日時に、freeeの全サービスと各モバイルアプリでシステムメンテナンスを行います。
日時:12/19 (水) 1:00 – 5:00
対象: 全サービス
メンテナンス中は当該サービスおよびAPIをご利用いただけません。
ご迷惑をおかけしますが、よろしくお願いいたします。
—
freee Developers Community 運営事務局・技術サポート
https://support.freee.co.jp/hc/ja/requests/new
リリース概要
自動エラーチェックライブラリを導入し、バリデーションチェックの厳格化およびエラーレスポンスの形式統一を行います。
リリースによる変更点
- データ型のバリデーションが強化され、amountへのString型でのリクエストなどができなくなります。正しい指定形式はdeveloperサイトの「パラメータ詳細」欄をご確認ください。なお、修正が必要と思われるユーザー様へは別途個別に必要な変更についてご連絡いたします。
- エラーレスポンスの一部でerrorsのfieldをarrayではなく、文字列で返しておりました。今後はarray形式に統一いたします。
- リクエストヘッダーにて適切なapplication/jsonを指定してください。指定がない場合、エラーレスポンスが適切に返されない場合がございます。
- (一部パートナー)ファイルボックスAPI:multipart/form-data, boundary=Boundary
- journals #download:application/csv,application/pdf
- その他:application/json
詳細はドキュメントにてご確認ください
—
freee Developers Community 運営事務局・技術サポート
https://support.freee.co.jp/hc/ja/requests/new