プライシングAPIを活用しましょう

価格帳を追加(C#)

価格帳を追加するには、クエリで一意の価格帳名を指定する必要があります。オプションで、表示名や説明を含めることも可能です。

価格帳を追加するには、例えば内部名(MyPriceBook)、表示名(Book Display Name)、帳簿説明(Book Description)を指定します。

DataServiceActionQuerySingle actionQuery = container.AddPriceBook("MyPriceBook", "Book Display Name", "Book Description", "{0F65742E-317F-44B0-A4DE-EBF06209E8EE}"); CommerceCommand command = Proxy.DoCommand(actionQuery);

クエリ応答はPriceCardAddedモデルを用いて価格表に配慮したIDを返します。例えば:

PriceBookAdded priceBookAddedModel = command.Models.OfType().FirstOrDefault(); string bookFriendlyId = priceBookAddedModel?.PriceBookFriendlyId;

プライスブック(C#)を入手してください

クエリにフレンドリーなIDを含めることで、既存の価格帳をプログラム的に取得できます。オプションで、ODataの拡張オプション を使ってOdataクエリを価格帳のコンポーネントを含めて拡張することもできます。

例えば、価格帳とその構成要素を取得するには:

DataServiceQuerySingle query = container.PriceBooks.ByKey(bookFriendlyId).Expand("Components"); PriceBook book = Proxy.GetValue(query);

価格帳(C#)を編集する

プライシングAPIを使って、プライスブックをプログラム的に編集できます。プライスブックを編集する際、内部名を変更することはできません。プライスブックの表示名、説明、通貨セットのプロパティは変更できます。

!注通貨を変更するには、Sitecoreコンテンツエディター内のCommerce Control Panelをご利用ください。

価格帳の編集方法:

• 価格帳の説明や表示名を変更するには:

  DataServiceActionQuerySingle actionQuery = container.EditPriceBook(bookFriendlyId, "edited book description", "edited book display name", "{0F65742E-317F-44B0-A4DE-EBF06209E8EE}"); CommerceCommand command = Proxy.DoCommand(actionQuery);

• 例えば、表示名を変えずに価格帳の説明を変更する方法:

  actionQuery = container.EditPriceBook(bookFriendlyId, string.Empty, "edited book display name only", "{0F65742E-317F-44B0-A4DE-EBF06209E8EE}"); command = Proxy.DoCommand(actionQuery); CommerceCommand command = Proxy.DoCommand(actionQuery);

関連カタログ(C#)を入手

プライシングAPIを使って、プライスブックに関連付けられたカタログのリストを取得します。

例えば、関連するカタログを取得するには、AventureWorksPriceBookに関連付けられたカタログのリストを以下に示します:

DataServiceQuery query = container.GetPriceBookAssociatedCatalogs("AdventureWorksPriceBook"); List catalogs = Proxy.Execute(query).ToList();

カタログを価格帳(C#)に関連付ける

1つまたは複数のカタログをプライスブックにプログラム的に関連付けることができます。カタログは1つのプライスブックにしか関連付けられません。

!注カタログは一度に単一の価格帳にしか関連付けられません。もしカタログがすでに価格簿に関連付けられている場合、そのカタログを別の価格帳に関連付けることができますが、最初のカタログとの関連付けは失われます。残るのは最新の関連のみです。

例えば、カタログを価格帳に関連付け、MyPriceBookをMyCatalogに関連付ける場合:

DataServiceActionQuerySingle actionQuery = container.AssociateCatalogToPriceBook("MyPriceBook", "MyCatalog"); CommerceCommand command = Proxy.DoCommand(actionQuery);

カタログを価格帳(C#)から切り離す

関連する価格帳からカタログをプログラム的に作成できます。

カタログを価格帳から切り離す、例えばMyCatalog" をMyPriceBookから切り離す:

DataServiceActionQuerySingle actionQuery = container.DisassociateCatalogFromPriceBook("MyPriceBook", "MyCatalog"); CommerceCommand command = Proxy.DoCommand(actionQuery);

プライスカード(C#)を追加してください

プライスカードをプライスブックに追加するには、クエリでプライスカードの内部名とカードを追加するプライスブック名を指定する必要があります。

プライスカードの名前はプライスブック内で一意でなければなりません。プライスカードを作成した後に内部名を変更することはできません。オプションで、プライスカードの表示名や説明を含めることも可能です。

例えば、価格簿に価格表を付けるには、MyPriceBookにMyPriceCardを追加するには:

DataServiceActionQuerySingle actionQuery = container.AddPriceCard("MyPriceBook", "MyPriceCard", "Card Display Name", "Card Description"); CommerceCommand command = Proxy.DoCommand(actionQuery);

// the price card friendly id is returned in the PriceCardAdded model PriceCardAdded priceCardAddedModel = command.Models.OfType().FirstOrDefault(); string cardFriendlyId = priceCardAddedModel?.PriceCardFriendlyId;

クエリはPriceCardAddedモデルを用いた価格カードのフレンドリーIDを返します。以下の例に示されます。

PriceCardAdded priceCardAddedModel = command.Models.OfType().FirstOrDefault(); string cardFriendlyId = priceCardAddedModel?.PriceCardFriendlyId;

価格表(C#)を編集する

プライスカードの詳細はプログラム的に変更できます。プライスカードの内部名は変更できません。変更できるのはプライスカードの表示名と説明だけです。クエリで物件の新しい値を指定しなければ、既存の値は変更されません。

価格表を編集するには、クエリに新しい名前や新しい説明、またはその両方を含めてください。例えば:

DataServiceActionQuerySingle actionQuery = container.EditPriceCard(cardFriendlyId, "edited card display name", "edited card description"); CommerceCommand command = Proxy.DoCommand(actionQuery);

プライスカードの複製(C#)

同じ価格帳内で新しい価格カードを作成したい場合、すべての価格スナップショットを ドラフト 状態に設定した価格表を複製してください。

プライスカードを複製するには:

DataServiceActionQuerySingle actionQuery = container.DuplicatePriceCard(CardFriendlyId, "MyDuplicatePriceCard"); CommerceCommand command = Proxy.DoCommand(actionQuery);

クエリはPriceCardAdded モデルにおける新しい価格カードのフレンドリーなIDを返します。例えば:

string duplicatedCardFriendlyId = command.Models.OfType().FirstOrDefault()?.PriceCardFriendlyId;

プライスカードを削除してください

プライスカードは 承認 されたスナップショットが含まれていない場合にのみ削除できます。

プライスカードを削除するには:

DataServiceActionQuerySingle actionQuery = container.DeletePriceCard(cardFriendlyId); CommerceCommand command = Proxy.DoCommand(actionQuery);

価格スナップショットを追加(C#)

プライシングAPIを使って、プライスカードにプログラム的にスナップショットを追加できます。

クエリでは、価格カードに配慮したID(cardFriendlyId、およびsnapshotDate)を指定してください。

価格カードにスナップショットを追加するには、価格情報を即座に適用するためにsnapshotBeginDate = DateTimeOffset.UtcNowを使うことができます(または、将来の日付を指定することもできます):

var snapshotBeginDate = DateTimeOffset.UtcNow; DataServiceActionQuerySingle actionQuery = container.AddPriceSnapshot(cardFriendlyId, snapshotDate); CommerceCommand command = Proxy.DoCommand();

応答はPriceCardAddedモデルを用いて価格スナップショットIDを返します。

string snapshotId = command.Models.OfType;().FirstOrDefault()?.PriceSnapshotId;

スナップショットを編集する(C#)

プライシングサービスAPIを使って、プライスカードの適用日を変更するなど、プログラム的にスナップショットを編集できます。

ドラフトステータスにある価格スナップショットに変更はできません。

例えば、ドラフトスナップショットを変更するには、DateTimeOffset.UtcNow.AddDays(5) メソッドを用いてください:

var snapshotNewBeginDate = DateTimeOffset.UtcNow.AddDays(5); DataServiceActionQuerySingle actionQuery = container.AddPriceSnapshot(cardFriendlyId, snapshotNewBeginDate); CommerceCommand command = Proxy.DoCommand(actionQuery);

スナップショット価格(C#)を削除する

プライシングAPIを使って、プライスカードからスナップショット価格を削除できます。

スナップショット価格を削除するには:

DataServiceActionQuerySingle actionQuery = container.RemovePriceSnapshot(cardFriendlyId, snapshotId); CommerceCommand command = Proxy.DoCommand(actionQuery);

価格スナップショットにタグを追加する(C#)

タグは販売可能な商品をまとめる方法です。Pricing APIを使って価格スナップショットにタグを追加できます。そのタグを使って、同じタグに割り当てられたすべての販売可能な商品にスナップショットを適用できます。

例えば価格スナップショットにタグを追加するには、MyTag:

DataServiceActionQuerySingle actionQuery = container.AddPriceSnapshotTag(cardFriendlyId, snapshotId, "MyTag"); CommerceCommand command = Proxy.DoCommand(actionQuery);

スナップショットからタグを削除する方法(C#)

同じタグが割り当てられた販売可能なアイテム群にスナップショット価格を適用したくない場合は、スナップショットからタグを削除できます。

例えば、スナップショットからタグを削除するには、指定されたスナップショットからタグMyTagをID:

DataServiceActionQuerySingle actionQuery = container.RemovePriceSnapshotTag(cardFriendlyId, snapshotId, "MyTag"); CommerceCommand command = Proxy.DoCommand(actionQuery);

価格帯(C#)を追加

プライシングAPIを使って、価格カードに階層別価格を追加できます。

例えば、価格カードに階層価格を追加するには、USD通貨を指定する階層、1の数量と20の価格を追加してください:

DataServiceActionQuerySingle actionQuery = container.AddPriceTier(cardFriendlyId, snapshotId, "USD", 1, 20); CommerceCommand command = Proxy.DoCommand(actionQuery);

価格帯IDはPriceTierAddedモデルで返されます。例えば:

string priceTierId = command.Models.OfType().FirstOrDefault()?.PriceTierId;

価格帯(C#)を編集します

ティア価格の価格特性は変更できます。数量や通貨は変更できません。

階層価格の価値を変更するには、カード対応のID、スナップショットID、価格帯のID、そしてその価格帯の新しい金額の値をリクエストで指定してください。例えば:

DataServiceActionQuerySingle actionQuery = container.EditPriceTier(cardFriendlyId, snapshotId, priceTierId,30); CommerceCommand command = Proxy.DoCommand(actionQuery);

価格帯(C#)を削除する

価格カードから段階的な価格を削除することができます。

価格帯を削除するには、カード対応のID、スナップショットID、価格帯のIDをリクエストで指定してください。例えば:

DataServiceActionQuerySingle actionQuery = container.RemovePriceTier(cardFriendlyId, snapshotId, priceTierId); CommerceCommand command = Proxy.DoCommand(actionQuery);

スナップショットの状態を ドラフト からReadyForApprovalに変更する(C#)

スナップショットステータスを ドラフト からReadyForApprovalに変更して承認をリクエストできます。オプションで、リクエストにコメントを含めることもできます。

例えば、コメント文字列を含むドラフトスナップショットの承認を要求する場合(このスナップショットは承認準備完了です):

// requesting approval DataServiceActionQuerySingle actionQuery = container.SetPriceSnapshotsApprovalStatus(cardFriendlyId, new List { snapshotId }, "ReadyForApproval", "This snapshot is ready to be approved"); CommerceCommand command = Proxy.DoCommand(actionQuery);

スナップショットの状態をReadyForApprovalから ドラフト (C#)に変更する

スナップショットのステータスをReadyForApprovalからdraftに変更してスナップショットを拒否できます。オプションで、クエリにコメント文字列を含めることも可能です。

例えば、スナップショットのステータスをReadyForApprovalからDraftに変更するには、オプションのコメント文字列を含めてください。 このスナップショットは拒否されました:

// rejecting approval of a snapshot DataServiceActionQuerySingle actionQuery = container.SetPriceSnapshotsApprovalStatus(cardFriendlyId, new List { snapshotId }, "Draft", "This snapshot has been rejected"); CommerceCommand command = Proxy.DoCommand(actionQuery);

スナップショットの状態をApproved (C#)に変更する

スナップショットのステータスをReadyForApprovalからApprovedに変更して承認します。オプションで、クエリにコメント文字列を含めることもできます。

スナップショットを承認するには:

// approving a snapshot DataServiceActionQuerySingle actionQuery = container.SetPriceSnapshotsApprovalStatus(cardFriendlyId, new List { snapshotId }, "Approved", "This snapshot is now approved"); CommerceCommand command = Proxy.DoCommand(actionQuery);