InsPolicyBillingService:generateBillingAccountStatements

我們不建議您直接叫用此服務。它是為了由「產生帳單對帳單單 Vlocity 排程工作」所叫用而建立。

類別:InsPolicyBillingService

方法:generateBillingAccountStatements

運作方式

1. 服務會從 Vlocity 排程工作中取得帳單帳戶清單。

2. 依帳戶將帳單帳戶分組。

3. 取得與「帳單帳戶」相關聯的原則。

4. 為每個帳戶建立陳述式:

   1. 將 RecordType__c 設為 Statement。

   2. 將 AccountId__c 設為帳戶的識別碼。

   3. 將 DueDate__c 設為群組中第一個帳單帳戶的 BillDueDate__c 值。

   4. 將 StatementDate__c 設為 BillDueDate__c 的值。

   5. 將 StatementEndDate__c 設為 BillDueDate__c 的值。

   6. 將 StatementStartDate__c 設定為帳單帳戶中 BillingFrequency__c 值指定的最遠日期。

   7. 將 BalanceDue__c 設為與帳單帳戶相關聯之保單上的 AutomaticPaymentAmounts__c 值總和。

   8. 將 PreviousBalance__c 設為與帳單帳戶相關聯之保單上的 PastDue__c 值總和。

5. 針對與特定對帳單相關聯的所有原則,請針對在對帳單週期開始與結束日期內有 TransactionDate__c 的指定原則所相關聯的所有交易,

   如果交易沒有該 StatementId__c 的值,請將 StatementId__c 設定為指定對帳單的識別碼。

6. 針對每個帳單帳戶:

   1. 將 AutomaticPaymentAmount__c 設為與帳單帳戶相關聯之保單上的 NextPaymentAmountDue__c 值總和。

   2. 根據目前的 BillDueDate__c 和 BillingFrequency__c 設定新 BillDueDate__c。

7. 針對與特定帳單帳戶相關聯的每個原則:

   1. 將 AutomaticPaymentAmountDue__c 設定為 NextPaymentAmountDue__c。

   2. 將 BillDueDate__c 設為帳單帳戶更新的 BillDueDate__c。

遠端選項

此服務不採用任何遠端選項。

計算 StatementStartDate__c

一個帳戶可以有多個具有直接帳單的保單。每個保單可能有不同的帳單頻率 (每年、每季、每月或每半月)。StatementStartDate__c 是使用保單的帳單到期日期和帳單頻率來決定每個保單的開始日期。接著選擇過去最遠的開始日期。

例如,如果帳戶有兩個保單,則兩個保單的帳單到期日為「2018-03-31」。保單 1 的帳單頻率為「每月」,而保單 2 的帳單頻率為「每季」。使用帳單到期日期與帳單頻率時,「保單 1」的開始日期將是「2018-02-28」,而「保單 2」的開始日期將是「2018-01-01」。由於「原則 2」的開始日期遠遠不及時,因此 StatementStartDate__c 設定為「2018-01-01」。

計算新的 BillDueDate__c

系統會根據目前的 BillDueDate__c 和 BillingFrequency__c 計算新的 BillDueDate__c。以下是新 BillDueDate__c 的帳單頻率與計算:

• 每年

  目前 BillDueDate__c 加上 1 年

• 每季

  BillDueDate__c 只能是 4 個日期的 1 個:3 月 31 日、6 月 30 日、9 月 30 日或 12 月 31 日。將 BillDueDate__c 設定為序列中的下一個日期。例如,如果目前設定為目前的 3 月 31 日,請將其設定為 6 月 30 日。

• 每月

  目前 BillDueDate__c 加上 1 個月

• 半月

  • 如果目前的 BillDueDate__c 為月份結束,則將其設定為下個月的中間 (如果是 2 月 14 日,如果是其他月份,則為 15 日)

  • 如果目前的 BillDueDate__c 是月份中部,則設定為月份結束

輸入 JSON

此服務預期由 Vlocity Scheduled Job 產生的輸入 JSON。此排程工作將包含下列金鑰及其值:

• records:已排程工作選取的帳單帳戶清單

{
	"records": [{
			"Id": "a3h5A000000Xz7l",
			"AccountId": "0015A000025MuenQAC",
			"BillDueDate__c": "2018-03-31",
			"BillingFrequency__c": "Monthly"
		},
		{
			"Id": "a3h5A000000Xz7m",
			"AccountId": "0015A000025MuenQAC"
			"BillDueDate__c": "2018-03-31",
			"BillingFrequency__c": "Quarterly"
		}
	]
}

輸出 JSON

服務不會傳回任何輸出 JSON。