InsPolicyService:createTransaction

類別:InsPolicyService

方法:createTransaction

此服務可讓您維護原則值並追蹤原則活動。

備註

此服務適用於 Salesforce Financial Services Cloud。

運作方式

1. 服務會從輸入 JSON 取得 assetId 或 policyId,並將其設定為交易上的 AssetId__c 欄位。

2. 從輸入 JSON 取得 transactionType,並將其設定為交易上的 Type__c 欄位。

3. 從輸入 JSON 取得 effectiveDate,並將其設定為交易上的 PostDate__c 和 TransactionDate__c 欄位。

4. (選用) 從輸入 JSON 取得金額,並將其設定為交易上的 Amount__c 欄位。

5. (僅限 FSC) 採用 postDataDRBundleName 或 postDataCustomClassName Omnistudio 資料對應器作為輸入。

6. (選用) 從輸入 JSON 取得 transactionName,並將其設定為交易上的「名稱」欄位。

7. (選用) 從輸入 JSON 取得 additionalFields 對應,並設定對應中指定的任何交易欄位。

8. (非 FSC) 建立新的 AssetTransaction_c 記錄,並在 transactionId 欄位中傳回記錄識別碼。

   或

   (FSC) 建立新的 InsurancePolicyTransaction 或 InsurancePolicyTransaction_c 記錄,並在 transactionId 欄位中傳回記錄識別碼。

9. (僅限 FSC) 以您指定的 postDataDRBundleName 輸出資料。

10. 如果 calculateCommission 為 true,則服務會呼叫 InsurancePolicyService.calculateAndSaveCommission,這會為 InsCommissionService.calculate 和 InsCommissionService.saveCommissions 服務準備輸入。計算服務處理輸入後,儲存服務會將計算值儲存在 TotalCommissionAmount 中。

遠端選項

遠端選項	描述
calculateCommission	true 或 false 設定為 true 時,服務會計算根項目的佣金,並將總金額儲存至 TotalCommissionAmount。 設定為 false (預設值) 時,服務不會計算佣金。 備註 如果您將此選項設定為 true,您也需要輸入至少一個產生者或生產代碼值:producerId、productionCodeId 或 productionCodeName。
commissionType	選擇性。 佣金類型 (例如,獎金或標準)。
commissionStatus	選擇性。 佣金的狀態 (例如「待處理」、「已支付」或「已豁免」)。
producerId	選擇性。 處理的產生者識別碼,亦即用來取得 commissionScheduleId 並計算佣金金額的產生者。 指派給 InsurancePolicy.ProducerId。
productionCodeId	選擇性。 生產代碼識別碼。 指派給 InsurancePolicy.ProductionCodeId__c。
productionCodeName	選擇性。 傳遞至 InsCommissionService.calculate 服務的生產代碼名稱。 如果您未輸入 productionCodeId,則服務會使用 productionCodeName 查詢 productionCodeId。如果您輸入兩個值,但這些值不相符,則 productionCodeId 會優先。

輸入 JSON

此服務會尋找下列金鑰/值配對:

• assetId 或 policyId

  建立交易所依據的原則識別碼

• transactionType

  交易類型

• effectiveDate

  交易的張貼日期與交易日期

• amount

  (選用) 交易金額

• transactionName

  (選用) 交易名稱。若未提供,則名稱預設為交易類型。

• additionalFields

  (選用) 待設定的其他交易欄位對應

例如：

{
	"assetId": "02i5A000005iF1MQAU",
	"transactionType": "Premium Paid",
	"effectiveDate": "2018-10-04",
	"amount": "100",
	"transactionName": "My Transaction",
	"additionalFields": {
		"StatementId__c": "a4f5A000001QFE0QAO"
	}
}

輸出 JSON

服務會傳回下列金鑰及其值:

• transactionId

  已建立交易記錄的識別碼

例如：

{
    "transactionId": "a3g5A000000YRPpQAO"
}

其他資訊

使用 additionalFields 地圖可在未在輸入參數中指定的交易上設定任何額外欄位。例如,若要設定 StatementId__c 欄位,additionalFields 地圖如下所示:

{
    “additionalFields”: {
    “StatementId__c” : “02i1I000001jaEhQAI”
    }
}