Fields on the Program Maintenance page


General tab

Pricing tab

Rules tab

Maintenance tab

Tech Support tab

Other Configuration tab

Renewal tab


General tab

Header Information

In the Header Information section, the first subsection is used to identify the program, set the status, and set the program start and expiration dates.

Pub ID Type the identifier used by the publisher to refer to the program.
Code In the Code field, type a code to represent the program. After a new program is saved, you cannot change the program code.
Name In the Name field, type the name of the program.
Status From the dropdown, select the status of the program.
Start date Set the date when the program begins. Either type the date into the field, or use the date picker to select the date. Contracts cannot be created for the program until the program begins.
Expire date Set the date when the program becomes inactive. Either type the date into the field, or use the date picker to select the date. While existing contracts are not affected, new contracts cannot be created after the program expires.

The second subsection contains information about the program type, including whether the program uses points.

Type From the dropdown, select the type of program.

After a new program is saved, you cannot change the program type.

Model From the dropdown, select the model to use for the program. The program model controls access to pricing information.
Market segment From the dropdown, select the market segment to which the program applies. Only companies within the selected market segment can purchase licenses under the program.

To not restrict the program by market segment, select All.

Point based To use a point-based volume pricing model, check the Point based check box.

If you use points, then on the Orders tab of the Product Maintenance page, you must configure the number of points for each product.

Program-specific prices To use the standard prices that are uploaded into Poetic, check the Program specific prices check box.
Point duration Type the number of days that program-awarded points are valid.

The third subsection contains information about the duration and contract number for contracts created under this program.

Contract duration Optional. To set a default duration for contracts created under this program, in the Contract duration field, type the duration. From the dropdown next to the field, select the unit of measurement for the duration.
Minimum contract period In the field, type the minimum number of days a contract created under this program can last.
Maximum contract period In the field, type the maximum number of days a contract created under this program can last.
System-generated contract numbers To have Poetic generate contract numbers, check the System-generated contract numbers check box.

If you do not check this box, then all contracts must be created manually. Poetic cannot create contracts automatically.

Contract number From the Contract number dropdown, select the algorithm to use to generate contract numbers.

Publisher Information

Lists the name, address, and phone number of the publisher.

Order Entry Rules

First order minimum qty/points Type the number of units or points a customer must request in their first order in order to participate in the program.
Later order minimum qty/points Type the number of units or points a customer must request in any following orders to participate in this program.
Allow zero qty/points on order To waive a quantity or point minimum for orders, check the Allow zero qty/points on order check box.

This allows orders with no quantity, often used for physical orders.

Order entry grace period When orders are placed, this grace period (in days) is added to the contract end date. The resulting date is used to validate the pricing date for the order.
Welcome Kit template From the dropdown, select the template used for the notification sent to the contract coordinator when an order is placed under this program.

To not send a notification, leave this field blank.

Program Notes

The Program Notes section allows you to enter any additional notes concerning the program.

Back to top

Pricing tab

The Pricing tab contains information on how prices are calculated for orders under this program.

Price List

The Price List table lists the available price lists for this program. When users place an order, if they have CAN_CHANGE_PRICE_LIST_ON_ORDER set to true, then if the program has multiple price lists, they can select which price list to use.

If the user is not able to select a price list, then the default price list is used.

To add a price list:

  1. Click Add another price list.
  2. To search for and select the price list, click the Find link.
  3. If this is the default price list, click the Default radio button. Only one price list can be the default.

To remove a price list, click the Remove link for that list.

About tiers

Pricing tier rules determine the quantity that customers must accumulate for a contract in order to reach a specific tier. The tier is used to calculate the price of an order.

Selecting how to calculate tiers

From the Calculate threshold on dropdown, select the level at which to calculate the pricing tier.

Setting up the default tier list

The pricing tier table in the Price Table section contains the pricing tiers to use if either:

To create a new pricing tier:

  1. Click Add tier.
  2. In the Tier/Level Name column, type the name of the tier.
  3. In the Minimum Qty field, type the minimum quantity the customer must have in order to reach this tier.

To remove a tier from the table, click the Remove link for the tier.

Setting up tiers when using product lines

If you are using product lines to calculate the pricing tier, then the Pricing tab includes a table listing the product lines for which pricing tiers have been configured.

For product lines that do not have tiers configured, the default tier list is used.

