税金プラグイン
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore.Commerce.Plugin.Taxプラグインは、カートレベルと品目レベルの両方で税金調整を適用するためのパイプラインブロックとポリシーを実装するサンプルの税金計算機です。
Sitecore.Commerce.Plugin.Taxプラグインはサンプルとしてのみ提供されており、本番環境での使用は意図されていません。サンプル税プラグインを出発点として使用して、特定の税計算要件を満たすカスタム税プラグインを開発できます。
パイプライン ブロック
Sitecore.Commerce.Plugin.Taxプラグインは、注文に税金がどのように適用されるかを計算するために使用される次のパイプラインブロックを定義します。
-
CalculateCartLinesTaxBlockパイプライン ブロック
-
CalculateCartTaxBlockパイプライン ブロック
-
RegisteredPluginBlockブロック
CalculateCartLinesTaxBlockブロック
ICalculateCartLinesPipelineパイプラインでは、CalculateCartLinesTaxBlockブロックは、カート品目レベルで適用される税合計を計算するサンプル パイプライン ブロックです。課税対象の販売可能商品を含むすべてのカート品目にCartLineLevelAwardedAdjustmentが追加されます。この調整の計算に使用される税率は、GlobalTaxPolicyポリシーで構成できます。
CalculateCartLinesTaxBlockブロックはサンプルとしてのみ意図されています。一般的なCommerceデプロイでは、このブロックを、デプロイの適切なサードパーティの税プロバイダーへの呼び出しに置き換えます。
CalculateCartTaxBlockブロック
ICalculateCartPipelineパイプラインでは、CalculateCartTaxBlockブロックは、注文全体に適用される課税対象税額の合計を表すカート レベルの税額調整を計算するサンプル パイプライン ブロックです。この調整の計算に使用される税率は、GlobalTaxPolicyポリシーで構成できます。
カートにSplitFulfillmentComponentコンポーネントが含まれている場合、CalculateCartTaxBlockブロックはアクションを実行せず、税調整はアイテムレベルでのみ計算されます。
RegisteredPluginBlockブロック
IRunningPluginsPipelineパイプラインでは、RegisteredPluginBlockブロックを使用して税プラグインをCommerce Engineに登録します。
檄
サンプルSitecore.Commerce.Plugin.Taxプラグインは、CalculateCartLinesTaxBlockブロックとCalculateCartTaxBlockブロックが税調整を適用する方法を構成できる税ポリシーを定義します。
GlobalTaxPolicyポリシー
GlobalTaxPolicyポリシーは、次の既定のCommerce環境構成ファイルで構成できます。
-
PlugIn.Habitat.CommerceAuthoring-1.0.0.json
-
PlugIn.Habitat.CommerceMinions-1.0.0.json
-
PlugIn.Habitat.CommerceShops-1.0.0.json
-
PlugIn.AdventureWorks.CommerceAuthoring-1.0.0.json
-
PlugIn.AdventureWorks.CommerceMinions-1.0.0.json
-
PlugIn.AdventureWorks.CommerceShops-1.0.0.json
次の表では、GlobalTaxPolicyポリシーのプロパティについて説明します。
|
財産 |
形容 |
既定値 |
|---|---|---|
|
TaxCalculationEnabled |
税計算を有効にするかどうかを指定します。(bool. 真または偽)。 |
true |
|
PriceIncludesTax |
価格に税金が含まれているかどうかを指定します。 |
false |
|
DefaultCartTaxRate |
CalculateCartTaxBlockブロックで使用される税率 (10進数形式) を指定します。 |
0.1 |
|
DefaultItemTaxRate |
CalculateCartLinesTaxBlockで使用される税率 (10進数形式) を指定します。 |
0.1 |
|
CalculateTaxBasedOn |
税金計算の基準となる住所を指定します。取り得る値は、ShippingAddress、BillingAddress、またはStoreAddressです。 |
"ShippingAddress" |
|
ShippingTaxClass |
配送に適用される税金を表すクラスの名前。 |
"CartItems" |
|
RoundAtSubTotal |
丸めを品目レベルと受注小計レベルのどちらで行うかを指定します。(bool. 真または偽)。 |
false |
|
TaxExemptTag |
免税対象のカート品目を識別するために使用するタグの名前を指定します。これらの品目の税計算はスキップされます。 手記 このプロパティはTaxプラグインで定義されていますが、現在は使用されておらず、GlobalTaxPolicyポリシーには含まれていません。 |
"taxexempt" |
|
TaxExemptTagsEnabled |
TaxExemptTagをcalculateCartLinesTaxBlockで使用するかどうかを指定します。CalculateCartTaxBlock. 手記 このプロパティはTaxプラグインで定義されていますが、現在は使用されておらず、GlobalTaxPolicyポリシーには含まれていません。 |
true |
TaxRatePolicyポリシー
Taxプラグインは、TaxRatePolicyポリシーを定義します。
このポリシーはデフォルトでは使用されません。サンプル環境設定ファイルには含まれていません。
次の表では、TaxRatePolicyポリシーのプロパティについて説明します。
|
財産 |
形容 |
既定値 |
|---|---|---|
|
CountryCode |
国コード (ISO 3166-1 alpha-2標準に基づく)。文字列値として定義されます。 |
デフォルトなし |
|
StateCode |
税務上の州に対応するコード (文字列形式)。すべての状態を空白のままにします。 |
デフォルトなし |
|
PostalCode |
税率の郵便番号 (文字列形式)。複数のコードはセミコロンで区切ります。すべてのコードで、値を割り当てないでください (空白のままにします)。 |
デフォルトなし |
|
City |
課税の都市 (文字列形式)。 |
デフォルトなし |
|
TaxRate |
税率 (%) (10進数形式)。 |
デフォルトなし |
|
TaxName |
この税率の税の名前 (文字列形式)。たとえば、VAT、GSTなどです。 |
デフォルトなし |
|
Priority |
複数の税率が存在する場合の税率 (整数形式) の優先順位を指定します。税率ごとに異なる優先順位を指定します。 |
デフォルトなし |
|
IsCompounded |
税率を以前の税金に適用するかどうかを指定します。(bool. 真または偽)。 |
デフォルトなし |
|
IsShipping |
配送に税率を適用するかどうかを指定します。(bool. 真または偽)。 |
デフォルトなし |
TaxGroupPolicy (税グループ ポリシー)
Taxプラグインは、TaxGroupPolicyポリシーを定義します。
このポリシーはデフォルトでは使用されません。サンプル環境設定ファイルには含まれていません。
ItemTaxPolicyポリシー
Taxプラグインは、ItemTaxPolicyポリシーを定義します。
このポリシーはデフォルトでは使用されません。サンプル環境設定ファイルには含まれていません。
次の表では、ItemTaxPolicyポリシーのプロパティについて説明します。
|
財産 |
形容 |
既定値 |
|---|---|---|
|
TaxClass |
定義済みの税区分 (文字列形式) を指定します。 |
"Taxable" |