This chapter provides reference information for Oracle Communications Billing and Revenue Management (BRM) Collections Manager utilities.
Use this utility to find bill units that are in collections and to trigger collections actions defined by the bill unit's collections scenario.
You must set a minimum value that this utility uses to determine whether bill units should be considered for collections. See "Setting the Minimum Overdue Balance to Process".
This utility is included in the pin_bill_day script. It should be run daily before pin_collections_send_dunning. See "About Billing Your Customers" in BRM Configuring and Running Billing for more information about the billing scripts.
Note:
To connect to the BRM database, pin_collections_process requires a configuration (pin.conf) file in the directory from which you run the utility. A configuration file is installed automatically in BRM_Home/apps/pin_collections when you install Collections Manager.Triggers collections actions against the specified bill unit. Use this parameter to perform collections against a single bill unit that belongs to a collections sharing group.
Sets the log level to debug and outputs debug information into the log file for this process. If not set, only error-level information is output.
Displays progress information.
Shows the summary of this billing run that includes information about how many account bill units are in collections, how many exited collections, and which system actions were performed.
Displays the syntax and parameters for this utility.
Use this utility to email or print dunning letters. This application is called by pin_collections_process, but it can also be run independently.
The delivery method for bill units that use the invoice payment type is specified in the Payment Details panel of Customer Center:
If the delivery method is set to Email, pin_collections_send_dunning emails the dunning letter.
If the delivery method is set to Postal, pin_collections_send_dunning prints the dunning letter.
For non-invoice bill units, you specify the delivery option in the collections configuration (pin.conf) file. See "Setting Dunning Letter Delivery Preferences for Non-Invoice Bill Units".
Important:
The Email Data Manager must be running when you run this utility, even for printing. For information, see "Sending Email to Customers Automatically" in BRM Managing Customers and "Configuring the Email Data Manager for Printing" in BRM Designing and Generating Invoices.The data used to create the dunning letter is generated by pin_collections_process and stored in the database. This data is combined with a dunning letter template to create the final letter.
Note:
To connect to the BRM database, pin_collections_send_dunning requires a configuration (pin.conf) file in the directory from which you run the utility. A configuration file is installed automatically in BRM_Home/apps/pin_collections when you install Collections Manager.Displays progress information.
Exports the generated dunning letters to the directory you specify.
Use this utility to load brand-specific dunning letter templates into the BRM database as /config/invoice_templates/dunning objects. These objects contain the XSL templates that you use to format dunning letters and invoice reminders.
For additional information, see "Loading Dunning Letter Templates".
Note:
This utility is brand-aware. You can load separate /config/invoice_templates/dunning objects for each brand.Important:
To connect to the BRM database, pin_collections_process requires a configuration (pin.conf) file in the directory from which you run the utility. A configuration file is installed automatically in BRM_Home/apps/pin_collections when you install Collections Manager.pin_load_template [-brand brand_POID] -name template_name [-type template_type] -format template_output_format -locale locale_name -template template_file [-usexsl] [-debug] [-logfile log_file]
Specifies the brand account POID for which you are loading the template: 0.0.0.1 /account 104 0 for example.
If your system is not brand enabled, the POID of the root account (0.0.0.1 /account 1) must be used.
Important:
If the brand account POID contains spaces, use quotation marks.Specifies the template name. The name must be unique for the brand and type. The name is displayed in the Collections Configuration application.
Important:
If the name contains spaces, use quotation marks.Specifies the template category. Use dunning for dunning letter templates.
Specifies the output format for the dunning letter templates.
Specifies the locale name. The default is en_US.
Specifies the template file name and path.
Specifies the use of XSL to format dunning letters. Must be used when loading an XSL dunning letter template.
Logs the flist and detailed messages in the log file.
Specifies the full path and name of the log file.