InsPolicyBillingService:generateBillingAccountStatements

Het wordt afgeraden om deze service rechtstreeks aan te roepen. Het is gemaakt om te worden aangeroepen door de geplande taak Factuuraccountafschriften genereren van Vlocity.

Klasse: InsPolicyBillingService

Methode: generateBillingAccountStatements

De manier waarop het werkt...

1. De service neemt een lijst van factureringsaccounts op van een geplande taak van Vlocity.

2. Groepeert factureringsaccounts op accounts.

3. Haalt polissen op die zijn gekoppeld aan de Factureringsaccounts.

4. Maakt een verklaring voor elke account:

   1. Stelt RecordType__c in op Statement.

   2. Stelt AccountId__c in op de ID van de account.

   3. Stelt DueDate__c in op de waarde van het BillDueDate__c van de eerste factuuraccount in de groep.

   4. Stelt StatementDate__c in op de waarde van BillDueDate__c.

   5. Stelt StatementEndDate__c in op de waarde van BillDueDate__c.

   6. Stelt StatementStartDate__c in op de verste datum terug die is opgegeven door de BillingFrequency__c in de factureringsaccounts.

   7. Stelt BalanceDue__c in op de som van de AutomaticPaymentAmounts__c voor de polissen die zijn gekoppeld aan de factureringsaccounts.

   8. Stelt PreviousBalance__c in op de som van de PastDue__c-waarden voor de polissen die zijn gekoppeld aan de factureringsaccounts.

5. Haalt voor alle polissen die zijn gekoppeld aan een specifieke verklaring, alle transacties op die zijn gekoppeld aan de opgegeven polissen die een TransactionDate__c hebben binnen de begin- en einddatum van de verklaringsperiode.

   Als de transactie geen waarde voor de StatementId__c heeft, stelt u de StatementId__c in op de ID van de opgegeven verklaring.

6. Voor elke factuuraccount:

   1. Stelt AutomaticPaymentAmount__c in op de som van de NextPaymentAmountDue__c voor de polissen die zijn gekoppeld aan de factureringsaccount.

   2. Stelt de nieuwe BillDueDate__c in op basis van de huidige BillDueDate__c en BillingFrequency__c.

7. Voor elke polis die is gekoppeld aan een specifieke factuuraccount:

   1. Stelt de AutomaticPaymentAmountDue__c in op de NextPaymentAmountDue__c.

   2. Stelt BillDueDate__c in op de bijgewerkte BillDueDate__c van de factuuraccount.

Externe opties

Deze service neemt geen externe opties.

StatementStartDate__c berekenen

Een account kan meerdere polissen hebben met directe facturering. Elke polis kan een andere factureringsfrequentie hebben (jaarlijks, per kwartaal, maandelijks of halfmaandelijks). StatementStartDate__c wordt bepaald aan de hand van de vervaldatum en factureringsfrequentie van de polis om de begindatum van elke polis te berekenen. Vervolgens wordt de begindatum gekozen die het verst terug in de tijd ligt.

Bijvoorbeeld als een account twee polissen heeft, beide met een vervaldatum van de factuur '2018-03-31'. Polis 1 heeft een factureringsfrequentie van 'Maandelijks' en Polis 2 heeft een factureringsfrequentie van 'Kwartaal'. Bij gebruik van de vervaldatum en factureringsfrequentie van de factuur is de begindatum van Polis 1 '2018-02-28' en de begindatum van Polis 2 '2018-01-01'. Aangezien de begindatum van Beleid 2 verder terug in de tijd ligt, wordt StatementStartDate__c ingesteld op '2018-01-01'.

De nieuwe BillDueDate__c berekenen

Een nieuwe BillDueDate__c wordt berekend op basis van de huidige BillDueDate__c en BillingFrequency__c. Dit zijn de factureringsfrequenties en berekeningen voor de nieuwe BillDueDate__c:

• Jaarlijks

  Huidige BillDueDate__c plus 1 jaar

• Driemaandelijks

  BillDueDate__c kan slechts 1 van 4 datums zijn: 31 maart, 30 juni, 30 september of 31 december. Stel BillDueDate__c in op de volgende datum in de reeks. Als deze momenteel bijvoorbeeld is ingesteld op 31 maart, stelt u deze in op 30 juni.

• Maandelijks

  Huidige BillDueDate__c plus 1 maand

• Halfmaandelijks

  • Als de huidige BillDueDate__c het einde van de maand is, stelt u deze in op het midden van de volgende maand (14e als februari, 15e als een andere maand)

  • Als de huidige BillDueDate__c het midden van de maand is, stelt u deze in op het einde van de maand

Invoer-JSON

Deze service verwacht een invoer-JSON die wordt gegenereerd door een geplande taak van Vlocity. Deze geplande taak bevat de volgende sleutel en hun waarden:

• records: Een lijst van factuuraccounts die zijn geselecteerd door de geplande taak

{
	"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"
		}
	]
}

Uitvoer-JSON

De service retourneert geen uitvoer-JSON.