Last Updated: about 6 hours ago

Packages are configured in Setup / Product Catalog / Package / Packages


Packages are products/offerings that are added to accounts and billed. A package contains one or more services, the services are the individual line items that charges are configured on. A package's price is determined by summing the charges for the services within the package. Packages have a sub element called 'package frequencies' which allow you to setup multiple billing frequencies for each package that you create (for example a monthly billing version of the package and an annual billing version of the package).

When packages are added to accounts they are referred to as 'account packages'. The term 'package' typically refers to a package in the product catalog, while the prefix 'account' indicates that an instance of an entity exists on an account (account package, account service, etc.).


  • Services need to be configured before packages can be setup

  • Currencies need to be setup in order to enable currencies on package frequencies and specify service charges for the enabled currencies

  • Rate plans are required if you need to attach a rate plan to a service or package frequency

  • Package contracts are required if you need to attach a contract to a package frequency

Packages Panel

The Packages panel on the left of this screen allows you to select existing packages to view and edit on the Edit Package panel to the right. Actions are also available in this panel which are shown as icons above the Filter text box. The available actions are described below.




Deletes the selected package if not in use (added to an account)

Adds a new package

Packages List

The Packages list on the left of the screen shows packages that are currently setup.

When you select a package in the list any package frequencies setup under the package will be presented. Selected packages will display a (emoji) icon which allows you to add a new package frequency to the package. Details on the selected package's configuration will also be displayed in the Edit Package panel to the right. These details are explained below.

Edit Package Panel

The information in this panel reflects the currently selected package. From here you can change package details (fields will display a red left border if a value is required and purple text if the field is read-only and cannot be modified).

Package Fields and Options:

  • Name: a unique name for the package. This name can be used internally or as a customer facing product name on invoices and in web portals if desired

  • Start Date: the date that the package becomes active in the product catalog. If left empty the package will be available to add to accounts immediately, provided package frequencies under the package are set as ‘Active’

  • Expiry Date: used to retire a package. When this date is reached the package will no longer be available when adding packages to accounts. Account's already configured with the package will not be affected when the package expiration date is reached

  • Description: a description of the package for internal purposes or (optionally) a detail that can be presented on invoices or in web portals

  • Default Account Package Status: specifies the status the package will default to when it is added to an account. The package status determines if the account package is billable and if package settings can be modified. See the package status screen help for more information on package statuses

  • Currencies: sets the currencies that the package frequencies under the package can be sold in. E.g. if you enable CAD and USD in this section then the package frequencies setup under the package will only be able to configure USD and CAD prices on services in the package

Services tab

This tab allows you to view, add, remove or edit services within the package. See the guides articles under this page for instructions on how to configure services on packages.

Options tab

This tab allows you to configure how the package is billed and define the type of package you wish to offer. The fields on this tab are explained below:

Billing Options:

  • Charge Full Period: if enabled the package will always bill at its full package price (i.e. service charges related to the package will not be prorated). In addition, packages configured for full period billing will not provide refunds when the package is canceled

  • Charge Recurring Only If Usage: if enabled recurring service charges will only be applied when usage related to a service in the package occurs. Even if usage charges amount to zero the fact that usage occurred will still result in recurring charges being applied. Enabling this option will result in the package being set as postpaid. Other non-recurring charges such as transition charges or one-time charges will still apply when this option is set

  • Postpaid: if selected, the package will be billed in arrears. Package charges will be applied for the previous period once the current period is reached. E.g. a monthly postpaid package’s charges for September will not be added to the account balance until the package’s next bill day in October is billed

  • Billing Activation Service: allows you select a billing activation service which triggers account package billing based on usage and/or time thresholds. See the services screen help for details on billing activation services and how to configure them

Add-on Type Options:

  • Share Plan Add-On: converts the package to a share plan add-on package. When this setting is enabled the package will be an 'add-on' offering which can be added to account share plans to increase the available shared usage (e.g. add another gigabyte of data to the share plan). The services configured on the package which contain buckets will determine the amount and type of usage that the add-on package provides

  • Global Add-On: configures the package as an add-on package that can be used to add additional services to existing account packages. E.g. can be used to sell additional equipment or apply additional charges so that the services applying these charges do not need to be configured on standard packages in the product catalog. Global add-on packages can only be added to account packages that are configured with the ‘Add-on eligible’ setting. Packages cannot be setup as both a global add-on package and an add-on eligible package

  • Add-on eligible: configures the package to permit any global add-on packages to be added to it. Global add-ons added to the eligible account package will add the services contained within the global add-on package to the eligible account package (e.g. additional one-time or recurring services will be appended to the eligible account package). For an example on how to setup add-on and eligible packages see the Global Add-on Package Configuration Example

Buckets tab

This tab will display any services within the package that contain buckets. Clicking on the (emoji) icon next to the service name on this tab will reveal bucket details and allow you to configure buckets as shared. Shared buckets are available to be used by other usage based services in the package but will only be used after the services in the package have consumed their own buckets.

For information on how to configure buckets on services see the Services screen help.

Custom Fields tab

This tab will display any custom fields that have been setup with an 'Entity' value of 'Packages'. Custom fields are used to capture/provide additional data on the package within the product catalog. Custom fields on this tab are typically used to store internal/back-end details related to the package. To allow or require users to enter data when adding packages to accounts you would setup custom fields with an 'Entity' value of 'Account Package'. For more information see the Custom Fields article.