Last Updated: December 06 2023
How to Set Up Letter Forms
Overview
Set up the layout of your letter forms, as well as the email template that automatically appears every time you print or email a letter from a lead, quote, or job in Simpro Premium.
In order to view content or perform actions referred to in this article you need to have the appropriate permissions enabled in your security group. Go to System > Setup > Security Groups and access your security group to update your permissions. The relevant security group tab and specific permissions for this article can be found here:
To set up the layout of how your PDF letter forms appear when your print or email them, go to System > Setup > Forms Setup > Letter Form > Display Options and adjust the following options as required:
Header Fields |
Under Grey Area Height, enter the height of the grey area containing the header fields in the top right of the form. Enter '0' mm to display the header fields on a white background if required. Select the fields you wish to display at the top of the form from the Fields Assigned drop-down list, then click Add Fields. You can then reorder these fields using the grey drag handles to the left. To remove fields you do not wish to display, click the icon. |
Terms and Conditions (PDF) |
Click Browse / Choose File to upload a PDF of terms and conditions to attach to the end of the form. Please note compressed PDFs do not upload. You can then select to append the PDF to the form automatically when Printing and / or Emailing the form. Select Attaching to append the PDF to the form automatically when you click Attach in the Forms tab when printing or emailing the form. |
When you have finished adjusting settings, click Save.
You can create editable, pre-written scripts for select from and populate the Subject and Description in the Letter tab when you generate a letter form.
You can create scripts for both the PDF letter form and the body of the email when sending a letter form.
To create a letter script:
- Go to System > Setup > Forms Setup > Letter Form > Scripts.
- Click Create Script.
- Select Description if this script is used in the PDF letter, or select Email if it is used in the body of the email.
- Under Name, enter the subject line that appears in the PDF letter and under Script enter the description text that appears.
- Adjust the Script description using the formatting options, for example, bold, italics, or underline, at the top of the text box.
- To insert information from Simpro Premium into the script template so that it is automatically retrieved when you use the script in a letter form, click where you wish to include the information in the Name or Script, then click the field of information in the Insert Field list.
- For example, rather than typing out your company email, click to insert the Company Email field to automatically retrieve the email address from System > Setup > Company.
- When you have finished adjusting the script, click Save.
To edit a letter script, return to System > Setup > Forms Setup > Letter Form > Scripts and click the script you wish to adjust. To delete a script, click the icon on the script.
Learn more in How to Use Scripts.
To test how your settings apply to a real letter form as you update them:
- Locate and open the lead, quote, or job.
- Click the Forms tab.
- Under Form, select Letter Form. A new window opens.
- Select a letter script and adjust as necessary, or alternatively, enter a Subject and Description manually. Learn more in Create letter scripts. You can also select:
- Send Letter Without PDF Attachment to replace the email template in the Forms tab with the Subject and Description from the Letter tab. The PDF letter form is not included in the email.
- Do Not Include Customer Details in PDF to remove the customer's address from the PDF letter form.
- Do Not Include Signature in PDF to remove the signature defined in System > Setup > Forms Setup > General > Page Setup > Signature that displays under the letter Description.
- Click Forms > View.
- Go to System > Setup > Forms Setup > Letter Form > Display Options.
- Each time you update and save your letter form settings, return to the new tab and refresh the page to view how the settings have changed the layout of your letter form.
To set up the email template to appear when you email a letter form:
- Go to System > Setup > Forms Setup > Letter Form > Email.
- Under Use Default Settings:
- Clear the check box to Customise letter form email settings.
- Select the check box to use settings defined in System > Setup > Forms Setup > General > Email Setup, including Request Read Receipt, Send CC of Email to Current User, From Name, From Address and CC to (email addresses separated by commas). Learn more in Email Setup sub-tab.
- Under Email Template, adjust the default email Subject and Body to appear every time you send the form:
- Adjust text in the email Body using the formatting options, for example, bold, italics, or underline, at the top of the text box.
- Use the [projectType] field in Subject, so that if the Show as Estimate option is selected, the email subject updates to Estimate. Also, any reference to Quote in the form template is replaced with Estimate.
- To insert information from Simpro Premium into the email template so that it is automatically retrieved from the system when you email the form, click to include the information in the Subject or Body, then click the field of information in the Insert Field list.
- For example, rather than typing out your company email, click to insert the Company Email field to automatically retrieve the email address from System > Setup > Company.
- When you have finished adjusting the email template and settings, click Save.
Note that some details, such as site fields and work order number are specific to work orders and shall not populate in the body of email sent from the Work Order invoice.
If you have entered text in System > Setup > Forms Setup > Email Set up > Email Template > Body, it is automatically added to the body text in this email template when you email a form.
When you clear the Use Default Settings check box, you can customise your letter form email settings with the following options:
Request Read Receipt | Select On to automatically request that the email recipient confirm their receipt of your email. |
Send CC of Email to Current User |
Select On to CC the logged-in Simpro Premium user sending the email. This sends the email to the primary email address entered in the user’s employee card file. The secondary email address is not used. |
From Name |
Enter the sender name to appear to the recipient of the email when sent from any Simpro Premium user. If left blank, the email uses the logged-in Simpro Premium user’s name as it appears in their employee card file. |
From Address |
Enter the sender’s email address to display to the recipient of the email when sent from any Simpro Premium user. The email address used in this field is that which the recipient can reply to. If left blank, the email sends from the logged-in Simpro Premium user’s primary email address located in their employee card file. |
CC to (email addresses separated by commas) |
Enter the email addresses, separated by commas, that you wish to receive all forms of this type emailed from Simpro Premium. This is the default CC. You can also select additional CC in a job in the Forms tab. |
When you have finished adjusting settings, click Save.