InsPolicyBillingService:generateBillingAccountStatements

Nous recommandons de ne pas invoquer directement ce service. Il a été créé pour être invoqué par la tâche planifiée Générer des relevés de compte de facturation Vlocity.

Classe: InsPolicyBillingService

Méthode : generateBillingAccountStatements

Fonctionnement

1. Le service prend en charge une liste de comptes de facturation à partir d'une Tâche planifiée Vlocity.

2. Regroupe les comptes de facturation par compte.

3. Récupère les stratégies associées aux Comptes de facturation.

4. Crée un relevé pour chaque compte :

   1. Définit RecordType__c sur Statement.

   2. Définit AccountId__c sur l'ID du compte.

   3. Définit la DueDate__c sur la valeur de BillDueDate__c du premier compte de facturation du groupe.

   4. Définit StatementDate__c sur la valeur de BillDueDate__c.

   5. Définit StatementEndDate__c sur la valeur de BillDueDate__c.

   6. Définit StatementStartDate__c sur la date la plus éloignée spécifiée par les valeurs de BillingFrequency__c dans les comptes de facturation.

   7. Définit BalanceDue__c à la somme des valeurs de AutomaticPaymentAmounts__c dans les polices associées aux comptes de facturation.

   8. Définit PreviousBalance__c à la somme des valeurs PastDue__c dans les stratégies associées aux comptes de facturation.

5. Pour toutes les polices associées à une instruction spécifique, récupère toutes les transactions associées aux polices spécifiées qui ont une TransactionDate__c comprise entre les dates de début et de fin de la période de déclaration.

   Si la transaction n'a pas de valeur pour le StatementId__c, définissez le StatementId__c sur l'ID du relevé spécifié.

6. Pour chaque compte de facturation :

   1. Définit AutomaticPaymentAmount__c à la somme des valeurs de NextPaymentAmountDue__c dans les polices associées au compte de facturation.

   2. Définit le nouveau BillDueDate__c en fonction des BillDueDate__c et BillingFrequency__c actuels.

7. Pour chaque politique associée à un compte de facturation spécifique :

   1. Définit le AutomaticPaymentAmountDue__c sur le NextPaymentAmountDue__c.

   2. Définit la BillDueDate__c sur la BillDueDate__c mise à jour du compte de facturation.

Options distantes

Ce service n'accepte aucune option distante.

Instruction de calculStartDate__c

Un compte peut avoir plusieurs polices avec facturation directe. Chaque police peut avoir une fréquence de facturation différente (annuelle, trimestrielle, mensuelle ou semestrielle). La StatementStartDate__c est déterminée en utilisant la date d'échéance de facturation et la fréquence de facturation de la police pour calculer la date de début de chaque police. puis en choisissant la date de début la plus ancienne.

Par exemple, si un compte a deux polices, toutes deux avec une date d'échéance de facturation au 31-03-2018. La police 1 a une fréquence de facturation « Mensuelle » et la police 2 a une fréquence de facturation « Trimestrielle ». En utilisant la date d’échéance de facturation et la fréquence de facturation, la date de début de la politique 1 serait «2018-02-28» et la date de début de la politique 2 serait «2018-01-01». La date de début de la politique 2 étant plus ancienne, StatementStartDate__c est définie sur ‘2018-01-01’.

Calcul de la nouvelle BillDueDate__c

Un nouveau BillDueDate__c est calculé sur la base du BillDueDate__c actuel et du BillingFrequency__c. Voici les fréquences de facturation et les calculs du nouveau BillDueDate__c :

• Annuelle

  BillDueDate__c actuelle plus 1 an

• Trimestrielle

  BillDueDate__c ne peut être que 1 des 4 dates : 31 mars, 30 juin, 30 septembre ou 31 décembre. Définissez BillDueDate__c sur la date suivante de la séquence. Par exemple, s'il est actuellement défini sur le 31 mars, définissez-le sur le 30 juin.

• Mensuelle

  BillDueDate__c actuelle plus 1 mois

• Semestriel

  • Si la BillDueDate__c actuelle est la fin du mois, définissez-la sur le milieu du mois suivant (14 février, 15 février, si n'importe quel autre mois)

  • Si la BillDueDate__c actuelle est au milieu du mois, définissez-la sur la fin du mois

JSON d'entrée

Ce service attend un JSON d'entrée généré par une Tâche planifiée Vlocity. Cette tâche planifiée comprendra les clés suivantes et leurs valeurs :

• records : Une liste de comptes de facturation sélectionnés par la tâche planifiée

{
	"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 de sortie

Le service ne renvoie aucun JSON de sortie.