順序積分

Orders API(C#)での作業

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Ordersサービスは、RESTfulでOData準拠のAPIを提供しており、他のビジネスシステムと統合して注文関連データを交換することができます。このトピックでは、Orders APIを使ってC#プログラミング言語を使ったCommerce統合を構築する例を提供します。

!注このトピックに含まれるC#コード例は、Sitecore Commerce Engine Software Development Kit(Sitecore.Commerce.Engine.SDK)にパッケージ化されたSitecore.Commerce.Sample.Consoleサンプルに基づいています。

コンテナコール内にはCommerce Engineの操作やコマンド(C#を使用)を含める必要があります(この例参照)。

Sitecore Experience Commerce(XC)システムでいかなる操作を実行するには、発信者はまずSitecore Identityサーバーから有効なベアラー認証トークンを取得する必要があります。

!注注文の履行や支払いの処理など、Orders Views and Actions APIを使えば、他の操作もプログラム的に実行できます。

注文を作成する(C#)

必要な商品、フルフィルメント、支払い情報がすべて揃っているショッピングカートに注文APIを使えば注文を作成できます。

注文を作成するには、CreateOrderクエリを使用します。クエリはショッピングカートのID(cartId)と買い物客のメールアドレスを提供しなければなりません。例えば:

Container container = AuthoringContainer(); DataServiceActionQuerySingle actionQuery = container.CreateOrder("cartId", "[email protected]"); CommerceCommand command = Proxy.DoCommand(actionQuery); string orderId = command.Models.OfType().FirstOrDefault().OrderId;

注文をキャンセルする(C#)

注文ステータスが保留中または 保留中の場合、注文をキャンセルするためにOrders APIを使うことができます。

注文をキャンセルするには:

Container container = AuthoringContainer(); DataServiceActionQuerySingle actionQuery = container.CancelOrder(orderId); CommerceCommand command = Proxy.DoCommand(actionQuery);

注文をカスタムステータス(C#)に設定してください

注文をカスタムステータスに設定できます。

!重要デフォルトでは、Commerce Orderフローは注文のステータスに基づいています。注文の状態は、End to Endプロセスフローで次に取るべき処理を決定します。カスタムオーダーステータスの導入は、Commerce Orderの通常のシステム内での流れに影響を与えることを念頭に置いてください。

注文を顧客ステータスに設定するには、C#を使って:

DataServiceActionQuerySingle actionQuery = container.SetOrderStatus(orderId, "CustomStatus"); CommerceCommand command = Proxy.DoCommand(actionQuery);

注文から販売活動を取得する(C#)

Sitecore XC注文の支払い情報が更新されるたびに販売活動を生成します。

注文の販売活動をC#で取得するには:

DataServiceQuery actionQuery = container.GetOrderSalesActivities(orderId); IEnumerable salesActivities = Proxy.Execute(actionQuery);

この記事を改善するための提案がある場合は、お知らせください!