> 継続的なプロセス改善 > 返品・返金処理 > Salesforce Commerce Cloud > データテンプレート

返品・返金処理のデータテンプレート

Salesforce Commerce Cloud

返品・返金処理の属性(20) 返品・返金処理のアクティビティ(13) データ抽出ガイド(2)

返品・返金処理のデータテンプレート

このテンプレートでは、返品・返金プロセスの分析に必要なデータの収集方法を詳しく説明します。必要なデータ項目や追跡すべき主要なアクティビティを示し、ソースシステムから情報を抽出する方法も案内します。このテンプレートを使ってイベントログを準備し、プロセスマイニングを始めましょう。

収集を推奨する属性
追跡すべき主要なアクティビティ
Salesforce Commerce Cloudからのデータ抽出ガイド

イベントログを初めて作成する方はこちら：プロセスマイニング用イベントログの作成方法.

テンプレートをダウンロード

返品・返金処理の属性

Salesforce Commerce Cloudで返品・返金処理を詳しく分析するために、イベントログに含めることを推奨するデータ項目です。

5 必須 6 推奨 9 任意

	名前	説明
	アクティビティ名 ActivityName	返品プロセスで発生した特定の業務ステップまたはイベントの名前です。
説明この属性は、返品ケースで特定の時点に完了したタスクや節目を示します。例として、「返品申請を作成」「倉庫で商品を受領」「返金を処理」などがあります。プロセスマイニングでは、アクティビティ名を使ってプロセスマップを作成し、ステップの順序やケースの流れを表示します。アクティビティを分析すると、ボトルネック、手戻りのループ、標準プロセスからの逸脱を特定できます。重要な理由プロセスマップの各ステップを定義し、返品ワークフローの表示と分析を可能にします。入手先通常、SalesforceのReturn OrderまたはCaseオブジェクトに関連するイベントログ、ステータス変更記録、タスク完了データから取得します。例返品申請の承認商品の検査完了返金処理の完了
	イベント時刻 EventTime	特定のアクティビティまたはイベントが発生した日時を示すタイムスタンプです。
説明イベント時刻には、アクティビティの実行時刻やステータス変更の発生時刻が正確に記録されます。イベントを正しい順序に並べるため、また時間に基づく分析を行うために欠かせない情報です。プロセスマイニングでは、このタイムスタンプを使ってアクティビティを並べ、ステップ間のサイクルタイムや待ち時間を算出し、さまざまな期間におけるプロセスのパフォーマンスを分析します。正確なタイムスタンプは、信頼できるプロセス分析の基盤です。重要な理由アクティビティの時系列順を確定します。サイクルタイムの算出やプロセスの遅延特定に欠かせません。入手先通常、返品プロセスに関連するSalesforce Commerce Cloudのレコード作成日時または更新日時です。オブジェクトの「CreatedDate」や「LastModifiedDate」などが該当します。例 2023-04-15T10:00:00Z2023-04-16T14:30:00Z2023-04-18T09:15:22Z
	返品ケースID ReturnCaseId	個々の返品ケースを識別する一意のIDです。返品の開始から完了まで、関連するすべてのアクティビティを結び付けます。
説明返品ケースIDは、特定の返品または返金申請に関連するすべてのアクティビティを結び付ける主キーです。これにより、返品の開始から最終的な完了まで、全期間を追跡して詳細に分析できます。プロセスマイニングでは、この属性がケースの再構成に欠かせません。同じ返品ケースIDを持つ各イベントは、同一のプロセスインスタンスに属します。プロセスマップの表示、ケース単位のサイクルタイムなどの重要業績評価指標（KPI）の算出、返品に関するプロセスバリアントの分析が可能になります。重要な理由返品プロセスのすべてのステップを、追跡可能な1つのケースに結び付ける主キーです。プロセスを最初から最後まで分析するうえで欠かせません。入手先通常、Salesforce Commerce Cloudの返品商品承認（RMA）プロセスで生成されます。Return OrderまたはCaseオブジェクトに記録されていることがよくあります。例 RT-0012345RT-0012346RT-0012347
	ソースシステム SourceSystem	イベントデータの発生元となるシステムです。
説明データが生成されたソースシステムを示す属性です。このプロセスでは、常に「Salesforce Commerce Cloud」が設定されます。複数のシステムのデータを組み合わせて分析する場合、この項目を使うと、異なるプラットフォーム間でプロセスがどのように進むかを把握できます。データの来歴を明確にし、特定のソースに起因するデータ品質の問題を調べる際にも役立ちます。重要な理由データの発生元を把握できます。データガバナンスや複数の基幹システムのデータ統合に欠かせない情報です。入手先データの抽出と変換の際に追加される固定値です。Salesforce自体のフィールドではなく、データモデルの一部として定義されます。例 Salesforce Commerce Cloud
	最終データ更新日時 LastDataUpdate	ソースシステムからデータを最後に抽出または更新した日時を示すタイムスタンプです。
説明 Salesforce Commerce Cloudからデータを最後に取得した日時を記録する属性です。分析対象のデータがどの程度新しいかを確認できます。この情報により、プロセス分析がどの時点の状況を反映しているかを把握できます。データの鮮度に関する認識をそろえ、データセットの完全性を検証する際にも役立ちます。重要な理由データの更新時期を把握できるため、分析結果がプロセスの最新状況を反映しているか確認できます。入手先データ更新時に、データ抽出ツールまたはスクリプトによって生成されるタイムスタンプです。Salesforceのフィールドではありません。例 2023-05-20T02:00:00Z2023-05-21T02:00:00Z
	処理担当者 ProcessingAgent	返品、または返品プロセス内の特定のアクティビティを担当するユーザーまたはエージェントです。
説明返品ケースに対して、申請の承認、商品の検品、返金処理などを行った従業員またはシステムユーザーを示す属性です。特定のユーザーIDまたは名前が設定されます。処理担当者を分析すると、個人やチームによるパフォーマンスの違いを把握できます。「エージェントのパフォーマンスと一貫性」ダッシュボードで、研修の必要性の特定、業務量の調整、組織全体での手順の標準化に役立ちます。重要な理由ユーザーごとのパフォーマンスや一貫性を分析し、優れた取り組みや研修が必要な領域を特定できます。入手先 SalesforceのCaseまたはReturn Orderオブジェクトにある「OwnerId」や「LastModifiedById」などのフィールドに記録されていることが一般的です。関連するタスクまたは履歴オブジェクトに保存されている場合もあります。例 Alice SmithBob Johnsonシステムによる自動処理
	商品SKU ProductSku	返品対象商品の在庫管理単位（SKU）です。
