Setting Up and Managing Agreements and Warranties

This chapter lists common elements, provides overviews of agreements and warranties, agreement pricing, how agreements and entitlements are used in PeopleSoft Order Capture, and discusses how to:

Click to jump to parent topicUnderstanding Agreements and Warranties

This section lists common elements and discusses:

Click to jump to top of pageClick to jump to parent topicCommon Elements Used in This Chapter

Scope

Select the scope of the agreement. Values are:

Site: Indicates that the agreement applies to sites that are specified on the Scope Details page.

Note. For PeopleSoft Order Capture the system only allows Site as the scope for agreement templates when Available for Ordering is selected as an option.

Contact: Indicates that the agreement applies to named callers that are specified on the Scope Details page.

Note. Although agreements with a scope of Contact are not available for selection on service orders, you can select agreements of either Site or Contact as scope for cases.

If you create a case and associate it to an agreement (regardless of the scope) and then create a service order from that case, you must first select an agreement for the new service order; so the agreement from the case is not defaulted to the service order.

Max. Contacts (maximum contacts) or Maximum Number of Contacts

Enter the maximum number of named callers one can specify on the Scope Details page. This value is applicable to agreements with a scope of Contact.

Provider Group and Group Member

Select the default provider group and group member to perform the service request that is covered by this agreement. You can change these values on the service order.

Renew Agreement

Click to create a copy of the agreement that is about to expire. The CRM system sets the start date of the new agreement to the day after the end date of the old agreement and the new end date equal to the new start date plus the same number of days as the original agreement. You can establish new start and end dates for the renewed agreement and modify the information as necessary.

Payment Terms

Select when payment is due. Payment terms in PeopleSoft CRM are synchronized with the payment terms from PeopleSoft Financials.

Purchase Option

Select the method of purchasing the service or support offering for an agreement transaction. The prompt displays the purchase options (for agreement transactions) that are defined for the selected service, product or service-product combination in its pricing record on the Pricing Information page. The options for an agreement pricing record are:

Flat: Indicates that the service or support offering is purchased for a flat fee.

Prepaid: Indicates that a specified number of work units of the service or support offering is purchased in advance.

Note. The T&M (time and material) purchase option only applies to agreement service or agreement case transactions, and on demand service or on demand case transactions; it is not applicable to agreement transactions.

Click to jump to parent topicAgreements and Warranties

In PeopleSoft CRM, agreements reflect service or support contracts. Warranties define the coverage that is offered for a particular item that is installed at a customer's site. Both warranties and agreements define the services or support that the customer is entitled to and the duration of the contract.

When searching for a customer's entitlements for a case or a service order that references an installed product, the CRM system matches agreements and warranties based on response time — either ascending or descending depending on setup option in Agreement Search Configuration page.

This diagram shows the data model for agreements and shows the relationship between agreements and warranties:

Agreement data model

See Also

Performing Entitlement Searches for Cases and Service Orders

Click to jump to parent topicDefault Agreements

PeopleSoft CRM enables you to create two types of default service level agreements:

Click to jump to parent topicUnderstanding Agreement Pricing

This section discusses:

Note. You can use PeopleSoft CRM to calculate agreement prices. In PeopleSoft Support, agents can accept payment by credit card at the time of the transaction regardless of whether an agreement is associated with the support case.

Click to jump to top of pageClick to jump to parent topicPricing Record Retrieval

The CRM system can retrieve five types of pricing records for the agreement line: agreement, agreement service, agreement case, on demand service, and on demand case.

Agreement pricing records define the fee that is paid for a specific service or support offering. The agreement price is paid when the agreement is issued to or signed by the customer. Agreement service pricing records define what the customer pays when the work that is associated with the service or support offering on the agreement is performed—that is, the price paid per transaction that is covered by a line item in the agreement. Likewise, agreement case pricing defines the amount payable by the customer for logging a case.

The CRM system only retrieves pricing records that are defined for the currency that is specified when you define the agreement. You cannot change the currency unless you clear the defined line pricing values.

For field service agreements, you define pricing records for a service or a service and product combination. When you create a line for a field service agreement, you can retrieve the price for the agreement. When you specify a prepaid purchase option, you must specify the prepaid quantity. The rate on the agreement pricing record that matches the criteria that you enter is used to calculate the base line price for the agreement line.

The rate for the agreement service pricing record that matches your criteria becomes the transaction price for work that is covered by the agreement line.

For support agreements, the functionality is similar. You can create agreement pricing and agreement case pricing records that define support rates for specific products. When you create a support agreement, the same logic (used in field service agreements) is also used in support agreement to retrieve base line price.

See Also

Defining Pricing Information for Services and Support Offerings

Click to jump to top of pageClick to jump to parent topicLine Price Calculations

This section describes line pricing calculations in detail.

Entitlement Adjustment

The CRM system adjusts the base line price or prepaid rate that is retrieved from the pricing record to account for uplifts and discounts that are associated with the entitlements on the agreement line. The uplift and discount percentage values are totaled and applied to the base line price using this formula:

Entitlement Adjusted Base Line Price = Base Line Price x (1 + (sum of entitlement discount and uplift percentage values))

For example, the CRM system returns a base line price of 100 USD for an agreement line with three entitlements. The first entitlement has an uplift of 10 percent, the second an uplift of 15 percent, and the third a discount of 5 percent. The entitlement-adjusted base line price is calculated as:

Entitlement Adjusted Base Line Price = 100 USD x (1 + (0.1 + 0.15 - 0.05)) = 100 USD x 1.2 = 120 USD

Installed Product Quantity

When the agreement purchase option is flat, the entitlement-adjusted price on the agreement line applies to each installed product that is covered by the agreement line. The applicable installed products are listed on the Agreement Line page. To determine the installed product quantity, the CRM system adds the values in the quantity field of each referenced installed product.

Flat Purchase Pricing Calculation

To calculate the final line price on an agreement line that uses a flat purchase option, PeopleSoft CRM:

  1. Calculates the base line price by adjusting the rate on the agreement pricing record for the number of installed products and agreement duration.

    For example, if the pricing record rate is $20 per year per installed product, the agreement line duration is two years, and there are three installed products, the base line price is $20 x 2 x 3 = $120.

  2. Adjusts the base price for entitlement adjustments.

  3. Applies any manual adjustments.

    Manual adjustments are either expressed as a percentage or as a dollar amount.

This formula is used:

Final Line Price (for flat rates) = Base Line Price x Entitlement Adjustment + Manual dollar amount adjustment or x Manual percentage adjustment

Prepaid Purchase Pricing Calculation

To calculate the final line price on an agreement line that uses a prepaid purchase option, the CRM system calculates the entitlement adjustment for the line and applies it to the base line price. The prepaid rate does not vary with the duration of the agreement, so there is no need to adjust the base line price to account for agreement duration. The final line price is calculated as:

Final Line Price (for prepaid rates) = Prepaid Rate x Prepaid Quantity x Entitlement Adjustment

Any manual adjustments that exist for the line are also applied to the final line price.

Click to jump to top of pageClick to jump to parent topicTotal Price Calculations

The total price is calculated by adding the final line prices on the associated agreement lines. Additionally, a final uplift or discount percentages can be applied to the base price of the agreement. For example, if the CRM system calculates a base price of 2,000 USD for the agreement and you have entered a discount of 10 percent, the CRM system calculates a total price of 1,800 USD for the agreement.

Click to jump to top of pageClick to jump to parent topicPrice Recalculations

If you modify the entitlements on an agreement line, change the installed product quantity for an agreement line, or update the start and end dates of the agreement line after agreement line pricing has been calculated, the change you made is not automatically reflected in the final line price, though edit messages issued when the user saves a changed agreement will prompt the user to have the system update the price or leave the price unchanged.

In other words, if the values of the variables (for example, entitlement adjustment and agreement duration) that are used to calculate the current final line prices do not match the ones that are captured for the new calculation, the price of the agreement is no longer accurate. You can then recalculate the final price for the agreement lines as needed and update the total agreement price for the agreement.

Click to jump to top of pageClick to jump to parent topicUncoupling Service Pricing from an Agreement

PeopleSoft CRM enables you to uncouple service pricing from an agreement for PeopleSoft Support and PeopleSoft Integrated FieldService. This enables you to define prepaid agreement with zero pricing, without having to set up service pricing first.

In addition to the External and Internal agreement categories, there is an agreement category called External – No Pricing. This category enables you to set up prepaid agreements without pricing. To create a flat zero dollar agreement, you can use either the External or External – No Pricing agreement category.

PeopleSoft CRM, however, recommends using the External – No Pricing agreement category, as the system bypasses the pricing logic and does not display a pricing warning message. This enables you to create an unlimited number of cases or service orders. To create a prepaid agreement with no pricing, use the External – No Pricing category. The system hides the Order Capture Created check box in the agreement header, but you can still define prepaid purchase options.

By having the Prepaid Quantity field on the agreement header level, it enables you to have a pool of prepaid quantities per agreement across agreement lines. The system displays the prepaid fields only when the category is External – No Pricing.

Once a prepaid agreement is active and used on a case or service order, changing the prepaid quantity will not do anything. The system sets the Prepaid section to read only after the agreement has been used by the case or service order, when the remaining quantity is less than the prepaid quantity. When the agreement is renewed, the system uses the same prepaid quantity, remaining quantity, and prepaid total as the old line.

