System Configuration
To configure the Oracle Utilities Customer Care and Billing setup for the integration:
1. Login to Oracle Utilities Customer Care and Billing.
3. Setup message senders. Refer to the
Message Senders section for details.
4. Setup an external system. Refer to the
External System section for details.
7. Setup Notification Preferences Master Configuration and Oracle Utilities Customer Care and Billing Self-Service Integration. Refer to the
Master Configuration section for details.
Notification Types
Define the notification types to be used in the integration process between Oracle Utilities Customer Care and Billing and Oracle Utilities Network Management System.
Note: The integration includes starter notification type templates. Additional algorithms are available to support an extended list of outbound notifications from Oracle Utilities Customer Care and Billing. See the Oracle Utilities Customer Care and Billing documentation for reference.
On the Admin menu, navigate to the Notification Type portal.
Note: For all notification types, a customer contact type can be configured on the notification type to record a record of the notification that includes notification details. To enable, this configure a unique customer contact type per notification type and specify the customer contact type on the notification type.
On the Admin menu, navigate to Add Customer Contact Type. Add a Customer Contact Type with following details:
• Contact Acton is Record Notification
Add the following Oracle Utilities Network Management System notification types used for this integration:
• Planned Outage Started
• Outage Started
• Planned Outage Restored
• Outage Restored
• Planned Outage Canceled
• Outage Canceled
• Planned Outage Estimated Restoration Time (ERT) Update
• Outage Estimated Restoration Time (ERT) Update
• Planned Outage Scheduled
Add the following Oracle Utilities Customer Care and Billing notification types used for this integration:
• Bill Due Notification
On the Admin menu, navigate to the Self-Service Task Type page. Add a Self-Service Task Type with following details:
• Service Task Type Business Object: Bill Due Notification Task Type
• Related Transaction Object: Bill Due Notification Task
• Service Task Type Status: Active
• Service Task Class: Self-Service
On the Admin menu, navigate to the Notification Type page. Add a Notification Type with following details:
• Notification Type Business Object: Template-Based Subscription Notification Type
• Notification Type (Legacy): Bill Due Notification
• Use Service Task: Enabled
• Service Task Type: Service Task Type created for Bill Due Notification
• Template Data Algorithms: Bill Information Template Data
• Person Contact Types
• Delivery Types:
• Delivery Type: Email and/or SMS
• Template Name: Template Name as created in Notification Delivery System
• Late Payment Notification
On the Admin menu, navigate to the Self-Service Task Type page. Add a Self-Service Task Type with following details:
• Service Task Type Business Object: Late Payment Notification Task Type
• Related Transaction Object: Late Payment Notification Task
• Service Task Type Status: Active
• Service Task Class: Self-Service
On the Admin menu, navigate to the Notification Type page. Add a Notification Type with following details:
• Notification Type Business Object: Template-Based Subscription Notification Type
• Notification Type (Legacy): Late Payment Notification
• Use Service Task: Enabled
• Service Task Type: Service Task Type created for Late Payment Notification
• Template Data Algorithms: Bill Information Template Data
• Person Contact Types
• Delivery Types:
• Delivery Type: Email and/or SMS
• Template Name: Template Name as created in Notification Delivery System.
• Invite User Notification
On the Admin menu, navigate to the Self-Service Task Type page. Add a Self-Service Task Type with following details:
• Service Task Type Business Object: Web User Invitation Task Type
• Related Transaction Object: Web User Invitation Task
• Service Task Type Status: Active
• Service Task Class: Self-Service
On the Admin menu, navigate to the Notification Type page. Add a Notification Type with following details:
• Notification Type Business Object: Template-Based Subscription Notification Type
• Suppression Criteria: Always Suppressed (C1-ALWY-SUP)
• Override Delivery Information: Override Guest Delivery Information (C1OVINVGSTDI)
• Template Data Algorithms: Guest Notification Template Data
• Person Contact Types
• Delivery Types:
• Delivery Type: Email
• Template Name: Template Name as created in Notification Delivery System.
• Confirm Acceptance Notification
On the Admin menu, navigate to the Notification Type page. Add a DSS-T Notification Type with following details:
• Notification Type Business Object: Template-Based Parent Push Notification Type
• Person Contact Types
• Delivery Types: Email and/or SMS
On the Admin menu, navigate to the Notification Type page. Add a Notification Type with following details:
• Notification Type Business Object: Template-Based Individual Push Notification Type
• Parent Notification Type: Notification Type created for DSS-T notifications
• Template Data Algorithms: Guest Notification Template Data
• Delivery Types:
• Delivery Type: Email and/or SMS
• Template Name: Template Name as created in Notification Delivery System.
• Collection Notification
On the Admin menu, navigate to the Notification Type page. Add a parent Notification Type with following details:
• Notification Type Business Object: Template-Based Parent Push Notification Type
• Person Contact Types
• Delivery Types: Email and/or SMS
On the Admin menu, navigate to the Notification Type page. Add a Notification Type with following details:
• Notification Type Business Object: Template-Based Individual Push Notification Type
• Parent Notification Type: The Parent Notification Type created above
• Template Data Algorithms: Collection Notification Template Data
• Delivery Types:
• Delivery Type: Email and/or SMS
• Template Name: Template Name as created in Notification Delivery System
Notification types can be defined as Template-Based Parent/Individual Push or Template-Based Subscription. Refer to the respective product’s online help for more information.
For Template-Based Notification Types, the Template Name defined for each Delivery Types must be a valid campaign in Oracle Responsys.
Template Parameters
Template Data algorithms defined on Notification Types send a set of key/value pairs to the external system. Additional custom Template Data algorithms can be configured on the Notification Type to add more key/value pairs.
Use the following details to configure Notification Templates in Delivery System.
Template parameters sent by Bill Information Template Data algorithm:
• BILL_ID
• BILL_DT
• BILL_DUE_DATE
• AMOUNT_DUE
• CURRENCY_CODE
• CURRENCY_SYMBOL
• MAIN_ACCOUNT_ADDRESS
• SERVICE_ADDRESS
Template parameters sent by Guest Notification Template Data algorithm:
• WEB_USER_NAME
• OWNER_FIRST_NAME
• OWNER_LAST_NAME
• GUEST_FIRST_NAME
• GUEST_LAST_NAME
• GUEST_EMAIL
• GUEST_ACCESS_ROLE
• GUEST_ACCESS_ROLE_DESCR
• MAIN_ACCOUNT_ADDRESS
• SERVICE_ADDRESS
Template parameters sent by Collection Notification Template Data algorithm:
• ARREARS_AMOUNT
• ARREARS_DATE
• CURRENCY_CODE
• CURRENCY_SYMBOL
• MAIN_ACCOUNT_ADDRESS
• SERVICE_ADDRESS
Message Senders
Define a message sender for sending Oracle Utilities Customer Care and Billing template-based notification preferences outbound messages.
On the Admin menu, navigate to the Message Sender page. Add a message sender for Oracle Utilities Customer Care and Billing template-based notification preferences with the following details:
• Invocation Type: Real Time
• Message Class: RTJSONSNDR (Sender for real-time HTTP / JSON messages)
• MSG Encoding: UTF-8 message encoding
• On the Context tab, provide the HTTP URL, Login User, Login Password, HTTP Method and HTTP Timeout to the integration layer.
External System
For Oracle Utilities Customer Care and Billing Notifications, define an external system for Oracle Utilities Customer Care and Billing template-based notification preference messages.
On the Admin menu, navigate to the External System page. Add a external system for Oracle Utilities Customer Care and Billing template-based notification preference messages.
Add an outbound message type with the following details:
• Outbound Message Type: C1-TMPLNTFRQ (Template Based Notification Request)
• Processing Method: Real-time
• Message Sender: Template-based notification preferences message sender defined above
• Date/Time Format: XSD
• JSON Conversion Method: Base JSON Conversion
Bill and Collection Event Algorithms
Define the Post Bill Completion algorithm.
1. On the Admin menu, navigate to the Customer Class page.
2. On the Controls tab, configure the following algorithm:
• Post Bill Completion: Set Bill Notifications for Self-Service (WX-SSBNOTIFY)
Define the Collection Event algorithm:
1. On the Admin menu, navigate to the Algorithm page.
2. Add the Collection Event Notification algorithm with the following details:
• Algorithm Type: Collection Event Notification (C1COLLEVTNOT)
• Notification Type: Notification Type defined for Collection Event Notification
3. On the Admin menu, navigate to Collection Event Type for the notification.
4. Configure the Collection Event Notification algorithm in the Collection Event Algorithm field.
Feature Configuration
To setup Invite Guest User and Confirm Acceptance notifications, enable the Is CX Installed feature.
1. On the Admin menu, navigate to Feature Configuration.
2. Add or edit the General System Configuration with following options:
• Is CX Installed: Y
Master Configuration
For Oracle Utilities Customer Care and Billing notifications, define the Notification Preferences master configuration:
1. On the Admin menu, navigate to the Master Configuration portal.
2. Add or edit the Notification Preferences master configuration.
3. In the Default External Communication section, add the Default External System and Default Outbound Message Type as defined above for template-based notification messages. External System and Outbound Message Type can also be configured separately for each notification type in the Override External Communication section.
Define the Oracle Utilities Customer Care and Billing Self-Service Integration master configuration:
1. On the Admin menu, navigate to the Master Configuration portal.
2. Add or edit the Oracle Utilities Customer Care and Billing Self-Service Integration master configuration. Refer to the product specific online and embedded help for more information on defining each section.
3. In the Notification Service Tasks section, add the following notification types:
• Bill Due Notification: Notification Type defined for Bill Due Notification
• Late Payment Notification: Notification Type defined for Late Payment Notification
4. In the Guest User Invitation Notification Types section, add the following notification types:
• Invite User: Notification Type defined for Invite Guest Notification
• Confirm Acceptance: Notification Type defined for Confirm Acceptance Notification