InsPolicyBillingService:generateBillingAccountStatements

このサービスを直接呼び出すことはお勧めしません。これは、[Generate Billing Account Statements Vlocity Scheduled Job (請求取引先ステートメントを生成 Vlocity スケジュール済みジョブ)] によって呼び出されるように作成されています。

クラス: InsPolicyBillingService

方法: generateBillingAccountStatements

操作手順

1. このサービスは、Vlocity スケジュール済みジョブから請求取引先のリストを取得します。

2. 請求取引先を取引先別にグループ化します。

3. 請求取引先に関連付けられた保険契約を取得します。

4. 各取引先のステートメントを作成します。

   1. RecordType__c を Statement に設定します。

   2. アカウントの ID にAccountId__cを設定します。

   3. グループの最初の請求取引先のBillDueDate__c値にDueDate__cを設定します。

   4. StatementDate__c を BillDueDate__c の値に設定します。

   5. StatementEndDate__c を BillDueDate__c の値に設定します。

   6. 請求アカウントのBillingFrequency__c値で指定された最新の日付にStatementStartDate__cを設定します。

   7. 請求アカウントに関連付けられたポリシーのAutomaticPaymentAmounts__c値の合計にBalanceDue__cを設定します。

   8. 請求アカウントに関連付けられたポリシーの PastDue__c 値の合計にPreviousBalance__cを設定します。

5. 特定のステートメントに関連付けられたすべてのポリシーで、ステートメント期間の開始日と終了日内にTransactionDate__cを持つ、指定されたポリシーに関連付けられたすべてのトランザクションを取得します。

   トランザクションにStatementId__cの値がない場合は、StatementId__cを指定したステートメントの ID に設定します。

6. 各請求取引先の場合:

   1. 請求アカウントに関連付けられたポリシーのNextPaymentAmountDue__c値の合計にAutomaticPaymentAmount__cを設定します。

   2. 現在のBillDueDate__cとBillingFrequency__cに基づいて新しいBillDueDate__cを設定します。

7. 特定の請求取引先に関連付けられた保険契約ごとに、次のようになります。

   1. AutomaticPaymentAmountDue__cをNextPaymentAmountDue__cに設定します。

   2. 請求アカウントの更新BillDueDate__cへのBillDueDate__cを設定します。

リモートオプション

このサービスでは、リモートオプションは使用されません。

Calculating StatementStartDate__c

直接請求では、取引先に複数の保険契約を設定できます。各保険契約の請求頻度 (年間、毎四半期、毎月、半毎月) は異なる場合があります。StatementStartDate__cは、ポリシーの請求期日と請求サイクルを使用して決定され、各ポリシーの開始日を計算します。次に、最も遠い日付から開始日を選択します。

たとえば、取引先に 2 つの保険契約があり、どちらも請求期日が「2018-03-31」であるとします。Policy 1 の請求サイクルは「毎月」、Policy 2 の請求サイクルは「毎四半期」です。請求期日と請求サイクルを使用すると、保険契約 1 の開始日は「2018-02-28」、保険契約 2 の開始日は「2018-01-01」になります。ポリシー 2 の開始日がさらに過去になるため、StatementStartDate__c は「2018-01-01」に設定されます。

新しい BillDueDate__c の計算

新しい BillDueDate__c は、現在の BillDueDate__c と BillingFrequency__c に基づいて計算されます。新しい BillDueDate__c の請求サイクルと計算を次に示します。

• 毎年

  現在 BillDueDate__c と 1 年

• 毎四半期

  BillDueDate__c は、3 月 31 日、6 月 30 日、9 月 30 日、または 12 月 31 日の 4 つの日付のいずれかにすることができます。BillDueDate__c をシーケンスの次の日付に設定します。たとえば、現在 3 月 31 日に設定されている場合は、6 月 30 日に設定します。

• 毎月

  Current BillDueDate__c plus 1 month (現在の期間 + 1 か月)

• 半月

  • 現在のBillDueDate__cが月末の場合、翌月中旬 (2 月の場合は 14 日、その他の月の場合は 15 日) に設定します。

  • 現在のBillDueDate__cが月中旬の場合、月末に設定する

Input JSON

このサービスは、Vlocity スケジュール済みジョブによって生成される入力 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 を返しません。