To create and edit the product line tiers:

  1. To add tiers for a product line, click Add product line pricing tiers.

    To edit existing tiers for a product line, click the Edit link for that product line.

    The Product Line Price Tiers form displays.

  2. For a new set of tires, from the Product line dropdown, select the product line for which to configure the tiers. If you are editing an existing set of tiers, you cannot change the product line.
  3. For each tier, in the Tier/Level Name column, type the name of the tier.
  4. In the Minimum Qty field, type the minimum quantity the customer must have in order to reach this tier.
  5. To add another line to the tier table, click Add tier.
  6. To remove a line, click its Remove link.
  7. When you have finished configuring the tiers for the selected product line, click Save.

To remove a product line from the list on the Pricing tab, click its Remove link.

Term Discount

The term discount table allows you to configure up to five discounts based on the duration of the subscription. This discount is applied after the price has been prorated.

For each term discount:

  1. In the Term Discount Code field, type a name for the discount.
  2. In the Minimum Duration field, type the minimum number of days for the duration in order to be eligible for this discount. For example, if this discount only applies if the subscription is longer than 120 days, type 120 in the field.
  3. In the Discount Percentage field, type the percentage to discount the price. For example, to discount the price by 5%, type 5 in the field.

Back to top

Rules tab

Contract Creation

Creation restriction From the dropdown, select the option for restricting the creation of new contracts under this program.

To not have any restrictions on how many contracts can be created per customer, select None.

To encourage customers to have one contract under this program, select 1 per customer with publisher override. If you select this option, then during order entry, if a channel partner or end customer opts to create a new contract for this program, and there is already an existing contract, a message displays indicating that they must use an existing contract.

Create contracts automatically To automatically create contracts when orders are placed under this program, check the Create contracts automatically check box.

Note: If this box is checked, do not check Ask for reseller.

Allow start/end dates to be entered at order level If contracts are created automatically, then to allow users to set the contract start or end date and duration when they place an order, check the Allow start/end dates to be entered at order level check box.

Ask for contract emails When contracts are created or edited manually, the check boxes under Ask for are used to indicate whether to prompt the user for specific pieces of information.

To prompt the user for a contact's email address, check the Contract emails check box.

