14 Managing Customer Contracts

Learn how to manage your customers' contracts in Oracle Communications Billing and Revenue Management (BRM).

Topics in this document:

About Contracts

Note:

Contracts are supported only in BRM 12.0.0.3.0 with Interim Patch 31426340 and later releases, and PDC 12.0.0.3.0 with Interim Patch 31426374 and later releases.

A contract is a subscription with terms that your customers agree to when they purchase it. The terms define the commitment period and options for canceling and renewing the subscription. For example, a contract might have a 1-year commitment period, a $100 early termination fee, and an automatic renewal after 12 months. A contract's terms apply to all offers, services, and required bundles in the contract. Any optional bundles that are purchased are governed by their own, independent terms.

After your customers have purchased a contract, they can:

  • Modify the contract's auto-renewal options

  • Purchase any optional bundles that are associated with their contract

  • Cancel optional bundles in their contract, incurring any early termination fees for doing so

  • Cancel their contract before the end of the commitment period, if allowed by the contract's terms, incurring any early termination fees for doing so

When their contracts reach the end of the commitment period, the contracts are either canceled or automatically renewed when you run the pin_contracts utility. See "Canceling Expired Contracts" and "Processing Contract Auto-Renewals".

About Managing Customer Contracts

You manage your customers' contracts by using:

  • Billing Care. See "Subscriptions" in Billing Care Online Help.

  • A custom client application. To do so, customize your client to call the Contract FM standard opcodes. See "Managing Contracts" in BRM Opcode Guide.

About Canceling a Customer's Contract Early

Your customers can cancel their contract before the end of the commitment period, if it is allowed by the contract's terms. When contracts are canceled early, BRM cancels all bundles, offers, and services in the contract and automatically charges your customers any early termination fees.

Your customers can also cancel any optional, add-on bundles in their contract before the end of the commitment period, if it is allowed by the bundle's terms, while still retaining their contract.

Note:

Because required bundles are governed by the contract's terms, customers cannot cancel a required bundle and still keep their contract. If they cancel a required bundle, the entire contract is canceled.

For example, assume a customer's Online Learning contract includes the following:

  • A one-year commitment term with a $20 fee for canceling early

  • A required bundle for digital textbooks

  • An optional bundle for online tutoring with a one-year commitment term and no fee for canceling early

If the customer cancels the Online Learning contract or the digital textbook service early, they must pay the $20 fee and the entire contract is canceled, including the online tutoring service.

If the customer cancels only the online tutoring service early, they are not charged a fee and they keep their digital textbook service.

Processing Contract Auto-Renewals

You use the pin_contracts utility to process all contract auto-renewals in BRM. The utility searches the BRM database for all contracts that have auto-renewal enabled and that have reached the end of their commitment period, and then renews the contract to the new subscription term. See "About Subscription Terms" in PDC Creating Product Offerings.

When a contract's term is renewed, its start date is updated to the end date of the current contract and its end date is extended for the new commitment period specified in the terms. For example, when a 6-month contract with a January 1 start date and June 30 end date is renewed, the new 6-month contract has a start date of July 1 and an end date of December 31.

To process all auto-renewal contracts that expire today, run the following command:

pin_contracts -renew

For more information, see "pin_contracts".

You should run pin_contracts with the -renew parameter regularly to ensure that contract auto-renewals are processed in a timely manner.

Canceling Expired Contracts

You use the pin_contracts utility to cancel the following:

  • Non-renewable contracts that are at the end of their commitment period

  • Auto-renewal contracts that have already been renewed and are at the end of their second commitment period

When an expired contract is canceled, BRM cancels all bundles, offers, and services associated with the contract.

To cancel all non-renewable contracts that expire today, run the following command:

pin_contracts -expire 

To cancel all contracts that have already been auto-renewed and are at the end of their second commitment period, run the following command:

pin_contracts -expire-renewed 

For more information, see "pin_contracts".

You should run pin_contracts with the -expire and -expire-renewed parameters regularly to ensure that contracts are canceled in a timely manner.

Customizing Contract Management

You can customize how contract management does the following:
  • Validates contracts by using the PCM_OP_CONTRACT_POL_VALID_CONTRACT policy opcode.

  • Prepares a contract by using the PCM_OP_CONTRACT_POL_PREP_CONTRACT policy opcode.

  • Creates contracts by using the PCM_OP_CONTRACT_POL_POST_CREATE_CONTRACT policy opcode.

For more information see "Contract FM Policy Opcodes" in BRM Opcode Guide.