The Product grid displays the prepaid purchase option defined for each product. The prepaid option at the agreement header level and the Product grid level cannot coexist, however. You need to either define the total pool of prepaid purchase options for the whole agreement or the prepaid purchase options per product.

In addition, you can define the prepaid option on the line level for service-related agreements. For service-related agreements, the prepaid option can only be specified on the agreement header, line level, or product level. For support-related agreements, you can only specify the prepaid option on the agreement header or the product level. The prepaid option on the line level doesn’t apply to support-related agreements, it only applies to service-related agreements.

Click to jump to parent topicUnderstanding Ordering and Service Management of Agreements

PeopleSoft Order Capture and Order Capture Self Service support the ordering of service agreements. Like any standard product or package, a service agreement can be added directly to an order by a customer service representative (CSR). Or, it can be added as a cross-sell or up-sell opportunity of an existing product in the order—a way to boost company sales.

Cross-sell of Agreements in Orders

The CRM product model provides the framework for establishing relationships between products and service agreements, which is the an important step for setting up cross-sell or up-sell offerings. You can associate a service agreement with one or more products using the Product Relationships component. When one of these products is added to an order, its associated service agreement appears on the order as well as a cross-sell or up-sell opportunity.

This screenshot shows an order of a phone product (Nokia 3360), and this phone product is associated with a service agreement (PHONEREPLACEMENTPLAN) as displayed on the Cross/Up Sell Opportunities section:

PeopleSoft provides the ability to associate a product with a service agreement, associate multiple products with the same service agreement, and drive the up-sell offering of agreements when purchasing other products.

Note. If an agreement template is set to be available for ordering, a corresponding product definition will be created automatically for ordering purposes when the template is saved.

