6 Event Notification Definitions

This chapter provides a brief description of each Oracle Communications Billing and Revenue Management (BRM) notification event and includes links to the notification event specifications. See "Using Event Notification" in BRM Developer's Guide for more information.

For more information about event notification definitions and field definitions, see BRM Event Notification Reference.

Event Notification Definitions

Table 6-1 lists the BRM event notification definitions and descriptions.

Table 6-1 Event Notification Definitions

Event Notification Description

/event/billing/dispute/notify

Generated when an event is disputed. When the notification event is detected, BRM creates a reservation for the disputed amount to prevent misuse of resources during the dispute. For more information, see "Configuring Adjustments, Disputes, and Settlements" in BRM Managing Accounts Receivable.

/event/billing/settlement/notify

Generated when a dispute is settled. When the notification event is detected, BRM releases the reservation against the disputed amount as part of the settlement process. For more information, see "Configuring Adjustments, Disputes, and Settlements" in BRM Managing Accounts Receivable.

/event/notification

An abstract class to define event notifications.

/event/notification/account

An abstract class to define event notifications for operations on the account object.

/event/notification/account/create

Generated when an account is created.

/event/notification/account/delete

Generated when an account is deleted.

/event/notification/account/pre_delete

Generated at the start of the account deletion process.

/event/notification/activity

An abstract class to define event notifications on activities.

/event/notification/activity/out_of_order

Generated when an out-of-order event is detected. When the notification event is detected, Pipeline Manager automatically rerates events. For more information, see "About Automatic Rerating of Out-of-Order Events" in BRM Setting Up Pricing and Rating.

/event/notification/amt

An abstract class to define event notifications for operations on the Account Migration Manager process.

/event/notification/amt/HoldCDRProcessing

Generated when Account Migration Manager begins migrating a group of accounts from one database schema to another. This event notifies the account-router Pipeline Manager that it needs to suspend all EDRs for the specified accounts. For more information, see "Migrating Accounts with the Pipeline Manager Running" in BRM System Administrator's Guide.

/event/notification/amt/MigrateAcct

Generated after Account Migration Manager successfully migrates a group of accounts from one database schema to another. This event notifies the account-router Pipeline Manager that it needs to update the POIDs for the specified list of accounts. For more information, see "Migrating Accounts with the Pipeline Manager Running" in BRM System Administrator's Guide.

/event/notification/amt/MigrateDestination

Generated after Account Migration Manager successfully migrates a group of accounts from one database schema to another. This event notifies the destination Pipeline Manager that it needs to update the account information stored in cache. For more information, see "Migrating Accounts with the Pipeline Manager Running" in BRM System Administrator's Guide.

/event/notification/amt/MigrateSource

Generated after Account Migration Manager successfully migrates a group of accounts from one database schema to another. For more information, see "Migrating Accounts with the Pipeline Manager Running" in BRM System Administrator's Guide.

/event/notification/amt/ResumeCDRProcessing

Generated after both Account Migration Manager successfully migrates a group of accounts and all Pipeline Manager instances successfully update their account information. This event notifies the account-router Pipeline Manager that it can begin processing all suspended and new EDRs for the specified list of accounts. For more information, see "Migrating Accounts with the Pipeline Manager Running" in BRM System Administrator's Guide.

/event/notification/auto_rerate

Generated when an event is backdated and requires rerating. For more information, see "About Automatic Rerating of Backdated Events" in BRM Setting Up Pricing and Rating.

/event/notification/bal_grp

An abstract class to define event notifications for operations on the balance group object.

/event/notification/bal_grp/create

Generated when a new balance group is created.

/event/notification/bal_grp/modify

Generated when an existing balance group is modified.

/event/notification/billing

An abstract class to define event notifications for billing operations.

/event/notification/billing/end

Generated when final billing ends for an accounting cycle.

Note: Final billing occurs after the end of the billing delay period, if configured.

/event/notification/billing/end_partial

Generated when partial billing ends for an accounting cycle. Partial billing occurs only if you configured delayed billing and you executed billing during the delay period.

/event/notification/billing/start

Generated when final billing starts for an accounting cycle.

Note: Final billing occurs after the end of the billing delay period, if configured.

/event/notification/billing/start_partial

Generated when partial billing starts for an accounting cycle. Partial billing occurs only if you configured delayed billing and you execute billing during the delay period.

/event/notification/customer

An abstract class to define event notifications for operations on the customer object.

/event/notification/customer/modify

Generated after an account is successfully modified.

/event/notification/customer/pre_modify

Generated just prior to an account modification.

/event/notification/customer/reg_complete

Generated when customer registration is complete.

/event/notification/customer/uniqueness_confirmed

Generated after BRM confirms that a customer's account POID is unique for all database schemas in your multischema system.

/event/notification/cycle

