取引の係争管理の使用事例
取引の係争管理は、「紛争中」などのエンティティを用いた専用のデータモデルを使用し、基本属性を係争データモデルエンティティの項目に対応付けます。
オブジェクト、権限、Mulesoft インテグレーションの設定
Service Process Connect API リソースを使用して取引の係争を作成する前に、オブジェクトを作成または変更し、ユーザー権限を設定し、Mulesoft に接続する必要があります。Financial Services Cloud の管理ガイドで説明されている次の作業を実行してください。
- 係争オブジェクトの設定
- ユーザーへの取引の係争管理権限の割り当て
- MuleSoft への接続とインテグレーションの有効化
- インテグレーション定義の作成
- 係争要求に必要な選択リスト値の追加
- デフォルトテンプレートを使用した取引の係争サービスプロセス定義の作成
- 取引の係争サービスプロセスの有効化 (ステップ 3 と 4 をスキップ)
次の作業は省略可能ですが、Salesforce 組織でケースレコードを表示するのに役立ちます。
係争管理オブジェクトと項目の確認
取引の係争管理は、すべてのサービスプロセスに共通するケースレコードやドキュメントチェックリスト項目レコードに加えて、係争レコードと係争項目レコードを使用します。次の項目の値を設定する必要があります。さらに項目を追加することもできます。
- 係争オブジェクト — AccountId、ActualAmount、ApprovedAmount、AssessmentId、Description、DisputeSubtype、DisputeType、DisputedAmount、FinancialAccountId、ReceivedDate、Status
- 係争項目オブジェクト (係争中取引ごとに 1 つのレコード) — TransactionAmount、TransactionDate、TransactionDescription、TransactionIdentifier
- ケースオブジェクト — Subject、Origin、AccountId
- ドキュメントチェックリスト項目オブジェクト — 取引の係争特有の要件はありません
TransactionIdentifier 値は通常、外部の勘定系システムの ID を参照します。ケースレコードの [種別] 項目を含める場合は、その値を「Dispute」に設定することをお勧めします。ドキュメントチェックリスト項目では、項目に、銀行取引明細書や領収書などのドキュメントを指定することができます。
サービスプロセス要求ペイロードの設定
Service Process POST ペイロードには、attributes、caseInfo、documentInfo、および svcCatalogItemDefApiName の 4 つの最上位レベルプロパティがあります。取引の係争管理プロセスでは、いくつかの属性が特定のオブジェクトに対応付けられます。
- attributes プロパティでは、係争レコードについて dispute_info プロパティに設定し、係争項目レコードのリストについて disputed_transactions_info プロパティに設定します。
- caseInfo と documentInfo は、他のサービスプロセスと同様に設定します。
- svcCatalogItemDefApiName を Dispute_Management に設定します。
これらのプロパティを次の例のように、JSON 形式で並べます。この構造内の属性は、次の項目を除きすべて Text 型です。
- 金額項目 (Number 型)
- disputed_amount
- transaction_amount
- actual_amount
- approved_amount
- 日付項目 (Date 型)
- received_date
- transaction_date
1{
2 "attributes": {
3 "data": {
4 "dispute_info": {
5 "data": {
6 "dispute_type": {
7 "value": "Consumer Dispute"
8 },
9 "dispute_subtype": {
10 "value": "Undelivered Product or Service"
11 },
12 "description": {
13 "value": "Order from acmemerchant.com not delivered but credit card charged."
14 },
15 "received_date": {
16 "value": "2023-07-14"
17 },
18 "account_id": {
19 "value": "001DI000001o10QYAQ"
20 },
21 "assessment_id": {
22 "value": "0U3DI000000018m0AA"
23 },
24 "financial_account_id": {
25 "value": "a0EDI000000Ce6W2AS"
26 },
27 "actual_amount": {
28 "value": 593.63
29 },
30 "disputed_amount": {
31 "value": 400
32 },
33 "approved_amount": {
34 "value": 100
35 },
36 "status": {
37 "value": "Submitted"
38 }
39 }
40 },
41 "disputed_transactions_info": {
42 "value": [
43 {
44 "transaction_date": "2023-01-01",
45 "transaction_identifier": "1",
46 "transaction_amount": 213.1,
47 "transaction_description": "t1"
48 },
49 {
50 "transaction_date": "2023-01-01",
51 "transaction_identifier": "2",
52 "transaction_amount": 150.94,
53 "transaction_description": "t2"
54 },
55 {
56 "transaction_date": "2023-01-01",
57 "transaction_identifier": "3",
58 "transaction_amount": 199.0,
59 "transaction_description": "t3"
60 },
61 {
62 "transaction_date": "2023-01-01",
63 "transaction_identifier": "4",
64 "transaction_amount": 30.59,
65 "transaction_description": "t4"
66 }
67 ]
68 }
69 }
70 },
71 "caseInfo": {
72 "data": {
73 "Subject": {
74 "value": "Julia Green Transaction Dispute Request"
75 },
76 "Origin": {
77 "value": "Phone"
78 },
79 "AccountId": {
80 "value": "001DI000001o10QYAQ"
81 }
82 }
83 },
84 "documentInfo": {
85 "data": [
86 {
87 "id": "content document id-1",
88 "name": "Julia Green credit card statement"
89 },
90 {
91 "id": "content document id-2",
92 "name": "acmemerchant.com receipt"
93 }
94 ]
95 },
96 "svcCatalogItemDefApiName": "Dispute_Management"
97}サービスプロセスリソースの呼び出し
ペイロードを作成したら、任意の REST クライアントを使用して Service Process リソースを呼び出すことができます。このリソースは、取引の係争レコードに関連するすべてのオブジェクトレコードを作成し、次のような応答を返します。
1{
2 "caseId": "500SM000000ecOLYAY",
3 "caseNumber": "00001035",
4 "svcCatalogRequestId": "946SM00000000CvYAI"
5}取引の係争に関連するすべてのレコードは、直接または間接的に Case レコードまたは SvcCatalogRequest レコードを参照します。