説明返品対象の商品を特定する一意の識別子です。商品ごとの詳細な分析が可能になります。商品SKU別に返品を分析すると、返品率の高い商品を特定できます。品質管理の問題、商品説明の不備、製造上の欠陥が原因である可能性があります。「倉庫での受領から検品までの時間」ダッシュボードでは、特定の商品群の検品に時間がかかっているかどうかを確認できます。重要な理由商品ごとの返品傾向を分析し、品質や説明に問題のある商品を特定できます。入手先 Return Order Line Item、または返品ケースと元の注文の商品を関連付けるオブジェクトに記録されています。例 SHIRT-BL-M-001PANTS-BK-32-004SHOE-RD-10-012
	実際の返金額 ActualRefundAmount	顧客に実際に返金された最終金額です。
説明査定、控除、計算がすべて完了した後に顧客へ返金される最終金額を示します。再入庫手数料、プロモーション、返品商品の状態などにより、希望額と異なる場合があります。この属性は、財務照合や「返金額の差異分析」ダッシュボードに欠かせません。返品ポリシーによる金銭的な影響を定量化し、返金額の計算や承認ワークフローにおける組織的な問題を特定できます。重要な理由返品に伴う最終的な金銭の結果です。希望額と比較すると、返品ポリシーや調整による金銭的な影響を把握できます。入手先通常、Salesforce Commerce CloudのReturn Orderに関連するRefundまたはPayment Transactionオブジェクトに保存されます。例 49.99115.000.00
	返品チャネル ReturnChannel	オンライン、店舗、カスタマーサービス経由など、返品を開始したチャネルです。
説明顧客が返品を開始した方法を示す属性です。オンラインのセルフサービス用ポータル、店舗への持ち込み、カスタマーサービス担当者への問い合わせなどが一般的です。「返品件数と処理量の推移」ダッシュボードで返品チャネルを把握すると、リソースの適切な配分に役立ちます。また、特定のチャネルでサイクルタイムが長い、返品理由が異なる、処理コストが高いといった傾向があるかを分析できます。重要な理由返品データをチャネル別に分類し、オンラインや店舗など、チャネルごとのプロセスの違いや必要なリソースを把握できます。入手先 Return OrderまたはCaseオブジェクトのフィールドとして記録される場合と、返品レコードを作成したユーザーまたはシステムから判定される場合があります。例オンラインポータル店舗カスタマーサービスへの電話
	返品理由 ReturnReason	顧客が商品を返品する理由です。
説明返品理由は、顧客が返品を開始した理由を記録します。「サイズ違い」「商品が破損していた」「不要になった」など、あらかじめ定義された選択肢から選ぶことが一般的です。この属性は根本原因の分析に欠かせません。返品理由を分析すると、商品の品質、サイズ、説明の正確さに関する傾向を特定できます。その結果を商品開発、マーケティング、サプライチェーンの改善に役立て、返品件数全体の削減につなげられます。重要な理由返品理由を把握すると、製品の不具合やサイズの問題などの根本原因を特定でき、今後の返品件数の削減に役立ちます。入手先通常、SalesforceのReturn OrderまたはCaseオブジェクトにある選択リスト項目です。返品の申請時に顧客が入力することがよくあります。例サイズ違い到着時に商品が破損誤った商品を発送
	返金希望額 RequestedRefundAmount	返品の申請時に顧客が希望した返金額です。
説明顧客が当初希望した返金額を記録する属性です。通常は返品商品の価格が設定され、返金額の計算におけるベースラインとなります。「返金額の差異分析」ダッシュボードでは、この金額を「実際の返金額」と比較します。差異が大きい、または頻繁に発生する場合、返品ポリシー、再入庫手数料、システムの計算エラーに問題がある可能性があり、顧客満足度の低下につながることがあります。重要な理由最終的な返金額との比較基準となり、差異の特定や調整による金銭的な影響の分析に役立ちます。入手先通常、元の販売注文から取得した値がReturn OrderまたはReturn Order Line Itemオブジェクトに保存されます。例 49.99125.0089.50
	SLA遵守状況 IsSlaCompliant	返金が定められたSLA目標日までに処理されたかどうかを示す真偽値です。
説明「返金処理」アクティビティが「返金SLA目標日」以前に発生した場合は「true」、それ以外は「false」に設定されます。ケースごとのSLA達成状況を明確に示します。この属性は、「返金SLA遵守状況」ダッシュボードと「返金SLA遵守率」の重要業績評価指標（KPI）の基礎となります。遵守率を簡単に分析できるほか、「処理担当者」や「返品チャネル」などの属性でデータを絞り込み、未達の理由を詳しく調べられます。重要な理由 SLAのパフォーマンス分析を簡素化し、遵守率の算出や遅延要因の特定を容易にします。入手先計算属性です。ロジックは次のとおりです：IF（「返金処理」のタイムスタンプ <= RefundSlaTargetDate）THEN true ELSE false。例 truefalse
	倉庫所在地 WarehouseLocation	返品商品を受領した倉庫または施設を識別する情報です。
説明返品商品を処理した物理的な拠点を示す属性です。複数の配送センターを持つ企業で特に重要です。倉庫所在地別に分析すると、拠点間のパフォーマンスの違いが分かります。たとえば、特定の倉庫で検品に時間がかかる、または破損品と判定される割合が高いといった傾向を確認できます。業務の標準化や、拠点固有の問題への対応に役立ちます。重要な理由倉庫ごとのパフォーマンスを比較し、処理時間や品質評価の違いを把握できます。入手先 Return Orderまたは関連する配送オブジェクトに保存されている場合があります。受領アクティビティを実行したユーザーから判定されることもあります。例 WH-EAST-01WH-WEST-03WH-CENTRAL-02
	却下理由 RejectionReason	返品申請または返金が却下された具体的な理由です。
説明返品が承認されなかった場合や返金が却下された場合、その理由をこの属性に記録します。「返品期間を超過」「顧客が商品を破損」「返品対象外の商品」などが例として挙げられます。この情報は「却下・エスカレーションされた返品」ダッシュボードに欠かせません。却下理由を分析すると、返品ポリシーやプロセスで顧客がつまずく点を把握できます。顧客への説明の明確化、ポリシーの見直し、返品申請の初期確認の改善につなげられます。重要な理由返品が却下される理由を把握し、返品ポリシー、顧客への説明、担当者の研修の改善に役立てられます。入手先 Return OrderまたはCaseオブジェクトのカスタムフィールドであることが多く、ステータスが「Rejected」または「Closed - Denied」に変更された際に値が設定されます。例返品期間を超過商品が元の状態ではない返品不可商品
	受領から検品までの時間 ReceiptToInspectionTime	倉庫で商品を受領してから検品が完了するまでの時間です。
