消費税率のAPIリクエスト値に関する仕様変更のご案内

利用企業各位

2023年6月29日
株式会社ROBOT PAYMENT
サポートデスク課

消費税率のAPIリクエスト値に関する仕様変更のご案内

拝啓、貴社ますますご清栄のことお慶び申し上げます。
日頃は請求管理ロボをご利用いただき、誠にありがとうございます。
さて、この度2023年7月13日より請求管理ロボにおきまして、消費税率のAPIリクエスト値に関する仕様を変更いたします。利用企業様にはご不便をおかけいたしますが、何卒ご理解いただきますようお願い申し上げます。

敬具

記

■仕様変更内容

下記4つのAPI仕様を変更いたします。
・請求情報登録更新  /api/v1.0/demand/bulk_upsert
・商品登録更新2  /api/v1.0/goods/bulk_upsert2
・請求情報登録（非推奨） /api/demand/add
・商品登録更新（非推奨）  /api/v1.0/goods/bulk_upsert

上記APIリクエストにて消費税率の値（tax）消費税率【5（5％）・8（8％）・10（10％）】ではなく各税率のIDである【3（5％）・1（8％）・2（10％）】を入力してもエラーが発生せず登録可能な状態となっておりました。
※消費税「8% , 10% , 5%」が弊社のDB上の消費税マスタでは、それぞれ「1・2・3」が割り当てられており、一部APIのリクエストでは登録可能な状態となっておりました。

上記仕様を変更し、利用可能な消費税率の値【5（5％）・8（8％）・10（10％）】以外のリクエストはエラーが返却されるよう改修致します。
現仕様と修正後のエラーの発生パターンについては下記概要をご確認ください。

なお、請求管理ロボで指定可能な消費税マスタは5% , 8% , 10% の3種類ございます。
※消費税5%機能をご希望の場合は、弊社にて別途手続きが必要となります。

■対象企業
請求管理ロボ ご利用企業様

■対象機能
①管理画面：変更なし
②CSV　　：変更なし
③API　　 ：変更あり

 

■概要

それぞれのAPIについて、リクエスト条件に対する現状の動作と、仕様変更後の挙動を記載いたします。

請求情報登録更新 /api/v1.0/demand/bulk_upsert

バグが発生する条件	現状	仕様変更後
商品指定のありなし関係なく 税区分を2(対象外)or3(非課税)、 消費税率で1,2,3のいずれかを 指定した場合	内部的にはnullと同じ扱いとなり、リクエスト値を無視する （空で返却される）	「エラーコード1316 　消費税率が不正」が返却される

商品登録更新2  /api/v1.0/goods/bulk_upsert2
商品登録更新（非推奨）  /api/v1.0/goods/bulk_upsert

バグが発生する条件	現状	仕様変更後
登録処理且つ、 税区分0(外税)or1(内税)、 消費税率で1,2,3を指定した場合	1は8%, 2は10%, 3は5%として登録される	「エラーコード1811 　消費税率が不正」が返却される
登録処理且つ、 税区分を2(対象外)or3(非課税)、 消費税率で1,2,3を指定した場合	内部的にはnullと同じ扱いとなり、リクエスト値を無視する （空で返却される）	「エラーコード1811 　消費税率が不正」が返却される
更新処理且つ、税区分に関係なく 消費税率で1,2,3のいずれかを指定した場合	1は8%, 2は10%, 3は5%として登録される	「エラーコード1811 　消費税率が不正」が返却される

請求情報登録（非推奨） /api/demand/add

バグが発生する条件	現状	仕様変更後
商品指定のありなし関係なく、 税区分2or3で消費税率で1,2,3の いずれかを指定した場合	内部的にはnullと同じ扱いとなり、リクエスト値を無視する （空で返却される）	「エラーコード211 　消費税率が不正」が返却される

■仕様変更予定日時
　2023年7月13日(木)午前9時ごろ

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

以上

━━━━━━━━━━━━━━━━━━━━━━━━━━━

株式会社ROBOT PAYMENT
〒150-0001 東京都渋谷区神宮前6-19-20 第15荒井ビル4F
TEL [phone]（サポートデスク直通）

業務時間のご案内
TEL：平日9:00～18:00まで(12:00～13:00を除く)
MAIL：平日休日問わずお送りください。
　　　 御対応は翌営業日までにご返信させて頂きます。

━━━━━━━━━━━━━━━━━━━━━━━━━━━