Skip to content

Latest commit

 

History

History
205 lines (128 loc) · 7.24 KB

quotes.md

File metadata and controls

205 lines (128 loc) · 7.24 KB

Quotes

The Quotes feature is available in Sales Pack.

A Quote is a specific group of products or services with their quantities and prices that you quote to customers.

The Quote entity type has a relationship with Opportunity type. You can add the Quotes panel to the Opportunity detail view at Administration > Layout Manager > Opportunities > Bottom Panels. When creating a new quote linked to an opportunity, it transfers opportunity items to the quote.

You can add the Quotes panel to the Account detail view to be able to see related quotes: Administration > Layout Manager > Accounts > Bottom Panels.

In the article:

Converting from Opportunity

Method 1. Create a new quote, on the form, specify a needed opportunity. Data will be copied from the opportunity to the created quote.

Method 2. Create a new quote from Quotes relationship panel on the detail view of the opportunity. Note: The administrator needs to add the panel in the Layout Manager.

Generating Sales Orders and Invoices from Quote

You are able to create a Sales Order and an Invoice from an existing Quote.

Method 1. Create a new sales order or invoice, on the form, specify the needed quote. Data will be copied from the quote to the created sales order or invoice.

Method 2. Create a new sales order or invoice from the corresponding relationship panel on Quote detail view.

Total Values Layout

The layout of total value fields (in the bottom on detail view) can be modified at Administration > Layout Manager > Quotes > Bottom Total.

Quote Items

A Quote has a list of items. Each item can represent a certain product or a service with description, quantity, tax rate, list price, and unit price fields. It's possible to sort items manually.

There is the ability to add custom fields for the Quote Item entity type using the Entity Manager.

Quote Items Layout

The layout of quote items can be modified at Administration > Layout Manager > Quote Items > List (Item).

Discount Rate

It's possible to specify a discount in percents. To have this ability, the administrator should add the Discount (%) field to the List (Item) layout.

Printing to PDF

Quotes can be printed to PDF. This action is available in the dropdown next to Edit button on the quote’s detail view. Then, you will be prompted to select a Template. More info about printing to PDF is available here.

Templates

An example template is available by default. You can create new templates (Quotes list view > top-right dropdown menu > Templates) as well as edit existing ones.

For more precise template editing, you can use the Code View mode.

You can print fields ofa Quote record as well as fields of related records by utilizing placeholders in your template.

Examples:

{{accountName}} – Account name,

{{{billingAddressStreet}}} – street,

{{account.type}} – type of related Account,

{{assignedUser.lastName}} – last name of the assigned user.

If your line item is a product, you can print product’s fields.

Examples:

{{product.length}},

{{product.color}}.

In examples, the length and color are custom fields of the Product entity type.

Looping through quote items:

<tr iterate="{{itemList}}">
  <td>{{order}}</td>
  <td>{{name}}</td>
  <td>{{quantity}}</td>
  <td>{{product.weight}}</td>
  <td align="right">{{listPrice}}</td>
  <td align="right">{{unitPrice}}</td>
  <td align="right">{{amount}}</td>
</tr>

Or:

<!-- {{#each itemList}} -->
  <td>{{order}}</td>
  <td>{{name}}</td>
  <td>{{quantity}}</td>
  <td>{{product.weight}}</td>
  <td align="right">{{listPrice}}</td>
  <td align="right">{{unitPrice}}</td>
  <td align="right">{{amount}}</td>
<!-- {{/each}} -->

It's possible to print image fields:

<img src="{{file imageId}}">

Where imageId – the name of the custom image field concatenated with the suffix Id.

For product line item:

<img src="{{file product.photoId}}">

To display float numbers (like quantity, unitPrice etc.) without a fractional part (as integer), use the following expression:

{{numberFormat quantity_RAW decimals=0}}

Custom formatting for currency values:

{{numberFormat unitPrice_RAW decimals=2 decimalPoint=',' thousandsSeparator=' '}}

Value 10000.5 will be printer as 10 000,50.

To display text fields (multiline), use triple braces: {{{description}}}.

Quote Items attributes

You can use these attributes in a template inside the loop {{#each itemList}} or <tr iterate="{{itemList}}">:

  • name
  • quantity
  • listPrice
  • unitPrice
  • discount
  • amount
  • unitWeight
  • weight
  • taxRate
  • order
  • description

All fields can be found at Administration > Entity Manager > Quote Items > Fields.

Sending quote in email

Quote PDF can be sent in an email as an attachment. Open a quote record, click the dropdown next to Edit button, and then click Email PDF.

Automatic numbering

By default, the Number field is auto-incremented. You can disable auto-increment at Administration > Entity Manager > Quote > Fields > number. It's also possible to make the number field read-only.

The prefix of the next number, the next number itself and the quantity of digits in the number can be configured at Administration > Entity Manager > Quote > Fields > numberA.

By default, there is no Name field on the Detail layout. The Number is used as a name. You can add the Number field at Administration > Entity Manager > Quote > Layouts > Detail.

Default tax

You need to have a Tax record created in your CRM. Taxes can be accessed at Quotes list view > dropdown in the top-right corner > Taxes.

An administrator can specify the default Tax record at Administration > Entity Manager > Quote > fields > Tax > Default.

Copying values from product to quote item

Field values can be transferred from a product to a quote item upon product selection. Field names you want to be copied should coincide in Product and Quote Item entity type.

You can select which fields you need to be copied at Administration > Entity Manager > Quote Item > Fields > Product > Fields to Copy.

Locking

A Quote can be locked if it's completed or canceled. When a record is locked, a specific fields become read-only. An administrator can configure the field list at: Administration > Entity Manager > Quote > Edit.

If the settings parameter Forbid order unlocking is checked, once a record is locked, it can be unlocked only by an administrator.

Automation with Workflows or BPM

The following service actions are available in Workflows and BPM tools:

  • Add Quote Items
  • Convert Currency
  • Send in Email

See also