説明倉庫内の重要な工程にかかる時間を測定する指標です。「倉庫で商品を受領」と「商品検品完了」の各アクティビティのタイムスタンプの差から算出します。この時間は、「倉庫での受領から検品までの時間」ダッシュボードと「商品受領から検品までの平均時間」重要業績評価指標（KPI）で確認できます。指標を分析すると、倉庫業務のボトルネックを特定できます。こうしたボトルネックは、プロセス全体の遅延につながることがあります。重要な理由返品プロセス全体を遅らせる倉庫内のボトルネックを特定できます。返金までの時間や在庫の利用可能性にも影響します。入手先データ変換時に、「商品検品完了」のタイムスタンプから「倉庫で商品を受領」のタイムスタンプを差し引いて算出します。例 1日2時間3日0時間8時間
	商品の状態 ItemCondition	倉庫での検品時に評価された返品商品の状態です。
説明返品商品を受領した後、通常は状態を確認するために検品します。この属性には、「新品」「使用済み・再販可能」「破損」などの検品結果を記録します。この評価は最終的な返金額に直接影響し、「返品ポリシーの遵守状況」ダッシュボードの重要な入力情報となります。データを追跡すると、返品商品の品質を把握し、再販、再生、廃棄に向けた在庫管理に役立ちます。重要な理由この評価が最終的な返金額を左右することが多く、返品商品の在庫管理にも欠かせません。入手先通常、Return Order Line Itemオブジェクトにあるカスタムフィールドで、「商品検品」アクティビティの際に更新されます。例新品・未開封使用済み・新品同様破損・販売不可
	返品ステータス ReturnStatus	ライフサイクルにおける返品ケースの現在のステータスです。
説明「承認待ち」「商品受領済み」「返金済み」「クローズ」など、返品の現在の状態を示す属性です。ケースがワークフローを進むにつれて値が変わります。プロセスマイニングではアクティビティから処理の流れを把握しますが、現在のステータスがあると、未完了ケースと完了ケースを絞り込んで分析する際に役立ちます。運用状況を監視し、プロセスの各段階における未処理件数や業務量を把握できます。重要な理由返品ケースがプロセスのどの段階にあるかを確認できるため、運用状況の監視や進行中のケースの絞り込みに役立ちます。入手先通常、Salesforce Commerce CloudのReturn OrderまたはCaseオブジェクトにある標準の「Status」フィールドです。例承認待ち承認済み商品受領済みクローズ済み
	返品ポリシーの遵守状況 ReturnPolicyAdherence	返品が定められた業務ポリシーに従っているかを示す指標です。
説明返品期間、商品の状態、購入証明などの社内ポリシーに照らして、返品の遵守状況をフラグまたは分類で示す属性です。「遵守／未遵守」の真偽値、またはより詳細なステータスで表せます。この属性は、「返品ポリシーの遵守状況」ダッシュボードと「ポリシー未遵守率」の重要業績評価指標（KPI）の中心となります。ポリシーが一貫して適用されているかを監視し、未遵守の返品がプロセスや財務に及ぼす影響を分析できます。重要な理由ポリシーの適用状況を監視できます。コスト管理、不正防止、顧客への公平で一貫した対応に欠かせません。入手先返品日、商品の状態、商品種別など、ほかのデータに業務ルールを適用して算出する属性であることが一般的です。例遵守未遵守・返品期限超過未遵守・商品破損
	返金SLA目標日 RefundSlaTargetDate	返品ケースの返金処理を完了する目標日です。
説明返金完了に関するサービスレベル契約（SLA）の期限を定める属性です。通常、返品申請の承認日または商品の受領日から所定の日数を加算するなど、業務ルールに基づいて算出されます。「返金SLA遵守状況」ダッシュボードでは、この日付を基準に実績を測定します。遵守状況を監視すると、一貫した良好な顧客体験の維持に役立ちます。また、SLAの未達リスクにつながっているチームやプロセスのステップを特定できます。重要な理由返金処理の目標を定め、SLAの遵守状況と顧客満足度への影響を測定できます。入手先 CaseまたはReturn Orderオブジェクトの計算フィールドであることが多く、作成日または承認日に所定の期間を加えて算出されます（例：CreatedDate + 14 days）。例 2023-04-29T23:59:59Z2023-05-10T23:59:59Z2023-05-15T23:59:59Z
	顧客ID CustomerId	返品を開始した顧客を識別する一意のIDです。
説明顧客のアカウントに関連付けられた一意のIDです。顧客単位で返品データを集計できます。顧客ID別に返品を分析すると、返品率が異常に高い顧客を特定できます。不正行為や継続的な不満の兆候である可能性があります。また、顧客セグメント別の分析により、顧客グループごとに返品の傾向や行動が異なるかどうかを把握できます。重要な理由顧客単位の分析が可能になり、返品頻度の高い顧客の特定や、顧客セグメントごとの返品行動の把握に役立ちます。入手先 SalesforceのOrderおよびCaseオブジェクトにある標準フィールドです。CustomerまたはAccountオブジェクトに関連付けられています。例 CUST-98765CUST-12345CUST-55555

必須推奨任意

返品・返金処理のアクティビティ

プロセスを正確に把握し、改善するためにイベントログへ記録すべき主要なステップと節目です。

6 推奨 7 任意

	アクティビティ	説明
	倉庫で商品を受領	このアクティビティは、返品商品が指定の倉庫または処理センターに物理的に届いた時点を示します。倉庫担当者が商品をスキャンし、関連するReturnOrderItemのステータスが更新されたときに記録します。
重要な理由この重要な節目を境に、顧客側の対応から社内処理へ移ります。受領から検査までの時間など、倉庫業務の重要業績評価指標（KPI）を測定する起点となります。入手先 ReturnOrderまたはReturnOrderItemオブジェクトのステータスが「Received」に変わったとき、または「quantityReceived」フィールドに値が入力されたときに判定します。記録 ReturnOrderItem.quantityReceivedの更新、またはステータスが「Received」に変わったことを検出します。イベントタイプ inferred
	商品の検査完了	このアクティビティは、返品商品の状態を確認して記録する検査が完了した時点を示します。返品商品のステータスが変わり、返金額の計算など次のステップに進むときに記録します。
重要な理由返金が妥当かどうかを判断する、プロセス上の重要な分岐点です。商品の受領から検査完了までの時間は、倉庫業務の重要業績評価指標（KPI）です。入手先 ReturnOrderItemオブジェクトのステータスが「Inspected」に更新されたとき、または担当者が「reasonForReturn」を確認したときに判定します。記録 ReturnOrderItem.statusフィールドが「Inspected」に変更されたことを検出します。イベントタイプ inferred
	返品ケースをクローズ	返金、交換、または却下の処理が確定した後、システム上で返品ケースが最終的にクローズされたことを示します。ReturnOrderのステータスが「Closed」または「Completed」に変わったことから判定します。
