--- title: "税務プラグイン" slug: "tax-plugin" abstract: "サンプルのSitecore Commerce Taxプラグインの概要と、それが提供する要素です。" --- # 税務プラグイン Sitecore.Commerce.Plugin.Taxプラグインはサンプル税計算機で、カートレベルと項目項目レベルで税務調整を適用するためのパイプラインブロックやポリシーを実装しています。 > !注Sitecore.Commerce.Plugin.Taxプラグインはサンプルのみ提供されており、本番環境向けではありません。サンプル税プラグインを出発点として、特定の税計算要件を満たすカスタム税金プラグインを開発できます。 ## パイプラインブロック Sitecore.Commerce.Plugin.Taxプラグインは、注文に税金がどのように適用されるかを計算するために使われる以下のパイプラインブロックを定義しています。 - CalculateCartLinesTaxBlockパイプラインブロック - CalculateCartTaxBlockパイプラインブロック - RegisteredPluginBlock棟 ### CalculateCartLinesTaxBlockブロック ICalculateCartLinesPipelineパイプラインでは、CalculateCartLinesTaxBlockブロックはカートラインレベルで適用される税額を計算するサンプルパイプラインブロックです。これは課税対象の販売品を含むすべてのカートラインにCartLineLevelAwardedAdjustmentを追加します。この調整を計算する税率はGlobalTaxPolicy[ポリシー](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/tax-plugin.html#UUID-f7298afd-2cde-0879-9db4-f54a9e6dd998_section-idm4575661964065631677309148427 "Policies")で設定可能です。 > !注CalculateCartLinesTaxBlockブロックはあくまでサンプルとして意図されています。一般的なCommerceのデプロイメントでは、このブロックを部署用の適切な第三者税務提供者への呼び出しに置き換えます。 ### CalculateCartTaxBlockブロック ICalculateCartPipelineパイプラインにおいて、CalculateCartTaxBlockブロックはサンプルパイプラインブロックで、カートレベルの税調整を計算し、注文全体に適用される課税税額の総額を表します。この調整を計算する税率はGlobalTaxPolicy[ポリシー](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/tax-plugin.html#UUID-f7298afd-2cde-0879-9db4-f54a9e6dd998_section-idm4575661964065631677309148427 "Policies")で設定可能です。 > !注カートにSplitFulfillmentComponentコンポーネントが含まれている場合、CalculateCartTaxBlockブロックは何のアクションも取らず、税金の調整はアイテムレベルでのみ計算されます。 ### RegisteredPluginBlockブロック IRunningPluginsPipelineパイプラインでは、RegisteredPluginBlockブロックがCommerce Engineで税務プラグイン[を登録](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/registering-a-custom-commerce-pipeline-or-block.html "Registering a custom Commerce pipeline or block")するために使われます。 ## 方針 サンプルSitecore.Commerce.Plugin.Taxプラグインは、CalculateCartLinesTaxBlockとCalculateCartTaxBlockブロックがどのように税務調整を適用するかを設定できる税制ポリシーを定義しています。 ### GlobalTaxPolicy方針 GlobalTaxPolicyポリシーは以下のデフォルトの[Commerce環境設定](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-engine-environments.html "Commerce Engine environments")ファイルで設定できます: - 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"