For agreement templates that are available for ordering, or if the integration to PeopleSoft Contracts is enabled in your system, you can only specify one product and one service in each agreement template line. If an agreement template contains multiple lines with services that are applicable to the same product (for example, phone line repair service and phone line maintenance service for product ID 12000, and you order the service agreement product that was created for that agreement template, you're purchasing all services that are available to the product in the template.

Pricing of Agreements in Orders

Pricing of a service agreement product is dynamic in that it depends upon which products are being covered on the order by the agreement. A CSR can add additional customer-purchased products to be covered by the agreement product by referencing the customer's installed products to the agreement product order line. This functionality is not extended to self-service users.

Note. The Order Capture applications limit the purchase of one agreement per standard product ordered. For example, if a customer orders a computer and the computer is covered by two agreements on the order, the computer can only be covered by one or the other agreement, but not both.

Calculation of Agreement Duration in Orders

When a service agreement is added to an order, the system computes its duration automatically and it is not available for edit. Based on the choice that the CSR makes to whether create a new agreement (leave the NEXT value in the Agreement Code field) or use an existing agreement (specify an agreement ID in the Agreement Code field) in the order line for service agreement, the start and end dates are calculated differently:

Agreement Entitlements

After an order has been submitted and the corresponding business process or business project completed, a new agreement is created for the service agreement product. This new agreement inherits several default values from the agreement template that is associated with the service agreement product, such as duration and entitlements.

This screenshot shows an agreement that is created after the completion of the business project, which was triggered upon order submission:

For agreement templates that are available for ordering, the default entitlement set (specified on the Line Defaults page) is used in all template lines and is not modifiable at the line level. For templates that are not orderable, entitlements can be updated on a line-by-line basis if necessary. The same is true for agreements. For those that are generated based on orderable agreement templates, the same set of entitlement is used as the default in each agreement for its lines. Whereas in agreements that are based on non-orderable templates, entitlements can be modified at the agreement line level.

Service Management of Agreements

One of the tasks of the business process or business project that runs after the submission of an order is to create a new installed product for the service agreement being purchased. The installed product (of typeAgreement) can be used to perform any agreement-related service requests, including renewing, cancelling, suspending and resuming agreements, using the Service Management component.

This screenshot shows an installed agreement that is created after the completion of the business project, which was triggered upon order submission:

This screenshot shows a service management order that is created for an installed agreement:

Supported actions include suspend, suspend/resume, cancel and renew.

See Understanding Installed Products, Understanding Service Management.

Click to jump to parent topicDefining Service Levels

This section provides an overview of service levels and service level suspensions and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Service Levels

You can define the hours of operation or prime period of maintenance for the services that your organization offers. For example, you may provide some services only during a 40-hour work week, whereas other services may be provided 24 hours a day.

You can define entitlements for specific service levels, which can then be included on a customer's agreement. When an agreement line with service level entitlements is selected for a case or service order, the system displays the calculated response and restore time.

Note. In general, you can define service levels for each time zone that is covered by your organization. PeopleSoft, however, strongly recommends that you not reset the base time zone in PeopleTools after your system is running and your applications are in production. Resetting the base time zone can cause time reports to be incorrect.

If you reset the base time zone (go to PeopleTools, Utilities, Administration, PeopleTools Options), your users will need to recreate all time-frame related data and update each record to reset the correct time frame for the new base time zone. Users can change the time zone for a particular agreement if they want to display time differently. If users continuously change time zones, however, the system will lose track of what the base time zone is at the time the record is saved (since all time-zone related fields on PeopleTools are stored against the base time zone).

Click to jump to top of pageClick to jump to parent topicPages Used to Define Service Levels

Page Name

Definition Name

Navigation

Usage

Service Level

RF_SERVICE_LEVEL

Set Up CRM, Common Definitions, Entitlements, Service Level, Service Level

Define the authorized hours of operations or prime period of maintenance. These service levels are informational only.

Cost Category Definition

RF_SLVL_COSTCAT

Set Up CRM, Common Definitions, Entitlements, Service Level, Cost Category Definition

Create additional cost categories for the service level.

Click to jump to top of pageClick to jump to parent topicDefining Service Levels

To define service levels, use the Service Level (RF_SERVICE_LEVEL) component.

Access the Service Level page (Set Up CRM, Common Definitions, Entitlements, Service Level, Service Level).

Service Level

Displays the name of the service level that you entered when the service level record was created.

Description and Short Description

Enter a long and short description. Because these descriptions are displayed in entitlements in which the service level is referenced, enter a meaningful service level description.

Time Zone

Select the appropriate time zone for the authorized hours of operations that you define for the service level. The CRM system populates the time zone code that you select next to the time values that you enter in the Defaults and Service Level Details group boxes. After you save the service level record, the time zone for the service level cannot be changed.

Cost Category Code

Select the cost category code that should apply for work performed during the days and times specified on this page.

Holiday Schedule

Select the holiday schedule that you want to apply to the service level. The system takes holidays into account when calculating required start and end dates for scheduled work.

By default, the system places the holiday schedule after the Entitlement grid on the Agreement Line page. Users can override it or clear it out. For platinum customers you can override holiday schedules by clearing them out on agreement lines.

The holiday schedule is based on specific dates, so each year you need to modify your existing holiday schedules with new dates or create new ones to re-prompt from the service level and agreement lines. PeopleSoft CRM recommends that administrator update existing dates, especially when re-prompts may affect a large number of agreement lines.

Defaults

Enter the begin and end times for the weekdays and weekend days that you want the system to use for the service level. When you click the Apply Defaults button, the system enters the hours in the appropriate fields displayed in the Service Level Details group box.

Service Level Details

This group box displays the begin and end times for the days of the week associated with the service level. You may change the hours displayed in the fields or clear them all by clicking the Clear button.

Click to jump to top of pageClick to jump to parent topicCreate Additional Cost Categories for the Service Level

Access the Cost Category Definition page (Set Up CRM, Common Definitions, Entitlements, Service Level, Cost Category Definition).

If you charge different rates for the hours and days worked that were not defined on the Service Level page, use the fields on this page to define additional days, hours and cost categories.

For example, if you charge time-and-a-half for work performed on Saturday, select Saturday from the Day of the Week field, enter the hours in the Start Time and End Time fields, and then the select HALF as the cost category.

Click to jump to parent topicDefining Entitlements

This section provides an overview of entitlements and discusses how to define entitlements.

Click to jump to top of pageClick to jump to parent topicUnderstanding Entitlements

You define an entitlement record for every response time, restore time, coverage type, or service level that your company intends to offer on customer agreements or warranties. By using the Agreement component, you select the entitlement records that describe what the customer is contractually owed for the service or support offering on each line of the customer's agreement.

Similarly, when defining warranties with the Warranty component, you select the entitlements that are contractually owed to customers who have an installed product that is covered by a valid warranty.

Each entitlement record can specify an uplift or discount to adjust the base price of agreement lines that include the entitlement. When the CRM system calculates the final line price of the agreement line, it adjusts the base line price to reflect the sum of the uplift and discount values that are associated with the entitlements on the line.

Click to jump to top of pageClick to jump to parent topicPage Used to Define Entitlements

Page Name

Definition Name

Navigation

Usage

Entitlements

RF_ENTITLEMENTS

Set Up CRM, Common Definitions, Entitlements, Entitlements, Entitlements

Define entitlements that can be offered on agreements and warranties.

Click to jump to top of pageClick to jump to parent topicDefining Entitlements

To define entitlements, use the Entitlements (RF_ENTITLEMENTS) component.

Access the Entitlements page (Set Up CRM, Common Definitions, Entitlements, Entitlements, Entitlements).

Description

Enter a description. You can use up to 30 alphanumeric characters.

Important! Entitlement descriptions are displayed at the time of service order and case entry. Enter descriptions that are meaningful to the person who enters the service order or case. Typically, the entitlement description describes the response time, restore time, coverage, or service level that is contractually owed to the customer per the specified agreement line or warranty. For example, you may want to include the time zone of a service level in its description.

Uplift/Discount

Enter the percentage of uplift or discount to add to the price of agreement lines that include this entitlement. Enter discounts with a minus sign that precedes the amount; enter uplifts without a minus or plus sign.

Entitlement Type

Specify the category of entitlement that is defined by the entitlement code together with the entitlement details that are associated with the selected category.

Guaranteed Response and Minutes

Select to entitle the customer to a response within the specified number of minutes. PeopleSoft Integrated FieldService uses the guaranteed response time to calculate the start date and time for service orders, if the automatic calculation feature is enabled at the business unit level. If the feature is disabled, agents can manually determine the customer preferred start date and time for service orders based on this information.

Call center cases also display and use the guaranteed response time from an associated agreement line entitlement.

Guaranteed Restore and Minutes

Select to entitle the customer to restored functionality of the product within the specified number of minutes. PeopleSoft Integrated FieldService uses the guaranteed restore time to calculate the committed end date and time for service orders, if the automatic calculation feature is enabled at the business unit level. If the feature is disabled, agents can manually determine the customer preferred end date and time for service orders based on this information.

The service order can have several types of begin and end times. The guaranteed restore entitlement is used to calculate the committed end date and time. Other end times include customer preferred, which are optional fields that are manually entered if the customer has a preferred date and time for service, such as a weekend. There are also planned end dates and times, which refer to the expected completion of each activity within a service order that are based on service begin type and activity duration.

Call center cases also display and use the guaranteed restore time from an associated agreement line entitlement.

Service Level

Select to entitle the customer to a specific service level or prime period of maintenance. Service levels are established on the Service Level page. PeopleSoft Integrated FieldService uses the service level that is specified in the entitlement to calculate the start and end dates and times for service orders, if the automatic calculation feature is enabled at the business unit level.

Service levels from an associated agreement line entitlement (in conjunction with guaranteed response or restore minute entitlements) are also used to calculate specific response and restore times for a call center case.

Guaranteed Coverage

Select to entitle the customer to a percentage of a specific type of coverage for a specific amount of time. When defining an entitlement for guaranteed coverage, select a coverage type, define the percent covered, and specify a time frame by entering a numeric value in the Length field and defining an appropriate unit, either Day, Week, Month, or Year.

Coverage Type

Select a coverage type if you select Guaranteed Coverage as the entitlement type. Values are:

Expenses: The portion (specified in the Percent Covered field) of any expenses that are associated with completing the customer's service order that is not charged to the customer.

Material: The portion (specified in the Percent Covered field) of the cost of any materials that are required to complete the customer's service order that is not charged to the customer.

Time: The portion (specified in the Percent Covered field) of the cost of any labor required to complete the customer's service order or case that is not charged to the customer.

See Also

Defining Service Levels

Setting Up Automatic Calculation of Dates and Times for Service Orders

Click to jump to parent topicDefining Entitlement Plans

This section provides an overview of entitlement plans and discusses how to define entitlement plans.

Click to jump to top of pageClick to jump to parent topicUnderstanding Entitlement Plans

Use entitlement plans as default values on agreements or warranties. You can reference a relevant entitlement plan to quickly populate an agreement or warranty with the entitlements that are associated with the plan. You can then delete or add other entitlements as necessary.

Click to jump to top of pageClick to jump to parent topicPage Used to Define Entitlement Plans

Page Name

Definition Name

Navigation

Usage

Entitlement Plan Setup

RF_ENTITLE_PLAN

Set Up CRM, Common Definitions, Entitlements, Entitlement Plan, Entitlement Plan Setup

Define groups of entitlements that can be referenced and populated quickly on agreements and warranties.

Click to jump to top of pageClick to jump to parent topicDefining Entitlement Plans

To define entitlement plans, use the Entitlement Plan Setup (RF_ENTITLE_PLAN) component.

Access the Entitlement Plan Setup page (Set Up CRM, Common Definitions, Entitlements, Entitlement Plan, Entitlement Plan Setup).

You can create new or update existing entitlement plans by adding or removing entitlement entries from the plan. When you reference an entitlement plan on an agreement, the system automatically populates the plan's associated entitlement entries to the agreement.

The system, however, does not retroactively update individual entitlements on existing agreement lines or warranties when the corresponding entitlement plan used to create those entries is updated.

For example, if an agreement line was created with an entitlement plan which originally had a response entitlement of A and a restore entitlement of B, and that plan is subsequently changed to refer to a restore entitlement of C rather than B, the existing agreement line will still have the original two entitlement values.

Entitlement Plans are only used to default individual entitlements onto other new objects, such as agreement lines or warranties. These individual entitlements may then be modified by the user at any time, and are no longer determined or reset by any changes to the corresponding entitlement plan.

Note. An entitlement plan must have at least one entitlement associated with it.

See Also

Defining Entitlements

Click to jump to parent topicConfiguring the CRM System for Agreement Searches

This section provides an overview on agreement searches and discusses how to configure agreement searches.

Click to jump to top of pageClick to jump to parent topicUnderstanding Agreement Searches

The Agreement Search Configuration page enables you to configure how the agreement search should function for PeopleSoft Support cases (external case agreement search), PeopleSoft HelpDesk cases (internal case agreement search) and PeopleSoft Integrated FieldService service orders (service order agreement search).

For external and internal agreements, there are separate group boxes for cases and service orders that enable you to instruct the system on how to search for agreements using these options:

If you select Match Using Case Criteria for external agreements (PeopleSoft Support), the system enables you to select case category, case priority, case source, case type, and customer value as the values for the Category field.

If you select Match Using Case Criteria for internal agreements (PeopleSoft HelpDesk), the system enables you to select department, location, priority, role, and source (inbound contact method) as the values for the Category field.

If you do not select the Match Using Case Criteria check box, the system performs the matching based on the radio button you selected. This means that if any agreement lines exist that specify values (criteria), the agreement matching engine ignores those values when selecting matches.

If you select the Match Using Case Criteria check box, the pool of agreement line matches will include any matches based on the criteria in the case and the corresponding criteria on the agreement lines. If two or more lines tie for the shortest or longest response, the system displays all agreement lines to the user.

To be considered a match, the criteria from a case may match any of the criteria conditions listed on the agreement line. For example, if an internal agreement line specifies that it is for high priority cases and the role is supervisor, the system matches the case with this line if the employee’s role is supervisor, regardless of whether the case priority is high or not.

If a product is specified on the case, the system matches only agreement lines that have the product and at least one criteria. The system will also match default agreement lines that have no products that match on at least one criteria (if any criteria are present on the agreement line).

The system then filters the pool of agreement lines (and warranties) that are found under this option for presentation to the user according to the radio button option that was selected on the Agreement Search Configuration page.

Note. Because PeopleSoft CRM no longer bases search results on the category weight factor, customers upgrading from a previous release may find that the agreement searching functionality for PeopleSoft HelpDesk may produce slightly different results. Also, now that the system sorts the total list of warranty and agreement line matches by response time, warranty matches do not always appear first in the list of results.

You can use a variety of agreements and agreement line values to set up your PeopleSoft CRM system. These tables summarize the main options that are available:

External Agreement Line Characteristics

Comments

  • No Product

  • No Service

  • No Installed Product

  • No Criteria

This default agreement line will always apply regardless of the product or installed product that is linked to the case or service order. This line cannot be priced. It is permitted only for the External - No Pricing agreement category.

  • Product = 123

  • No Service

  • No Installed Product

  • No Criteria

This agreement line applies to any case for product 123, regardless of the installed product value on the case.

  • Service = ABC

  • No Product

  • No Installed Product

  • No Criteria

This agreement line applies to any service order, assuming that a service has not been selected on the service order. If a service has already been selected on the service order, this agreement line will only be a match if the service is the same in both places.

Note. The Service ID from a service order will be included as part of the matching criteria when selecting entitlements from the service order.

  • Product = 123

  • Installed

  • Products = 456, 789

  • No Service

  • No Criteria

This agreement line applies to any case with matching product and installed product values.

  • Product = 123

  • No Service

  • No Installed Product

  • Priority = Medium

  • Customer Value = Silver

This agreement line applies to any case for the product (regardless of the installed product) where the case priority is medium or the customer value is silver.

  • Product = 123

  • No Service

  • Installed Products = 456, 789

  • Priority = High

  • Customer Value = Gold

This agreement line applies to any case that is linked to product 123 and installed product 456 or 789, where the case priority is high or the customer value is gold.

  • No Product

  • No Installed Product

  • No Service

  • Priority = High

This agreement line applies, regardless of whether the product or the installed product is linked to the case, as long as the case priority is high. This line cannot be priced.

  • Product = 123

  • Service = Repair Widget

  • No Installed Product

  • No Criteria

This agreement line applies to any service order for product 123, regardless of the installed product, assuming that the service has not been selected on the service order, or has already been selected as Repair Widget.

  • Product = 123

  • Service = Repair Widget

  • Installed Product 456, 789

  • No Criteria

This agreement line applies to any service order for product 123 and installed product 456 or 789, assuming that the service has not been selected on the service order, or has already been selected as Repair Widget.

Note. Customer, PIN, Person, SIN and Site Matching also apply for customer-based agreements in addition to comments in the table above.

Internal Agreement Line Characteristics

Comments

  • No Product

  • No Installed Asset

  • No Criteria

This default agreement line applies, regardless of the product or installed asset that is linked to the case.

  • Product = 123

  • No Installed Asset

  • No Criteria

This agreement line applies to any case for the product, regardless of the installed asset value on the case.

  • Product = 123

  • Installed Assets = 456, 789

  • No Criteria

This agreement line applies to any case that matches the product and installed asset values.

  • Product = 123

  • No Installed Asset

  • Priority = Medium

  • Source = Phone

This agreement line applies to any case that is linked to the product (regardless of installed asset), where the case priority is medium or the source is phone.

  • Product = 123

  • Installed Assets = 456, 789

  • Priority = High

  • Department = HR

This agreement line applies to any case that is linked to product 123 and installed asset 456 or 789, where the case priority is high or the department is HR.

  • No Product

  • No Installed Asset

  • Priority = High

This agreement line applies, regardless of the product or installed product that is linked to the case, as long as the case priority is high.

Click to jump to top of pageClick to jump to parent topicPage Used to Configure Agreement Searches

Page Name

Definition Name

Navigation

Usage

Agreement Search Configuration

RF_AG_SRCH_CFG

Set Up CRM, Common Definitions, Agreement Search Configuration, Agreement Search Configuration

Define how the system will search for agreements.

Click to jump to top of pageClick to jump to parent topicConfiguring Agreement Searches

Access the Agreement Search Configuration page (Set Up CRM, Common Definitions, Agreement Search Configuration, Agreement Search Configuration).

Note. The group boxes that appear on this page are dependent on which PeopleSoft applications you have installed. For example, the External Case Agreement Search group box appears only if you have PeopleSoft Support installed. The Internal Case Agreement Search group box appears only if you have PeopleSoft HelpDesk installed. The Service Order Agreement Search group box appears only if you have PeopleSoft Integrated FieldService installed.

External Case Agreement Search

Select one of the options listed to indicate how you want the system to search for agreements when a user selects the Select Agreement or Warranty link on the Case page in PeopleSoft Support.

The values include:

Note. If you select either the Autoselect Shortest Response or Autoselect Longest Response agreement search option for cases (or service orders), and an AAF policy is defined and enabled in the CRM system to return a list of applicable agreements when products are selected on that type of cases (or service orders) for the same setID, the agreement search option takes precedence over what is defined in the corresponding AAF policy. In this example, the system returns the agreement with either the shortest or longest response time when a product is selected in an opened case (service order).

Match Using Case Criteria and Category

If you do not select the Match Using Case Criteria check box, the system performs the agreement search based on the radio button that you select.

If you select the Match Using Case Criteria check box, the system includes agreement lines that match the criteria that you select in the Category field and the radio button that you select.

For example, if case priority and customer value are listed on the Agreement Search Configuration page, and the agreement line specifies it is for high priority cases, or cases whose customer value is platinum, the system still matches a high priority case to this agreement line regardless of customer value. The case criteria on an agreement line don't all have to match the values on a case to be considered a match. It is sufficient for just one criteria to match.

If a product is specified on the case, the system matches only agreement lines that match the product and at least one criteria.

The system matches agreement lines to the case for default agreement lines that have no products but match on at least one criteria, if any criteria are present on the agreement line.

Internal Case Agreement Search

Select one of the options listed to indicate how you want the system to search for agreements when a user selects the Select Agreement or Warranty link from the Case page in PeopleSoft HelpDesk.

The system returns all applicable default lines even when there is another match based on product or installed product. PeopleSoft designed the system to do this to give agents the option of selecting an agreement based on a completely different set of criteria.

For example, if you have one agreement line that covers a pocket PC and another default line to cover the role of CEO that does not have a product specified but has a better response time, the system displays both lines. This gives the agent the ability to select either line.

If you select the Match Using Case Criteria check box, you must select one or more categories that you want the system to use in its search. Refer to the previous section for a fuller explanation on using the Match Using Case Criteria and Category fields.

Service Order Agreement Search

Select one of the options listed to indicate how you want the system to search for agreements when a user selects the Select Agreement or Warranty link from the Service Order page in PeopleSoft Integrated FieldService.

Click to jump to parent topicDefining Agreement Templates

To define agreement templates, use the Agreement Template (RF_AGREETEMP) component.

This section provides an overview of agreement templates and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Agreement Templates

You can define model agreements for specific types of customers, products, or services. When you define an agreement for a specific customer by using the Agreement component, you can reference an agreement template to populate the basic agreement information and then make modifications as necessary.

Note. You can create templates with specific values for certain agreement criteria. However, if you create more than one agreement from the same template, you should change at least some of the criteria that you copied from the template; otherwise, you would have two identical agreements in your system.

Click to jump to top of pageClick to jump to parent topicPages Used to Define Agreement Templates

Page Name

Definition Name

Navigation

Usage

Agreement Template

RF_AGREETEMP_HDR

Customer Contracts CRM, Agreements, Agreement Templates, Agreement Template

Define basic header and billing information for agreement templates.

Line Defaults

RF_AGREETEMP_ENTL

Customer Contracts CRM, Agreements, Agreement Templates, Line Defaults

Define a set of entitlements to use as default values for the entries that are added on the Template Line page.

Template Line

RF_AGREETEMP_LINE

Customer Contracts CRM, Agreements, Agreement Templates, Template Line

Define default agreement lines.

Related Products

RF_AGREETEMP_PROD

Customer Contracts CRM, Agreements, Agreement Templates, Related Products

View and access linked product definitions.

Note. The Related Products page appears only if the template is being used with PeopleSoft Order Capture

Click to jump to top of pageClick to jump to parent topicDefining Basic Header and Billing Information for Agreement Templates

Access the Agreement Template page (Customer Contracts CRM, Agreements, Agreement Templates, Agreement Template).

Agreement Category

This field is required on the Add page when you are adding a new agreement. For agreements used in PeopleSoft HelpDesk, you must select Internal as the agreement category.

For agreements used in PeopleSoft Support and PeopleSoft Integrated FieldService, select External or External - No Pricing as the agreement category.

Note. If you select External - No Pricing as the agreement category, the system only displays the Status Information and Coverage sections.

Internal Agreement Type

This group box appears only if you select the Internal agreement type. Select one or both of the HR Help Desk or IT Help Desk check boxes to designate the types of cases to which the agreement applies.

Status Information

Use the fields appearing in this group box to select the scope and status for the agreement template you are defining.

Note. If you are defining an agreement template for PeopleSoft HelpDesk and you selected Internal as the agreement category, only the Status field appears on this page.

Scope

Select either Site or Contact to indicate the scope of the agreement template. If you select Contact, enter the number of contacts in the Maximum Contacts field.

Note. When Available for Ordering is selected as an option in the Order Capture group box, the system only allows Site as the scope for agreement templates. This is because PeopleSoft Integrated FieldService only uses Site as the scope for this type of agreement for service orders. PeopleSoft call center applications can use either Contact or Site as the scope.

Status

Select the status of the agreement: Pending, Active, or Closed. There are no system processes that change the status value of the agreement template, but you can manually change the status as necessary. You can only use templates with a status of Active to create a new agreement.

Coverage

Select the provider group and provider group member that you want the system to use for the agreement template.

Billing Information

Select the payment terms and payment method that you want the system to use for billing for agreements using the agreement template.

Order Capture Information

Available for Ordering

Select to indicate if the agreement template may be sold through PeopleSoft Order Capture. If this option is selected, the scope of the agreement template must be Site.

Duration

Enter the duration for the agreement template.

Since start and end dates cannot be added to the template and the start and end dates are one of the attributes used to price an agreement line, the system uses the Duration field to calculate start and end dates. As such, agreements created from the template will have their own start and end dates.

The system uses the current system date to set the agreement line start date (or the override start date on the order). The system adds the duration to the start date to calculate the end date.

Product and Product ID

Select Create New if you want the system to create a new product from the agreement template to represent that template. The system creates a new product ID value when you save the new template. The system sets the description of the product to the template ID. It also sets the service flag on the product to Y for Yes. This enables the agreement to be selected (referenced by product ID) on an Order Capture order.

Select Use Existing to select a product from the Product ID field.

Note. If autonumbering is turned off, the system returns an error message when you attempt to save the template.

See Also

Performing Entitlement Searches for Cases and Service Orders

Click to jump to top of pageClick to jump to parent topicDefining Default Entitlement Sets

Access the Entitlement Defaults page (Customer Contracts CRM, Agreements, Agreement Templates, Line Defaults).

Entitlement Plan Name

Select a default entitlement plan. Plans are established on the Entitlement Plan Setup page. The system displays the entitlements in the plan. You can add or delete entitlements to create a specific list for this template.

The PeopleSoft CRM system displays the information that is associated with each entitlement as defined on the Entitlements page.

Note. Setting up plans is optional. You can add individual entitlements directly to the grid. The individual entitlements listed on this page will be defaulted onto each new agreement template line entry that is created from that template.

See Also

Defining Entitlements

Defining Entitlement Plans

Click to jump to top of pageClick to jump to parent topicDefining Default Agreement Lines

Access the Template Line page (Customer Contracts CRM, Agreements, Agreement Templates, Template Line).

Agreement Line Details

Add rows for each new line.

Line Number

Displays the agreement line number. The CRM system automatically increments this number for each row that you add. The agreement line number and description appear on cases that are covered by the agreement line entitlements. Service orders only display the agreement name, not line number.

Service

Select the service that is covered by the agreement line. For Field Service agreements, select a service. Support agreements do not reference services. You define services by using the Service component.

The PeopleSoft CRM system prompt displays only services with an active status and for which the Agreement check box has been selected on the Service page.

Note. Since there is no start date on the Template Line page, the system validates that the agreement start date occurs between the offer start date and the offer end date defined for the service on the Agreement Line page, not the Template Line page.

Internal agreement templates also require you to designate the person type and person status. The system uses these to select the agreements that apply to the case. For example, if a contingent worker in active status opens an IT Help Desk case, only agreement lines that have a person type of Contingent Worker and a status of Active apply.

Service Pricing Details

Define the default criteria for retrieving pricing records for an agreement line.

Purchase Options

Select the purchase options that you want the system to use for the agreement template.

Prepaid Quantity

Enter the number of work units of a service or support offering that a customer pays for in advance. This value only applies to the Prepaid purchase option.

Product, Purchase Options and Prepaid Quantity

Select the product covered by the agreement line, the purchase option, and the prepaid quantity.

If you select a service, the CRM system prompt displays all the products that are defined for the service. If no service is selected, the system prompt displays all products that are defined in it.

Products are established with the Product enterprise integration point (EIP) or the Product Definition component.

Entitlements

Displays the entitlements that are contractually owed to the customer for this agreement line. This information is initially populated by using the Entitlement Defaults page. The user, however, can modify the entitlements for each line.

Note. If you select the Available to Order field on the Agreement Template page, the system hides the Add row and Delete row buttons on the Entitlements grid. The system copies the entitlement information from the Entitlement Defaults page to each new line. You cannot change these entitlements in the Entitlements grid. This is required to ensure that all template lines, regardless of the product ID entered for each template line will have the same set of entitlements.

This is important when performing a side-by-side comparison of products in the product catalog to determine which service agreement is the best fit for the product selected. Additionally, if you select the Available to Order field, the system defaults the Purchase Option field to FLAT and makes it read only, since flat fee is the only type of agreement fee PeopleSoft Order Capture uses for the purchase of agreements. Therefore, it is important to ensure that you have first created flat free prices for each service or product that you intend to use on an agreement template.

Entitlements Apply To

This group box appears only if you are defining an agreement template for PeopleSoft HelpDesk and you selected Internal as the agreement category. Also, the system displays a set of fields based on the options you selected on the Agreement Search Configuration page for the business unit you are using.

For example, if you selected the Match Using Case Criteria check box and then selected Role, Department, Priority, Source, and Location as categories that you wanted the system to use when searching for agreements, the system would display all of the fields.

Use the fields that appear in this group box to link the response and restore times to the different values for the various fields that can appear on the Case page. For example, if you set the priority for the agreement to low, and a user selects the Select Agreement link on a low priority case, the system displays the respond and restore times that you set up on the Entitlement Defaults page.

If you select User Selects From All Matches, Autoselect Shortest Response, or Autoselect Longest Response, on the Agreement Search Configuration page, the system does not display this group box.

See Also

Setting Up Products

Defining Services

Click to jump to top of pageClick to jump to parent topicViewing and Accessing Linked Product Definitions

Access the Related Products page (Customer Contracts CRM, Agreements, Agreement Templates, Related Products).

The Related Products page appears only if the template is being used with PeopleSoft Order Capture. The system uses the Related Products page to show all products that point to the template. The system does not display this page until you save the template and navigate to the page from one of the other pages in the Agreement Template component.

To access the Product Definition page, click the link under the Product ID field.

Note. If the Agreement Template is set to a closed status and there are active products in the Related Products tab, the system displays a warning message stating that there are active products associated with the Agreement Template and that inactivating the template may also inactivate the related products.

Click to jump to parent topicDefining Agreements

This section provides an overview of agreement definitions and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Agreement Definitions

When you create a case or service order for a customer and click the Select Agreement or Warranty button, the CRM system searches for agreement lines or warranties that cover the case or service order and displays the associated entitlements.

The CRM system uses the values that you have entered in the fields for product ID, serial number, and either site or SIN to search for agreement line and warranty matches for service orders.

For cases, the CRM system uses the same fields, as well as those for contact or PIN. For both cases and service orders, the entitlement match page also displays any transaction price information that is defined under the terms of the agreement.

Internal agreements define the levels of service that are available to Help Desk and HR Help Desk cases. These cases use the additional information of organizational relationship, as defined by the person type, and worker status to locate and display the levels of service that are defined on the agreement.

External - No Pricing agreements are similar to External agreements, except they do not display pricing-related fields, only prepaid amounts. Using External - No Pricing agreements enables you to specify how many free prepaid cases or services, or hours of support, a customer is entitled to on an agreement. For PeopleSoft Support, you can specify prepaid at the agreement header level or in the product grid on the agreement line. For FieldService, you can specify prepaid on the agreement header, agreement line for service, or on the product grid on the agreement line.

See Also

Understanding Agreement Pricing

Performing Entitlement Searches for Cases and Service Orders

Service Order Toolbar Functions

Click to jump to top of pageClick to jump to parent topicPages Used to Define Agreements

Page Name

Definition Name

Navigation

Usage

Agreement

RF_AGREEMENT_HDR

Customer Contracts CRM, Agreements, Agreements, Agreement

Define agreement header information.

Scope Details

RF_AGREEMENT_COV

Customer Contracts CRM, Agreements, Agreements, Scope Details

Specify people that are entitled to call center support or customer sites that are entitled to the service that is detailed by agreement lines.

Line Defaults

RF_AGREEMENT_ENTL

Customer Contracts CRM, Agreements, Agreements, Line Defaults

Specify the default values to appear on rows that are added on the Agreement Line page.

Agreement Line

RF_AGREEMENT_LINE

Customer Contracts CRM, Agreements, Agreements, Agreement Line

Define detailed agreement line information for each service or support offering.

Billing

RF_AGREEMENT_BILL

Customer Contracts CRM, Agreements, Agreements, Billing

Define agreement billing information.

Click to jump to top of pageClick to jump to parent topicDefining Agreement Header Information

Access the Agreement page (Customer Contracts CRM, Agreements, Agreements, Agreement).

Agreement Category

This field is required on the Add page when you are adding a new agreement. For agreements used in PeopleSoft HelpDesk, you must select Internal as the agreement category. For agreements used in PeopleSoft Support and PeopleSoft Integrated FieldService, select either External or External - No Pricing as the agreement category.

Note. In the top section of this page the system changes the field label to Category.

Copy From Agreement Template

When you create a new agreement, you can either add all the information to it manually, or base it on an agreement template.

Note. This group box does not appear if the agreement has already been created and saved.

Copy from Template and Template ID

Select a template and then click the Copy from Template button to populate the agreement with information that is established in the selected agreement template.

Note. Because the integration with PeopleSoft Contracts requires certain validations before a user can set the status of an agreement to Active, the system does not copy the value of the Status field from the agreement template to the new agreement. The system initially sets the status of the new agreement to Pending.

A user can change the status of the agreement to Active by taking certain actions; but they cannot create a new agreement with a status of Active by copying information from an agreement template.

Agreement Information

Renewal Number

Displays the renewal version of the agreement. When an agreement is first created, this value is set to 1. Each time you renew the agreement by clicking the Renew Agreement button, the CRM system increments this value by 1.

Scope and Maximum Contacts

Select either Site or Contact to indicate if the agreement applies to sites or callers (contacts). If you select Contact, enter the maximum number that would be allowed to call within the scope of the agreement.

Note. These fields do not appear on the page if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement.

Status

Select from Pending, Pending Activation, Action Required, Active, or Closed.

There are no system processes that change the status value of the agreement, but you can manually change the status. When an entitlement search is performed for a case or a service order, the CRM system includes only agreements with an Active status that are effective on the date that the search is performed.

Note. When renewing an agreement, you should manually adjust the status of the old agreement to Closed on the date that it expires and ensure that the status of the new agreement is set to Active.

For example, if you renew an agreement one week before it expires, the new agreement should have a status of Pending Activation, and the old agreement should retain its status of Active until the renewal date matches the current date. At that point the old agreement status should be set to Closed, and the new agreement status should be set to Active.

If you have an integration with PeopleSoft Transaction Billing Processor, the system makes the Pending Activation and Action Required statuses available. Additionally, if you are using this integration, the system changes the status from Pending Activation to Active or Action Required based on the success you have creating a corresponding entry in PeopleSoft Transaction Billing Processor.

Order Capture Created

If this check box is selected the agreement was created through PeopleSoft Order Capture.

Contract Details

Click this link to go the Contract Information page. Use this page to view contract information associated with the contracts business unit, general ledger business unit, and contract details. This applies only when integrating to the Contracts module in PeopleSoft Financials.

Internal Agreement Type

This section appears on the page for internal agreements only.

Customer Information

This section does not appear on the page if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement.

Customer

Click the Search button to select the name of the customer. Customers are established by using the Customer EIP, the Company component (select Customers CRM, Add Company) or the Consumer component (select Customers CRM, Add Person).

Contact

Click the Search button to select the name of the customer's agent. This is the person to contact about agreement administration issues, such as renewing and remitting payment for agreements.

You define contacts by using the Contact component or the Contacts page of the Company, Consumer, or Site component.

Contact Site

Select the customer site that is associated with the contact. You establish this relationship by using the Customers page of the Contact component.

Note. The prompt for this field shows only sites that are associated with the contact.

Prefix, Phone, and Extension

Enter the telephone information for the customer's contact. If you select a contact, the CRM system populates these fields with the primary telephone information of the person's role as a customer's contact. You can modify this information as needed.

Contact Information

These fields appear on the page only if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement.

The contact fields on the main Agreement page for internal agreements are functionally similar to the customer contact fields mentioned above for external agreements. They refer to the person to contact about the agreement administration issues.

Some users may mistakenly assume that the contact listed on the main page of an internal agreement represents the person or worker for whom the agreement was created, or who was covered by the agreement. This field is only used to represent the administrative contact for the internal agreement.

First Name, Last Name, Phone, Location and Search

Click the Search button to select the name of the contact. You define contacts by using the Workforce component (select Workforce, Create Worker).

Prefix, Phone, and Extension

Enter the telephone information for the contact. If you select a contact, the CRM system populates these fields with the primary telephone information of the contact. You can modify this information as needed.

Default Provider Group

Enter the default provider group and group member that get assigned to perform the services that are covered by this agreement. These default values apply to service orders only; they do not apply to cases.

Note. This group box does not appear on the page if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement.

See Also

Defining Agreement Templates

Performing Entitlement Searches for Cases and Service Orders

Defining Company Business Objects

Defining Consumer Information

Click to jump to top of pageClick to jump to parent topicSpecifying People or Sites That Are Entitled to Service or Support

Access the Scope Details page (Customer Contracts CRM, Agreements, Agreements, Scope Details).

This page varies depending on the scope that is specified on the Agreement page. For agreements with the contact scope, you enter the people who are eligible for support. These agreements are only available to PeopleSoft Support. For agreements with the site scope, you enter sites that are eligible for service. These agreements are available to both PeopleSoft Support and PeopleSoft Integrated FieldService.

Note. This page does not appear if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement.

Named Callers

This grid appears if the selected agreement has a scope of contact. Enter the people who are eligible to request support that is related to this agreement.

Primary

Select if this person is the primary caller.

Name

Enter the name of a person who is entitled to request support that is defined by the agreement lines. Named callers must first be established as contacts by using the Contact component or the Contacts page of the Company, Consumer, or Site component. The number of contacts that you specify cannot exceed the number of maximum contacts that are recorded on the Agreement page.

Note. For consumer agreements with scope as the contact, the CRM system populates the first row of the Named Callers grid with the name of the customer that is specified on the Agreement page. You can change this value or add additional rows.

PIN (personal identification number)

Displays a unique value that is generated by the CRM system for each caller when the agreement is saved. Customers calling to request support under the terms of the agreement provide their PIN to your customer service representative (CSR). The CRM system uses the PIN that the CSR enters on cases to identify the agreement that defines the customer's entitlements.

Note. The PIN is unique for every person within an agreement. If a person is a named caller on two agreements, this person is assigned two PINs.

Valid Sites

This grid appears if the selected agreement has site as the scope. Enter customer sites that are eligible to receive support or services specified on its agreement lines.

Site Name

Enter the name of the site that is covered by this agreement. The CRM system displays the site ID of the selected site automatically.

SIN (site identification number)

Displays a unique value that is generated by the CRM system for each site when the agreement is saved. Customers calling to request service under the terms of the agreement provide the SIN to your CSR. The CRM system uses the SIN that the CSR enters on cases or service orders to identify the agreement line that defines the customer's entitlements for a particular site.

Note. The SIN is unique for every site within an agreement. If a site is valid on two agreements, the site is assigned two SINs.

See Also

Defining Site Business Objects

Click to jump to top of pageClick to jump to parent topicSpecifying Line Defaults

Access the Default Entitlements page (Customer Contracts CRM, Agreements, Agreements, Line Defaults).

Note. If you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement, the system does not display the Coverage Type, Percent Covered, Coverage Duration and Uplift or Discount fields. The group boxes with the Person Type and Worker Status check boxes shown in the example above is only relevant for and displayed for internal agreements. It is not displayed for external or external-no pricing agreements

Default Entitlements

Entitlement Plan Name

Select a default entitlement plan to populate the grid initially. You define entitlement plans on the Entitlement Plan Setup page.

The list of entitlements in the grid becomes the default entitlement set for each new line that is added on the Agreement Line page.

Add or delete entitlements on each agreement line to define the final set of entitlements that is contractually owed to the customer. Each line in the grid is associated with the entitlement information that is defined on the Entitlements page.

Description

Click the Lookup Entitlement Name button to locate entitlements that you want to add to the Entitlements grid.

Note. Any changes that you make to the defaults do not affect any existing agreement lines.

Additional Selections for Internal Cases

Person Type

Select the person type. Available choices are Employee, Contingent Worker, and Person of Interest.

Note. Person of Interest does not appear for IT Help Desk cases.

Worker Status

Select the status of the worker.

See Also

Defining Entitlements

Defining Entitlement Plans

Click to jump to top of pageClick to jump to parent topicDefining Detailed Agreement Line Information

Access the Agreement Line page (Customer Contracts CRM, Agreements, Agreements, Agreement Line).

Note. If you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement, the system does not display the Sites and Price Information sub pages and links. If you selected External - No Pricing as the agreement category, the system does not display the Price Information sub page.

Agreement Line: View Line Summary

If an agreement has multiple agreement lines, they are listed in the Agreement Lines summary grid (available when you click the View Line Summary link) with basic information such as agreement line and service descriptions, product name, and product ID number. Click the agreement line number link to access the Agreement Line Details group box, where you can edit and view the corresponding line in detail.

If there is only one line in the agreement, the CRM system displays the Agreement Line Details group box together with pricing, site, entitlements, and product information.

When you click the Line Details link at the top of the page, the CRM system displays information for the selected agreement line in group boxes such as Retrieve Base Line Price, Calculate Final Line Price, Entitlements and so on. To minimize the need for scrolling, you can click the Sites, Entitlements, Installed Products, or Price Information links to view corresponding information selectively.

Agreement Line: Line Details - Agreement Line Details

Use this group box to add new lines to the agreement. Enter the status, start and end dates, description and service for the agreement service line. Click the Billing Information link to set up the billing schedule, purchase order, and payment terms information for the agreement line.

The Billing Information link only appears when the customer is integrating with the Contracts module in PeopleSoft Financials.

Note. For internal agreements (IT Help Desk and HR Help Desk), the Person Type and Worker Status fields also appear in this section.

Agreement Line: Line Details - Service Pricing

Use this group box to enter purchase option and transactional information for the agreement line service. Click the Price Definitions link to access the Service Pricing page.

Agreement Line: Line Details - Products

Use this section to define the products, purchase options, and prepaid quantity (if there is one). The system displays the prepaid rate, base line price, and base line price unit if it is stored in the system.

To view the transaction price for the product, click the Transaction Price tab. This section displays the transaction price on the corresponding agreement service pricing record. The price is based on the service or service-product combination that is defined for the agreement line.

The CRM system matches the value for the service and product fields on the agreement line with a unique pricing record that contains the same service and product values. In addition, this pricing record must contain the appropriate currency code for the agreement line. Never define more than one agreement service pricing record in the Pricing Information page for the same combination of service, product, and currency code, because this implies multiple prices for a single transaction.

You may associate a support-oriented agreement line with multiple products unless you have an integration to PeopleSoft Contracts. In this case you can only have one product per support-oriented agreement line (an agreement line with no Service). If you are not using the Contracts Integration feature, the save-edit check is disabled and you can enter multiple rows of data in the Product grid for the agreement line.

After defining the product and purchase option (prepaid options, if applicable), the other price related fields on this grid are populated when the user clicks the Calculate Final Price button.

When you perform an entitlement search from a case or a service order, the CRM system displays the transaction price or the remaining quantity that is defined on the customer's agreement.

Note. A credit card link on support cases is enabled when the associated agreement line includes a price per transaction and does not entitle the customer to 100 percent coverage of time, material, and expenses. Also, many of the fields related to pricing do not appear if you selected External - No Pricing as the agreement category.

Purchase Option

Displays the method of purchasing the service or support offering for an agreement or agreement service transaction.

Prepaid Rate, Prepaid Unit, Baseline Price and Baseline Price Unit

Displays the amount paid per unit of work or per unit of time, depending on the purchase option of the agreement.

Rates that are retrieved from an agreement service pricing record with a flat purchase option can be by the hour, case, or service order. Rates that are retrieved from an agreement service pricing record with a time and material purchase option can be per unit of time—hour, day, week, month, or year.

Transaction Purchase Option, Transaction Price Unit, Transaction Price, and Currency Code

Displays the transaction purchase option, the price per unit, the total transaction price and the currency.

The currency that is displayed for the rate reflects the currency that is entered on the Billing page of this component.

Remaining Quantity

Displays the amount of the prepaid quantity that has not been used. For field service agreements, the prepaid quantity is in units of service orders or hours.

For example, the CRM system reduces this quantity each time a user saves a new service order that is covered by the agreement line. If the service order is canceled, the CRM system readjusts the remaining quantity accordingly.

For support agreements, the prepaid quantity is in units of cases or hours. Workflow processes must be implemented to update remaining quantity on support agreements.

Agreement Line: Line Details - Valid Sites

Use this section to add any valid sites to the agreement line. The system displays the site ID and description.

Note. Every line of a site-based agreement must be linked to at least one site.

Agreement Line : Line Details - Products Under Service

Use this section to add or delete any installed products that are covered by the agreement line. The system displays the description, serial number, asset tag (if there is one), quantity, and site where the product is installed.

Use the Add Installed Product and Delete Installed Selected Product buttons to make changes to the products listed under this group box.

Agreement Line: Line Details - Entitlements

This section lists the entitlements that are contractually owed to the customer for an agreement line. These are initially populated by using the set of entitlements that are defined on the Default Entitlements page of this component. You can add or delete entitlements in the grid by adding and deleting rows.

The system also displays the Holiday Schedule field after the entitlements. It appears by default from the Service Level page. You can override it or clear it. For Platinum customers, you may want inactivate the holiday schedule by clearing the field. If you enter a holiday schedule without a service level, the system treats it as a 7 x 24 entitlement with holiday schedule.

Entitlements Apply To

The system displays a group of fields based on the options you selected on the Agreement Search Configuration page for the business unit you are using.

Use the fields that appear in this group box to link the response and restore times to the different values for the various fields that appear.

For example, if you selected the Match Using Case Criteria option and selected Role, Department, Priority, Source, and Location as categories that you wanted the system to use when searching for agreements, the system would display all of the fields on this page.

If you do set values for the fields appearing in this group box, the system uses them to search for agreements when a user selects the Select Agreement link from the Case page.

For example, if you set the Priority field to Low on this page, the system would locate this agreement line and use the response and restore times that you set up on the agreement line for all low priority cases that meet the other criteria of the agreement line.

For all low priority cases that fulfill the other matching considerations for a valid agreement line for all low priority cases, the system uses other standard fields that are considered for an agreement match, such as start and end date, status, product, installed product, asset, and so on. The system is not using the other criteria in the Entitlements Apply To section.

Agreement Line: Line Details - Calculate Final Line Price

This section displays the variables that the CRM system used to calculate the final line price for the agreement line.

Note. This section does not appear if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement. If you selected External - No Pricing as the agreement category, the system does not display this section either.

Base Price

Displays the base price for the service or service product combinations of the agreement line.

Note. For agreement lines with a prepaid purchase option, this value is informational only. The prepaid rate, not the base price, is used to calculate the final line price.

Entitlement Adjustment

Displays the sum of the uplift and discount percentage values that are associated with the entitlements on this agreement line after clicking the Calculate Final Price button.

Subtotal

Displays the subtotal for the agreement line after the base price has been adjusted by the entitlement uplift or discount.

Adjustment (Percentage)

Select the positive (+) or the negative (–) sign from the drop-down list box and then enter a percentage by which you want to adjust the price of the agreement line.

Adjustment (Amount)

Select the positive (+) or the negative (–) sign from the drop-down list box and then enter an amount by which you want to adjust the price of the agreement line.

Reason

Select the reason that you are making the adjustment. If the reason is not listed in the drop-down list box, click the Other link and enter the reason you are making the adjustment.

Final Line Price

Displays the final price for the agreement line.

Sum of the Prepaid Quantity x Prepaid Rate

Calculate Final Price

Click this button to calculate the final price for the agreement line. The system retrieves all appropriate service or service/product prices, calculates subtotals and adds and subtracts any discounts or adjustments that you have made to the base price.

Agreement Line: Installed Products

The section lists all of the installed products covered by that agreement line. If the agreement covering the service order has a scope of Site, the installed products are limited to those that match the sites that are covered by the agreement line.

The CRM system displays the Products Under Service grid if you choose to view line details or just the installed product information of the agreement line.

It lists the customer's installed products that are eligible for the service or support specified on the agreement line. Installed product information must be added manually to the agreement.

When installed products are added to an agreement line, the CRM system automatically updates them on the agreement line whenever replacements are made at the customer's site (when material is recorded in the Service Order on the Time Material Expense page).

Before selecting an installed product, you must define a product for the agreement line; and, for agreements with a scope of Site, select the sites that will be covered by the line.

If the scope of the agreement is Contact, the installed product choices are limited to those that match the product and customer specified. You can never select installed products with a status of Uninstalled.

Agreement Line: Entitlements

This section lists the entitlements that are contractually owed to the customer for an agreement line, including the holiday schedule. These are initially populated by using the set of entitlements that are defined on the Default Entitlements page of this component.

Agreement Line: Sites

The section lists all of the sites associated with the agreement line: the allowable values are determined by the sites that were entered on the Scope Details page. You can add or delete sites displayed in the grid by adding and deleting rows.

Note. This section does not appear if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement.

Agreement Line: Price Information

Use this group box to enter purchase option and transactional information for the agreement line. Click the Price Definitions link to access the Service Pricing page.

For more information and field descriptions, refer to the Line Details - Products section for the Agreement Line Tab.

Note. This section does not appear if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement. If you selected External - No Pricing as the agreement category, the system does not display this section either.

See Also

Specifying Line Defaults

Performing Entitlement Searches for Cases and Service Orders

Specifying Line Defaults

Working with Active Analytics Framework

Setting Up Services

Ordering and Receiving Materials

Click to jump to top of pageClick to jump to parent topicDefining Billing Information

Access the Billing page (Customer Contracts CRM, Agreements, Agreements, Billing).

Note. This page does not appear if you are creating an agreement for PeopleSoft HelpDesk and selected Internal as the agreement category when you added the agreement. If you selected External - No Pricing as the agreement category, the system does not display this page either.

Customer Information

These fields capture information to determine how much to charge the customer for the agreement and the method of remittance that the customer uses.

Bill to Customer

Select the customer that should be billed for the service. The primary customer appears by default in this field.

Bill To Contact

Select the contact that should be billed for the service. The primary contact appears by default in this field.

Bill To Address

Select the bill to customer address to which the bill should be sent. The primary bill to address appears by default in this field.

Currency Code

Select the currency that the customer is using for the transaction.

The currency name appears to the right of the field. When the information is sent to PeopleSoft Contracts, the system prints the name of the currency on the invoice. The base currency of the sold to customer appears by default in this field.

Payment Information

Purchase Order

Enter the customer-provided purchase order number.

Note. This field does not have any integration to PeopleSoft Supply Chain Management (PeopleSoft SCM) and is not required. If you enter a purchase order number in this field, the system posts it to PeopleSoft Contracts. When PeopleSoft Contracts sends the information to PeopleSoft Billing for invoice generation, the system prints the purchase order number on the invoice.

Invoice

Select if the customer intends to pay for the service by invoice.

Payment Terms

If you selected the Invoice option, use this field to select the payment terms for the invoice (for example, NET30 - Due in 30 days). The payment terms appear on the invoice that is sent to the customer.

Credit Card

Select if the customer intends to pay for the service by credit card. The system displays the Credit Card Information link after you select this option.

Credit Card Information

Click to access the Credit Card Details page, where you enter credit card authorization information, such as the card type, card number, expiration month and year, and card verification number.

Note. The system deletes the card verification number after the credit card authorization process is completed.

The system populates the name of the cardholder, email address and phone number of the bill to contact (selected on the Billing page). It also populates the bill to address as the default address for the new credit card. You can enter a new address, or click the Edit link to update the selected address in the corresponding Person record.

The system displays the authorization status, date, and code on the Transactions Results page after you click the Submit Transaction button on the Credit Card Details page.

Note. You can integrate credit card information with Cybersource, a third-party card vendor.

The Credit Card Details page is also used in the Case component to submit customers' credit card information for authorization purposes.

See Submitting Credit Card Information for Authorization.

Tax Parameters

Click this link to access the Tax Parameters page. Use this page to indicate whether the customer is exempt from taxes. If the customer is tax exempt, enter the exemption certificate number and tax code that the customer supplies to you.

The system uses a default tax code based on the customer's address; however, you can override it by choosing another value.

Schedule

Select the schedule to indicate the way in which the revenue needs to be recognized in the general ledger. The system synchronizes this information from the general ledger.

Billing Information

Managers can use this section to adjust the fees by increasing or decreasing a fee by a percent or by an amount.

The system does not use the new price in the totals until a user clicks the Recalculate Totals button. The system then calculates the sum of all active or closed lines, including those that have changed, and provides the recalculated amount in the Total Amount field.

Click the Expanded button to the left of the Line column to view all billable amounts that were included in the price for a given fee.

+/-

Select the positive (+) or the negative (–) sign from the drop-down list box and then enter the number by which you want to adjust the price of the agreement line.

Adjustment

Enter the number, either a percentage or an amount, by which you want to make an adjustment.

Type

Select Percent or Amount.

Reason

Select the reason for the adjustment. These values are user-definable. You define reason codes on the Reason Code page (select Set Up CRM, Common Definitions, Codes and Autonumbering, Reason Codes). Use Agreement Billing Adjustment, Case Billing Adjustment or Svc Order Billing Adjustment as the reason type when you set up your reason codes.

See Setting Up Reason Codes.

Other

If the predefined values for the Reason field do not describe the reason for the adjustment, click this link to access the Other Reason page where you can enter a unique description of the reason.

Extended Price

This value is calculated when you click the Recalculate Totals button. The system sums the total of the price, plus or minus any adjustments.

Recalculate Totals

Click this button any time there is a change to the Billing Details grid that impacts the price or the currency code. The system recalculates the total cost of the fees.

Clear Adjustments

Click this button to clear the adjustments that were made and return to the original total amounts.

Click to jump to parent topicDefining Warranties

This section provides an overview of warranty definitions and discusses how to define warranties.

Click to jump to top of pageClick to jump to parent topicUnderstanding Warranty Definition

Use the Warranty component to define the duration and entitlements that are associated with a warranty. Defined warranties are associated with items on the Item Definition page.

If a product references an item in its product definition and this item is associated with a warranty, any installed product that is subsequently created for this product then contains the warranty information of its own item. You can manually update or delete the associated warranty for an individual installed product.

For items that are installed at a customer's site, you can activate the warranty on a customer's installed product by using the Installed Product component. When searching for entitlements for a product on a case or service order, the CRM system checks the response time, so a warranty match may appear before or after an agreement on the results page.

See Also

Defining Items

Defining Items

Performing Entitlement Searches for Cases and Service Orders

Click to jump to top of pageClick to jump to parent topicPage Used to Define Warranties

Page Name

Definition Name

Navigation

Usage

Warranty

RF_WARRANTY

Customer Contracts CRM, Agreements, Warranties, Warranty

Define product warranties.

Click to jump to top of pageClick to jump to parent topicDefining Warranties

Access the Warranty page (Customer Contracts CRM, Agreements, Warranties, Warranty).

Warranty Details

Provider

Select the organization that absorbs the cost of the services that are covered by the warranty. Options include: Manufacturer, Retailer, or Service Organization.

Critical Times

This section details the periods of coverage for the warranty. If an installed product is under warranty, its default start date is determined by the ship date, installation date, or order date of the installed product, as applicable. The CRM system calculates the end date by adding the warranty length to the start date.

Warranty Length

Enter a number value to represent the length of the warranty.

Unit

Select the time unit of measure for the warranty period. The values are: Day, Month, Week, or Year.

Starts

Select when warranty coverage begins.

Install: Coverage begins the date when the item is installed at the customer site.

Order: Coverage begins the date when the item is ordered.

Ship: Coverage begins the date when the item is shipped to the customer.

Days for Refund, Days to Return, and Days For Replacement

Enter the number of days from the date in the Starts field during which the customer is entitled to return the item for a full refund, return the item to receive credit for the price of the item, or return the item in exchange for a replacement item.

Use the check boxes in the center of the page to indicate, for informational purposes, how warranty services are provided.

RMA Required (return material authorization required)

Select if installed products under warranty must be returned for warranty services by using RMA processing.

Walk-in Allowed

Select if the customer can bring installed products under warranty to your repair center.

Warranty Transferable

Select to keep the warranty in effect for the new owner if ownership of the installed product changes.

On-Site Repair

Select if installed products under warranty can be serviced at the customer's site.

Invoice Required

Select if the customer must provide a copy of the invoice for an installed product under warranty before warranty services can be performed.

Shipment Allowed

Select if the customer can ship installed products under warranty to your repair center.

Loaner Provided

Select if the customer will be loaned a similar item while the installed product under warranty is being repaired.

Entitlement Plan Name

Select a default entitlement plan from the Entitlement Plan Name field to initially populate the grid with a predefined set of entitlements.

Entitlements

Use this section to add or delete entitlements from this set as necessary. Entitlement plans are established on the Entitlement Plan Setup page. You can also manually enter all entitlement entries into the Entitlements grid without entering an entitlement plan name to pre-populate the grid.

If you do not provide warranty service on holidays, select the holiday schedule that applies to your company's hours of operation. The system uses this information to calculate start and end dates for service.

Warning! If you change the entitlements that are offered by an existing warranty, you also change the entitlements for any installed product that is covered by the warranty. When a warranty has been associated with an installed product, you should not modify the warranty definition on the Warranty page. Instead, define a new warranty with the required entitlements and update the warranty information on the Item Definition page.

The CRM system displays the information that is associated with set of entitlements as defined on the Entitlements page.

See Also

Defining Holiday Schedules

Understanding Agreements and Warranties

Defining Entitlements

Defining Entitlement Plans

Managing Materials

Click to jump to parent topicGenerating Sales Leads for Agreement Renewal

This section provides an overview of lead generation for agreement renewal and discusses how to set it up

Note. This feature is only available to customers that have licensed PeopleSoft Sales and PeopleSoft Integrated FieldService.

Click to jump to top of pageClick to jump to parent topicUnderstanding Lead Generation for Agreement Renewal

To help you sustain company revenue and be proactive about contract renewals for the established customer base, set up PeopleSoft CRM to retrieve agreements that are expired or about to expire and generate sales leads for them. Like other leads, the leads that are created for agreement renewal appear on the Search Leads page for the sales team with Agreement as the lead source.

Lead Generation for Expiring and Expired Agreements

PeopleSoft CRM uses an Application Engine (AE) program, which runs on a daily basis (recommended setting) to look for agreements that are about to expire or have recently expired (based on the number of lead days that are defined by the user) and create leads for them.

When the AE program runs, it searches for agreements that are associated with the sales business unit that is specified on the run control page. Because sales leads are keyed by business unit and agreements are keyed by setID, the CRM system performs a business unit-setID mapping exercise in the background to determine which setID corresponds to the selected sales business unit. All agreements in that setID are processed, and all leads that are subsequently created will belong to the specified sales business unit.

Note. Only agreements with the status of Available are selected by the AE program for evaluation. The AE program does not process agreement templates.

Among all available agreements in the given setID, the AE program generates sales leads for those whose expiration date falls between the start and end dates of a time period that is calculated by using the user-defined lead time. The start and end dates are calculated using this formula:

(Start Date) = (Current Date) - (Agreement Renewal Lead Time)

(End Date) = (Current Date) + (Agreement Renewal Lead Time)

For example, the AE program is scheduled to run today on October 15, and the lead time (in number of days) that is defined at the installation level is 7. For any agreement with an expiration date between October 8 through October 22, a sales lead is generated by the lead generation process.

When you look up a sales lead for agreement renewal from the Search Leads page, agreement-specific information, such as agreement code and renewal number, is available on the Source tab as a reference. You can also transfer to the read-only version of the agreement from the lead.

For agreement renewal purposes, an agreement can only be associated with one sales lead at a time. The agreement is not selected by the AE program if a sales lead was already generated for it. In addition, the CRM system does not generate sales leads for agreements that are already renewed.

Click to jump to top of pageClick to jump to parent topicSetting Up Lead Generation for Agreement Renewal

This section discusses how to:

Click to jump to top of pageClick to jump to parent topicPages Used to Set Up Lead Generation for Agreement Renewal

Page Name

Definition Name

Navigation

Usage

General Options

RB_INSTALLATION

Set Up CRM, Install, Installation Options, General Options

Define how many days before or after an agreement expiration date that a sales lead should be generated.

Sales Lead Generation for Agreement Renewal

RUN_CNTL_RFLEAD

Customer Contracts CRM, Agreements, Lead Generation, Sales Lead Generation for Agreement Renewal

Start a batch process that runs on a daily basis (recommended) to generate sales leads for agreements that are about to expire or have recently expired.

Lead - Discover

RSF_LEAD_ENTRY

Sales, Search Leads, Discover

Access sales leads that are generated for agreements.

Click to jump to top of pageClick to jump to parent topicDefining Lead Time for Generating Leads

Access the General Options page (Set Up CRM, Install, Installation Options, General Options).

In the Agreement Renewal Lead Time field, enter the number of days before expiration that an agreement is eligible for the lead generation process. This is also the number of days after expiration that the agreement is still eligible for the process. By default, this value is set to 90 days.

See Setting Up General Options.

Click to jump to top of pageClick to jump to parent topicGenerating Leads for Expiring Agreements

Access the Sales Lead Generation for Agreement Renewal page (Customer Contracts CRM, Agreements, Lead Generation, Sales Lead Generation for Agreement Renewal).

Select a sales business unit for which leads will be created for expiring agreements after the AE program (RF_AGR_LEAD) is run.

Note. The AE process should be run on a daily basis.

Click to jump to top of pageClick to jump to parent topicAccessing Leads That Are Generated for Agreements

Access the Lead - Discover page (Sales, Search Leads, Discover).

Open a sales lead that is generated for agreement renewal purposes. You can click the Agreement link to access the agreement that needs to be renewed. The name of the agreement is listed is part of the lead name.

See Also

Creating Sales Leads and Opportunities