Create a Purchase Grant

A purchase grant is applied to a balance when a subscriber purchases the product offer or bundle containing the grant.

Before you begin

Create the decision tables the rate tables will use.

About this task

Use positive numbers when defining discount amounts.

Procedure

  1. In Price Components, click the Grants tab, and click New Grant Component.
  2. In Create New Price Component:
    1. In Name, enter a unique name.
    2. (Optional) In Description, enter descriptive information about the item.
    3. (Optional) In External ID, enter any alphanumeric character to serve as a unique ID on this pricing object. The external ID can be used for any reason that is meaningful to your implementation of MATRIXX Engine. External IDs are saved to the pricing configuration file and loaded into the Pricing database.
    4. In Application, select purchase.
      Note: For grants, the usage option is not available.
    5. Skip the Service Type field (this field is only applicable to usage price components).
    6. Click Create.
  3. In Start Date/Time, use the date picker to select the date on which the object becomes active in the pricing database and is first available for use. Alternatively, enter the date in the format YYYY-MM-DD. Optionally, enter a time for when the object becomes active. The default is midnight. If applicable, the range in which the start date/time must fall is listed. For example:
    • Choose a date on or before 2021-12-01.
    • Choose a date on or after 2020-01-27.
    • Choose a date between 2000-01-02 and 2021-10-04.
    Note: If you are creating a new revision of this object, the start date must be greater than the start date of the previous revision and less than the start date of the next revision.
  4. In Target:
    • To apply the grant to a group balance, you can define a tier value or select a tier parameter; you cannot specify both. Select either:
      • Tier — In the Tier list, select the name of the tier containing the group to which the grant is to be applied. The event initiator must be a member of this group hierarchy. For information about creating tiers, see the discussion about adding a field to a pricing plan.
      • Tier Parameter — In the Tier Parameter list, select from all parameters set up in pricing.
    • To apply the grant to the balance of the event initiator, select Event Initiator.
  5. Click Save.
  6. Create a new rate table. For details, see the discussion about creating a new rate table.
  7. To add a system attribute to the rate table:
    1. Click the Attributes tab, and click Add Attribute.
    2. In Add Attribute, select the row of the system attribute you want, and click Add.
    3. Click Save.

      Repeat these steps for each system attribute to add to the rate table.

      To change the value of an attribute, click the cell in the Value column for the attribute, and select the value from the list (if the attribute has allowed values) or enter the value.

      To delete a system attribute, click Delete the selected object in the Delete column for the attribute.

  8. (Optional) Add parameters to the list of price component parameters on the Parameters tab.
    Note: You can use price component parameters in rating formulas. When you add a parameter to a rating formula, it is also added to the parent price component.

    When you assign a price component that has parameters to an offer or a bundle, MATRIXX also creates a default parameter binding between each price component parameter and a parameter with the same name in the offer or bundle. Any parameters that are not already assigned to the offer or bundle, are added to the list of offer or bundle parameters without you having to add them manually.

    For more information about adding parameters to a price component, see the discussion about adding a parameter to a price component.