インボイス（適格請求書）設定によるAPIへの影響について

2023年4月24日より順次実施されるBカートのアップデート（v3.5.2）により、Bカート本体にインボイス制度に対応するための設定が追加されます。
該当設定の有効/無効により下記のエンドポイントにて取得される値が変わりますので、設定を変更する場合は事前に変更内容を確認、調整をお願いいたします。（設定を変更されない場合対応は不要です）

  • 受注
  • 受注商品
  • 会員
  • 配送グループ

また関連して下記エンドポイントへパラメータを追加いたします。必要に応じてご活用ください。

  • 受注

Bカート本体のアップデートの詳細はこちらご確認ください。


Bカート本体への設定追加日時

2023年4月24日より順次実施いたします。

BカートAPIへのパラメータ追加日時

2023年4月26日 12:00 ~ 13:00

1.設定変更後に自動的に出力内容が変わるエンドポイント

  1. 受注（orders）
  2. 受注商品（order_products）

2.関連するパラメータが追加されるエンドポイント

  1. 受注（orders）

3.設定変更する際に出力内容の変更が必要なエンドポイント

  1. 会員（customers）
  2. 配送グループ（shipping_groups）

4.その他の影響について

  1. WebHook


1.1 受注（orders）

インボイス設定を変更後に作成された受注の取得（GET）において、下記項目の出力内容が自動的に変わります。

キー名 Bカートでの名称 インボイス設定無効（現在） インボイス設定有効
shipping_cost 送料 税込金額 税抜金額
COD_cost 決済手数料 税込金額 税抜金額
use_point ポイント利用 税込金額 税抜金額
total_price 商品総額 税抜金額（整数） 税抜金額（小数点以下を含む）
tax 消費税 商品総額にかかる消費税額（送料等にかかる消費税を含まない） 注文総額にかかる消費税額（送料等にかかる消費税も含む）



1.2 受注商品（order_products）

インボイス設定を変更後に作成された受注商品の取得（GET）において、ポイント明細（item_typeがpoint）の出力内容が変わります。

キー名 Bカートでの名称 インボイス設定無効（現在） インボイス設定有効
unit_price 単価 税込金額 税抜金額
tax_incl 税込フラグ 1 0

参考（その他の明細について）

その他の明細については、インボイス設定の影響を受けない（商品明細）、または、インボイス設定を有効にするために事前に税抜金額登録への設定変更が必要になるため、出力内容も変更となる可能性があります（送料・決済手数料明細）。

商品明細（item_typeがproduct）
※ インボイス設定の変更前後で、出力内容は変わりません。

キー名 Bカートでの名称 インボイス設定無効（現在） インボイス設定有効
unit_price 単価 税抜金額 税抜金額
tax_incl 税込フラグ 0 0

送料明細（item_typeがshipping）および決済手数料明細（item_typeがpayment_fees）
※ インボイス設定を有効にするための事前の設定変更に伴い、出力内容も変更となる可能性があります。

キー名 Bカートでの名称 インボイス設定無効（現在） インボイス設定有効
unit_price 単価 税込金額 or 税抜金額 税抜金額
tax_incl 税込フラグ 1 or 0 0



2.1 受注（orders）にパラメータ追加

インボイス設定は、インボイス設定変更後に作成された受注だけに適用されます（設定を変更しても過去の受注には適用されません）。
そのためAPIにおいて、インボイス設定が適用されているかの判別が可能となるようにパラメータを追加しております。
インボイス設定の変更前後で、有効/無効の受注を区別して取り扱う必要がある場合の絞り込み条件としてご活用ください。

キー名 Bカートでの名称 型 説明
qualified_invoice インボイス設定フラグ 整数 0=適用されていない受注,1=適用されている受注



3.1 会員（customers）

インボイス設定を変更する際に、Bカート管理画面より下記項目の金額を手動で変更する必要があります。
そのため変更後はAPIにおいて取得（GET）、更新（PATCH）、追加（POST）時の出力や入力する値が変更となる可能性があります。

キー名 Bカートでの名称 インボイス設定無効（現在） インボイス設定有効
special_shipping_cost 会員ごとの特別送料 税込金額 税抜金額



3.2 配送グループ（shipping_groups）

インボイス設定を変更する際に、Bカート管理画面より下記項目を手動で変更する必要があります。
そのため変更後はAPIにおいて、取得（GET）時の出力される値が変更となる可能性があります。

キー名 Bカートでの名称 インボイス設定無効（現在） インボイス設定有効
tax_included 送料の税込フラグ 1 or 0 0
cost 送料 税込金額 or 税抜金額 税抜金額
tax_COD_included 決済手数料の税込フラグ 1 or 0 0
cod_cost 決済手数料 税込金額 or 税抜金額 税抜金額



4.その他の影響について

Bカート本体で設定可能なWebHookですが、こちらに関してもAPIの変更に伴い送信される値が変更されます。
影響するWebHookのイベントは受注登録、変更と会員登録、変更となります。 変更内容に関しましてはAPIと同じとなりますので、ご利用いただいている場合は合わせてご確認ください。