InsPolicyBillingService:generateBillingAccountStatements

No recomendamos que invoque este servicio directamente. Se creó para ser invocado por el trabajo programado Generar extractos de cuentas de facturación de Vlocity.

Clase: InsPolicyBillingService

Método: generateBillingAccountStatements

Funcionamiento

1. El servicio incluye una lista de cuentas de facturación de un trabajo programado de Vlocity.

2. Agrupa cuentas de facturación por cuentas.

3. Recupera pólizas asociadas con las Cuentas de facturación.

4. Crea una declaración para cada cuenta:

   1. Establece RecordType__c en Statement.

   2. Establece AccountId__c en el Id. de la cuenta.

   3. Establece el DueDate__c en el valor de BillDueDate__c de la primera cuenta de facturación del grupo.

   4. Establece StatementDate__c en el valor de BillDueDate__c.

   5. Establece StatementEndDate__c en el valor de BillDueDate__c.

   6. Establece la StatementStartDate__c en la fecha más lejana especificada por los valores de BillingFrequency__c en las cuentas de facturación.

   7. Establece BalanceDue__c en la suma de los valores de AutomaticPaymentAmounts__c en las pólizas asociadas con las cuentas de facturación.

   8. Establece PreviousBalance__c en la suma de los valores PastDue__c en las políticas asociadas con las cuentas de facturación.

5. Para todas las políticas asociadas con una declaración específica, recupera todas las transacciones asociadas con las políticas especificadas que tienen un TransactionDate__c en la fecha de inicio y finalización del periodo de declaración.

   Si la transacción no tiene un valor para el StatementId__c, establezca el StatementId__c en el Id. de la declaración especificada.

6. Para cada cuenta de facturación:

   1. Establece AutomaticPaymentAmount__c en la suma de los valores de NextPaymentAmountDue__c en las pólizas asociadas con la cuenta de facturación.

   2. Establece el nuevo BillDueDate__c en base a los BillDueDate__c y BillingFrequency__c actuales.

7. Para cada póliza asociada con una cuenta de facturación específica:

   1. Establece el AutomaticPaymentAmountDue__c en el NextPaymentAmountDue__c.

   2. Establece la BillDueDate__c del BillDueDate__c actualizado de la cuenta de facturación.

Opciones remotas

Este servicio no toma ninguna opción remota.

Calculating StatementStartDate__c

Una cuenta puede tener múltiples pólizas con facturación directa. Cada póliza puede tener una frecuencia de facturación diferente (anual, trimestral, mensual o semestral). La StatementStartDate__c se determina utilizando la fecha de vencimiento de factura y la frecuencia de facturación de la póliza para calcular la fecha de inicio de cada póliza. a continuación, seleccione la fecha de inicio más lejana en el tiempo.

Por ejemplo, si una Cuenta tiene dos pólizas, ambas con una fecha de vencimiento de factura de ‘2018-03-31’. La póliza 1 tiene una frecuencia de facturación de "Mensual" y la póliza 2 tiene una frecuencia de facturación de "Trimestral". Utilizando la fecha de vencimiento de factura y la frecuencia de facturación, la fecha de inicio de la póliza 1 sería ‘2018-02-28’ y la fecha de inicio de la póliza 2 sería ‘2018-01-01’. Dado que la fecha de inicio de la Política 2 está más atrás en el tiempo, StatementStartDate__c se establece en ‘2018-01-01’.

Cálculo de la nueva BillDueDate__c

Una nueva BillDueDate__c se calcula basándose en BillDueDate__c actual y BillingFrequency__c. Estas son las frecuencias de facturación y los cálculos para el nuevo BillDueDate__c:

• Anualmente

  BillDueDate__c actual más 1 año

• Trimestral

  Las BillDueDate__c solo pueden tener 1 de 4 fechas: 31 de marzo, 30 de junio, 30 de septiembre o 31 de diciembre. Establezca BillDueDate__c en la siguiente fecha de la secuencia. Por ejemplo, si está establecido actualmente como el 31 de marzo, establézcalo como el 30 de junio.

• Mensual

  BillDueDate__c actual más 1 mes

• Semestral

  • Si el BillDueDate__c actual es el final del mes, defínalo para mediados del mes siguiente (14 si es febrero, 15 si es cualquier otro mes)

  • Si el BillDueDate__c actual es a mediados de mes, defínalo como final de mes.

JSON de entrada

Este servicio espera un JSON de entrada generado por un trabajo programado de Vlocity. Este trabajo programado incluirá la siguiente clave y sus valores:

• records: Una lista de cuentas de facturación seleccionadas por el trabajo programado

{
	"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 salida

El servicio no devuelve ningún JSON de salida.