> For the complete documentation index, see [llms.txt](https://en.docs.airdesk.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://en.docs.airdesk.ai/interface/comercial/contracts.md).

# Contracts

Contract management is one of Airdesk's most versatile features. It aims to be able to control any type of contract.  \
By using the contracts, you'll be able to launch of:&#x20;

```dart
Cases
    Tasks
        Times
```

Once there are entries made, Airdesk helps you to control or respond to the following situations:&#x20;

1. How many hours are included in the contract.&#x20;
2. What the value of the contract is.&#x20;
3. How many tasks are left to complete the contract.&#x20;
4. When the contract is renewed.&#x20;
5. You cannot close a contract while cases or tasks are still open. It will be necessary to close everything before concluding the contract, so that the missing tasks are removed from the employees' agendas.&#x20;
6. How many hours were released this month?&#x20;
7. Has the client already exceeded the time limit?&#x20;
8. Why has this contract exceeded 20 hours?&#x20;
9. Among others.&#x20;

### Contract Fields&#x20;

In order to manage with contracts with accuracy, it's important that you fill out the contract fields presented in the table below:

| Field Name                     | Description                                                                                               |
| ------------------------------ | --------------------------------------------------------------------------------------------------------- |
| Company &#xD;                  | Assign the contract to one of your companies.                                                             |
| Assign to                      | You can associate the contract with a client or a deal.                                                   |
| Contact                        | The customer's primary contact for the respective contract.                                               |
| Pipeline                       | Which pipeline it’s associated with.                                                                      |
| Status                         | What the status of the contract is.                                                                       |
| Nº Sales Opportunity           | Number for those who want to identify a number, for example, from the ERP.                                |
| Type of Contract               | You must first configure the types of contract.                                                           |
| Total Value                    | Monetary value of the contract.                                                                           |
| Minimum billing interval (min) | You can configure the invoicing interval value, for example, 15 minutes.                                  |
| Rounding margin (min)          | You can define a rounding margin, for example 5 minutes.                                                  |
| Estimated time (Hours)         | Maximum estimated time you intend to spend on the contract                                                |
| Start                          | Contract start date.                                                                                      |
| End                            | Contract end date.                                                                                        |
| Travels                        | Total number of trips included.                                                                           |
| Renewal                        | Periodicity of contract renewal.                                                                          |
| Time Control Periodicity       | You can set the frequency of the time control.                                                            |
| Maximum hours per Period       | You can manage hours per month, for example, an annual contract that has a maximum of 40 hours per month. |
| Value per Hour                 | Monetary value, reference per hour.                                                                       |
| Description                    | Free contract description.                                                                                |
| Opening hours                  | Service timetable included in the contract.                                                               |
| Manager                        | Who is responsible for the contract.                                                                      |
| Departments                    | Who has access to the contract.                                                                           |
| Teams / Collaborators          | Who has access, whether user or team.                                                                     |
| Followers                      |                                                                                                           |
| Internal note                  | Internal description that will not be added to exports or notifications.                                  |
| Attachments                    | Files attached to the contract.                                                                           |

### Special contract fields&#x20;

There are some display fields that help to manage the status of contracts. These fields are dynamic and based on the settings of each contract.&#x20;

### Originated/Completed&#x20;

The field allows you to know the total number of dependencies you have so that it can be closed. In the example below, you can see that the respective contract has 4 complete dependencies out of 4.&#x20;

![](/files/-MUJwRNJLZs1rt7gsLjm)

### Control by periodicity&#x20;

The field allows you to visualize, within the defined period, which contract has exceeded the desired hours. In the example below, you can see that in September contract hours were exceeded.&#x20;

![](/files/-MUJwSfXlFcw3_fx5Ls9)

### Exceeded hours&#x20;

The field allows you to view exceeded hours launched per contract. The arrow indicates whether they were before or after the contract. In the example below, you can see that they were posted 10 hours and 32 minutes before the contract start date and 1 hour after the contract end date.&#x20;

{% hint style="warning" %}
This field is not used to validate exceeded hours.&#x20;
{% endhint %}

![](/files/-MUJwVo1ZW9MRpLh7Q9E)

### Performance&#x20;

The field allows you to know, without having to calculate hours and in percentage, the number of hours skipped.&#x20;

![](/files/-MUJwXFeAU7ONq9gwrDR)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://en.docs.airdesk.ai/interface/comercial/contracts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
