Contracts: Difference between revisions

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
No edit summary
 
(39 intermediate revisions by 5 users not shown)
Line 1: Line 1:
A '''Contract''' in CommitCRM defines the service agreement with your customer, which helps you manage the way you charge your customer for services and track the status of the agreement. Each Contract is always related to an Account.
{{Usermanualbilling}}


CommitCRM Contracts are categorized according to their type:
A '''Contract''' in RangerMSP defines the service agreement with your customer, which helps you manage the way you charge your customer for services and track the status of the agreement. Each Contract is always related to an Account.
 
 
__TOC__
 
RangerMSP Contracts are categorized according to their type:
*Global
*Global
*Block of Time
*Block of Time
Line 7: Line 12:
*Block of Money
*Block of Money
   
   
The Contract is created based on the [[Billing_Plans|Billing Plan]] that defines the contract type, billing settings and pricing.


The contract type is set when you create a new Contract, and the system automatically tracks the status of a Contract according to the type selected. You can read more about contract types and their statuses in [[Contracts#Tracking the Contract Status|Tracking the Contract Status]].<br>Each Account can have one or more Contracts at a time for different purposes. For example, you can have a '''Block of Time''' service agreement for on-site support at the customer site, and also a '''Global''' Contract for phone support.
RangerMSP automatically tracks the status of a Contract according to the type selected. You can read more about contract types and their statuses in [[Contracts#Tracking_the_Contract_Status|Tracking the Contract Status]].<br>Each Account can have one or more Contracts at a time for different purposes. For example, you can have a '''Block of Time''' service agreement for on-site support at the customer site, and also a '''Global''' Contract for phone support.
   
   
Each Contract also has a '''Start date''' and '''End date''' which determines when the Contract is valid or expired (i.e. out of date). CommitCRM automatically selects the most valid Contract – see [[Contracts#How does the system select a Default Contract?|How does the system choose the Contract to be used]]. To view Contracts which are about to expire, go to the Reports window, select the Contracts category and generate the 'Contract List by Type and Expiration' report.
Each Contract also has a '''Start date''' and '''End date''' which determines when the Contract is valid or expired (i.e. out of date). RangerMSP automatically selects the most valid Contract – see [[Contracts#How does the system select a Default Contract?|How does the system choose the Contract to be used]]. To view Contracts which are about to expire, go to the Reports window, select the Contracts category and generate the 'Contract List by Type and Expiration' report.


Note that using Contracts is '''optional''', and should only be used if needed – see the next section, [[Contracts#When to use Contracts|When to use Contracts]].
Note that using Contracts is '''optional''', and should only be used if needed – see the next section, [[Contracts#When to use Contracts|When to use Contracts]].


If you don't have special contract terms with your customers and you bill according to ad-hoc charges per activity, you can simply use the '''Global System Contract''' which allows you to skip the Contract definition step and go straight to [[Charges]]. This System Contract is a global Contract which is automatically created for each Account so you can avoid having to create and manage contracts yourself.
If you don't have special contract terms with your customers and you bill according to ad-hoc charges per activity, you can simply use the '''Global System Contract''' which allows you to skip the Contract definition step and go straight to [[Charges]]. This System Contract is a global Contract which is automatically created for each Account so you can avoid having to create and manage contracts yourself.


== When to use Contracts ==
== When to use Contracts ==
Contracts are '''optional'''. CommitCRM Contracts are useful for managing your service contracts and tracking their statuses in the following cases:
Contracts are '''optional'''. RangerMSP Contracts are useful for managing your service contracts and tracking their statuses in the following cases:
   
   
#You have a '''service agreement''' which needs a Contract (for example a Block of Time contract, a Block of Money contract, etc.)
#You have a '''service agreement''' which needs a Contract (for example a Block of Time contract, a Block of Money contract, etc.)
Line 24: Line 31:


For more information and advanced usage tips for Contracts, see [[Project Management|Managing Projects using Contracts]] and [[Recurring Contracts|How to use Recurring Contracts]].
For more information and advanced usage tips for Contracts, see [[Project Management|Managing Projects using Contracts]] and [[Recurring Contracts|How to use Recurring Contracts]].


==Contract Fields==
==Contract Fields==
Line 69: Line 77:
| The Internal field holds internal comments about the Contract, which will be displayed only to employees (Customers viewing the Contract via the Web Interface will not see this field).
| The Internal field holds internal comments about the Contract, which will be displayed only to employees (Customers viewing the Contract via the Web Interface will not see this field).
The Internal comments are displayed when a Contract is selected for use (in a new Ticket window), and in a Ticket's Contract/Asset tab.
The Internal comments are displayed when a Contract is selected for use (in a new Ticket window), and in a Ticket's Contract/Asset tab.
|-
| Default Items
| It is possible to set default Items (per Parts, Labor or Expense) to be used when adding Charges to the Contract. Using default Items '''streamlines adding new Charges''' - the default Item will be automatically selected when creating a new Charge. The user can then modify the Item if needed.
|-
| Linked Activity Template
| Each contract in the CommitCRM system can be assigned a "Linked Activity Template." This template can be linked to a contract and applied whenever a user copies this contract to a new date range or creates a new contract based on the contract to which the template is assigned. See the [[Activity Templates]] user guide for more details.
|-
|-
| Status
| Status
Line 85: Line 87:
In a typical lifecycle, a contract will start as '''Active''', and when it passes the End Date, it will be set as '''Completed''' by the employee handling the Account.
In a typical lifecycle, a contract will start as '''Active''', and when it passes the End Date, it will be set as '''Completed''' by the employee handling the Account.


'''Suspended and Canceled''' statuses are to be used for special cases. For example, if a customer has not yes paid a debt and should not be receiving regular support, or if the payment agreement has been modified and a new Contract has been issued instead. If any of these statuses are set, the '''system will warn you when attempting to use this Contract''' for new Tickets/Charges.
By default, only Active Contracts are displayed when choosing a Contract in windows such as Charge, Ticket, etc. It is still possible to use Contracts which are not active by clicking the magnifying glass when choosing a Contract.
 
The selection list by status default behavior is managed from Tools > Options > Charges & Contracts > Hide inactive Contracts from Contract selection fields.
 
'''Suspended and Canceled''' statuses are to be used for special cases. For example, if a customer has not yet paid a debt and should not be receiving regular support, or if the payment agreement has been modified and a new Contract has been issued instead. If any of these statuses are set, the '''system will warn you when attempting to use this Contract''' for new Tickets/Charges.
|-
| Default Items
| It is possible to set default Items (per Parts, Labor or Expense) to be used when adding Charges to the Contract. Using default Items '''streamlines adding new Charges''' - the default Item will be automatically selected when creating a new Charge. The user can then modify the Item if needed.
|-
| Linked Activity Template
| Each contract in the RangerMSP system can be assigned a "Linked Activity Template." This template can be linked to a contract and applied whenever a user copies this contract to a new date range or creates a new contract based on the contract to which the template is assigned. See the [[Activity Templates]] user guide for more details.
|-
|-
| Used x out of y
| Used x out of y
Line 93: Line 105:
|-
|-
| Contract-Price Charges
| Contract-Price Charges
| The Contract Price allows you to define charges which are the actual contract payment for the contract itself. This way you can invoice your customer for the contract from within CommitCRM. You can read more about this in [[Contracts#Contract-Price Charges|Contract-Price Charge]] section.
| The Contract Price allows you to define charges which are the actual contract payment for the contract itself. This way you can invoice your customer for the contract from within RangerMSP. You can read more about this in [[Contracts#Contract-Price Charges|Contract-Price Charge]] section.
|-
|-
| Custom Pricing
| Custom Pricing
| If you define Custom Pricing for a Contract, each time you create a Charge for this Contract, CommitCRM automatically pulls up the correct custom price for it. Contract's Custom Pricing replaces the Account's Custom Pricing (if defined). You can read more about this in [[Custom Pricing]] section.
| If you define Custom Pricing for a Contract, each time you create a Charge for this Contract, RangerMSP automatically pulls up the correct custom price for it. Contract's Custom Pricing replaces the Account's Custom Pricing (if defined). You can read more about this in [[Custom Pricing]] section.
|}
|}


==Contract-Price Charges==
Contract-price Charges provide an easy-to-use and innovative way to ensure that clients get billed for the service contracts you have signed with them, whether they are recurring contracts or ad-hoc contracts/projects.


Contract-price Charges are used to charge for an amount agreed upon in a contract. For example, let’s say you sign a 50-hour (block-of-time) contract with a customer for a price of $1,000. You can then create a Contract-price Charge to represent this amount ($1,000) in the CommitCRM system. A Contract-price Charge only represents an amount listed for a contract—it does not represent a fee for specific work performed under a contract.
==Setting up Recurring Contracts==
 
RangerMSP Contracts can be configured to renew automatically.
 
<u>Technical note</u><br>
Recurring Contracts are automatically renewed and created by the 'CRM Server' Windows service that should be installed and running on your server.
In case you already use the [[Email Connector]] or [[Alerts Server]] then you can skip this section as the CRM Server service is already installed and there is nothing more you need to do besides to create a recurring Contract.  
For installation instructions please review the [[Install Server_Service|Service Setup Guide]].
 
==Recurring Contract based on a Billing Plan==
 
Click the '''New''' button to launch the New Contract wizard and select the Plan you want to based it on from the list of predefined Plans (e.g. Managed Services MSP) or create your own [[Billing Plans]] to base new Contracts on.
 
<nowiki>*</nowiki>For non-recurring/one-off Contracts select a Project/One-off Plan.
 
[[File:New_contract_wizard_step1.png]]
 


Contract-price Charges work much like other charges in CommitCRM: they are included in reports; they can be defined as Billable; and they are included in invoices. However, since Contract-price Charges do not represent specific work, they do not affect the balance of a contract block. For further explanation, see [[Contracts#Contract-price Charges: Features|Contract-Price Charges Features]] below.
Click '''Next''' to select an Account and to set the Contract Code and Name:  


===Benefits of Using Contract-price Charges ===
[[File:New_contract_wizard_step2.png]]
*'''Monitor your contracts easily and export the charge to QuickBooks.'''<br>By using Contract-price Charges, you can easily define, track, and bill for the price of a contract itself. To invoice the client, export the Contract-price Charge to QuickBooks, just like any other charge in CommitCRM.
*'''Billing for recurring services is simple.'''<br>When you renew a contract for the next billing period, Contract-price Charges are automatically transferred as well. You need only create a Contract-price Charge once for each contract, making invoicing for recurring services simple! For a more detailed description of this benefit, see the [[Contracts#Benefits of Copying Contract-price Charges|Benefits of Copying Contract-price Charges]] section.


*'''Create standard service-plan contracts.'''<br>Because Contract-price Charges are so flexible and easily copied, you can build predefined service-contract agreements and use them for contracts with new customers. For example, you can offer different plans, such as a block of 10 hours of on-site support for $250 a month, or only 5 hours of remote support for $99 a month. When signing such an agreement with a customer, all you need to do is copy the contract, and all the details and Contract-price Charges linked to this contract can be copied to the new customer as well.


*'''Flexibility in Billing for MSP Services'''<br>Users can create several Contract-price Charges for each contract. This allows great flexibility, particularly in monitoring MSP services, where devices might be added or removed on a regular basis.  For a more detailed description of this benefit, see the [[Contracts#Benefits of Copying Contract-price Charges|Benefits of Copying Contract-price Charges]] section.
Click '''Next''' to define Contract period settings:


*'''Effectively Bill for Recurring Hosted Services'''<br>Using Contract-price Charges is a great way to define the hosted services you provide to your customer. Once a service is defined in the form of a Contract-price Charge, you can easily bill for it at the beginning of a new contract period. For a more detailed description of this benefit, see the [[Contracts#Benefits of Copying Contract-price Charges|Benefits of Copying Contract-price Charges]] section.
[[File:New_contract_wizard_step3.png]]


===Creating a New Contract-price Charges===
To create a new Contract-price Charge, select the specific contract from the Contract List and open the contract’s main window. Click on the “Charges—Contract Price” tab. You can now view a list of Contract-price Charges for this contract. (To view all the charges linked to a contract, go to the “Charges—All” tab in the Contract window.)  Click the New button at the bottom of the tab. A pop-up menu now opens, asking you to select whether this is a Labor, Part, or Expense charge. After making this selection, the charge-details window opens:


[[File:contracts_price_charge_new.gif|center]]


The details window of a Contract-price Charge looks similar to other charge-details windows and contains practically all the same fields. The heading “Contract-price Charge” appears at the top of the window to differentiate between this charge and a standard charge.
Period settings for Recurring Contracts:


The following fields in the details window of a Contract-price charge have special characteristics or differ slightly from a standard charge:
*'''Auto complete & renew''' - with this option selected, when a Contract expires, the system will automatically complete it and create a new Contract for the next period.


*'''Item''' — Only unit-based items should be entered in this field, and only unit-based items appear in the drop-down selection list. For more details, see the [[Contracts#Contract-price Charges: Features|Contract-Price Charges Features]] section.
*'''Auto renew''' - with this option selected, when a Contract expires, the system will automatically create a new Contract for the next period. <br>The expired Contract can be completed manually by changing its status to ‘Completed’ or using the [[Contracts#Batch_Complete_Contracts|Batch Complete Contracts]] tool.
*'''Amount''' — In a Contract-price Charge, the Amount field refers to the Item units. For example, if you want to create a 50-hour block-of-time contract, you can either create an Item with a single block of 50 hours, or you can create an Item for a 10-hour block of time and then assign 5 units of it, getting you the same 50 hours.
*'''Employee''' — Assigning an employee to a Contract-price Charge is optional and is usually not required, as this type of charge does not represent actual work performed and, therefore, is usually not overseen by one employee. 
*'''Billable flag''' — By default, Contract-price charges are always set as Billable.  


After filling in all the details, you can save and close the window. You will now be able to see the Contract Price charge in the list. Note that this charge will appear both in the 'Charges - Contract Price' and 'Charges - All' tabs.
*'''Manual renew''' - with this option selected the Contracts will not be automatically renewed. Such contracts can nevertheless be renewed manually by copying it to the next period or by using the manual [[Recurring_Contracts|Batch Renewal Wizard]] option.




'''Adding New Items'''<br>New Items can be added directly from the Contract price–Charge window by clicking on the plus sign (+) in the Item field. A new Item window now opens:
[[File:New_contract_wizard_step3_1.png]]


===Viewing Contract-price Charges===
Click '''Next''' to set the Contract Price and define items that reflect the price of the contract. These items will be added as [[Contract-Price Charges]] thus reflecting the contract’s total price. Such Charges are automatically added when Contracts are renewed for the next period.
Contract-price Charges can only be viewed and updated by users with the necessary privileges, i.e. users who have the “Contracts—Finance” privileges (see more details on Contract-price privileges in the Contract-price Charges Privileges section).


'''Using Charges-Contract Price tab'''<br>Users with these privileges can see the Contract-price Charges in the  “Charges—Contract Price” tab:


[[File:contracts_price_charge_tab.gif|center]]
[[File:New_contract_wizard_step4.png]]


In this tab you can see all the Contract-price charges which represent the amount agreed upon in a contract.


The total contract price is displayed at the bottom part of this tab. The total billable price is the summary of all the billable Contract-price charges which appear in the list above.


'''Using Charges-All tab'''<br>You may also go to the “Charges—All” tab, which displays both "regular" charges, which are logged to record actual work performed or parts sold, as well as the Contract-price Charges. The Contract-price Charges are clearly marked, and you can sort the list according to the type of charge by clicking on the top of the Contract-price Charge column. (See the screen shot below.)
Click '''Finish''' to create the Contract.  


[[File:contracts_price_charge_all_tab.gif|center]]


===Contract-price Charges: Features===
[[File:Msp_recurring_contract_sample.png]]
Price charges behave like standard charges, meaning that they are included in reports, use the billable flag, and are included in invoices.
That said, there are some differences between the way Contract-price Charges and standard charges behave:
*'''Contract-price Charges do not affect the contract’s block balance:''' Since Contract-price charges are used for the actual payment of a contract and do not represent specific work performed under the contract, it does not affect the block balance of a contract.


*'''Contract-price charges are not linked to Tickets:''' Contract-price charges define the price to be paid for a service-agreement contract and do not represent specific work performed. Therefore, they cannot be linked to a specific ticket.


*'''Contract-price Charges are automatically defined as Billable:''' A new Contract-price Charge is set as Billable by default, as the system assumes that the contract payment should be billed to the customer. This status can be modified by the user, if necessary.


*'''Contract-price Charges do not refer to a specific time:''' The details window of a Contract-price charge does not include the “From Time” or “To Time” fields, as these are irrelevant for this type of charge.


*'''Contract-price Charges use only unit-based items:''' Like any other charge, each Contract-price charge should be linked to an Item. However, Contract-price Charges can use only unit-based Items (as opposed to hourly Items), since they reflect a purchase of a service in units rather than work actually performed. For further explanation, see the box below.
==New custom Contract==




'''Why do Contract-price Charges use only unit-based Items?'''<br>When defining items, users can define each Item with a price that can be either be unit-based or hourly-based. This classification can then be used in charges, to log work by hours or by service (by unit).
The Contract can be created without the Billing Plan. It is useful in case the [[Contracts#Custom_Pricing_for_Contracts|Contract Prices]] and [[Contracts#Custom_Settings_for_Contracts|Settings]] should be set specifically at the Contract without inheriting those from the Plan.  


When assigning Items to Contract-price Charges, only unit-based items can be used. The system is set up this way in order to prevent situations in which Contract-price Charges affect employees’ hourly reports. By using unit-based charges, you can add charges to the system without influencing the employee's hourly summary charge reports.
Click the '''New''' drop down in the Contracts window and select '''New Contract (custom)''':


For example, in order to charge for a block of 50 hours, you should add a Labor Item that is a unit- based “block of 50 hours” rather than adding an hour-based Item that sets the charge for 50 hours. This method actually helps to keep the data accurate as hours Charges should only be added to describe actual work performed or time actually spent.


===Invoicing Contract-price Charges===
[[File:New_custom_contract_option1.png]]
Contract-price Charges allow you to define charges that represent the payment for the contract itself. These charges function like regular charges, meaning that they are included in reports, use the billable flag, and are included in invoices.


By creating a Contract-price Charge, you can invoice your customer for a contract (or portion of a contract) from within CommitCRM and export the charge to QuickBooks, as you would any other charge. Since this type of charge is set as Billable, it is considered a charge that should be billed for, and users can create invoices for these charges using CommitCRM’s invoice-creation wizard (from File > New > QuickBooks Invoice), as they would any other charge.


[[File:contracts_price_charge_invoice.gif|center]]
OR


Note that the invoice lines include both standard and Contract-price charges, so you can bill for the Contract-price charge like any other charge and monitor all invoices from within CommitCRM.
use the option '''New - Custom''' under the Contracts menu:


===Contract-price Charges in Reports===
By default, Contract-price charges are included by in Charge reports. You can choose to omit Contract-price Charges from reports or even create a report with Contract-price Charges only. To filter a report according to this parameter, choose the report you want from the Reports List and press “Generate.” This opens the Report Generation window, where you can set the parameters of a report.


[[File:contracts_price_charge_report_filter.gif|center]]
[[File:New_custom_contract_option2.png]]


The options in this window can be very helpful in generating many types of reports. There is also a special drop-down list in which you can decide to include or exclude Contract-price Charges from a report, or even create a report using Contract-price Charges only. (See screen shot above.) For example, if you wish to generate a Charge Report that lists all the actual work performed for a certain contract, you should not include the Contract-price Charges in this report. In this case, you should select the “Do not include Contract-price Charges” option.
==Assign an existing Contract to a Billing Plan==


In other cases, you may want to check the cash flow from contract agreements. In this case you can generate a report by selecting the “Include Contract-price Charges only” option.
Click '''Assign Plan''' link under the Contract General tab and select the Billing Plan from the list:


===Copying and Renewing Contracts with Contract-Price Charge===
Copying contracts is useful for renewing a completed contract or for using a pre-existing contract with another customer who receives similar terms. When copying the contract, it is also possible to automatically copy the Contract-price Charges along with the contract you are copying. This is useful in order to automatically bill the customer for the newly created contract.


Copying contracts can be done in two ways:
[[File:Assign_plan_to_contract.png]]
*'''Renewing Contracts With the Batch Copy Wizard''', which copies a group of contracts to the next date ranges. This method is generally used to renew contracts for the same customers. Note that if you are not familiar with the Batch Copy Wizard, it is recommended to review the [[Recurring Contracts]] section first. You can also watch the [http://www.commitcrm.com/videos/commit_contracts_batch_copy_wizard_video.htm Copying Recurring Contracts video] to familiarize yourself with the contract-renewal process.


*'''Using the manual single copy''', which copies one contract at a time. This method is generally used to create a new contract for a different customer.


==Changing the Billing Plan for Contracts==


'''Copying Contract-price charges when using the Batch Copy Wizard'''<br>When copying contracts to the next date range using the Batch Copy Wizard, the system suggests copying the Contract-price Charges along with the newly-renewed contract. This way you can easily generate an invoice for the new contract.


In one of the steps when using the Batch Copy Wizard you will be asked whether you want to include the Contract-price Charge(s) along with the contract you are copying. You may choose to copy these charges or not to. You will also be asked to choose the date of the newly-copied charge from a drop-down list. The dates are relative to the contract start/end date. The Contract-price Charges are copied as-is from the existing contract, including the items, prices, amounts, etc.
Click the arrow to change the Plan for the Contract or unassign the Plan from the Contract:


[[File:contracts_price_charge_copy_batch.gif|center]]


[[File:Change_plan_on_contract.png]]


'''Copying Contract-price charges when copying a single contract'''<br>Here you are given the choice to copy the Contract-price Charges to the new charge. You are also asked to determine the charged date for the newly-created Contract-price Charges.


[[File:contracts_price_charge_copy_single.gif|center]]
==Setting an existing Contract to auto-renew==


The dates are relative to the contract start/end date. The Contract-price Charges are copied as-is from the existing contract, including the items, prices, amounts, etc.
Select the option '''Auto Complete & Renew''' under the Contract General Tab:


Once copied, the newly-created Contract-price Charges now appear in the new contract's “Charges—Contract Price” tab. 


[[File:Set_contract_as_auto_renew.png]]


'''Custom Pricing'''<br>Note that any [[Custom Pricing]] that is defined for the target account will not apply to the copied charges, and they will be with fixed prices as-is. You can find more information on this subject under Contract-price Charges and Custom Pricing section.


====Benefits of Copying Contract-price Charges====
Configure the Contract Renewal Settings:  
Copying Contract-price charges along with the contract provides you with the following benefits:


*'''Billing for recurring services:'''<br>Let’s say you wish to automatically bill your customers for the fixed monthly service that includes a block of 5 hours each month. All you need to do is create the Contract-price Charge for this amount once. When you renew this contract by copying it to the next date range, the Contract-price Charge can also be copied to the new contract, and there is no need to worry about entering the charge each month.


[[File:Contract_renewal_settings.png]]


*'''Creating standard service-plan contracts:'''<br>Because Contract-price Charges are so flexible and easily copied, you can build predefined service-contract agreements and use them for contracts with new customers.<br><br>For example, you can offer different plans, such as a block of 10 hours of on-site support for $250 a month, or only 5 hours of remote support for $99 a month. When signing such an agreement with the customer, all you need to do is copy the contract and all details and Contract-price Charges can be copied to the new customer.


==Manage Contract Recurrence Settings==


*'''Billing for MSP services:'''<br><br>Users can create several Contract-price Charges for each contract. This allows great flexibility, particularly in monitoring MSP services, where devices might be added or removed on a regular basis.<br><br>Let's say a customer signs up for the following services:<br>24x7 server monitoring, for 5 servers<br>Patch management, firewall monitoring, and backup monitoring, for 50 PCs<br><br>You can add Contract-price Charges as follows:<br>1. Add a Contract-price Charge for the 5 servers.<br>2. Add another Contract-price Charge for the monitoring of the 50 PCs.<br>Now let's say that in the middle of a contract, the client asks you to monitor 10 more PCs. You can then update the Contract-price Charge with the additional 10 PCs. When you renew the contract, the most updated Contract-price Charge will be copied, and you will be automatically billing the customer with the most up-to-date agreement details.
* Use the link to open the renewal settings window: <br><br>[[File:Manage_contract_renewal.png]]
*Use the '''Add Periods''' link to add more periods.
*Use '''Delete''' link to delete last/all periods
*Set the Contract to '''Auto Renew''' only or '''Auto Complete & Renew'''.  




*'''Billing for recurring hosted services:'''<br>Once a hosted service is defined in the form of a Contract-price Charge, you can easily bill for it at the beginning of a new contract period. The Contract-price Charges can include all the hosted services and their price. For example:
[[File:Manage_contract_renewal2.png]]
2 X domain hosting @ 9$/domain
15 X hosted e-mail accounts @ $15/account
10 X Anti-spam and antivirus service e-mail accounts @ $9/account.
Using this method, you can easily see which services the contract includes and easily bill the customer accordingly.


===Contract-price Charges and Custom Pricing===
Custom pricing for accounts and contracts allow you to use special prices for items and employees associated with this customer.


When creating Contract-price Charges, if this contract or user has custom pricing defined for it, then these custom prices will be used for these charges.


[[File:contracts_price_charge_custom.gif|center]]


Note that when copying the contract together with the Contract-price Charges, the charge’s prices will be copied as-is. This means that if you copy the contract to a different account that has predefined custom pricing, the custom prices will not be affect the copied Contract-price Charges. The system always assumes the all charges in the tab—exactly as they are—represent the price of the contract. You can always adjust the charges after copying them, if necessary.
==Contract-Price Charges==
Contract-price Charges provide an easy-to-use and innovative way to ensure that clients get billed for the service contracts you have signed with them, whether they are recurring contracts or ad-hoc contracts/projects.


===Contract-price Charges Privileges===
Contract-price Charges are used to charge for an amount agreed upon in a contract. For example, let’s say you sign a 50-hour (block-of-time) contract with a customer for a price of $1,000. You can then create a Contract-price Charge to represent this amount ($1,000) in the RangerMSP system. A Contract-price Charge only represents an amount listed for a contract—it does not represent a fee for specific work performed under a contract.
Contract-Price Charges are considered administrative, financial information, and therefore users require specific privileges in order to work with them. In order to work with Contract-price Charges, a user must be assigned all of the following privileges.


*'''Charges Incl. Finance:''' This allows a user to view financial information, such as Items and Contract-price Charges.
Contract-price Charges work much like other charges in RangerMSP: they are included in reports; they can be defined as Billable; and they are included in invoices. However, since Contract-price Charges do not represent specific work, they do not affect the balance of a contract block. For further explanation, see [[Contract-Price Charges#Contract-Price Charges: Features|Contract-Price Charges Features]] below.
*'''Contracts—Manage:''' This allows access the Contracts window and lets a user view all details.  
*'''Contracts—Finance:''' This allows a user to update the contract block and to add Contract-price Charges


[[File:contracts_price_charge_privileges.gif|center]]
See [[Contract-Price Charges]].


A system administrator can assign these privileges to a user by going to File Menu > Users & Privileges. You can read more about assigning privileges in the Setup Guide under [[Employees#Employee Privileges Group |Employee Privileges Group]].


==Tracking the Contract Status==
==Tracking the Contract Status==
Line 280: Line 257:
{| id="mp-tfp" style="margin:7px 0 0 0; width:100%; background:none;"
{| id="mp-tfp" style="margin:7px 0 0 0; width:100%; background:none;"


| class="MainPageBG" style="width:50%; border:1px solid #FFCB99; background:#ffffff; vertical-align:top; color:#000;" |
{| id="mp-left" cellpadding="2" cellspacing="5" style="width:100%; vertical-align:top; background:#ffffff;"
! <h2 id="mp-tfa-h2" style="margin:0; background:#fff3e1; font-size:120%; font-weight:bold; border:1px solid #FFCB99; text-align:left; color:#000; padding:0.2em 0.4em;">Tip
|-
| style="color:#000;" | <div id="mp-tfa">Learn more about the various contract types and how each can be used by watching the contract videos on [http://www.commitcrm.com/support_videos.htm#contracts our Web site.] </div>
|}
|}


==Custom Pricing  for Contracts==
==Custom Pricing  for Contracts==
Custom Pricing lets you set special pricing for different Accounts or Contracts. Once you define custom prices for an Account or Contract, these prices will be used automatically for every charge logged for Accounts or Contracts. You can also manually adjust the prices while creating a charge.
Custom Pricing lets you set special pricing for different Accounts, Billing Plans or Contracts.  
 
For Contract assigned to a Billing Plan, custom pricing can be managed as part of the Plan and overrides system settings. In cases where the plan custom pricing is not used, the relevant customer’s custom pricing settings apply. For more information see [[Billing_Plans#Plan_Custom_Pricing|Plan Custom Pricing]]. 
 
Once you define custom prices for an Account, a Billing Plan or a Contract, these prices will be used automatically for every charge logged for Accounts or Contracts. You can also manually adjust the prices while creating a charge.


You can read more about this under [[Custom Pricing]].
You can read more about this under [[Custom Pricing]].
==Custom Settings for Contracts==
The Custom Settings for Contracts provide much more flexibility when defining your contracts. The variations and options can help you to provide better service, with a more accurate and easier billing workflow (e.g. better MSP coverage for recurring Contracts).
The Custom Settings for Contracts include: Item Group permissions and Billable flag settings for Global Contracts.
For Contracts assigned to a Billing Plan, custom pricing can be managed as part of the Plan. You can read about Billing Plan Setting [[Billing_Plans#Plan_Settings|here]].
'''Item Group permissions'''<br>
The Item settings allow you to select which Items can or cannot be logged for Charges under this Contract. The settings include whether Labor, Expense or Part Item groups are allowed or not. Exceptions for specific Items can be added.
'''Billable Flag Settings for Global Contracts'''<br>
You can set default values for the Billable flag, based on the Item group. This way you can choose which items are covered by the contract, and which are not, and should be billed. Note that for other Contract types (i.e. block contracts), the billable flag is determined automatically by the system according to the contract type.
'''Usage example:'''<br>
You offer a monthly recurring Contract for services you provide. The contract covers phone and remote support but does not cover on-site work, nor any expenses or parts.
Defining your contract:
#Contract defined: Global Contract.
#Define the recurring price using [[Contract-Price_Charges|Contract-Price Charges]] .
#Do not allow Parts and Expense Items to be used.
#Allow Labor Items.
#Set the contract’s Billable flag behavior for Labor Items to – Billable.
#Then add two Labor Item exceptions for ‘Phone Support’ and ‘Remote Support’ and set their Billable flag to ‘Not Billable’ (i.e. covered).
This way, parts and expense Items cannot be logged as Charges under this contract. The phone/remote support services will be covered while any other type of labor charges will be billed.
To define Custom Contract settings go to the Contract’s Custom Settings tab: <br>
[[File:Custom_settings_for_contract.png]]
==Default SLA for Contracts==
The SLA feature in RangerMSP helps you provide services to your customers within the time frame agreed with them. It provides an easy way to define the time-to-deliver of your Service-Level Agreements (SLA) with the customer and apply them to Tickets Due Date automatically.
A default SLA can be set to Accounts or Contracts, thus automatically applied to Tickets created under the Account or Contract.
<br><br>
To assign a default SLA to a Contract:
# Open the Contract Details tab.
# Select the SLA you want to use in the 'Detault SLA for new Tickets' field.
# Click Save to save your changes.
<br>
''Note'':
Contract settings override Account settings. So, if both the Account and the Contract have a default SLA defined, Tickets created under this Contract will be assigned with Contract's SLA. Account SLA will be ignored in this case.
<br><br>
See [[SLA#Default SLA for Accounts and Contracts|Default SLA for Accounts and Contracts]] in the main [[SLA|SLA user guide]] for more details.
<br><br>


==Activity Templates for Contracts==
==Activity Templates for Contracts==
Each contract in the CommitCRM system can be assigned a "Linked Activity Template." This template can be linked to a contract and applied whenever a user copies this contract to a new date range or creates a new contract based on the contract to which the template is assigned.
Each contract in the RangerMSP system can be assigned a "Linked Activity Template." This template can be linked to a contract and applied whenever a user copies this contract to a new date range or creates a new contract based on the contract to which the template is assigned.




Line 316: Line 336:
When no Contracts have been created for an Account, or when there are no other active Contracts, the 'Global System Contract' will be used automatically. This is a Contract that is created for each Account by default.
When no Contracts have been created for an Account, or when there are no other active Contracts, the 'Global System Contract' will be used automatically. This is a Contract that is created for each Account by default.


Note that this is especially useful for recurring contracts (e.g. Monthly Contracts), because CommitCRM will use a new copy of the previous Contract (which is valid for the next date range (see [[Recurring Contracts]]). In this case, the Account will have several copies of the Contract with different date ranges. The system will only start automatically selecting the Contract with the new date ranges when the previous Contract expires.
Note that this is especially useful for recurring contracts (e.g. Monthly Contracts), because RangerMSP will use a new copy of the previous Contract (which is valid for the next date range (see [[Recurring Contracts]]). In this case, the Account will have several copies of the Contract with different date ranges. The system will only start automatically selecting the Contract with the new date ranges when the previous Contract expires.
 
Note: The system does not select a [[Project_Management|Project Contract]] if there is another active and current Contract for an Account. Project Contracts are not considered as relevant active contracts for routing billing.
 


===Forcing a Default Contract for an Account===
===Forcing a Default Contract for an Account===
You can set a default Contract for an Account, which will always be used by default when adding new Tickets or Charges to the Account.  This option should be used only in cases where you always want to use the selected contract. '''We do not recommend using this option unless necessary.'''
You can set a default Contract for an Account, which will always be used by default when adding new Tickets or Charges to the Account.  This option should be used only in cases where you always want to use the selected contract. '''We do not recommend using this option unless necessary.'''


To manually set the default contract for an Account, open the Accounts window, navigate to the relevant Account record, click on the Contracts tab, select the Contract you want to set as default, right-click on it > Default Contract > 'Set selected contract as the default contract for this account'.
To manually set the default contract for an Account, open the Accounts window, navigate to the relevant Account record, click on the Contracts tab, select the Contract you want to set as default, right-click on it > Default Contract > ''Set selected contract as the default contract for this account''.
 
<br>
[[File:Set_default_contract_for_account.png]]
 
<br>
 
===Setting a Contract series as the default Contract for the Account===
You can set a Contract series as the default for the Account and RangerMSP will automatically pick the correct Contract from the series when adding new Ticket or Charges to the Account.
 
To manually set the default contract for an Account, open the Accounts window, navigate to the relevant Account record, click on the Contracts tab, select the Contract you want to set as default, right-click on it > Default Contract > ''Set the selected contract series as the default contract for this account''.
 
<br>
[[File:Set_default_contract_series_for_account.png]]
 
<br>
 
===Closing a Contract forcefully marked as the Default===
RangerMSP will not let you mark a default contract for an account as closed, since closed contracts cannot be default contracts for Accounts. In order to select a different default contract for these accounts, you will need to follow these steps:
*Go to the '''Accounts screen'''.
*Choose '''Select an account'''.
*Choose '''Contracts tab'''.
*Select a new contract.
*Right click the new Contract.
*Select '''Default Contract'''.
*Choose '''Set Selected Contract''' or '''Automatically Select'''.
<br>
Once you’ve selected a different contract than the one you’re closing as the default contract for that account, you’ll be able to mark the contracts you were trying to close as closed.
*As an alternative to selecting a specific contract as the default contract, you can set the option to have the system automatically choose the relevant contract based on time and f other valid contracts are available.
 
<br>


==Copying Contracts==
==Copying Contracts==
Line 331: Line 384:
#The contract's default activity template, while applying the activities for the newly created contract
#The contract's default activity template, while applying the activities for the newly created contract


Copying contracts can be done in two ways:
Copying contracts can be done in two ways: Using the Batch Copy Wizard or copying a single Contract. In both cases the Contract general details and linked information (such as Contract-Price Charges and Activity Templates) can be copied to the new Contract.
<br><br>
To copy a Single Contract, open the Contract window and click the ''Copy'' button from the toolbar.
<br>To use the batch copy, go to ''Contracts > Batch Copy Contract for New Date Range''.
<br><br>
Additional information about copying Contracts:
* Learn more about renewing contracts in [[#Renewing Contracts With the Batch Copy Wizard|Renewing Contracts With the Batch Copy Wizard]].
* Learn more about copying Contract-price charges along with the contract in [[Contracts#Copying and Renewing Contracts with Contract-Price Charge|Copying and Renewing Contract with Contract-Price Charges]].
* Learn more about copying activity templates along with the contract in [[Activity Templates#Copying Contracts With Linked Activity Templates|Copying Contracts With Linked Activity Templates]].
<br>
==Renewing Contracts With the Batch Copy Wizard==
The Batch Copy Wizard copies a group of contracts to the next date ranges. This method is generally used to renew contracts for the same customers.
 
To learn more about renewing Contracts:
* Learn more in the [[Recurring Contracts]] section first.
 
<br><br>
 
==Deleting Contracts==
Normally if you used Contract you probably do not want to delete it, in order to keep you database complete with all of your history. <br>'''Best practice''' in case you don't want to use a Contract anymore is simply to '''deactivate it by changing the Contract Status field from the General tab.
 
<br>
Having said that, if you do want to delete a Contract (for example, if it is a test Contract that you do not want to affect your database), select the Contract in the list, and use Contracts > Delete option.
 
'''Important Note:'''
Contracts that are linked to existing Charges cannot be deleted, to keep the data integrity.
 
In this case, to delete a Contract, you should first delete all linked Charges. To find which Charges are linked to this Contract:
# Open the Contract window.
# Click the Charges - All tab.
# All Charge records linking to this Contract will be displayed and you can delete them one by one.
 
Only after deleting all the Charges that were created with this Contract, the system will let you delete the Contract.''
''
<br><br>
 
== Batch Complete Contracts ==
The ''Batch Complete Contracts'' tool completes a group of selected Contracts. Use this option to complete Contracts which are expired either because their date has expired or because the block is empty. The Contracts should usually be completed only after renewing them (when managing recurring Contracts).
 
Related topics:
* [[Recurring Contracts]].
* [[Contracts#Renewing_Contracts_With_the_Batch_Copy_Wizard|Renewing Contracts With the Batch Copy Wizard]].
 
 
To run the Batch Complete Contracts utility, go to the Contracts window and from the menu bar choose ''Contracts > Batch Complete Contracts''.
 
The following window opens:
 
[[File:Batch_complete_contracts.gif]]
 
In this window, you can filter the Contracts list either by End Date or an empty block, select the Contracts you wish to complete and then confirm to perform the action.
 
See more details in the steps process below.
 
* '''Show Contracts of Type''' - You must first choose the Contract type you wish to update. The filtering criteria changes according to the Contract type. 
* '''Filter completed Contracts by''' - 
** End Date – Contracts with an End Date smaller or equal to the date you choose.
**  Block Empty – Available for block Contracts: Block of Time, Block of Money and Block of Tickets.
**  Block is Empty and by End Date – Also available for block Contracts only.
 
* '''Hide Contracts that were not renewed yet''' – Select this option if you want to Complete only Contracts that have already been renewed. <br> ''Note: If a Contract is completed, and there are no new contracts valid for this Account, the system will automatically default to the System Global Contract without alerting you that the Account has no current valid Contracts. Leaving such Contracts open until you take care of the renewal means you will be alerted when using such an expired Contract.''
 
* '''Click Refresh or hit Enter''' to see the results in the Contracts list.
 
* '''Choose the Contracts''' you actually want to complete from the filtered list. You can use the Select All and Clear All buttons for quick selection.
 
* '''Click OK''' to perform the action and complete all the chosen Contracts. This action will update the Status to Completed for all the chosen Contracts.


Once done, all the Contracts in the list will be updated and their status will be set as 'Completed'.


'''Renewing Contracts With the Batch Copy Wizard'''<br>This option copies a group of contracts to the next date ranges. This method is generally used to renew contracts for the same customers. Note that if you are not familiar with the Batch Copy Wizard, it is recommended to review the [[Recurring Contracts]] section first. You can also watch the [http://www.commitcrm.com/videos/commit_contracts_batch_copy_wizard_video.htm Copying Recurring Contracts video] to familiarize yourself with the contract-renewal process.




'''Using the manual single copy'''<br>This option copies one contract at a time. This method is generally used to create a new contract for a different customer.
== Labels ==


Contracts can have default [[Labels]] defined so that all Tickets created under a specific Contract will have the default labels applied automatically. See full details on default Labels [[Labels#Default_Labels|here]].


You can find more information on copying Contract-price charges along with the contract in the [[Contracts#Copying and Renewing Contracts with Contract-Price Charge|Copying and Renewing Contract with Contract-Price Charges]] section. Copying Contract-price charges along with the contract provides you with many [[Contracts#Benefits of Copying Contract-price Charges|benefits]].


You can also find more information on copying activity templates along with the contract and creating the activities automatically in the Activity Templates user Guide, under [[Activity Templates#Copying Contracts With Linked Activity Templates|Copying Contracts With Linked Activity Templates]] section.
<br><br>


==See Also==
==See Also==
Line 349: Line 468:
*[[Charges]]
*[[Charges]]
*[[Custom Pricing]]
*[[Custom Pricing]]
*[[Contract-Price Charges]]
*[[Recurring Contracts]]
*[[Activity Templates]]
*[[Activity Templates]]
*[[Videos]]
*[[Contracts FAQ]]
*[[To-do Lists]]
[[Category:User Manuals]]
[[Category:User Manuals]]
[[Category:Billing]]
[[Category:Billing]]

Latest revision as of 08:05, 8 July 2020

User Manuals | Billing | Contracts

A Contract in RangerMSP defines the service agreement with your customer, which helps you manage the way you charge your customer for services and track the status of the agreement. Each Contract is always related to an Account.


RangerMSP Contracts are categorized according to their type:

  • Global
  • Block of Time
  • Block of Tickets
  • Block of Money

The Contract is created based on the Billing Plan that defines the contract type, billing settings and pricing.

RangerMSP automatically tracks the status of a Contract according to the type selected. You can read more about contract types and their statuses in Tracking the Contract Status.
Each Account can have one or more Contracts at a time for different purposes. For example, you can have a Block of Time service agreement for on-site support at the customer site, and also a Global Contract for phone support.

Each Contract also has a Start date and End date which determines when the Contract is valid or expired (i.e. out of date). RangerMSP automatically selects the most valid Contract – see How does the system choose the Contract to be used. To view Contracts which are about to expire, go to the Reports window, select the Contracts category and generate the 'Contract List by Type and Expiration' report.

Note that using Contracts is optional, and should only be used if needed – see the next section, When to use Contracts.

If you don't have special contract terms with your customers and you bill according to ad-hoc charges per activity, you can simply use the Global System Contract which allows you to skip the Contract definition step and go straight to Charges. This System Contract is a global Contract which is automatically created for each Account so you can avoid having to create and manage contracts yourself.


When to use Contracts

Contracts are optional. RangerMSP Contracts are useful for managing your service contracts and tracking their statuses in the following cases:

  1. You have a service agreement which needs a Contract (for example a Block of Time contract, a Block of Money contract, etc.)
  2. You use recurring service agreements, such as monthly billing. See a more detailed explanation in Recurring Contracts.
  3. You manage complex Projects which include various Tasks and Charges. For example, you are building a new network infrastructure for a customer with various hardware and software installations.

For more information and advanced usage tips for Contracts, see Managing Projects using Contracts and How to use Recurring Contracts.


Contract Fields

The following table explains the Contract fields and their usage:

Field Description
Contract Type (mandatory) A Contract can be created under one of the following types:
  • Global
  • Block of Time
  • Block of Tickets
  • Block of Money

The contract type is set when you create a new Contract, and the system automatically tracks the status of contracts according to their type. Read more about Tracking the Contract Status|Tracking the Contract Status.

When adding Charges for a Contract, the Billing flag will be automatically set according to the Contract type. You can read more in How is the 'Billable flag' determined.

Contract Code (mandatory) The Code field is the unique ID of a Contract, which can contain numbers and letters as desired.

The Code field is used for the following:

  • Easily selecting a Contract for Charges, Ticket etc. by typing its code in the Contract field, rather than clicking on the magnifying glass and searching for it
  • If you use a sortable notation for the codes, you can easily sort your Contracts and Charge reports. For example, you can group several contracts of an Account (like 1550-P001 and 1550-P002) so that you can see them together or print Charge reports together (note that Charge reports can be filtered by a Contract Code Range – this can be very helpful in many cases)
  • You can use the Contract's sub-code to differentiate between identical contracts for differing date ranges (see Recurring Contracts).
Contract Name (mandatory) The Name field describes the purpose of the Contract. This field is displayed whenever viewing the Contract in various windows (e.g. when creating a new Ticket).

The Contract Name is a non-unique identifier (you may have several Contracts with the same name).

Start Date (mandatory) Indicates the date the Contract starts being active and can be used for Charges/Tickets..
End Date (mandatory) Indicates the date the Contract stops being active and should not be used for Charges anymore. The system will warn the user when an expired Contract is being used for a Ticket/Charge.

Also, the system will automatically select the most appropriate Contract according to the relevant dates. Read more about How does the system select a default Contract.

Description The Description (Desc.) field holds the description of this specific Contract. The Description is displayed whenever selecting to use this Contract (in a new Ticket window) and in the Ticket's Contract/Asset tab.
Internal The Internal field holds internal comments about the Contract, which will be displayed only to employees (Customers viewing the Contract via the Web Interface will not see this field).

The Internal comments are displayed when a Contract is selected for use (in a new Ticket window), and in a Ticket's Contract/Asset tab.

Status The status field may contain the following possible values:
  • Active
  • Suspended
  • Canceled
  • Completed

In a typical lifecycle, a contract will start as Active, and when it passes the End Date, it will be set as Completed by the employee handling the Account.

By default, only Active Contracts are displayed when choosing a Contract in windows such as Charge, Ticket, etc. It is still possible to use Contracts which are not active by clicking the magnifying glass when choosing a Contract.

The selection list by status default behavior is managed from Tools > Options > Charges & Contracts > Hide inactive Contracts from Contract selection fields.

Suspended and Canceled statuses are to be used for special cases. For example, if a customer has not yet paid a debt and should not be receiving regular support, or if the payment agreement has been modified and a new Contract has been issued instead. If any of these statuses are set, the system will warn you when attempting to use this Contract for new Tickets/Charges.

Default Items It is possible to set default Items (per Parts, Labor or Expense) to be used when adding Charges to the Contract. Using default Items streamlines adding new Charges - the default Item will be automatically selected when creating a new Charge. The user can then modify the Item if needed.
Linked Activity Template Each contract in the RangerMSP system can be assigned a "Linked Activity Template." This template can be linked to a contract and applied whenever a user copies this contract to a new date range or creates a new contract based on the contract to which the template is assigned. See the Activity Templates user guide for more details.
Used x out of y When the Contract is a "Block of…" contract, the field next to the Contract status will show the status of the block. For example, a Block of Time Contract will display the amount of used hours out of the block (for example "Used 3 out of 15 hours").

When the Contract exceeds it's terms, this text will appear in red.

Contract-Price Charges The Contract Price allows you to define charges which are the actual contract payment for the contract itself. This way you can invoice your customer for the contract from within RangerMSP. You can read more about this in Contract-Price Charge section.
Custom Pricing If you define Custom Pricing for a Contract, each time you create a Charge for this Contract, RangerMSP automatically pulls up the correct custom price for it. Contract's Custom Pricing replaces the Account's Custom Pricing (if defined). You can read more about this in Custom Pricing section.


Setting up Recurring Contracts

RangerMSP Contracts can be configured to renew automatically.

Technical note
Recurring Contracts are automatically renewed and created by the 'CRM Server' Windows service that should be installed and running on your server. In case you already use the Email Connector or Alerts Server then you can skip this section as the CRM Server service is already installed and there is nothing more you need to do besides to create a recurring Contract. For installation instructions please review the Service Setup Guide.

Recurring Contract based on a Billing Plan

Click the New button to launch the New Contract wizard and select the Plan you want to based it on from the list of predefined Plans (e.g. Managed Services MSP) or create your own Billing Plans to base new Contracts on.

*For non-recurring/one-off Contracts select a Project/One-off Plan.


Click Next to select an Account and to set the Contract Code and Name:


Click Next to define Contract period settings:


Period settings for Recurring Contracts:

  • Auto complete & renew - with this option selected, when a Contract expires, the system will automatically complete it and create a new Contract for the next period.
  • Auto renew - with this option selected, when a Contract expires, the system will automatically create a new Contract for the next period.
    The expired Contract can be completed manually by changing its status to ‘Completed’ or using the Batch Complete Contracts tool.
  • Manual renew - with this option selected the Contracts will not be automatically renewed. Such contracts can nevertheless be renewed manually by copying it to the next period or by using the manual Batch Renewal Wizard option.


Click Next to set the Contract Price and define items that reflect the price of the contract. These items will be added as Contract-Price Charges thus reflecting the contract’s total price. Such Charges are automatically added when Contracts are renewed for the next period.



Click Finish to create the Contract.




New custom Contract

The Contract can be created without the Billing Plan. It is useful in case the Contract Prices and Settings should be set specifically at the Contract without inheriting those from the Plan.

Click the New drop down in the Contracts window and select New Contract (custom):



OR

use the option New - Custom under the Contracts menu:


Assign an existing Contract to a Billing Plan

Click Assign Plan link under the Contract General tab and select the Billing Plan from the list:



Changing the Billing Plan for Contracts

Click the arrow to change the Plan for the Contract or unassign the Plan from the Contract:



Setting an existing Contract to auto-renew

Select the option Auto Complete & Renew under the Contract General Tab:



Configure the Contract Renewal Settings:



Manage Contract Recurrence Settings

  • Use the link to open the renewal settings window:

  • Use the Add Periods link to add more periods.
  • Use Delete link to delete last/all periods
  • Set the Contract to Auto Renew only or Auto Complete & Renew.




Contract-Price Charges

Contract-price Charges provide an easy-to-use and innovative way to ensure that clients get billed for the service contracts you have signed with them, whether they are recurring contracts or ad-hoc contracts/projects.

Contract-price Charges are used to charge for an amount agreed upon in a contract. For example, let’s say you sign a 50-hour (block-of-time) contract with a customer for a price of $1,000. You can then create a Contract-price Charge to represent this amount ($1,000) in the RangerMSP system. A Contract-price Charge only represents an amount listed for a contract—it does not represent a fee for specific work performed under a contract.

Contract-price Charges work much like other charges in RangerMSP: they are included in reports; they can be defined as Billable; and they are included in invoices. However, since Contract-price Charges do not represent specific work, they do not affect the balance of a contract block. For further explanation, see Contract-Price Charges Features below.

See Contract-Price Charges.


Tracking the Contract Status

An Active Contract can exceed the Contract terms, depending on the Contract type. Each Contract type has its own limitations and once the Charges or Tickets added to the Contract exceeds the limit, the system warns the user before adding any more Charges/Tickets.

The Contract Type is set when you create a new Contract, and the system automatically tracks the status of contracts according to their type:

  1. Global - The Global Contract allows the use of an unlimited number of Charges of any type. The only limitation for Global Contracts is the contract end date. A typical usage for this type would be a phone service contract which is valid for one year.
  2. Block of Time - Block of Time Contracts are suitable for contracts that agree upon a limited and predefined block of service time. Each Charge added to this Contract will decrease the time remaining for this Account.
  3. Block of Money - Block of Money Contracts are suitable for contracts that agree upon a limited and predefined sum of Money or for "all-included" service agreements. Each Charge added to this Contract will be deducted from the original sum of money.
  4. Block of Tickets - Block of Tickets Contracts are suitable for contracts that agree upon a limited and predefined block of service Tickets. Each Ticket added to this Contract will subtract one Ticket from the original block of Tickets.

Certain charges will automatically be deducted from the contract, such as the addition of a new Charge to a Block of Time Contract, which will reduce the remaining time in the Contract. This also applies to money in a Block of Money contract, and so on.

When you create a Ticket under an active Contract, the system will warn you if the contract terms are out of date, for example, if the Block of Time allocated has already been used or if the end date has passed.

You can see the current status of the Contract in the Contract General tab, near the Status field (for example "Used 3 of 12 Hours"). In case the Contract has exceeded its terms, the status will appear in red (for example "Used 13 of 12 Hours").

Custom Pricing for Contracts

Custom Pricing lets you set special pricing for different Accounts, Billing Plans or Contracts.

For Contract assigned to a Billing Plan, custom pricing can be managed as part of the Plan and overrides system settings. In cases where the plan custom pricing is not used, the relevant customer’s custom pricing settings apply. For more information see Plan Custom Pricing.

Once you define custom prices for an Account, a Billing Plan or a Contract, these prices will be used automatically for every charge logged for Accounts or Contracts. You can also manually adjust the prices while creating a charge.

You can read more about this under Custom Pricing.


Custom Settings for Contracts

The Custom Settings for Contracts provide much more flexibility when defining your contracts. The variations and options can help you to provide better service, with a more accurate and easier billing workflow (e.g. better MSP coverage for recurring Contracts). The Custom Settings for Contracts include: Item Group permissions and Billable flag settings for Global Contracts.

For Contracts assigned to a Billing Plan, custom pricing can be managed as part of the Plan. You can read about Billing Plan Setting here.


Item Group permissions
The Item settings allow you to select which Items can or cannot be logged for Charges under this Contract. The settings include whether Labor, Expense or Part Item groups are allowed or not. Exceptions for specific Items can be added.

Billable Flag Settings for Global Contracts
You can set default values for the Billable flag, based on the Item group. This way you can choose which items are covered by the contract, and which are not, and should be billed. Note that for other Contract types (i.e. block contracts), the billable flag is determined automatically by the system according to the contract type.

Usage example:
You offer a monthly recurring Contract for services you provide. The contract covers phone and remote support but does not cover on-site work, nor any expenses or parts. Defining your contract:

  1. Contract defined: Global Contract.
  2. Define the recurring price using Contract-Price Charges .
  3. Do not allow Parts and Expense Items to be used.
  4. Allow Labor Items.
  5. Set the contract’s Billable flag behavior for Labor Items to – Billable.
  6. Then add two Labor Item exceptions for ‘Phone Support’ and ‘Remote Support’ and set their Billable flag to ‘Not Billable’ (i.e. covered).

This way, parts and expense Items cannot be logged as Charges under this contract. The phone/remote support services will be covered while any other type of labor charges will be billed.

To define Custom Contract settings go to the Contract’s Custom Settings tab:

Default SLA for Contracts

The SLA feature in RangerMSP helps you provide services to your customers within the time frame agreed with them. It provides an easy way to define the time-to-deliver of your Service-Level Agreements (SLA) with the customer and apply them to Tickets Due Date automatically.

A default SLA can be set to Accounts or Contracts, thus automatically applied to Tickets created under the Account or Contract.

To assign a default SLA to a Contract:

  1. Open the Contract Details tab.
  2. Select the SLA you want to use in the 'Detault SLA for new Tickets' field.
  3. Click Save to save your changes.


Note: Contract settings override Account settings. So, if both the Account and the Contract have a default SLA defined, Tickets created under this Contract will be assigned with Contract's SLA. Account SLA will be ignored in this case.

See Default SLA for Accounts and Contracts in the main SLA user guide for more details.

Activity Templates for Contracts

Each contract in the RangerMSP system can be assigned a "Linked Activity Template." This template can be linked to a contract and applied whenever a user copies this contract to a new date range or creates a new contract based on the contract to which the template is assigned.


When should it be used?
Linked Activity Templates can be useful for situations in which you want to copy a contract with all its data (the block terms, contract-price, etc.) along with a set of activities that are typical to this contract.

For example, if you have a monthly service contract that requires you to perform the same actions each month (on-site visit for preventative maintenance, server checkup, etc.), you can simply assign a Linked Activity Template to that contract. By attaching the template, every time you renew the contract for the following month, all of the monthly Tasks, Tickets, and Appointments associated with this template can be automatically created as well.

Another possible use for Linked Activity Templates would be in preparing predefined plans to offer to new and existing customers. Each plan can be defined as a Contract, linked to your business account record. Whenever a customer purchases a plan, you can simply copy the predefined contract, including all the predefined terms and activities, and create an actual contract for the customer.

Each of these predefined contracts would already include all of the plan terms—custom pricing, default items, special internal terms, block size, etc., as well as a linked activity template, which defines all the activities that needs to be done once an actual contract based on this predefined one is signed. All you would need to do is copy the predefined contract to a new one and apply the Linked Activity Template.

See the Activity Templates user guide for more details.

How does the system select a Default Contract?

When adding a new Ticket or Charge for an Account, the system will automatically select a Contract for the new Ticket/Charge. The parameters which the system considers when trying to find the valid contract are the Start and End Dates of the Contract.

This feature saves you time and helps you enter new Charges and Tickets quickly, without the need to manually select a Contract.

In order for the system to automatically select a contract by date, the Account should be set to 'Automatic' default Contract selection (this is the default behavior for new Accounts).

When no Contracts have been created for an Account, or when there are no other active Contracts, the 'Global System Contract' will be used automatically. This is a Contract that is created for each Account by default.

Note that this is especially useful for recurring contracts (e.g. Monthly Contracts), because RangerMSP will use a new copy of the previous Contract (which is valid for the next date range (see Recurring Contracts). In this case, the Account will have several copies of the Contract with different date ranges. The system will only start automatically selecting the Contract with the new date ranges when the previous Contract expires.

Note: The system does not select a Project Contract if there is another active and current Contract for an Account. Project Contracts are not considered as relevant active contracts for routing billing.


Forcing a Default Contract for an Account

You can set a default Contract for an Account, which will always be used by default when adding new Tickets or Charges to the Account. This option should be used only in cases where you always want to use the selected contract. We do not recommend using this option unless necessary.

To manually set the default contract for an Account, open the Accounts window, navigate to the relevant Account record, click on the Contracts tab, select the Contract you want to set as default, right-click on it > Default Contract > Set selected contract as the default contract for this account.



Setting a Contract series as the default Contract for the Account

You can set a Contract series as the default for the Account and RangerMSP will automatically pick the correct Contract from the series when adding new Ticket or Charges to the Account.

To manually set the default contract for an Account, open the Accounts window, navigate to the relevant Account record, click on the Contracts tab, select the Contract you want to set as default, right-click on it > Default Contract > Set the selected contract series as the default contract for this account.



Closing a Contract forcefully marked as the Default

RangerMSP will not let you mark a default contract for an account as closed, since closed contracts cannot be default contracts for Accounts. In order to select a different default contract for these accounts, you will need to follow these steps:

  • Go to the Accounts screen.
  • Choose Select an account.
  • Choose Contracts tab.
  • Select a new contract.
  • Right click the new Contract.
  • Select Default Contract.
  • Choose Set Selected Contract or Automatically Select.


Once you’ve selected a different contract than the one you’re closing as the default contract for that account, you’ll be able to mark the contracts you were trying to close as closed.

  • As an alternative to selecting a specific contract as the default contract, you can set the option to have the system automatically choose the relevant contract based on time and f other valid contracts are available.


Copying Contracts

Copying contracts is useful for renewing a completed contract or for using a pre-existing contract with another customer who receives similar terms.

When copying the contract, this copies the following data:

  1. The contract's basic data, such as the contract terms, the linked account, etc.
  2. The contract's Contract-price Charges
  3. The contract's default activity template, while applying the activities for the newly created contract

Copying contracts can be done in two ways: Using the Batch Copy Wizard or copying a single Contract. In both cases the Contract general details and linked information (such as Contract-Price Charges and Activity Templates) can be copied to the new Contract.

To copy a Single Contract, open the Contract window and click the Copy button from the toolbar.
To use the batch copy, go to Contracts > Batch Copy Contract for New Date Range.

Additional information about copying Contracts:


Renewing Contracts With the Batch Copy Wizard

The Batch Copy Wizard copies a group of contracts to the next date ranges. This method is generally used to renew contracts for the same customers.

To learn more about renewing Contracts:



Deleting Contracts

Normally if you used Contract you probably do not want to delete it, in order to keep you database complete with all of your history.
Best practice in case you don't want to use a Contract anymore is simply to deactivate it by changing the Contract Status field from the General tab.


Having said that, if you do want to delete a Contract (for example, if it is a test Contract that you do not want to affect your database), select the Contract in the list, and use Contracts > Delete option.

Important Note: Contracts that are linked to existing Charges cannot be deleted, to keep the data integrity.

In this case, to delete a Contract, you should first delete all linked Charges. To find which Charges are linked to this Contract:

  1. Open the Contract window.
  2. Click the Charges - All tab.
  3. All Charge records linking to this Contract will be displayed and you can delete them one by one.

Only after deleting all the Charges that were created with this Contract, the system will let you delete the Contract.

Batch Complete Contracts

The Batch Complete Contracts tool completes a group of selected Contracts. Use this option to complete Contracts which are expired either because their date has expired or because the block is empty. The Contracts should usually be completed only after renewing them (when managing recurring Contracts).

Related topics:


To run the Batch Complete Contracts utility, go to the Contracts window and from the menu bar choose Contracts > Batch Complete Contracts.

The following window opens:

In this window, you can filter the Contracts list either by End Date or an empty block, select the Contracts you wish to complete and then confirm to perform the action.

See more details in the steps process below.

  • Show Contracts of Type - You must first choose the Contract type you wish to update. The filtering criteria changes according to the Contract type.
  • Filter completed Contracts by -
    • End Date – Contracts with an End Date smaller or equal to the date you choose.
    • Block Empty – Available for block Contracts: Block of Time, Block of Money and Block of Tickets.
    • Block is Empty and by End Date – Also available for block Contracts only.
  • Hide Contracts that were not renewed yet – Select this option if you want to Complete only Contracts that have already been renewed.
    Note: If a Contract is completed, and there are no new contracts valid for this Account, the system will automatically default to the System Global Contract without alerting you that the Account has no current valid Contracts. Leaving such Contracts open until you take care of the renewal means you will be alerted when using such an expired Contract.
  • Click Refresh or hit Enter to see the results in the Contracts list.
  • Choose the Contracts you actually want to complete from the filtered list. You can use the Select All and Clear All buttons for quick selection.
  • Click OK to perform the action and complete all the chosen Contracts. This action will update the Status to Completed for all the chosen Contracts.

Once done, all the Contracts in the list will be updated and their status will be set as 'Completed'.


Labels

Contracts can have default Labels defined so that all Tickets created under a specific Contract will have the default labels applied automatically. See full details on default Labels here.




See Also