重要な理由プロセスの主な終了点となるこのアクティビティは、全体のサイクルタイムの算出や返品処理業務の処理量の測定に欠かせません。入手先 ReturnOrderオブジェクトのステータスフィールドが「Closed」や「Completed」などの最終状態に更新された時刻から判定します。記録 ReturnOrder.statusフィールドが「Closed」に変わったことを検出します。イベントタイプ inferred
	返品申請の作成	このアクティビティは、システムで返品承認ケースが作成された時点を示します。Salesforce Commerce Cloudで新しいReturnOrderレコードが作成されたときに記録されます。作成者は、ストアフロントを利用する顧客またはサービス担当者です。
重要な理由返品処理の開始点となるこのアクティビティは、最初から最後までのサイクルタイムの測定や、期間ごとの返品申請件数の分析に欠かせません。入手先 Salesforce Commerce Cloud OMSでReturnOrderオブジェクトが作成されたタイムスタンプから、このイベントを記録します。記録新しいReturnOrderレコードの作成を追跡します。イベントタイプ explicit
	返品申請の承認	このイベントは、サービス担当者または自動ルールによって返品申請が確認・承認されたことを示します。通常、ReturnOrderオブジェクトのステータスが「New」から「Approved」に変わったことなどから判定します。
重要な理由この節目を追跡すると、承認段階の効率を分析し、ボトルネックを特定できます。申請の作成から承認までの時間は、担当者のパフォーマンスを測る重要業績評価指標（KPI）です。入手先 ReturnOrderオブジェクトのステータスフィールドが「Approved」や「Authorized」など、承認を示す値に更新されたタイムスタンプから判定します。記録 ReturnOrder.statusフィールドが「Approved」に変更されたことを検出します。イベントタイプ inferred
	返金処理の完了	このアクティビティは、決済ゲートウェイで返金処理が正常に完了し、顧客への送金が行われたことを確認します。通常、決済プロバイダーからの確認コールバックによって発生します。
重要な理由返金SLAの遵守状況を測定するうえで重要な節目です。返品プロセスの金銭面の処理が正常に完了したことを確認します。入手先決済ゲートウェイからのコールバックイベントを取得します。このイベントにより、Salesforceの関連するPaymentまたはRefundオブジェクトのステータスが「Processed」または「Completed」に更新されます。記録決済プロバイダーからの確認イベントを追跡し、Paymentオブジェクトのステータス更新を記録します。イベントタイプ explicit
	交換注文を作成	交換を伴う返品では、このイベントは交換品の新しい販売注文が作成されたことを示します。金銭による返金とは別の処理経路です。
重要な理由交換の割合や交換品の出荷処理の効率を把握するには、この経路を返金とは分けて追跡することが重要です。入手先元のReturnOrderに関連付けられた新しいSalesOrderオブジェクトの作成から取得します。記録 ReturnOrder IDに関連付けられた新しいSalesOrderの作成を追跡します。イベントタイプ explicit
	商品の検査開始	このイベントは、返品商品の品質と状態の確認が始まったことを示します。通常、返品商品のステータスが「Inspecting」などに変わったときに判定します。
重要な理由検査の開始を追跡すると、倉庫での待ち時間全体から検査そのものにかかる時間を切り分けられ、ボトルネックの可能性をより詳しく把握できます。入手先 ReturnOrderItemオブジェクトのステータスが「Inspecting」や「Under Inspection」などに更新されたときに判定します。記録 ReturnOrderItem.statusフィールドが「Inspecting」に変更されたことを検出します。イベントタイプ inferred
	返品ラベルの発行	このアクティビティは、顧客が商品を返品する際に使う配送ラベルが作成された時点を示します。配送業者との連携によって、このイベントが返品ケースに記録される場合は、明示的に取得できます。
重要な理由このステップは顧客体験を左右する重要な工程です。ラベルの発行がスムーズでないと、遅延の原因になります。商品を発送するための手続きが顧客に引き継がれる時点でもあります。入手先 Salesforce Shippingなどの配送連携によって、ReturnOrderオブジェクトのカスタムフィールドまたは関連オブジェクトに記録される場合があります。記録配送連携のイベント、またはカスタムオブジェクトの作成を追跡します。イベントタイプ explicit
	返品申請の却下	このイベントは、返品申請が却下され、それ以降の処理が行われないことを示します。商品を受領する前にReturnOrderのステータスが「Rejected」または「Canceled」に更新されたときに記録します。
重要な理由却下された返品を分析すると、ポリシー違反など、却下の主な理由を特定できます。顧客への案内や、申請時の入力チェックの改善に役立ちます。入手先 ReturnOrderオブジェクトのステータスフィールドが「Rejected」や「Denied」など、却下を示す値に更新されたタイムスタンプから判定します。記録 ReturnOrder.statusフィールドが「Rejected」に変更されたことを検出します。イベントタイプ inferred
	返金の承認	このアクティビティは、計算された返金額が承認され、処理できる状態になったことを示します。自動で行われる場合と、高額な返品について手動承認が必要な場合があります。
重要な理由特に手動での対応が必要な場合、この承認がボトルネックになることがあります。金銭の取引を開始する前の重要な節目です。入手先 ReturnOrderまたは関連する支払い概要オブジェクトのステータスが「Refund Approved」や「Ready for Refund」などに変わったときに判定します。記録 ReturnOrderまたは関連する支払いオブジェクトのステータス変更を検出します。イベントタイプ inferred
	返金処理の開始	このイベントは、Salesforce Commerce Cloudから外部の決済ゲートウェイに返金リクエストが送信された時点を示します。金銭の取引が始まるタイミングです。
重要な理由開始と処理を区別することは、SLAへの適合状況を分析するうえで重要です。この時点以降の遅延は通常、社内処理ではなく決済事業者に関係します。入手先システムが決済ゲートウェイと通信した際の明示的なイベントログまたはAPI呼び出しの記録から取得します。Paymentオブジェクトのステータス変更から判定することもできます。記録決済ゲートウェイへのAPI呼び出しイベント、またはステータスが「Refund Pending」に変わったことを追跡します。イベントタイプ explicit
	返金額の計算	このステップでは、商品の状態、再入庫手数料、プロモーションなどを考慮して、最終的な返金額を決定します。多くの場合、システムが自動で処理し、返金額のフィールドに値を入力します。
重要な理由このステップの分析は、「返金額の不一致分析」ダッシュボードに欠かせません。最終的な返金額が顧客の希望額と異なるケースを明らかにします。入手先 ReturnOrderまたは関連する返金支払いオブジェクトの返金額フィールドに値が入力または更新されたことから、このイベントを判定できます。記録返金額フィールドに値が入力された時刻を検出します。イベントタイプ inferred