An abstract class to define event notifications for cycle operations.

/event/notification/cycle/end

Generated at the end of a billing cycle either by the PCM_OP_BILL_MAKE_BILL opcode or after applying the cycle fees.

/event/notification/cycle/start

Generated at the start of a billing cycle either by the PCM_OP_BILL_MAKE_BILL opcode or before applying the cycle fees.

/event/notification/deal

An abstract class to define event notifications for operations on the deal object.

/event/notification/deal/change

When transitioning an account from one deal to another, this event is generated just prior to canceling the old deal.

/event/notification/deal/change_complete

When transitioning an account from one deal to another, this event is generated after successfully canceling the old deal.

/event/notification/deal/transition

When transitioning an account from one deal to another, this event is generated just prior to adding the new deal.

/event/notification/deal/transition_complete

When transitioning an account from one deal to another, this event is generated after successfully adding the new deal.

/event/notification/device

An abstract class to define event notifications for operations on the device object.

/event/notification/device/state

Generated after a device is successfully changed to a new state.

/event/notification/device/state/in_transition

Generated just prior to a device changing state.

/event/notification/offer_profile/create

Generated when a new offer profile is created.

/event/notification/offer_profile/delete

Generated when an offer profile is deleted.

/event/notification/offer_profile/ThresholdBreach

Generated when the sum of current balance and the consumed reservation is equal to or greater than the nearest threshold configured in the offer profile for a service and resource ID.

/event/notification/offer_profile/update

Generated when an existing offer profile is modified.

/event/notification/order

An abstract class to define event notifications for operations on the order object.

/event/notification/order/state

Generated after an order is successfully changed to a new state.

/event/notification/order/state/in_transition

Generated just prior to an order changing state.

/event/notification/plan

An abstract class to define event notifications for operations on the plan object.

/event/notification/plan/transition

Generated just prior to an account transitioning from one plan to another.

/event/notification/plan/transition_complete

Generated after an account is successfully transitioned to a new plan.

/event/notification/price

An abstract class to define event notifications for operations on the price object.

/event/notification/price/discounts

An abstract class to define event notifications for operations on the pricing discount object.

/event/notification/price/discounts/modify

Generated after a discount is created or updated in the BRM database. This event is used to synchronize discounts between BRM and external CRM applications.

/event/notification/price/products

An abstract class to define event notifications for operations on the pricing product object.

/event/notification/price/products/modify

Generated after a product is created or updated in the BRM database. This event is used to synchronize products between BRM and external CRM applications.

/event/notification/price/sponsorships

An abstract class to define event notifications for operations on the pricing sponsorship object.

/event/notification/price/sponsorships/modify

Generated after a /sponsorship object is created or updated in the BRM database. This event is used to synchronize sponsorship (chargeshare) data between BRM and external CRM applications.

/event/notification/price/tailormade_products/create

Generated when a customized /product object is created. For more information, see "Modifying Rates and Price Models in a Product" in BRM Managing Customers.

/event/notification/price/tailormade_products/modify

Generated when a customized /product object is modified. For more information, see "Modifying Rates and Price Models in a Product" in BRM Managing Customers.

/event/notification/process_audit

An abstract class to define event notifications for operations on the process audit object.

/event/notification/process_audit/create

Generated when Revenue Assurance Manager creates a /process_audit object. For more information, see "Understanding Revenue Assurance Manager" in BRM Collecting Revenue Assurance Data.

/event/notification/process_audit/update

Generated when Revenue Assurance Manager updates a /process_audit object with revenue assurance data. For more information, see "Understanding Revenue Assurance Manager" in BRM Collecting Revenue Assurance Data.

/event/notification/product/cancel/no_refund

Generated when a refund could not be applied due to a canceled override product. For more information, see "Configuring Event Notification for Override Pricing" in BRM Setting Up Pricing and Rating.

/event/notification/profile

An abstract class to define event notifications for operations on the profile object.

/event/notification/profile/create

Generated when a new profile is created.

/event/notification/profile/delete

Generated when a profile is deleted.

/event/notification/profile/modify

Generated after a profile is successfully changed.

/event/notification/profile/pre_modify

Generated just prior to a profile being modified.

/event/notification/rate_change

Generated when a condition occurs that may require rerating. For more information, see "About Automatic Rerating" in BRM Setting Up Pricing and Rating.

/event/notification/ra_threshold

Generated by the pin_ra_check_thresholds utility when specified conditions for producing revenue leakage alerts occur. For more information, see "Setting Up Revenue Assurance Manager for Pipeline Batch Rating" in BRM Collecting Revenue Assurance Data.

/event/notification/rerating

An abstract class to define event notifications for the rerating operation.

/event/notification/rerating/end

Generated when a rerating job has finished.

/event/notification/rerating/PrepareToRerate