To prompt the user for a reseller, check the Reseller check box. (This is not recommended. A better method is to use contract parties (coordinators).

To prompt users to select a language to restrict the products that can be ordered under that contract, check the Product language limit check box.

Adjust end date to Select the radio button to determine whether to automatically adjust the end of the contract.

To keep the contract end date as it is specified in the contract, click the No adjustment radio button.

To ensure that contracts always end at the end of the month, click the End of month radio button.

To ensure that contracts always end at the end of the calendar quarter, click the End of calendar quarter radio button.

Forecast Program Rules

For forecast programs, the Forecast Program Rules section allows you to set up the required milestones for the program.

To add blank rows to the table, click the Add rows link.

For each milestone:

  1. In the # Days into Contract column, type the number of days into the contract that the milestone must be reached.
  2. In the % Must Purchase column, type the percentage of the total that must be purchased by the milestone.
  3. To send an email notification when a milestone is not reached, check the Send Email check box.
  4. In the Grace Period in Days, type the number of days after the original deadline that the customer has to reach the milestone.
  5. In the Email to column, click a radio button to select the recipient for the notification.
  6. To stop orders if a milestone has not been reached, check the Stop Order check box.

To remove a milestone, click its Remove link.

Company Type Restrictions

The Company Type Restrictions section lists all of the company types. Check the check box next to each company type that can buy or sell products under this program.

Coordinators

The Coordinator Rules section lists rules for creating coordinators under this program. For a summary of the coordinator types, see About groups and coordinators.

For each coordinator type, you set the following parameters:

Active To allow coordinators of this type, check the Active check box.
Required To require coordinators of this type, check the Required check box.
Per Family To allow users to provide this type of coordinator for each product family, check the Per Family check box.

You can only provide family-level coordinators for upgrade, technical, dealer, and bill-to coordinators.

Allow Multiple To allow multiple coordinators within the group, check the Allow Multiple check box. You can only allow multiple coordinators for group and service company coordinators.
Display To display the coordinator on the user interface, check the Display check box.
Send Notice When Added To send a Coordinator Modification notification whenever coordinators of this type are added, check the Send Notice when Added check box.
Send Notice When Modified To send a Coordinator Modification notification whenever there are changes to this type of coordinator, check the Send Notice When Modified check box.
Update Coordinator From the Update Coordinator dropdown, select the circumstances under which to allow coordinators on an existing group to be updated either from a SetPoeticEntitlement message or from a new order.

To never update the coordinator from SetPoeticEntitlement or order entry, select No automatic updates.

For group, renewal, and service company coordinators, the dropdown is locked to this value. These coordinators can never be updated except from the coordinator management function.

To:

  • Allow the coordinator to be updated from SetPoeticEntitlement or order entry, and
  • Prompt users to provide the coordinator during order entry

select Allow updates and prompt.

To:

  • Allow the coordinator to be updated from SetPoeticEntitlement or order entry, but
  • NOT prompt users to provide the coordinator during order entry

select Allow updates; no prompt.

Groups

Depending on how the application is configured, customers can create groups to organize the licenses purchased by their company.

Groups can represent a location, department, project, region, server, or anything else that is useful to the customer.

Can add group To allow users to create groups during the order process, check the Can add group check box.

If the Poetic instance allows groups, but this box is unchecked, then Poetic automatically creates a single group.

New group for each combination of product family and new license (order entry) When Poetic creates groups for entitlements generated by the order entry process, to create a separate group for new entitlements for each product family, check this check box.
Pub ID generation method From the dropdown, select the method used to generate pub IDs for groups.

To not generate a pub ID, select None.

To assign a sequence number to each new group, select Sequential.

To assign the next serial number from the contract serial number pool to each new group, select Serial.

Pub ID requirement From the dropdown, select whether users can set the pub ID of a group.

To not allow users to provide pub IDs for groups, select No input.

To provide an optional pub ID field, select Input optional.

To provide a required pub ID field, select Input required.

Pub ID must be unique To require that each group pub ID be unique within a company, and not just a contract, check the Pub ID must be unique check box.

Order Entry Survey Questions

This section allows you to set up a list of survey questions to ask during the order entry process.

To add blank rows to the list, click the Add rows link.

To search for and select a survey question, click the Find link for a row. The survey question search is resticted to survey questions for order entry.

To clear a selected question, click the Clear link for the row.

Back to top

Maintenance tab

You use the Maintenance tab to specify information about purchasing maintenance products under the program.

Validation for Ordering Maintenance

Maintenance grace period Enter the number of days after the contract starts within which customers can purchase maintenance.

This is not recommended unless you require users to purchase maintenance licenses.

Quantity limited to To set the restrictions on purchasing maintenance products, click the appropriate radio button:
  • To require customers to purchase the same number of maintenance licenses as original licenses ordered, click the Must buy same amount as licenses on order radio button.
  • To allow customers to purchase fewer than but no more than the original number of licenses ordered, click the No more than licenses on order radio button.
  • To allow customers to buy no more than the total number of licenses for that customer, click the No more than matching license entitlements radio button.
  • To place no restrictions on purchasing maintenance products, click the Unlimited radio button.
  • To prevent customers from purchasing maintenance under this program, click the Cannot buy any maintenance radio button.

Maintenance Effective Start Date and Expiration Calculation

Effective start date based on From the dropdown, select the method used to determine when maintenance begins.
On expired renewals, price for From the dropdown, select the method for determining the price of maintenance when the renewal period has expired.
On initial purchase, set expire date To determine when maintenance purchased under the program expires, click the appropriate radio button:

  • To end maintenance on the same date as the contract, click the Co-terminate with contract radio button.
  • To determine the expiration date based on the duration of the maintenance product, click the No adjustment radio button.
  • To set the expiration date to the end of the month during which the maintenance product expires, click the End of month radio button.
  • To set the expiration date to the end of the quarter during which the maintenance product expires, click the End of quarter radio button.

Maintenance Pro-Ration

Co-terminate with contract To end the maintenance on the date the contract ends, check the Co-terminate with contract check box.
Pro-ration method From the dropdown, select the method used to determine the cost of maintenance if the duration is less than the default duration of the product.
Pro-ration table If you selected Pro-rate against table as the pro-ration method, then you need to use the pro-ration table to set up the rules for pro-rating the price of maintenance.

For each pro-ration rule:

  1. In the Product Duration column, type the default duration in days of the product. This allows you to set up different proration rules for different product durations.
  2. In the % Duration column, type the percentage of the duration.
  3. In the % Charge column, type the percentage of the price to charge.

For example, if the duration is 365, the percent duration is 25%, and the charge is 0%, it means that for maintenance products that last a year, if the actual product duration is less than 25% of the original, then the maintenance is free.

So if the contract began on January 1 and ends on December 31, but the maintenance isn't purchased until November, then the maintenance is free.

If in the second line the duration is the same, the percent duration is 50%, and the charge is 25%, then if the duration is less than half but more than a quarter of the default duration, customers are charged 25% of the original maintenance price.

So for the same January 1 and December 31 start and dates, if the maintenance is purchased in August, then maintenance is a quarter of the price.

Back to top

Tech Support tab

On the Tech Support tab, you specify how technical support products are handled under this program.

Validation for Ordering Technical Support

Contract support From the dropdown, select whether technical support is included with the product.
Purchase limit If supported is not included, then to set restrictions on purchasing technical support, click the appropriate radio button:
  • To not place any restrictions on purchasing technical support, click the No limits radio button.
  • To not allow any technical support for this program, click the Cannot buy any radio button.
  • To require that customers first purchase maintenance before purchasing technical support, click the Must buy after initial maintenance purchase radio button.
  • To only allow customers to purchase technical support for the same product family and version for which they purchased maintenance, check the Within family & version check box.

Technical Support Expiration Calculation

Adjust expire date To determine when technical support expires under this program, click the appropriate radio button:
  • To end technical support at the same time the contract ends, click the Co-terminate with contract radio button.
  • To end technical support based on the duration of the technical support product, click the No adjustment radio button.
  • To end technical support at the end of the month during which the technical support product expires, click the End of month radio button.
  • To end technical support at the end of the quarter during which the technical support product expires, click the End of quarter radio button.

Technical Support Pricing

From the Co-termination rules dropdown, select the method to use to prorate the cost of technical support when the duration is different from the default product duration.

If you select Pro-rate from table, then the table on the Maintenance tab is used to set up the percentage of the price to charge based on the percentage of the original product duration.

Technical Support Notification

Send technical support notification To send a technical support notification when an order involves technical support, check this check box.
Notification template From the dropdown, select the template to use for the Technical Support Notification.

Back to top

Other Configuration tab

Validation for Add-on Orders

To only allow add-ons if the customer already has license entitlements in the same product family, check the Must have license entitlement with same family check box.

Add-on restrictions To prevent orders of add-on products under this program, check the Cannot purchase any check box.

Validation for Physical Media and Documentation

Used to set any restrictions on the quantity of physical products that can be included in an order.

Use license version To use the license version instead of the product version when validating the quantity ordered for a physical product, check the Use license version check box.
Limit quantity to number of entitlements with same: To limit the quantity for physical products to the quantity for license or maintenance products with the same operating system, version, or product family, check the Quantity limited to # of entitlements with same check box, then check the OS, Version, or Family check boxes.
Limit quantity to maximum of maintenance or licenses To limit the quantity for physical products on either the quantity of license products or maintenance products, whichever is greater, check this check box.

Back to top

Renewal tab

Renewal Rules and Schedule

The first subsection contains basic settings for allowing renewals.

Allow renewals To allow renewals under this program, check this check box. If this check box is not checked, then the rest of the fields on the Renewal tab are hidden.
Allow partial renewals To allow users to renew part of their subscription, check this check box.
Allow renewal requests To allow users to create renewal requests, check this check box. If this check box is not checked, then the Renewal Request Rules section does not display.
Allow Renew Now To allow users to select an option to purchase renewals immediately, check this check box. If this box is not checked, then the Renew Now Rules section does not display.

The second subsection is used to set the renewal schedule.

Renewal period starts In the field, type the number of days before the expiration date to begin the renewal period. For example, if the renewal period begins 90 days before the contract expires, type 90.
Renewal period ends In the field, type the number of days after the expiration date during which customers may still renew. For example, if the user can renew up to 30 days after the expiration, type 30. If the user cannot renew after the expiration date, type 0.

The third subsection contains settings for purchasing renewals:

Can purchase renewal products To allow renewal products to be included in an order, check this check box.
If renewing tech support, must renew equal quantity of maintenance To require users to match the number of tech support renewals with maintenance renewals, check this check box.
Party boundaries From the dropdown, select the rule for generating renewal orders based on the dealer and bill-to parties.

To generate an order for each dealer, without comparing the dealer to the bill-to, select Generate one renewal order for each dealer.

To generate an order for each dealer unless the dealer and bill-to are different resellers, in which case generate multiple orders, select Generate one renewal order for each LARS at the sold-to level.

Renewal co-termination rules From the dropdown, select the rule for co-terminating renewals.

Renewal Reminders

The Renewal Reminders section is used to configure the notifications sent to remind customers that renewals are available or have expired.

In the first subsection:

Default email for notices In the field, type the default email address for renewal notices.
Notice consolidation From the dropdown, select how to consolidate the renewal notifications. For example, you could send one notification for an entire contract.

The second subsection is used to configure the schedule for sending renewal reminders.

Renewal reminder schedule Used to set the schedule for renewal reminders sent before the expiration date:
  • To have renewal reminders sent at regular intervals once the renewal period begins, click the Every radio button, then type the number of days in the field. For example, to send a reminder every 7 days once the renewal period begins, type 7 in the field.
  • To have renewal reminders sent at times you specify, click the On the following schedule radio button, then type each number of days before the renewal expires on which to send a reminder. Separate each number with commas. For example, to send reminders 30, 15, and 7 days before the contract expires, type 30,15,7 in the field.
Post-expiration notice schedule Type the schedule for sending the post-expiration notification. Type the number of days after the expiration to send the notification. Use commas to separate multiple days.

For example, to send the notification 2, 5, and 10 days after the contract expires, type 2,5,10 into the field.

The third subsection is used to select the template and recipients for each type of reminder notification. For each type of reminder:

The available renewal reminders are:

First notice The first renewal reminder. For example, if the reminders are sent 30, 20, 10, and 5 days before the expiration, then the first notice is sent 30 days before the expiration.
Reminder Used for all reminders between the first and final notices. For example, if the reminders are sent 30,20, 10, and 5 days before the expiration, then this reminder is sent 20 and 10 days before the expiration.
Final notice The last reminder before the expiration date. For example, if the reminders are sent 30,20, 10, and 5 days before the expiration, then the final notice is sent 5 days before the expiration.
Upon expiration Notifies customers that they have not renewed within the renewal period. Sent on the expiration date.
Post-expiration Sent to customers after the expiration to remind them to renew, based on the schedule provided.

Renewal Request Rules

If renewal requests are allowed, use this section to set the rules for displaying the renewal request option on the Renewal Dashboard or in a renewal notification.

Country You can control whether to allow renewal requests based on the country in which the company is located.

To only allow renewal requests for certain countries, click the select icon next to the Country field.

The country selection page displays. By default, all of the countries are checked.

To exclude a country from the list for which to allow renewal requests, uncheck the check box next to it.

At least one country must be checked.

Quantity You can also control whether to allow renewal requests based on the quantity of active maintenance for the company.

To only allow renewal requests if the total active maintenance quantity is less than the specified value, select Total maintenance count is less than from the dropdown, then type the value in the field.

To only allow renewal requests if the total active maintenance quantity is greater than the specified value, select Total maintenance count is greater than from the dropdown, then type the value in the field.

Company types A check box displays for each company type in the end customer tier.

To allow renewal requests for a company type, check the check box.

When renewal requests are created:

For each notification:

Renew Now Rules

If Renew Now is allowed, use this section to set the rules for purchasing renewals immediately from the Renewal Dashboard or a renewal notification.

Country You can control whether the option to purchase renewals immediately is available based on the country in which the company is located.

To only display the option for certain countries, click the select icon next to the Country field.

The country selection page displays. By default, all of the countries are checked.

To exclude a country from the list for which to display the option, uncheck the check box next to it.

At least one country must be checked.

Quantity You can also control whether the option to purchase renewals immediately is available based on the quantity of active maintenance.

To only display the option if the total active maintenance quantity is less than the specified value, select Total maintenance count is less than from the dropdown, then type the value in the field.

To only display the option if the total active maintenance quantity is greater than the specified value, select Total maintenance count is greater than from the dropdown, then type the value in the field.

Company types A check box displays for each company type in the end customer tier.

To allow the option to purchase renewals immediately for a company type, check the check box.

Begin allowing Use the field and dropdown to set the number of days before or after the expiration to start allowing users to purchase renewals immediately.

Type the number of days in the field. From the dropdown, select Before to have the period start before the expiration, and After to have the period start after the expiration.

For example, if this option becomes available 30 days before the expiration date, type 30 in the field, and select Before from the dropdown.

Allow until Use the field and dropdown to set the number of days before or after the expiration to stop allowing the option.

Type the number of the days in the field. From the dropdown, select Before to have the period end before the expiration, and After to have the period end after the expiration.

For example, if this option is up to 10 days after the expiration date, type 10 in the field, and select After from the dropdown.

Back to top