推奨任意

データ抽出ガイド

Salesforce Commerce Cloudからデータを取得する方法

ステップ

Salesforce Commerce Cloud Business Managerにログイン：データを抽出するサイトのBusiness Managerにアクセスします。
インポート／エクスポートセクションを開く：Administration > Site Development > Import & Exportの順に開きます。
新しいエクスポートジョブを作成：JobsセクションでNew Jobをクリックします。一意のID（例：ProcessMind-Returns-Export）と説明を入力し、作成をクリックします。
ジョブのステップを設定：作成したジョブを選択し、Job Stepsタブを開きます。Configure a stepをクリックして、Exportシステムステップタイプを選択します。Object Typeに注文を選び、ステップに一意のIDを指定します。作成をクリックします。
エクスポート設定を入力：ステップの設定画面で、再度注文オブジェクトを選択します。以下のqueryセクションにあるXML全体をExport Configurationのテキスト欄に貼り付けます。このXMLでイベントログを作成するための変換ロジックを定義します。
エクスポートファイル名を設定：File Pattern / Name欄に出力ファイル名を入力します。ファイルの上書きを避けるため、returns-event-log-{yyyyMMddHHmmss}.csvのような動的なパターンを指定します。
SFTPの送信先を設定：エクスポートファイルの送信先となるSFTPサーバーの詳細を指定します。Host Name、Port、User Name、PasswordまたはSSH Keyが必要です。
ジョブの実行条件を設定：Schedule and Historyタブを開きます。ジョブを定期実行（例：毎日）するよう設定するか、手動で実行する場合はRun on demandのままにします。
エクスポートジョブを実行：Run Nowボタンをクリックしてエクスポートを実行します。Job Historyタブで進捗を確認できます。ステータスがSuccessになれば完了です。
ファイルを取得して確認：SFTPサーバーに接続し、エクスポートされたCSVファイルを探します。ファイルを開き、想定したヘッダー行とイベントデータが含まれていることを確認します。
アップロードの準備：ファイルの文字コードがUTF-8であることを確認します。これでProcessMindプラットフォームにアップロードできます。

設定

ジョブID：エクスポートジョブを識別する一意のIDです。例：ProcessMind-Returns-Export。
オブジェクトタイプ：主なエクスポート対象は注文です。設定では、注文から関連する返品ケースをたどります。
エクスポート設定：XML/XSLTスクリプトで記述する、処理の中心となるロジックです。階層構造の注文データをフラットなイベントログに変換します。SFCCの実装でカスタム項目を使用している場合は、XMLのパスを少し調整する必要があります。
日付範囲のフィルタリング：エクスポートするデータ量を調整するため、XMLクエリには注文作成日のフィルターが含まれています：<creation-date-from>[YYYY-MM-DDThh:mm:ss.sssZ]</creation-date-from>。実行のたびに値を更新し、対象期間を指定してください。直近90日間を対象にすることを推奨します。
送信先のSFTPサーバー：エクスポートファイルの受信には、有効でアクセス可能なSFTPサーバーが必要です。SFCCインスタンスからサーバーへの接続がファイアウォールで許可されていることを確認してください。
ジョブのスケジュール：プロセスを継続的に監視するには、本番サイトへの影響を抑えるため、アクセスの少ない時間帯に毎日実行するよう設定してください。
ユーザー権限：ジョブを設定するBusiness Managerユーザーには、Manage_JobsとManage_Data_Exportの権限が必要です。

クエリの例 xml

