# Quotes

## Introduction

You can view all of the quotes in the Quotes dashboard. The view shows all the quotes in the system, including quotes for both B2B and B2C customers. The B2C customer quotes are those without the company value.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-a21a9bec5605a5aa14e45d8ee72ba26799186386%2Fquote_board.png?alt=media" alt="Quotes"><figcaption><p>Quotes</p></figcaption></figure>

To narrow the list of your quotes you can filter the quotes by the available columns. The possible status types are:

* **Creating** - the quote is in preparation
* **Open** - the quote was prepared and is awaiting approval
* **Accepted** - the customer approved the quote
* **Pending** - the customer requested a change in the quote
* **Declined** - the customer rejected the quote
* **Expired** - the validity period for the quote is over
* **Declined by Merchant** - the quote was cancelled by an employee

You can also change the default view by using the options available under the orchestration icon.

<div align="left"><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-7cfcfdf2cec4c375b7575ad6c176c07374395af1%2Forchestration.png?alt=media" alt=""></div>

{% hint style="info" %}
With the table orchestration, you can add custom columns to the list view, by adding **mixin** fields as columns.\
If you have already defined mixin schema for the entity, you'd be able to select the defined mixin fields to display them in the main view.

See example how to do it in the [Displaying mixins in entity list view](https://developer.emporix.io/ce/settings/mixin-schemas#displaying-mixins-in-entity-list-view) documentation.
{% endhint %}

If you want to edit a quote, use the edit icon.

<div align="left"><figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-bc4cab84e11a826c8e7cc69d0a6580a917d11d44%2Fquote_edit.png?alt=media" alt="Edit quote" width="28"><figcaption><p>Edit quote</p></figcaption></figure></div>

{% hint style="info" %}

* Looking for business guides? Check out the [Quote Management](https://developer.emporix.io/ce/core-commerce/quote-management) guides.
* Looking for code tutorials and API reference? Check out the [Quotes API](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/quotes/quote) documentation.
  {% endhint %}

### Prerequisites

To start working with quotes, you need to:

* Enter the details related to companies, contacts and customers in the **Customer Management** module. Location and contact person settings are needed to create quotes.
* Have products prepared that can be added to the quote.

## Creating a quote

{% stepper %}
{% step %}

#### Create a quote

Go to the **Quotes** module and choose **Create Quote**.

The configuration of a new quote takes place in main sections located in different tabs:

* **General**
* **Products**
* **Preview**
* **Approval**
* **Changelog**
  {% endstep %}

{% step %}

#### Provide general information

In the **General** tab, first choose if the quote is for a B2B or B2C customer. Based on your selection, you get further options to provide the main information about the new quote.

* For B2B:

  * **Company** - choose the company for which you're creating the quote
  * **Contact Person** - choose the contact person that is responsible for the quote on the customer side
  * **Restrictions** - view a site restriction associated with the quote; modifying the value is possible only when the quote is in the "Creating" or "Open" status, otherwise it's read-only
  * **Locations** - choose the shipping and billing addresses that should be used for the quote

  <figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-4b2c495a1612fbf8e9986d87717058168def737b%2Fquote_general.png?alt=media" alt="B2B Quote"><figcaption><p>B2B Quote</p></figcaption></figure>
* For B2C:

  * **Customer**
  * **Restrictions** - view a site restriction associated with the quote; modifying the value is possible only when the quote is in the "Creating" or "Open" status, otherwise it's read-only
  * **Addresses**

  <figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-1cedfeada60e298bf1e15ca9e2190de91ecc5664%2Fquote_b2c.png?alt=media" alt="B2C Quote"><figcaption><p>B2C Quote</p></figcaption></figure>

{% hint style="warning" %}
The list of sites or restriction values depends on the specific user's restrictions to the site-aware (or restriction-aware) entities assigned through an employee group.

For more information about site permissions, see the [Site permissions](https://developer.emporix.io/ce/system-management/authentication-and-authorization/authorization/site-permissions).
{% endhint %}

When the first step is done, you can already save the quote and keep it for editing in the future. The status of the quote is set up as **Creating**.
{% endstep %}

{% step %}

#### Add products

To select products that should be included in the quote, go to the **Products** tab and choose the items that you want to add. After you make the selection, you can see a summary of the products and check it before saving the changes.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-74a308b50b022940b9c544ee6d2b333f9bebdc38%2Fquote_products.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Review shipping and prices

To check shipping information and to check the product-related details with a summary of their prices, go to the **Preview** tab. In this view, you can change the **Shipping Zone**, **Shipping Method**, the **Quantity** of every product and its **Net Price**.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-8e3c515547d1a2baff72d4380a314f8e66ccc9f9%2Fquote_preview.png?alt=media" alt=""><figcaption></figcaption></figure>

In this tab you can also customize the time after which the quote expires. By default, it's 30 days, but you can change the time in the **Validity** field, under **Additional Information**.

After updating the quote, make sure to **Save** your changes.
{% endstep %}

{% step %}

#### Send for approval

To start the quote approval process, go to the **Approval** tab where you have the pdf document visible with your newly created quote.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-2f4effdc4e22a2126d328f9799090d579226f2cf%2Fquote_approval.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-2f4effdc4e22a2126d328f9799090d579226f2cf%2Fquote_approval.png?alt=media" alt=""><figcaption></figcaption></figure>

Choosing **Create quote** sets the quote's status as **Open** and the request for approval is sent to the customer who requested the quote. The customer is notified by email that the quote is awaiting and it has to be approved or declined. Otherwise, the quote expires after the time that was set.

Both the customer, and the employees on behalf of the customer, can approve the quote, decline it, or request a change to the quote in the **Approval** tab. When choosing the request to change the quote or to decline it, it's necessary to select a reason for the decision. The reasons, called status codes, are managed in the Management Dashboard under **Quotes** -> **Status Codes**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
To learn more about the decline and change reasons management, check out the [Status Codes](https://developer.emporix.io/ce/management-dashboard/quotes/status-change-reasons) guide.
{% endhint %}

## Changelog

Changelog provides a detailed history of changes made to a single quote.

{% stepper %}
{% step %}

#### Open the quote in edit mode

To check a quote's changelog, go to **Quotes** and move to the edit mode of a selected quote. Use the view icon to go to the edit mode.

<div align="left"><figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-bc4cab84e11a826c8e7cc69d0a6580a917d11d44%2Fquote_edit.png?alt=media" alt="Edit quote" width="28"><figcaption><p>Edit quote</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### View the changelog

Go to the **Changelog** tab.

Here you can check all the editing changes and flow history of the selected quote.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-2968eca5f0c0882721979ebb819bb6c7153f609b%2Fquote_changelog.png?alt=media" alt="Quote changelog"><figcaption><p>Quote changelog</p></figcaption></figure>
{% endstep %}
{% endstepper %}