Resuming a Delinquency Process on Adjustment Cancellation

To automatically resume a delinquency process when an adjustment made against the respective overdue bill is canceled, you need to attach the following algorithms to the Adjustment Cancellation system event of the required adjustment types:

  • C1-DPADJCAN - This algorithm is invoked when an adjustment is canceled. It checks whether the Delinquency Process (C1-DELPO) characteristic is defined on the adjustment. If the C1-DELPO characteristic is not defined on the adjustment, the system creates a customer contact for the main customer of the account for which the adjustment was created. In addition, the system stamps the adjustment ID as a characteristic using the given characteristic type on the customer contact and the customer contact ID as a characteristic using the given characteristic type on the adjustment.

    However, if the C1-DELPO characteristic is defined on the adjustment, the system derives the delinquency process ID from characteristic value. It then validates whether the delinquency process exist with the given ID in the system. Note that if the delinquency process does not exist, no further action takes place on the adjustment cancellation. However, if the delinquency process ID is successfully validated, the system checks the following:

    • The status of the delinquency process is set to the value (for example, Canceled) specified in the Delinquency Process Canceled Status attribute of the delinquency process preference.

    • The related delinquency process does not exist for the delinquency process.

    Note: 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 either or both the conditions are not satisfied, no further action takes place on the adjustment cancellation. However, if both the conditions are satisfied, the system invokes the C1-CANDELPRC algorithm attached to the Cancel Criteria system event of the respective delinquency process type. If the cancel criteria is met, the delinquency process remains in the existing status and no further action takes place on the adjustment cancellation. However, if the cancel criteria is not met, the status of the delinquency process is set to the status prior to cancellation (i.e. Initiated, Delinquency In Progress, or On Hold). If the status of the delinquency process before cancellation was On Hold, then the status of the hold record is changed to Active. The system also creates a customer contact for the main customer of the account for which the adjustment was created. In addition, the system does the following:

    • Adds a log entry for the customer contact in the delinquency process

    • Stamps the customer contact ID as a characteristic using the given characteristic type on the adjustment

    • Stamps the adjustment ID as a characteristic using the given characteristic type on the customer contact

    • Stamps the delinquency process ID using the C1-DELPO characteristic type on the customer contact

    This algorithm derives the preferred contact method for the customer contact. While deriving the preferred contact method, the algorithm first fetches the main customer’s bill route type on the account and then fetches the bill routing method of the bill route type. Once the bill routing method is derived, the system considers the preference which is specified in the Routing Method – Contact Method Mapping option type of the DELINPROC feature configuration. For more information about the feature configuration, see Setting the DELINPROC Feature Configuration. It then checks whether any preferred contact method is mapped to the bill routing method in the preference.

    If the preferred contact method is mapped to the bill routing method in the preference, the system stamps it on the customer contact. However, if the preferred contact method is not mapped to the bill routing method in the preference, the system considers the default contact method as the preferred contact method and stamps it on the customer contact.

    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.

    • 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.

    • Customer Contact Characteristic Type - Used to indicate the characteristic type using which you want to store the customer contact ID on the adjustment. Here, you must specify a characteristic type where the characteristic entity is set to Adjustment.

    • Adjustment Characteristic For Customer Contact - Used to indicate the characteristic type using which you want to store the adjustment ID on the customer contact. Here, you must specify a characteristic type where the characteristic entity is set to Customer Contact.

    All the above parameters are mandatory.

  • C1-RODPONADX - This algorithm is invoked when an adjustment is canceled. It derives the reason why the adjustment was canceled and validates whether it is listed as a value in the Excluded Adjustment Cancel Reason List parameter. If the adjustment cancel reason is listed in the Excluded Adjustment Cancel Reason List parameter, no further action takes place on the adjustment cancellation. However, if the adjustment cancel reason is not listed in the Excluded Adjustment Cancel Reason List parameter, the system checks whether the Delinquency Process (C1-DELPO) characteristic is defined on the adjustment. If the C1-DELPO characteristic is not defined on the adjustment, no further action takes place on the adjustment cancellation.

    However, if the C1-DELPO characteristic is defined on the adjustment, the system derives the delinquency process ID from characteristic value. It then validates whether the delinquency process exist with the given ID in the system. If the delinquency process does not exist, no further action takes place on the adjustment cancellation. However, if the delinquency process ID is successfully validated, the system checks whether the status of the delinquency process is set to the value (for example, Customer Reinstated) specified in the Delinquency Process Customer Reinstated Status attribute of the delinquency process preference. If so, the system checks the value of the Delinquency Process Resume Switch parameter. If the Delinquency Process Resume Switch parameter is set to Y, the system does the following:

    • Sets the status of the delinquency process to the value (for example, Reinstatement Payment/Adjustment Canceled) specified in the Delinquency Reinstatement Payment/Adjustment Canceled Status attribute of the delinquency process preference

    However, if the Delinquency Process Resume Switch parameter is set to N, the system does the following:

    • If a delinquency process created using the given delinquency process type already exists for the account, the system adds the overdue bill for which the adjustment is canceled in the existing delinquency process. In addition, a log entry is created for the overdue bill which is added in the existing delinquency process. Note that the system considers an existing delinquency process which is in the status that is listed in the Delinquency Process Status For Existing Delinquency Process parameter of the C1-DLNQMNRL algorithm attached to the delinquency control of the person’s or account’s collection class.

    • If a delinquency process does not exist for the account, the system creates a new delinquency process using the given delinquency process type. It adds the overdue bill for which the adjustment is canceled in the new delinquency process. Also, if there are any other overdue bills of the account that do not meet the tolerance limit are also added in the delinquency process. The status of the delinquency process is set to the value (for example, Initiated) specified in the Delinquency Process Initiated Status attribute of the delinquency process preference. In addition, a log entry is created for each overdue bill which is added in the delinquency process.

    Note: 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.

    This algorithm contains the following parameters:

    • Excluded Adjustment Cancel Reason List – Used to specify a list of comma-separated adjustment cancel reasons. The system will then skip the adjustments which are canceled using the given adjustment cancel reason and will not take any actions on the adjustment cancellation. You can specify maximum five comma-separated values for this parameter. Here, you must specify an adjustment cancel reason which is already defined in the system.

    • Delinquency Process Resume Switch – Used to indicate whether the original delinquency process which was canceled due to the adjustment should be resumed when the adjustment is canceled. The valid values are – Y and N. This parameter is mandatory.

    • Delinquency Process Type – Used to indicate the delinquency process type using which a new process delinquency process should be created for the account when the adjustment is canceled. It is also used to check whether any existing delinquency process created using the given delinquency process type already exists in the system. Here, you must specify a delinquency process type which is already defined in the system. This parameter is required only when the Delinquency Process Resume Switch parameter is set to N.