<?xml version="1.0" encoding="UTF-8"?>
<export xmlns="http://www.demandware.com/xml/impex/order/2006-10-31">
    <orders>
        <order-query>
            <creation-date-from>2023-01-01T00:00:00.000Z</creation-date-from>
        </order-query>
    </orders>
    <data-transformation>
        <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
            <xsl:output method="text" encoding="UTF-8"/>
            <xsl:variable name="delimiter" select="','"/>
            <xsl:variable name="quote" select="'"'"/>
            <xsl:variable name="lastDataUpdate"><xsl:value-of select="current-dateTime()"/></xsl:variable>

            <xsl:template match="/">
                <!-- Header Row -->
                <xsl:text>ReturnCaseId,ActivityName,EventTime,SourceSystem,LastDataUpdate,ProcessingAgent,ReturnReason,ProductSku,RequestedRefundAmount,ActualRefundAmount,ReturnChannel</xsl:text>
                <xsl:text>&#10;</xsl:text>

                <!-- Process each return within each order -->
                <xsl:for-each select="orders/order/returns/return">
                    <xsl:variable name="return" select="."/>
                    <xsl:variable name="order" select="ancestor::order"/>

                    <!-- 1. Return Request Created -->
                    <xsl:call-template name="CreateRow">
                        <xsl:with-param name="returnNode" select="$return"/>
                        <xsl:with-param name="orderNode" select="$order"/>
                        <xsl:with-param name="activityName" select="'Return Request Created'"/>
                        <xsl:with-param name="eventTime" select="$return/creation-date"/>
                        <xsl:with-param name="sku" select="''"/>
                    </xsl:call-template>

                    <!-- 2. Return Request Approved -->
                    <xsl:if test="status='APPROVED'">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Return Request Approved'"/>
                            <xsl:with-param name="eventTime" select="$return/last-modified"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- 3. Return Request Rejected -->
                    <xsl:if test="status='CANCELED' or status='REJECTED'">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Return Request Rejected'"/>
                            <xsl:with-param name="eventTime" select="$return/last-modified"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- 4. Return Label Generated (Placeholder Logic) -->
                    <xsl:if test="custom-attributes/custom-attribute[@attribute-id='returnLabelGeneratedDate']">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Return Label Generated'"/>
                            <xsl:with-param name="eventTime" select="custom-attributes/custom-attribute[@attribute-id='returnLabelGeneratedDate']"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- Item-level Events -->
                    <xsl:for-each select="items/return-item">
                        <!-- 5. Item Received At Warehouse -->
                        <xsl:if test="status='RECEIVED'">
                            <xsl:call-template name="CreateRow">
                                <xsl:with-param name="returnNode" select="$return"/>
                                <xsl:with-param name="orderNode" select="$order"/>
                                <xsl:with-param name="activityName" select="'Item Received At Warehouse'"/>
                                <xsl:with-param name="eventTime" select="last-modified"/>
                                <xsl:with-param name="sku" select="product-id"/>
                            </xsl:call-template>
                        </xsl:if>
                        <!-- 6. Item Inspection Started -->
                        <xsl:if test="status='INSPECTING'">
                             <xsl:call-template name="CreateRow">
                                <xsl:with-param name="returnNode" select="$return"/>
                                <xsl:with-param name="orderNode" select="$order"/>
                                <xsl:with-param name="activityName" select="'Item Inspection Started'"/>
                                <xsl:with-param name="eventTime" select="last-modified"/>
                                <xsl:with-param name="sku" select="product-id"/>
                            </xsl:call-template>
                        </xsl:if>
                        <!-- 7. Item Inspection Completed -->
                        <xsl:if test="status='INSPECTED' or status='COMPLETED_INSPECTION'">
                            <xsl:call-template name="CreateRow">
                                <xsl:with-param name="returnNode" select="$return"/>
                                <xsl:with-param name="orderNode" select="$order"/>
                                <xsl:with-param name="activityName" select="'Item Inspection Completed'"/>
                                <xsl:with-param name="eventTime" select="last-modified"/>
                                <xsl:with-param name="sku" select="product-id"/>
                            </xsl:call-template>
                        </xsl:if>
                    </xsl:for-each>

                    <!-- 8. Refund Amount Calculated (Placeholder Logic) -->
                    <xsl:if test="custom-attributes/custom-attribute[@attribute-id='refundCalculatedDate']">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Refund Amount Calculated'"/>
                            <xsl:with-param name="eventTime" select="custom-attributes/custom-attribute[@attribute-id='refundCalculatedDate']"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- 9. Refund Approved (Placeholder Logic) -->
                    <xsl:if test="custom-attributes/custom-attribute[@attribute-id='refundApprovedDate']">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Refund Approved'"/>
                            <xsl:with-param name="eventTime" select="custom-attributes/custom-attribute[@attribute-id='refundApprovedDate']"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- 10. Refund Initiated -->
                    <xsl:if test="return-payment-status='REFUND_INITIATED'">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Refund Initiated'"/>
                            <xsl:with-param name="eventTime" select="$return/last-modified"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- 11. Refund Processed -->
                    <xsl:if test="return-payment-status='REFUNDED'">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Refund Processed'"/>
                            <xsl:with-param name="eventTime" select="$return/last-modified"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- 12. Exchange Order Created -->
                    <xsl:if test="exchange-order-no">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Exchange Order Created'"/>
                            <xsl:with-param name="eventTime" select="$return/last-modified"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                    <!-- 13. Return Case Closed -->
                    <xsl:if test="status='COMPLETED'">
                        <xsl:call-template name="CreateRow">
                            <xsl:with-param name="returnNode" select="$return"/>
                            <xsl:with-param name="orderNode" select="$order"/>
                            <xsl:with-param name="activityName" select="'Return Case Closed'"/>
                            <xsl:with-param name="eventTime" select="$return/last-modified"/>
                            <xsl:with-param name="sku" select="''"/>
                        </xsl:call-template>
                    </xsl:if>

                </xsl:for-each>
            </xsl:template>

            <!-- Reusable template to generate a single CSV row -->
            <xsl:template name="CreateRow">
                <xsl:param name="returnNode"/>
                <xsl:param name="orderNode"/>
                <xsl:param name="activityName"/>
                <xsl:param name="eventTime"/>
                <xsl:param name="sku"/>

                <xsl:value-of select="concat($quote, $returnNode/return-number, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $activityName, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $eventTime, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, 'Salesforce Commerce Cloud', $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $lastDataUpdate, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $returnNode/created-by, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, normalize-space($returnNode/items/return-item[1]/reason-text), $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $sku, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $returnNode/totals/grand-total, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $returnNode/totals/refunded-total, $quote, $delimiter)"/>
                <xsl:value-of select="concat($quote, $orderNode/channel-type, $quote, $delimiter)"/>
                <xsl:text>&#10;</xsl:text>
            </xsl:template>

        </xsl:stylesheet>
    </data-transformation>
</export>

ステップ

前提条件とセットアップ：Python 3.6以降がインストールされていることを確認します。pip install requests pandasを実行して必要なPythonライブラリをインストールします。Salesforce Commerce Cloudのアカウントマネージャーから、クライアントIDとクライアントシークレットを含むAPIクライアント認証情報を取得します。OCAPI Data APIへのアクセスには、APIクライアントにsfcc.data.rw権限が必要です。
Pythonスクリプトを設定：提供されたPythonスクリプトをextract_returns.pyという名前で保存します。ファイルを開き、## CONFIGURATION ##セクションのプレースホルダー変数にSalesforce Commerce Cloudの情報を入力します。CLIENT_ID、CLIENT_SECRET、BASE_URL（例：https://your-instance.demandware.net）、API_VERSION（例：v21_3）、SITE_IDを設定してください。
抽出する日付範囲を指定：設定セクションでSTART_DATEとEND_DATEをYYYY-MM-DD形式で指定します。返品ケースの作成日を基準に、抽出対象の期間を定義します。
認証の流れを確認：スクリプトは最初にget_auth_token関数を呼び出し、Salesforceの/dw/oauth2/access_tokenエンドポイントへPOSTリクエストを送信します。クライアント認証情報を使って一時的なベアラートークンを取得し、以降のAPI呼び出しに使用します。
データ取得を開始：スクリプトの主要部分で、OCAPI Data APIの/returnsエンドポイントへのリクエストを作成します。queryパラメーターで指定した期間内に作成された返品を絞り込み、expandパラメーターで商品と支払いの詳細をレスポンスに含めます。これにより、追加のAPI呼び出しを減らせます。
APIのページネーションを処理：スクリプトはページ分割された結果を処理します。最初のリクエストで返品データの最初の一群と総件数を取得します。その後、後続のリクエストでstartパラメーターを使って繰り返し取得し、指定期間の返品レコードをすべて取得します。
返品レコードを処理：取得した各返品レコードに対して、process_return_data関数を呼び出します。この関数は、ステータス、タイムスタンプ、入れ子になった商品や支払いの情報など、個々の返品のJSONデータを分析します。
イベントログの行を作成：処理関数は、返品のJSON構造に含まれる各データを個別のアクティビティに対応付けます。たとえば、creation_dateは「返品申請の作成」イベントになり、statusがCLOSEDの場合はlast_modifiedのタイムスタンプを使って「返品ケースのクローズ」イベントが作成されます。必要な13種類のアクティビティを確認し、データが存在するものについて行を作成します。
属性を対応付け：イベント行を作成する際に、必須属性と推奨属性を設定します。ReturnCaseIdにはreturn_order_noを、ProductSkuにはitems配列内のproduct_idを、ActualRefundAmountにはpayments配列内のamountを対応付けます。
スクリプトを実行：ターミナルまたはコマンドプロンプトを開き、スクリプトを保存したディレクトリに移動して、python extract_returns.pyを実行します。
出力を取得：正常に実行されると、同じディレクトリにreturns_event_log.csvというCSVファイルが作成されます。抽出したすべてのアクティビティと属性を含むイベントログが保存されており、ProcessMindにアップロードできます。

