InsPolicyBillingService:generateBillingAccountStatements

Non è consigliabile invocare direttamente questo servizio. È stato creato per essere invocato dal processo pianificato Genera estratti conto fatturazione Vlocity.

Classe: InsPolicyBillingService

Metodo: generateBillingAccountStatements

Funzionamento

1. Il servizio riceve un elenco di account di fatturazione da un processo pianificato Vlocity.

2. Raggruppa gli account di fatturazione per account.

3. Recupera le policy associate agli account di fatturazione.

4. Crea un estratto conto per ogni account:

   1. Imposta RecordType__c su Statement.

   2. Imposta la AccountId__c sull'ID dell'account.

   3. Imposta il DueDate__c sul valore di BillDueDate__c del primo account di fatturazione del gruppo.

   4. Imposta la StatementDate__c sul valore di BillDueDate__c.

   5. Imposta la StatementEndDate__c sul valore di BillDueDate__c.

   6. Imposta la StatementStartDate__c sulla data più recente specificata dai valori di BillingFrequency__c negli account di fatturazione.

   7. Imposta l'BalanceDue__c sulla somma dei valori di AutomaticPaymentAmounts__c delle policy associate agli account di fatturazione.

   8. Imposta l'PreviousBalance__c sulla somma dei valori PastDue__c delle policy associate agli account di fatturazione.

5. Per tutte le polizze associate a un estratto conto specifico, recupera tutte le transazioni associate alle polizze specificate che hanno una TransactionDate__c entro la data di inizio e fine del periodo dell'estratto conto.

   Se la transazione non ha un valore per il StatementId__c, impostare il StatementId__c sull'ID dell'Estratto conto specificato.

6. Per ogni account di fatturazione:

   1. Imposta l'AutomaticPaymentAmount__c sulla somma dei valori di NextPaymentAmountDue__c delle policy associate all'account di fatturazione.

   2. Imposta il nuovo BillDueDate__c in base al BillDueDate__c e alla BillingFrequency__c correnti.

7. Per ogni policy associata a un account di fatturazione specifico:

   1. Imposta il AutomaticPaymentAmountDue__c sul NextPaymentAmountDue__c.

   2. Imposta l'BillDueDate__c alla BillDueDate__c aggiornata dell'account di fatturazione.

Opzioni remote

Questo servizio non accetta opzioni remote.

Calcolo dell'istruzioneStartDate__c

Un account può avere più polizze con fatturazione diretta. Ogni polizza può avere una frequenza di fatturazione diversa (annuale, trimestrale, mensile o semestrale). Il StatementStartDate__c viene determinato utilizzando la scadenza della polizza e la frequenza di fatturazione per calcolare la data iniziale di ogni polizza. scegliendo quindi la data iniziale più lontana nel tempo.

Ad esempio, se un Account ha due polizze, entrambe con scadenza "2018-03-31". La Polizza 1 ha una frequenza di fatturazione "Mensile" e la Polizza 2 ha una frequenza di fatturazione "Trimestrale". Utilizzando la scadenza delle bollette e la frequenza di fatturazione, la data iniziale della polizza 1 sarebbe "2018-02-28" e la data iniziale della polizza 2 sarebbe "2018-01-01". Poiché la data iniziale della Policy 2 è più indietro nel tempo, StatementStartDate__c è impostato su ‘2018-01-01’.

Calcolo del nuovo BillDueDate__c

Un nuovo BillDueDate__c viene calcolato in base al BillDueDate__c corrente e al BillingFrequency__c. Di seguito sono riportate le frequenze di fatturazione e i calcoli per il nuovo BillDueDate__c:

• Annualmente

  BillDueDate__c corrente più 1 anno

• Trimestrale

  I BillDueDate__c possono essere solo 1 su 4 date: 31 marzo, 30 giugno, 30 settembre o 31 dicembre. Impostare BillDueDate__c sulla data successiva nella sequenza. Ad esempio, se è attualmente impostato sul 31 marzo, impostarlo sul 30 giugno.

• Mensile

  BillDueDate__c corrente più 1 mese

• Semimensile

  • Se il BillDueDate__c corrente corrisponde alla fine del mese, impostarlo sulla metà del mese successivo (14 se febbraio, 15 se qualsiasi altro mese)

  • Se il BillDueDate__c corrente è la metà del mese, impostarlo sulla fine del mese

Input JSON

Questo servizio si aspetta un JSON di input generato da un processo pianificato Vlocity. Questo processo pianificato includerà la chiave seguente e i relativi valori:

• records: Elenco degli account di fatturazione selezionati dal processo pianificato

{
	"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 di output

Il servizio non restituisce alcun JSON di output.