# Introduction (https://docs.carlio.app/docs/deals)

The sales deals of the dealership, from the first request to the closed sale



A deal records the sale of one car to one customer. Every deal has a number that is unique within the dealership, for example Deal #14.

A deal names a customer. It can also name a sales partner and a car. A deal can exist before the car does, which allows the dealership to record an order for a car that is not yet sourced.

## Guides [#guides]

* [Open a deal](/docs/deals/open-a-deal)
* [Find and filter deals](/docs/deals/find-and-filter-deals)
* [Change the status of a deal](/docs/deals/change-the-status-of-a-deal)
* [Attach a car to a deal](/docs/deals/attach-a-car-to-a-deal)
* [Set commission terms on a deal](/docs/deals/set-commission-terms-on-a-deal)
* [Track payments on a deal](/docs/deals/track-payments-on-a-deal)
* [Edit or delete a deal](/docs/deals/edit-or-delete-a-deal)

## Deal statuses [#deal-statuses]

| Status        | Meaning                                                    |
| ------------- | ---------------------------------------------------------- |
| **Open**      | The deal is active and not yet settled.                    |
| **Won**       | The sale is agreed. The commission is fixed at this point. |
| **Lost**      | The customer purchased elsewhere.                          |
| **Cancelled** | Either party cancelled the deal.                           |

A new deal always starts as **Open**.

## The deal page [#the-deal-page]

Select a deal in the list to open its page. The page shows the car name, the status, the deal number, the customer and the sales partner. The remaining content sits in tabs.

| Tab           | Content                                                                                                                                    | Shown when                                              |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
| **Overview**  | Details, contacts, closing reason and notes. The financial summary and invoices appear when the team member holds the matching permission. | Always                                                  |
| **Payments**  | Money received, money awaited and the recorded transactions                                                                                | The team member can read financial records              |
| **Documents** | Invoices of the deal and the documents of the customer                                                                                     | The team member can read customer and partner documents |
| **Tasks**     | Tasks linked to the deal                                                                                                                   | Always                                                  |
| **History**   | Every status change, with author, reason and time                                                                                          | Always                                                  |

## Requirements [#requirements]

The sidebar shows **Deals** only to team members who hold the **Deal Pipeline Access** permission. The Owner and Manager roles hold every permission in the table. The Staff role holds none of them by default.

| Action                                         | Permission                                       |
| ---------------------------------------------- | ------------------------------------------------ |
| Open the **Deals** page and a deal             | **Deal Pipeline Access**                         |
| Open a deal                                    | **Open Deals**                                   |
| Edit a deal, change its status or attach a car | Deal update, held by the Owner and Manager roles |
| Delete a deal                                  | Deal delete, held by the Owner and Manager roles |
| See sale prices                                | **Deal Financial Access**                        |
| See partner names                              | **Partner Directory Access**                     |
| See commission figures                         | **Partner Commission Access**                    |
| See the **Payments** tab                       | **Financial Records Access**                     |

The Owner changes the switches that carry a label in **Settings** under **Permissions**. Deal update and deal delete have no switch. The **Edit** action of a deal also needs **Deal Financial Access** and **Partner Commission Access**.

## Shared pages [#shared-pages]

A customer, a partner or a task assignee opens a shared page from a link that a team member issues. Those pages have their own guides.