設定

APIクライアント認証情報：認証には有効なClient IDとClient Secretが必要です。Salesforce Commerce Cloudのアカウントマネージャーで生成し、OCAPI Data APIに必要な権限を付与してください。
OCAPIエンドポイントの設定：インスタンスのBASE_URL、対象のAPI_VERSION、データを抽出するSITE_IDが必要です。値が正しくないと接続に失敗します。
日付範囲：START_DATEとEND_DATEの変数で抽出期間を指定します。初回の分析では、データ量と処理性能のバランスを考慮し、3～6か月を対象にすることを推奨します。データ量が非常に多い環境では、月ごとに期間を分けて連続して抽出してください。
APIリクエストのパラメーター：COUNT変数で、API呼び出しごとに取得するレコード数（ページサイズ）を指定します。上限は200です。値を大きくすると一般に効率が上がりますが、タイムアウトが発生する場合は減らしてください。EXPANDパラメーターにはitemsとpaymentsを指定し、1回の呼び出しでデータを補います。
Python環境：このスクリプトは、HTTPリクエストにrequestsライブラリ、データ処理とCSV出力にpandasライブラリを使用します。Python環境にこれらがインストールされていることを確認してください。
カスタム属性の対応付け：このスクリプトは標準的なOCAPIデータ構造を前提としています。「商品の検査開始」など、重要なタイムスタンプやデータをカスタム属性に保存している場合は、process_return_data関数を変更し、該当するカスタム項目から値を読み取るようにしてください。

クエリの例 python

import requests
import json
import pandas as pd
from datetime import datetime, timezone

class=class="hl-string">"hl-comment">## CONFIGURATION ##
CLIENT_ID = class="hl-string">'[Your_Salesforce_Client_ID]'
CLIENT_SECRET = class="hl-string">'[Your_Salesforce_Client_Secret]'
BASE_URL = class="hl-string">'https://[your-instance].demandware.net'
API_VERSION = class="hl-string">'v23_1' class=class="hl-string">"hl-comment"># Example version, update as needed
SITE_ID = class="hl-string">'[Your_Site_ID]'
START_DATE = class="hl-string">'2023-01-01' class=class="hl-string">"hl-comment"># Inclusive start date YYYY-MM-DD
END_DATE = class="hl-string">'2023-06-30' class=class="hl-string">"hl-comment"># Inclusive end date YYYY-MM-DD
COUNT = 200 class=class="hl-string">"hl-comment"># Number of records per API call, max is 200

