Notification on Advance Deposit Cancellation

Oracle Revenue Management and Billing enables you to send notification via a customer contact when the payment on the advance deposit contract is canceled. To enable this feature, you need to attach an algorithm created using the C1-NOTADCAN algorithm type to the Payment Cancellation system event of the parent customer's customer class.

This algorithm checks whether the payment is made on a contract which is created using a contract type specified in the Advance Deposit Contract Type attribute of the delinquency process preference. The system considers the delinquency process preference which is specified in the Delinquency Process Field Mapping option type of the DELINPROC feature configuration. For more information about the feature configuration, see Setting the DELINPROC Feature Configuration

If the payment is not made on a contract of the advance deposit contract type, no action takes place while canceling the payment. However, if the payment is made on a contract of the advance deposit contract type, this algorithm checks whether the cancel reason specified while canceling a payment is listed in the Advanced Deposit Payment Cancel Reason List parameter. If so, the system creates a customer contact using the given customer contact type for the given customer contact class. If the advance deposit contract is linked to a policy, the system stamps the policy ID as a characteristic on the customer contact using the characteristic type which is specified in the Policy Characteristic Type for Customer Contact option type of the DELINPROC feature configuration.

However, if the cancel reason specified while canceling a payment is not listed in the Advanced Deposit Payment Cancel Reason List parameter, no action takes place while canceling the payment. If the advance deposit payment is already used to settle an overdue bill through a delinquency process, the system does the following:

  • Cancels the debit adjustments created against the advance deposit payment.

  • Cancels the credit adjustments used to offset the overdue bills through a delinquency process.

  • Unapplies or cancels the offset request. If the number of transfer or offset adjustments does not exceed the online record process limit (defined in the C1-DFRUNAPLY algorithm), the system cancels the frozen transfer or offset adjustments immediately and then changes the status of the offset request to Unapplied Offset. However, if the number of transfer or offset adjustments exceeds the online record process limit (defined in the C1-DFRUNAPLY algorithm), the system changes the status of the offset request to Defer Unapplied.

Note:

On executing the Offset Request Periodic Monitor (C1-OFSRQ) batch, the system considers the offset requests which are in the Defer Unapplied status. The system then cancels the frozen transfer or offset adjustments of the offset request and changes the status of the offset request to Unapplied Offset.

The system then executes the C1-CDPPAYCAN algorithm attached to the Payment Cancellation system event of the parent customer's customer class. It changes the status of the delinquency process. For more information about the algorithm, see Resuming a Delinquency Process on Payment Cancellation

Always ensure that you attach the following algorithms to the Payment Cancellation system event in the specified sequence:

  1. C1-NOTADCAN

  2. C1-CDPPAYCAN

This algorithm contains the following parameters:

  • Customer Contact Type - Used to indicate the customer contact type using which you want to create the customer contact. Here, you must specify a customer contact type with the appropriate letter template depending on the type of letter you want to send to the customer.

  • Customer Contact Class - Used to indicate the customer contact class to which the customer contact type belongs.

  • Default Contact Method - Used to indicate the contact method that you want to use when the preferred contact method cannot be derived for the routing method from the preference.

  • Advanced Deposit Payment Cancel Reason List - Used to specify a comma-separated list of payment cancel reasons that the system should consider while notifying customers on payment cancelation. The system uses this parameter to distinguish between advance deposit transfer and advance deposit cancellation. You can specify maximum five comma-separated values for this parameter. Here, you must specify a payment cancel reason which is already defined in the system.

  • Offset Request Defer Unapply Status Code - Used to specify the status to which you want to transition the offset request when an advance deposit payment is canceled. You must specify a status code which is already defined in the lifecycle of the C1-OffsetRequest business object.

  • Offset Request Defer Unapply Status Reason - Used to specify the reason why you want to unapply or cancel the offset request. You must specify a reason which is already defined for the Defer Unapplied status of the C1-OffsetRequest business object in the Status Reason screen.

All these parameters are mandatory.