Generated just prior to the rerating process. This event notifies Pipeline Manager to suspend event data record (EDR) processing for all accounts affected by the rerating job.

/event/notification/rerating/ReratingCompleted

Generated after rerating completes successfully. This signals that Pipeline Manager should resume EDR processing for all accounts affected by the rerating job.

/event/notification/rerating/start

Generated just prior to the start of the rerating process. This signals that Pipeline Manager should halt EDR processing for all accounts affected by the rerating job.

/event/notification/rollover

An abstract class to define event notifications for the rollover operation.

/event/notification/rollover/end

Generated after a resource sub-balance is successfully rolled over to another cycle. For more information, see "About Rollovers" in BRM Setting Up Pricing and Rating.

/event/notification/rollover/start

Generated just prior to a resource sub-balance being rolled over from one cycle to another. For more information, see "About Rollovers" in BRM Setting Up Pricing and Rating.

/event/notification/rollover_correction

An abstract class to define event notifications for operations on the rollover correction object.

/event/notification/rollover_correction/rerate

Generated when a rollover correction during billing requires an event to be rerated. This rollover correction, in turn, is necessitated by delayed usage events after the end of the cycle. For more information, see "Enabling Rerating and Rollover Correction Due to Delayed Events" in BRM Configuring and Running Billing.

/event/notification/service

An abstract class to define event notifications for operations on the service object.

/event/notification/service_balgrp_transfer

An abstract class to define event notifications for the service balance group transfer operation.

/event/notification/service_balgrp_transfer/data

Generated when either of the following occurs:

  • A service is transferred from one balance group to another.

  • A balance group is transferred from one bill unit to another.

This is used to synchronize balance group transfer data between BRM and Pipeline Manager.

For more information, see "About Transferring Services between Balance Groups" in BRM Managing Accounts Receivable.

/event/notification/service_balgrp_transfer/end

Generated after a service is successfully transferred from one balance group to another. For more information, see "About Transferring Services between Balance Groups" in BRM Managing Accounts Receivable.

/event/notification/service_balgrp_transfer/start

Generated just prior to a service being transferred from one balance group to another. For more information, see "About Transferring Services between Balance Groups" in BRM Managing Accounts Receivable.

/event/notification/service/create

Generated when a service is created.

/event/notification/service/delete

Generated when a service is deleted.

/event/notification/service/modify

Generated when a service is modified.

/event/notification/service/post_change

Generated after a service has been successfully updated.

/event/notification/service/pre_change

Generated just prior to a service being updated.

/event/notification/service/pre_create

Generated just prior to the creation of a service.

/event/notification/service/pre_purchase

Generated just prior to a product purchase.

/event/notification/suspense

An abstract class to define event notifications for the suspense operation.

/event/notification/suspense/batch_delete

Generated when a suspended batch is purged. For more information, see "About Suspense Manager" in BRM Configuring Pipeline Rating and Discounting.

/event/notification/suspense/batch_resubmit

Generated when a suspended batch is submitted for recycling. For more information, see "About Suspense Manager" in BRM Configuring Pipeline Rating and Discounting.

/event/notification/suspense/batch_writeoff

Generated when a suspended batch is written off. For more information, see "About Suspense Manager" in BRM Configuring Pipeline Rating and Discounting.

/event/notification/suspense/delete

Generated when a suspense record is deleted. For more information, see "About Suspense Manager" in BRM Configuring Pipeline Rating and Discounting.

/event/notification/suspense/edit

Generated when a suspense record is modified. For more information, see "About Suspense Manager" in BRM Configuring Pipeline Rating and Discounting.

/event/notification/suspense/recycle

Generated when a suspense record is recycled. For more information, see "About Suspense Manager" in BRM Configuring Pipeline Rating and Discounting.

/event/notification/suspense/writeoff

Generated when a suspense record is written off. For more information, see "About Suspense Manager" in BRM Configuring Pipeline Rating and Discounting.

/event/notification/svc_order

An abstract class to define event notifications for operations on the service order object.

/event/notification/svc_order/state

Generated after a service order is successfully changed to a new state.

/event/notification/svc_order/state/in_transition

Generated just prior to a service order changing state.

/event/notification/threshold

Generated when an balance crosses above a threshold value or credit limit. For more information, see "Alerting Customers When Monitored Balances Cross Limits or Thresholds" in BRM Managing Accounts Receivable and "About Credit Limit and Threshold Checking during Batch Rating" in BRM Managing Customers.

/event/notification/threshold_below

Generated when a balance crosses below a threshold value or credit limit. For more information, see "Alerting Customers When Monitored Balances Cross Limits or Thresholds" in BRM Managing Accounts Receivable and "About Credit Limit and Threshold Checking during Batch Rating" in BRM Managing Customers.