def get_auth_token():
    class="hl-string">"""Authenticates with Salesforce OCAPI and returns a bearer token."""
    url = fclass="hl-string">'{BASE_URL}/dw/oauth2/access_token'
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials'
    }
    try:
        response = requests.post(url, auth=(CLIENT_ID, CLIENT_SECRET), data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting auth token: {e}")
        return None

def process_return_data(return_case, last_update_ts):
    class="hl-string">"""Processes a single return case JSON and generates event log rows."""
    events = []
    case_id = return_case.get(class="hl-string">'return_order_no')
    creation_time = return_case.get(class="hl-string">'creation_date')
    last_modified_time = return_case.get(class="hl-string">'last_modified')
    status = return_case.get(class="hl-string">'status')
    return_reason = return_case.get(class="hl-string">'return_reason') class=class="hl-string">"hl-comment"># Placeholder, adjust to actual field
    channel = return_case.get(class="hl-string">'channel_type') class=class="hl-string">"hl-comment"># Example field for channel

    def create_event(activity, event_time, item=None):
        class=class="hl-string">"hl-comment"># Helper to create a single event dictionary
        if not event_time:
            return None
        
        class=class="hl-string">"hl-comment"># Base attributes
        base_event = {
            class="hl-string">'ReturnCaseId': case_id,
            class="hl-string">'ActivityName': activity,
            class="hl-string">'EventTime': event_time,
            class="hl-string">'SourceSystem': class="hl-string">'Salesforce Commerce Cloud',
            class="hl-string">'LastDataUpdate': last_update_ts,
            class="hl-string">'ReturnReason': return_reason,
            class="hl-string">'ReturnChannel': channel,
            class="hl-string">'ProcessingAgent': return_case.get(class="hl-string">'created_by'),
            class="hl-string">'RequestedRefundAmount': return_case.get(class="hl-string">'price_total'), class=class="hl-string">"hl-comment"># Total value of return
            class="hl-string">'ActualRefundAmount': None, class=class="hl-string">"hl-comment"># Populated later from payment info
            class="hl-string">'ProductSku': None,
            class="hl-string">'ReturnCycleTime': None class=class="hl-string">"hl-comment"># This would typically be calculated post-extraction
        }

        if item:
            base_event[class="hl-string">'ProductSku'] = item.get(class="hl-string">'product_id')
            base_event[class="hl-string">'RequestedRefundAmount'] = item.get(class="hl-string">'price')

        class=class="hl-string">"hl-comment"># Populate refund amount from payment info if available
        if return_case.get(class="hl-string">'payments') and class="hl-string">'amount' in return_case[class="hl-string">'payments'][0]:
            base_event[class="hl-string">'ActualRefundAmount'] = return_case[class="hl-string">'payments'][0][class="hl-string">'amount']

        return base_event

    class=class="hl-string">"hl-comment"># 1. Return Request Created
    events.append(create_event(class="hl-string">'Return Request Created', creation_time))

    class=class="hl-string">"hl-comment"># Status-based events use last_modified as a proxy for the event time
    class=class="hl-string">"hl-comment"># 2. Return Request Approved
    if status == class="hl-string">'APPROVED':
        events.append(create_event(class="hl-string">'Return Request Approved', last_modified_time))
    
    class=class="hl-string">"hl-comment"># 3. Return Request Rejected
    if status in [class="hl-string">'CANCELED', class="hl-string">'REJECTED']:
        events.append(create_event(class="hl-string">'Return Request Rejected', last_modified_time))

    class=class="hl-string">"hl-comment"># 13. Return Case Closed
    if status == class="hl-string">'CLOSED':
        events.append(create_event(class="hl-string">'Return Case Closed', last_modified_time))

    class=class="hl-string">"hl-comment"># Item-level events
    if return_case.get(class="hl-string">'items'):
        for item in return_case[class="hl-string">'items']:
            item_status = item.get(class="hl-string">'status')
            item_last_modified = item.get(class="hl-string">'last_modified') class=class="hl-string">"hl-comment"># Assume item has its own modified time

            class=class="hl-string">"hl-comment"># 5. Item Received At Warehouse
            if item_status == class="hl-string">'RECEIVED':
                events.append(create_event(class="hl-string">'Item Received At Warehouse', item_last_modified, item=item))
            class=class="hl-string">"hl-comment"># 6. Item Inspection Started
            if item.get(class="hl-string">'c_inspectionStartedDate'): class=class="hl-string">"hl-comment"># Example custom field
                events.append(create_event(class="hl-string">'Item Inspection Started', item.get(class="hl-string">'c_inspectionStartedDate'), item=item))
            class=class="hl-string">"hl-comment"># 7. Item Inspection Completed
            if item.get(class="hl-string">'c_inspectionCompletedDate'): class=class="hl-string">"hl-comment"># Example custom field
                events.append(create_event(class="hl-string">'Item Inspection Completed', item.get(class="hl-string">'c_inspectionCompletedDate'), item=item))

    class=class="hl-string">"hl-comment"># Payment/Refund-level events
    if return_case.get(class="hl-string">'payments'):
        for payment in return_case[class="hl-string">'payments']:
            payment_status = payment.get(class="hl-string">'status') class=class="hl-string">"hl-comment"># Hypothetical status field
            payment_last_modified = payment.get(class="hl-string">'last_modified') class=class="hl-string">"hl-comment"># Hypothetical timestamp

            class=class="hl-string">"hl-comment"># 8. Refund Amount Calculated
            class=class="hl-string">"hl-comment"># This is often implicit. We can use the payment record creation date as a proxy.
            events.append(create_event(class="hl-string">'Refund Amount Calculated', payment.get(class="hl-string">'creation_date')))
            
            class=class="hl-string">"hl-comment"># 9. Refund Approved
            if payment_status == class="hl-string">'APPROVED_FOR_REFUND':
                events.append(create_event(class="hl-string">'Refund Approved', payment_last_modified))
            class=class="hl-string">"hl-comment"># 10. Refund Initiated
            if payment_status == class="hl-string">'REFUND_INITIATED':
                events.append(create_event(class="hl-string">'Refund Initiated', payment_last_modified))
            class=class="hl-string">"hl-comment"># 11. Refund Processed
            if payment_status == class="hl-string">'PROCESSED':
                events.append(create_event(class="hl-string">'Refund Processed', payment_last_modified))

    class=class="hl-string">"hl-comment"># Integration-dependent events (using placeholder custom attributes)
    class=class="hl-string">"hl-comment"># 4. Return Label Generated
    if return_case.get(class="hl-string">'c_labelGeneratedDate'):
        events.append(create_event(class="hl-string">'Return Label Generated', return_case.get(class="hl-string">'c_labelGeneratedDate')))

    class=class="hl-string">"hl-comment"># 12. Exchange Order Created
    if return_case.get(class="hl-string">'exchange_order_no') and return_case.get(class="hl-string">'c_exchangeOrderCreationDate'):
        events.append(create_event(class="hl-string">'Exchange Order Created', return_case.get(class="hl-string">'c_exchangeOrderCreationDate')))
    
    class=class="hl-string">"hl-comment"># Filter out any null events that might have been created
    return [e for e in events if e is not None]

def main():
    class="hl-string">"""Main function to orchestrate the data extraction."""
    token = get_auth_token()
    if not token:
        return

    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}',
        class="hl-string">'Content-Type': class="hl-string">'application/json'
    }

    all_events = []
    start_index = 0
    total_records = -1
    last_update_ts = datetime.now(timezone.utc).isoformat()

    print(class="hl-string">'Starting extraction...')

    while total_records == -1 or start_index < total_records:
        class=class="hl-string">"hl-comment"># Construct query to filter by creation date
        query = {
            class="hl-string">"query": {
                class="hl-string">"filtered_query": {
                    class="hl-string">"query": {class="hl-string">"match_all_query": {}},
                    class="hl-string">"filter": {
                        class="hl-string">"range_filter": {
                            class="hl-string">"field": class="hl-string">"creation_date",
                            class="hl-string">"from": fclass="hl-string">"{START_DATE}T00:00:00.000Z",
                            class="hl-string">"to": fclass="hl-string">"{END_DATE}T23:59:59.999Z"
                        }
                    }
                }
            },
            class="hl-string">"select": class="hl-string">"(**)",
            class="hl-string">"expand": [class="hl-string">"items", class="hl-string">"payments"]
        }

        url = fclass="hl-string">'{BASE_URL}/s/{SITE_ID}/dw/data/{API_VERSION}/returns?start={start_index}&count={COUNT}'
        
        try:
            response = requests.post(fclass="hl-string">'{BASE_URL}/s/{SITE_ID}/dw/data/{API_VERSION}/returns/search', headers=headers, json=query)
            response.raise_for_status()
            data = response.json()

            if total_records == -1:
                total_records = data.get(class="hl-string">'total', 0)
                print(fclass="hl-string">'Found {total_records} return records to process.')

            return_hits = data.get(class="hl-string">'hits', [])
            if not return_hits:
                break

            for hit in return_hits:
                events = process_return_data(hit, last_update_ts)
                all_events.extend(events)

            start_index += len(return_hits)
            print(fclass="hl-string">'Processed {start_index} of {total_records} records...')

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"An API error occurred: {e}")
            print(fclass="hl-string">"Response body: {response.text}")
            break

    if all_events:
        df = pd.DataFrame(all_events)
        class=class="hl-string">"hl-comment"># Ensure required columns exist even if empty
        for col in [class="hl-string">'ReturnCaseId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate']:
            if col not in df.columns:
                df[col] = None
        df.to_csv(class="hl-string">'returns_event_log.csv', index=False)
        print(fclass="hl-string">'Successfully extracted {len(df)} events to returns_event_log.csv')
    else:
        print(class="hl-string">'No events were extracted.')

if __name__ == class="hl-string">'__main__':
    main()

始める準備はできていますか？

このデータテンプレートを使って、プロセスマイニングを始めましょう。返品・返金業務の効率を高め、顧客満足度の向上を目指せます。

改善ガイドに戻る

テンプレートをダウンロード

返品・返金処理の効率を今すぐ改善

非効率な箇所を特定し、返品処理のサイクルタイムを30％以上短縮しましょう。

無料トライアルを開始しましょう。

クレジットカードは不要です。数分で設定できます。

返品・返金処理のデータテンプレート

返品・返金処理のデータテンプレート

返品・返金処理の属性

返品・返金処理のアクティビティ

データ抽出ガイド

Salesforce Commerce Cloud Business Managerのエクスポートジョブ

ステップ

設定

クエリの例 xml

Salesforce OCAPI Data APIを使用したPythonスクリプト

ステップ

設定

クエリの例 python

始める準備はできていますか？

返品・返金処理の効率を今すぐ改善