税務プラグイン
このページの翻訳は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
税金計算が有効かどうかを指定します。(ブール。真または偽)
true
PriceIncludesTax
価格に税金が含まれているかどうかを明記します。
false
DefaultCartTaxRate
CalculateCartTaxBlockブロックで使用される税率(十進法)を指定します。
0.1
DefaultItemTaxRate
CalculateCartLinesTaxBlockが使用する税率(十進法)を指定します。
0.1
CalculateTaxBasedOn
税金計算の基準となる住所を指定します。可能な値は ShippingAddress、 BillingAddress、または StoreAddressです。
"ShippingAddress"
ShippingTaxClass
輸送に適用される税金を表すクラス名。
"CartItems"
RoundAtSubTotal
項目レベルでの四捨五入が行われるのか、順序小合計レベルで行われるのかを指定します。(ブール。真か偽か)
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
税率が過去の税に適用されるかどうかを指定します。(ブール
)デフォルトはない
IsShipping
この税率が船舶に適用されるかどうかを明記しています。(Bool.真偽)
デフォルトはない
TaxGroupPolicy
TaxプラグインはTaxGroupPolicyポリシーを定義します。
!注このポリシーはデフォルトでは使用されません。サンプル環境の設定ファイルには含まれていません。
ItemTaxPolicyポリシーポリシー
TaxプラグインはItemTaxPolicyポリシーを定義します。
!注このポリシーはデフォルトでは使用されません。サンプル環境の設定ファイルには含まれていません。
以下の表はItemTaxPolicyポリシーの性質を説明します。
財産
概要
デフォルト値
TaxClass
定義された税種(文字列形式)を指定します。
"Taxable"