- Created by Camille Marshall, last modified on Nov 13, 2020
Accessing the Service Plan Details Page
- From the Ubersmith Dashboard, click Settings.
The Ubersmith Settings page appears. - From the Clients section, click Service Plans.
The Service Plans page appears. - Click the service plan you want to change.
The Service Plans Detail page appears.
Editing Service Plans
- From the Service Plan Details page, click on edit in any section.
The Edit Service Plan page appears, with that section’s information displayed. - Make any necessary updates you need.
- Click Update.
Adding a Rate Plan
- From the Service Plan Details page, click add rate plan.
The Add Rate Plan Service Plan Pricing page appears. - From the Rate Plan field, select the rate plan you need or click Add Rate Plan to create a new rate.
Enter the price for the service plan.
These fields contain a range of pricing options you can charge for the service upgrade. The rows represent selectable renewal periods and the columns are the service plan upgrade’s price and corresponding setup fee along with your cost and corresponding upgrade fee for the upgrade.
For each price, use the following setting to refine your rate:
= does not affect the existing default price.
$ sets a specific price override (an example is always $10 instead of the existing default).
+/- is a number of dollars more or less than the base default.
% is a percentage higher or lower than the existing default.Careful attention should be paid to configuring the pricing options. For a monthly fee with an associated one-time setup fee, the price for both should go in the monthly row, since the upgrade option is based on a monthly price. If there was a one-time fee along with a one-time setup fee, both prices should be set in the One-Time fee row.
- Click Add.
Adding Usage Plans
Usage plans calculate and bill for the volume of resources consumed through a configured plugin data source. Some examples include OnApp and CloudStack usage. See Plugins for more information. Usage plans rely on existing plugins to provide a data source. Once you have a plugin configured and active, you can configure a service plan to track usage information. The data source in the service plan is configured to provide the necessary resources to track, and the appropriate units for those resources.
- From the Service Plan Details page, in the Usage Plan section, click add usage plan.
The Add Usage Plan page appears. - In the Usage Plan Name field, enter the name for your usage plan.
- In the Data Source field, select the appropriate data source.
- Click Save or Save & Add Resources.
- If you clicked Save & Add Resources, see Adding Resources.
Managing Usage Plans
If you have services using a usage plan, you can add new resources, but existing resources cannot be deleted.
Editing Usage Plans
- From the Service Plan Details page, in the Usage Plan section, click details.
The Configure Usage Plan page appears. - In the Usage Plan Properties section, click edit.
The Edit Usage Plan page appears. - Make any necessary updates.
- Click Update.
Adding Resources
- From the Service Plan Details page, in the Usage Plan section, click details.
The Configure Usage Plan page appears. - In the Usage Plan Properties section, click add resources.
The Add Resources page appears.
Complete the Add Resources Page
The fields in this section differ, based on the type of plugin you are using.
For markup resources:
- In the Resource Name field, enter or select the name of the resource.
- In the Resource field, select the type of resource.
- In the Markup field, enter either the fixed price or the percentage you want to mark up your resource, and select either the percent or dollar sign.
- In the Update existing services field, select Yes if you want to update any existing services to being using this resource.
- Click Save or Save & New.
For tiered resources:
- In the Resource Name field, enter or select the name of the resource.
- In the Resource field, select the type of resource.
- In the Resource Unit, select the appropriate unit based on the resource.
- In the Base Price field, enter the monetary cost of the resource unit.
- In the Update existing services field, select Yes if you want to update any existing services to being using this resource.
- Click the Tiers tab, which only displays if you are using a plugin with tiered billing amounts.
- In the Included row, enter the cut off range for the included amount. The monetary value is set to zero.
- In the Rate Tier [number] field, enter the monetary value for that tier.
- In the Up to Tier field, enter the cut off range for the tier.
- Click the + sign to add additional tier fields.
- Click delete to remove tier fields.
- In the Remaining field, enter the monetary value for the usage past the last tier.
- Click Save or Save & New.
Editing Resources
- From the Service Plan Details page, in the Usage Plan section, click details.
The Configure Usage Plan page appears. - In the appropriate resource section, click edit.
The Edit Usage Plan page appears. - Make any necessary updates.
- Click Update.
Deleting Resources
You can only delete resources not in use.
- From the Service Plan Details page, in the Usage Plan section, click details.
The Configure Usage Plan page appears. - In the appropriate resource section, click delete.
A confirmation message appears. - Click Yes.
Adding Service Plan Notes
Service plan notes are included on your client’s invoices when the associated service is billed.
- From the Service Plan Details page, click add note.
The Add Service Plan Note page appears. - In the Note section, enter the note you want to display on your client’s invoice.
- Click Save or Save & New.
Managing Service Notes
Text entered as a service note displays on your client’s invoices under each service, unless the service notes are individually overridden at the service level.
- From the Service Plan Details page, in the Service Notes section, click edit or delete.
Managing Custom Welcome Letters
You can send clients a customized welcome letter for the associated service plan. This welcome letter will be specifically for the service plan you add it to. If a custom template is not set up for a service plan, the default, brand-specific template located in the Client Communications menu in the Clients settings is used.
- From the Service Plan Details page, in the Welcome Letter section, click edit.
The Edit Service Plan page appears. - In the Send Welcome Letter field, select Yes if you want to automatically send a welcome letter to your clients when this service plan is added to their account.
- In the From Address field, enter the address associated with the service plan.
In the Message Body field, enter the body of your welcome message.
Click the View Variables link to display the View Variables: Welcome Letters page that lists all the system variables you can use to customize your letters.
- Click Update.
Adding Service Modules
Service modules are custom php files that run specific code for particular service-related events. They carry out customized functions or integrate with third party systems. Ubersmith provides a number of service modules that only need to be enabled and properly configured. You can also create custom modules and uploaded them directly to your Ubersmith instance without any special code or intervention from the Ubersmith team.
Custom Service Module Examples
Configuring Bandwidth Usage Billing
Configuring Bandwidth Notification Billing
Configuring CloudStack Billing Service Module
Configuring Control Panel Account Notification Billing
Configuring Domain Management Billing
Configuring Power Circuit Billing
Configuring SolusVM VServer Management Billing
Configuring Swift Usage Billing
- From the Service Plan Details page, click add module.
The Add Service Module page appears.
Complete the Details tab
- In the Enabled field, select Yes.
- In the Module field, select the service module you want to add to the service plan.
In the Client Access field, select either No Access, View or Edit.
This setting does something different for each service module.
- Click the Config tab.
Complete the Config tab
The fields and options in this step vary depending on the selected service module. See Adding Service Modules (above) for more information.
Managing Service Modules
If a service module within an active service is disabled, the module will skip its process and the service will renew at the prescribed time. The service itself will be unaffected, only the service module code will stop and all functions written for it will be skipped.
- From the Service Plan Details page, in the Service Modules section, click edit or delete.
Copying Service Plans
- From the Service Plan Details page, click copy plan.
The Copy Service Plan page appears. - In the Service Title field, enter the name of the new service plan.
- In the Service Code field, enter the new alternative abbreviated name or number to represent the service plan. This code will display on your customers’ invoices.
- Click Copy.
Deactivating Service Plans
Deactivating a service plan does not deactivate any of its associated services. It does disable any service module. It is best practice to either also deactivate any active services or move them to a different, active service plan before deactivating the original service plan.
- From the Service Plan Details page, click deactivate.
A warning message appears. - Click Yes.
On this page: