--- title: "注文パイプライン" slug: "order-pipelines" abstract: "GetAvailableRegionsパイプラインの概要。これはECSから国内の利用可能なリージョンのリストを取得します。" --- # 注文パイプライン ## SubmitVisitorOrderパイプライン **名前:** **送信訪問者注文** **説明:** このパイプラインは注文の作成を担当します。注文は商取引システムによって管理されます。 **使用方法:** Sitecoreから電話をかけてきました。 **ARGS:** \*\*リクエスト -\*\*店舗名、カート、顧客ID、買い手(発送)および会計(請求書)の顧客パーティIDが記載されたカートが含まれています。 \*\*Response -\*\*orderオブジェクトを含む。 **プロセッサー:** \*\*CreateOrderInExternalSystem – \*\*与えられたパラメータに基づいて外部商取引システム内で注文を作成します。 \> \[!注\] \> カートの処理中にエラーが発生した場合、SubmitVisitorOrderResultの*Success*プロパティはfalseに設定されます。 \*\*AbandonCurrentSession -\*\*すべての注文が行われた後に実行され、インタラクションが [xDBコレクションデータベース](https://doc.sitecore.com/xp/en/developers/101/platform-administration-and-architecture/en/xdb-collection-database.html)にフラッシュされるようにします。これはセッションを放棄することで行われ、セッションは終了しますが破棄されません。 注文が連続して即座に行われる場合、ホームページ上の商品推薦が最新の注文に基づいているまでに遅延が生じる可能性があります。これは、トラッカーがデータを処理し、xDBコレクションデータベースに反映する時間が必要なためです。 \>\[!重要\] \> AbandonCurrentSession プロセッサを使うと、同じ訪問でのセッション数が増え、顧客が注文をした際にxDBコレクションデータベース内でのやり取りが増えます。このため、 AbandonCurrentSession プロセッサはデフォルトで無効化されています。 \*\*TriggerOrderGoal – \*\*Visitor Order Created 目標は、ShopName、Customer ID、Order ID、総注文金額の値でトリガーされます。 エンゲージメント値は注文総額に相当します。 \> \[!注\] \> SubmitVisitorOrderResultのSuccessプロパティが偽であれば、目標は発生しません。 **TriggerLoyaltyCardPurchasePageEvent**\*\*–\*\*ロイヤルティカード購入イベントは何の価値も表示されません。 **トリガーギフトカード購入ページイベント**\*\*–\*\*ギフトカード購入イベントは、何の値も表示されません。 **TriggerOrderedProductStockStatusPageEvent**\*\*–\*\* Ordered Product Stock Statusイベントは、カート内の各商品やその状況の詳細が一切表示されないままトリガーされます。 **TriggerOrderOutcome**\*\*–\*\*注文された結果は注文関連データとともに上昇します。 **UpdateVisitorInAutomationPlan –** **責任:** 現在の連絡先を *New Order Placed* キャンペーン処理者に登録すること。 **使用方法:** 任意。Commerceマーケティングオートメーションキャンペーンに登録している人を特定するために使用されます。 **所有権:** プロセッサーにはConnectが付属しています。 **カスタマイズ:** 以下のパラメータに基づいて、現在の連絡先を *New Order Placed* マーケティングオートメーションキャンペーンに登録します: - basePlanName はキャンペーンプラン名です。デフォルト値は「New Order Placed」です。 - allowDuplicateContacts 同じ連絡先をマーケティングオートメーションキャンペーンに複数回登録させるかどうかを示します。デフォルト値はfalseです。 - allowUnauthenticatedContacts 匿名および未登録ユーザーの登録を許可するかどうかを示します。デフォルト値はtrueです。 さらなるカスタマイズのために、プロセッサを継承することも可能です。 ## GetAvailableCountriesパイプライン **名前:** GetAvailableCountries(取得可能国) **説明:** ECSから利用可能な国のリストを受け取る **使用方法:** Sitecoreから電話をかけてきました。 **ARGS:** **リクエスト –** \*\*回答 –\*\*利用可能な国の一覧。 **プロセッサー:** **GetAvailableCountries(取得可能国****)** **責任:**ECSから国のリストを受け取る。 **使用方法**:プロセッサーは必須です。 **所有権**:プロセッサにはECSコネクタが付属し、Connectと統合されています。 **カスタマイズ:**プロセッサは常にECSと連携する実装を持つ必要があります。 ## GetAvailableRegionsパイプライン **名前:** GetAvailableRegions **説明:** ECSから国の利用可能な地域一覧を入手します。 **使用方法:** Sitecoreから電話をかけてきました。 **ARGS:** **リクエスト** – CountryCode \*\*応答 –\*\*利用可能な地域の一覧。 **プロセッサー:** **GetAvailableRegions** – \*\*責任:\*\*ECSから国の地域一覧を入手します。 **使用方法**:プロセッサーは必須です。 **所有権**:プロセッサにはECSコネクタが付属し、Connectと統合されています。 **カスタマイズ:**プロセッサは常にECSと連携する実装を持つ必要があります。 ## GetVisitorOrderパイプライン **名前:** GetVisitorOrder(訪問者注文)を **説明:** 訪問者が置いたIDで注文を受け取ります。 GetVisitorOrder 方式から実行されます。 **使用方法:** Sitecoreから電話をかけてきました。 **ARGS:** \*\*リクエスト –\*\*ショップ名と注文ID \*\*応答 –\*\*命令のインスタンス。 **プロセッサー:** **ECSからの訪問者注文を取得–** **責任:**ECSから指定された注文IDの注文詳細を取得します。 **使用方法**:プロセッサーは必須です。 **所有権**:プロセッサにはECSコネクタが付属し、Connectと統合されています。 **カスタマイズ:**プロセッサは常にECSと連携する実装を持つ必要があります。 **トリガーページイベント****–** **責任:**Connect専用ページイベントをトリガーします:訪問者が注文詳細を表示、ShopName、Order ID、総注文金額に関する情報を表示します。 **使用方法**:必須。 **所有権**:プロセッサーにはConnectが付属しています。 **カスタマイズ**:プロセッサを上書きして注文の他の値を登録します。 ## GetVisitorOrdersパイプライン **名前:** **GetVisitorOrders** **説明:** 指定された顧客の注文リストを受け取ります。 **使用方法:** Sitecoreから電話をかけてきました。 **ARGS:** \*\*リクエスト –\*\*ShopName と CustomerID \*\*レスポンス –\*\*OrderBaseオブジェクトのリスト。 **プロセッサー:** **ECSからの訪問者命令を入手** **責任:**ECSから指定された顧客の注文リストを取得します。ECSとSitecoreを異なる場所に設置可能でなければならず、リモートアクセスが可能でなければなりません。 **使用方法**:プロセッサーは必須です。 **所有権**:プロセッサにはECSコネクタが付属し、Connectと統合されています。 **カスタマイズ:**プロセッサは常にECSと連携する実装を持つ必要があります。 **トリガーページイベント** **責任:**Connect専用ページイベントをトリガーします:Visitor Viewed Order History、ShopNameおよびCustomer IDに関する情報。 **使用方法**:必須。 **所有権**:プロセッサーにはConnectが付属しています。 **カスタマイズ:**必須ではありませんが、ページイベントで順序の他の値を登録するために上書き可能です。 ## OrderStatusChangedパイプライン **名前:** **命令ステータス変更** **説明:** 注文のステータス変更をSitecoreに通知するために使われました。 **使用方法:** Sitecoreから電話をかけてきました。 **ARGS:** \*\*リクエスト – \*\*注文ID、CustomerId、OrderStatus。 \*\*返答 –\*\*なし。 **プロセッサー:** **TriggerOrderStatusChangedPageEvent** **–** **責任:**Connect専用ページイベントをトリガーします。注文ステータスが変更され、注文IDや新しい注文ステータスに関する情報も含まれます。 **使用方法**:必須。 **所有権**:プロセッサーにはConnectが付属しています。 **カスタマイズ**:プロセッサを上書きして注文の他の値を登録します。 ## 再注文パイプライン **名前:** **再注文** **説明:** 以前の注文から顧客のカートにラインを追加し、それらの商品を再注文する目的で担当します。 **使用方法:** 顧客が以前の注文から1点以上の商品を再注文したいと依頼した際に連絡します。 **ARGS:** \*\*リクエスト -\*\*ショップ名、注文ID、顧客IDを含む。 \*\*Response -\*\*結果として得られたカートオブジェクトと、カートに追加された新しいカート行のリストを含む。 **プロセッサー:** **GetReorderSource**\*\*–\*\*再順序付けされるアイテムの順序を読み込みます。このプロセッサは getVisitorOrder パイプラインを呼び出します。 \> \[!注\] \> 順序の読み込み中にエラーが発生した場合、ReorderResultの*Success*プロパティはfalseに設定されます。 **AddReorderLinesToCart**\*\*–\*\*顧客の現在のカートを読み込み、再注文する商品に基づいて新しいラインを追加します。このプロセッサは CreateOrResumeCart と AddCartLines パイプラインを呼び出します。 \> \[!注\] \> ReorderResultの*Success*プロパティがフェイスであれば、顧客のカートに追加されるアイテムはありません。*Success*プロパティが真であれば、少なくとも1つのアイテムがカートに追加されたことになります。 **AddReorderShippingInfoToCart**\*\*–\*\*再注文商品に関連する当事者や配送情報を顧客のカートに追加します。このプロセッサは AddPartiesToCart および AddShippingInfo パイプラインを呼び出します。 **TriggerReorderRequestedPageEvent**\*\*–\*\*Reorder Requestedページイベントをトリガーします。 \> \[!注\] \> ReorderResultの*Success*プロパティがフェイスであれば、ページイベントは発生しません。 ## VisitorCancelOrderパイプライン **名前:** 訪問者キャンセル注文 **説明:** 訪問者の注文がキャンセルされるときに電話します。 **使用方法:** Sitecoreから電話をかけてきました。 **ARGS:** **Request**\*\*–\*\*OrderId、CustomerId、OrderLineExternalIds および ShopName。 **応答**\*\*–\*\*命令の一例。 **プロセッサー:** **来訪者ECSからの注文キャンセル–** **責任:**ECSから指定された注文IDの注文詳細を取得します。 **使用方法**:プロセッサーは必須です。 **所有権**:プロセッサにはECSコネクタが付属し、Connectと統合されています。 **カスタマイズ:**プロセッサは常にECSと連携する実装を持つ必要があります。 **トリガーページイベント****–** **責任:**Connect特定のページイベント「訪問者キャンセル注文詳細」、ショップ名、注文ID、総注文金額の情報をトリガーします。 **使用方法**:必須。 **所有権**:プロセッサーにはConnectが付属しています。 **カスタマイズ**:プロセッサを上書きして注文の他の値を登録します。